返回首页

如何转发 Webhook 到 localhost

先接收公网回调，再安全地 replay 或 forward 到本地开发环境，是更可控的方式。

最近更新: 2026-06-24

绝大多数第三方服务无法直接访问你的 localhost。更实际的方式，是先把 webhook 收到公网收件箱，再转发或 replay 到本地 tunnel。

步骤

  1. 先让 WebhookPilot 接收这条 webhook。
  2. 为本地应用打开一个可信的公网 tunnel。
  3. 配置 forward rule，或者手动 replay。
  4. 同时查看原始事件和下游投递结果。

示例

curl -X POST "https://your-domain.com/api/events/evt_123/replay" \
  -H "Content-Type: application/json" \
  -d '{"targetUrl":"https://your-tunnel.example/webhook"}'

常见错误

  • 试图让托管服务直接访问 localhost
  • 没有校验 replay 目标地址
  • tunnel 地址变化后忘记更新

FAQ

托管服务能直接打到 localhost 吗？

不能。你需要一个公网入口，比如 tunnel 或 staging 地址。

为什么还要保留公网 inbox 这一步？

因为它能提供稳定的原始记录、重放控制和更安全的调试流程。

可结合 如何重放 Webhook 请求 使用。