本地开发

把 Webhook 转发到 localhost,而不是直接暴露你的本地服务

HookNexus 先提供稳定的公开 Webhook URL,再通过 CLI 将捕获到的请求转发进本地 HTTP 路由,帮助你用真实 provider payload 调试本地代码。

典型的 localhost 调试流程

  1. 1. 在 HookNexus 创建 endpoint,把公开 URL 配到 Stripe、GitHub、Shopify、Slack 等服务商后台。
  2. 2. 启动本地服务,然后运行 hooknexus forward --to http://localhost:PORT/PATH
  3. 3. 在控制台查看原始流量,同时让 CLI 把同一请求打到本地应用。

一个典型的 CLI 命令示例

如果你的本地路由监听在 3000 端口,这通常就是从公开 Webhook URL 到本地真实请求的最短路径。

hooknexus endpoints create

hooknexus forward ENDPOINT_ID --to http://localhost:3000/api/webhooks/stripe

转发启动后,你可以保持服务商后台配置不变,直接围绕真实投递调试本地代码,而不必反复手写模拟请求。

建议一起打开的文档

为什么很多团队更喜欢这种方式

  • 你不需要把随机本地端口直接暴露到公网,再围着隧道和回调地址反复切换。
  • 请求进入本地处理器前,可以先在 HookNexus 控制台中查看原始请求内容,定位问题更直接。
  • Plus 的重放能力还能把已保存的请求重新下发到在线客户端,适合复测和回归验证。

这类 localhost 问题最适合这样解决

  • 服务商明明已经打到公开 endpoint,但你的本地服务始终看不到请求。
  • 你在本地开发时频繁更换隧道地址和回调配置,调试成本越来越高。
  • 你需要对照控制台里的原始请求和本地框架解析后的结果,确认问题到底出在哪一层。
  • 你修完代码后,只想拿同一条保存请求再跑一遍,而不想回到服务商后台重新触发。

什么时候 Plus 会更有价值

Free 足够帮你接住请求并验证这条工作流是否适合自己。Plus 更适合已经把 localhost 转发和 replay 变成日常开发动作的团队。

通常也是从这个阶段开始,你会更在意固定的公开 endpoint、更快的复测节奏,以及减少重复触发 provider 动作的成本。

什么时候 localhost 转发帮助最大

  • 应用还在本地。 如果你的处理器还没部署到公网,localhost 转发通常是最快把真实 provider 流量接进开发环境的方式。
  • 请求细节很关键。 如果 body、headers、重试节奏都会影响排查结果,直接转发真实请求会比手写模拟数据更可靠。
  • 隧道方案太重。 如果你现在还在暴露随机端口、频繁改回调地址、再加一堆辅助工具,这种方式往往更轻量。

常见问题

是不是仍然需要一个公开 Webhook URL?

需要。服务商仍然要先把请求打到一个公开地址,HookNexus 先提供这个稳定入口,再把流量转发进 localhost。

请求进本地前能先在控制台查看吗?

可以。这正是这种工作流的价值之一。你可以先在控制台里确认请求内容,再让 CLI 把它送进本地路由。

它只适合本地开发吗?

本地开发是最典型场景,但当你想把稳定的捕获入口和下游调试客户端分开时,这种方式同样有价值。