CLI 故障排查
Not logged in
重新登录:
hooknexus login若仍异常,执行 hooknexus whoami 检查会话;可尝试 logout 后再次 login。
Request not found
request id 需要 完整。先列出该 endpoint 下的请求:
hooknexus requests ls <endpoint-id>再对完整 id 使用 show、body 或 replay。
Target URL must be localhost
转发到非本机地址需要显式开启:
hooknexus forward --to http://example.com/webhook --allow-external未加 --allow-external 时,仅允许 localhost、127.0.0.1、.local。
转发后本地返回 404
--to 必须包含 路径。若只写 http://localhost:8788 这类无路径地址,请求会打到本地的 /,很多框架会返回 404。
应使用完整 URL,例如 http://localhost:8788/your/webhook/route(具体路径依你的应用而定)。详见 本地转发。
Request replay is available on the Plus plan and above
请求重放不属于 Free。可在 CLI 中升级:
hooknexus upgrade或通过网页端的订阅 / 账单流程处理。
仍然无法解决?
- 使用
hooknexus --help与hooknexus <command> --help查看最新参数。 - 在支持的情况下设置
HOOKNEXUS_DEBUG获取更详细的诊断输出。 - 参阅 安装与快速上手 中的 API 地址与凭据存储说明。
- 反馈问题或查看源码:hooknexus/hooknexus-cli(GitHub)。