Webhook 隧道专为接收第三方平台的回调请求设计，适合支付通知、消息推送等场景。支持对回调请求进行签名验证，确保请求来源合法。

​
前置条件

已订阅 Webhook 集成插件（参见 集成中心）

​
步骤

​
1. 进入隧道管理

进入 控制台 → 隧道管理，点击 添加隧道。

​
2. 配置隧道基本信息

配置项说明
隧道模式选择标准隧道（默认）
隧道特性选择 Webhook
隧道协议选择 HTTPS
带宽（Mbps）填写允许使用的最大带宽值

​
3. 配置公网域名

选择该隧道对外使用的公网域名：
  • 随机域名：系统自动分配，即时可用
  • 自定义域名：从已添加的域名中选择

​
4. 绑定设备与内网服务

选择运行 ZeroNews CLI 客户端的本机设备，并填写内网服务地址：
  • 内网 IP：例如 127.0.0.1
  • 内网端口：例如 8080

​
5. Webhook 特性配置

​
选择 Webhook 类型

类型说明
标准 Webhook直接将公网回调请求转发到内网服务，不做签名验证，适合通用回调场景
Webhook Verify在转发前由 ZeroNews 对请求签名进行验证，验证通过后再转发，确保请求来源合法
选择 Webhook Verify 后，需继续选择 Verify 场景：

​
① 微信支付回调

选择密钥信息提供方式： 方式一：键值对 由您直接在控制台提供密钥信息，ZeroNews 会自动完成该隧道关联所有设备的配置同步，并保证密钥安全。 需填写以下信息：
  • 微信 AppID
  • 微信商户号
  • 微信 API v3 Key
  • 微信支付平台证书序列号
填写完成后点击 确认 即可。
方式二：内网配置文件地址 在本地创建 YAML 配置文件，并将文件绝对路径提供给 ZeroNews。ZeroNews 会从内网服务的配置文件中读取密钥进行验证，密钥信息不会上报至 ZeroNews 云服务，所有验证行为均在用户内网完成，密钥安全由用户自身保障。 填写 YAML 配置文件路径，例如 /etc/zeronews/wechat-pay-verify.yaml。 配置文件格式如下，复制后替换占位符即可使用： 
appid: <微信_appid>
mch_id: <微信商户号>
api_v3_key: <微信api_v3_key>
serial_no: <微信支付平台证书序列号>
填写完成后点击 确认 即可。

​
② 微信签约回调

选择密钥信息提供方式： 方式一：键值对 由您直接在控制台提供密钥信息，ZeroNews 会自动完成该隧道关联所有设备的配置同步，并保证密钥安全。 需填写以下信息：
  • 微信 AppID
  • 微信商户号
  • 微信 API v2 Key
  • 签名算法
填写完成后点击 确认 即可。
方式二：内网配置文件地址 在本地创建 YAML 配置文件，并将文件绝对路径提供给 ZeroNews。ZeroNews 会从内网服务的配置文件中读取密钥进行验证，密钥信息不会上报至 ZeroNews 云服务，所有验证行为均在用户内网完成，密钥安全由用户自身保障。 填写 YAML 配置文件路径，例如 /etc/zeronews/wechat-contract-verify.yaml。 配置文件格式如下，复制后替换占位符即可使用： 
appid: <微信_appid>
mch_id: <微信商户号>
api_v2_key: <微信api_v2_key>
sign_type: <MD5>
填写完成后点击 确认 即可。