分类

Webhook 调试与中继工具

生成唯一的 Webhook 接收地址,查看请求详情、校验签名,并把捕获的请求回放到目标端点

示例结果

2 个示例

先捕获 Stripe 测试 Webhook 再转发

创建唯一接收地址,校验签名后再把选中的请求回放到真实接口

Webhook dashboard with a unique capture URL, signature validation, and replay controls.
查看输入参数
{ "relayTargetUrl": "https://api.example.com/webhooks/stripe", "signatureSecret": "whsec_test_123", "signatureHeader": "stripe-signature", "autoReplay": false, "methodFilter": "POST", "bodyMustContain": "\"type\":\"invoice.paid\"", "storedRequestLimit": 50 }

按条件转发 GitHub Webhook

只自动转发匹配的 push 事件,同时保留完整日志用于回放和导出

Webhook dashboard configured for conditional relay, replay, and export.
查看输入参数
{ "relayTargetUrl": "https://api.example.com/webhooks/github", "signatureSecret": "github_secret_value", "signatureHeader": "x-hub-signature-256", "autoReplay": true, "methodFilter": "POST", "bodyMustContain": "\"ref\":\"refs/heads/main\"", "storedRequestLimit": 100 }

关键信息

分类
Network
输入类型
text, checkbox, select, number
输出类型
html
样本覆盖
4
支持 API
Yes

概览

一款专为开发者设计的 Webhook 调试与中继工具。它能一键生成唯一的接收地址,实时捕获并展示 HTTP 请求详情。支持配置签名密钥进行安全校验,并可根据请求方法或 Body 内容过滤请求。无论是本地开发调试,还是将线上 Webhook 流量安全地回放、中继到目标服务器,都能轻松搞定。

适用场景

  • 在本地开发环境中需要接收并调试第三方平台(如 Stripe、GitHub)的 Webhook 通知时。
  • 需要验证 Webhook 签名(HMAC)是否正确,排查鉴权失败问题时。
  • 希望拦截特定条件的 Webhook 请求,并将其手动或自动回放到内网或测试服务器时。

工作原理

  • 生成唯一的 Webhook 接收 URL,将其配置到第三方平台的 Webhook 设置中。
  • 配置签名请求头和密钥(可选),工具将自动校验接收到的请求签名。
  • 设置方法过滤(如仅 POST)或 Body 关键字过滤,精准捕获目标请求。
  • 在面板中查看请求详情,或开启自动回放功能,将匹配的请求中继到指定的目标 URL。

使用场景

支付网关(如 Stripe、支付宝)异步通知的本地联调与签名验证。
GitHub/GitLab 代码提交事件的过滤与 CI/CD 触发器中继。
SaaS 平台 Webhook 流量的临时捕获、分析与故障排查。

用户案例

1. 调试 Stripe 支付成功通知

后端开发者
背景原因
正在接入 Stripe 支付,需要接收 invoice.paid 事件并在本地测试业务逻辑。
解决问题
本地环境无法直接接收公网 Webhook,且需要验证 Stripe 签名是否正确。
如何使用
生成接收地址填入 Stripe,配置回放目标为本地穿透地址,设置签名头为 stripe-signature,并过滤包含 "type":"invoice.paid" 的请求。
示例配置
{
  "relayTargetUrl": "https://api.example.com/webhooks/stripe",
  "signatureSecret": "whsec_test_123",
  "signatureHeader": "stripe-signature",
  "methodFilter": "POST",
  "bodyMustContain": "\"type\":\"invoice.paid\""
}
效果
成功捕获 Stripe 的支付通知,验证签名通过后,手动将请求回放到本地开发环境进行断点调试。

2. 按条件自动中继 GitHub Push 事件

DevOps 工程师
背景原因
需要将 GitHub 仓库的 Push 事件推送到内部的自动化部署脚本,但只关心 main 分支的提交。
解决问题
GitHub 原生 Webhook 无法细粒度过滤分支,导致内部服务器接收过多无效请求。
如何使用
使用本工具作为中间层,开启自动回放,并设置 Body 必须包含 "ref":"refs/heads/main"。
示例配置
{
  "relayTargetUrl": "https://api.example.com/webhooks/github",
  "autoReplay": true,
  "methodFilter": "POST",
  "bodyMustContain": "\"ref\":\"refs/heads/main\""
}
效果
工具自动拦截非 main 分支的推送,仅将符合条件的 Push 事件实时中继到内部服务器,减轻了服务器负载。

用 Samples 测试

network

相关专题

常见问题

接收到的 Webhook 请求会保存多久?

工具最多保存您设置的“存储请求上限”数量的请求(默认 50 条,最高 200 条),超出后将自动覆盖最早的记录。

支持哪些类型的签名校验?

支持基于请求头(如 x-signature 或 stripe-signature)和密钥的 HMAC 签名校验。

可以只回放特定的请求吗?

可以。您可以通过设置“方法过滤”和“Body 必须包含”字段,仅拦截并回放符合条件的请求。

自动回放和手动回放有什么区别?

开启“自动回放匹配请求”后,符合过滤条件的请求到达时会立即转发到目标 URL;关闭则需在面板中手动点击回放。

回放目标 URL 可以是本地地址吗?

如果您的本地地址已通过内网穿透(如 Ngrok)暴露为公网 URL,则可以作为回放目标进行中继。

API 文档

请求端点

POST /zh/api/tools/webhook-debugger-relay

请求参数

参数名 类型 必填 描述
relayTargetUrl text -
signatureSecret text -
signatureHeader text -
autoReplay checkbox -
methodFilter select -
bodyMustContain text -
storedRequestLimit number -

响应格式

{
  "result": "
Processed HTML content
", "error": "Error message (optional)", "message": "Notification message (optional)", "metadata": { "key": "value" } }
HTML: HTML

AI MCP 文档

将此工具添加到您的 MCP 服务器配置中:

{
  "mcpServers": {
    "elysiatools-webhook-debugger-relay": {
      "name": "webhook-debugger-relay",
      "description": "生成唯一的 Webhook 接收地址,查看请求详情、校验签名,并把捕获的请求回放到目标端点",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=webhook-debugger-relay",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

你可以串联多个工具,比如:`https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`,最多20个。

如果遇见问题,请联系我们:[email protected]