跳转到内容

CLI 故障排查

Not logged in

重新登录:

Terminal window
hooknexus login

若仍异常,执行 hooknexus whoami 检查会话;可尝试 logout 后再次 login

Request not found

request id 需要 完整。先列出该 endpoint 下的请求:

Terminal window
hooknexus requests ls <endpoint-id>

再对完整 id 使用 showbodyreplay

Target URL must be localhost

转发到非本机地址需要显式开启:

Terminal window
hooknexus forward --to http://example.com/webhook --allow-external

未加 --allow-external 时,仅允许 localhost127.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 中升级:

Terminal window
hooknexus upgrade

或通过网页端的订阅 / 账单流程处理。

仍然无法解决?

  • 使用 hooknexus --helphooknexus <command> --help 查看最新参数。
  • 在支持的情况下设置 HOOKNEXUS_DEBUG 获取更详细的诊断输出。
  • 参阅 安装与快速上手 中的 API 地址与凭据存储说明。
  • 反馈问题或查看源码:hooknexus/hooknexus-cli(GitHub)