内网穿透工具 Ngrok 与 Natapp 使用及微信回调配置指南

4.2 设置 Token

1. 登录后在 Dashboard 页面找到 Authtoken。
2. 在命令行中运行：

   ./ngrok authtoken 你的 Token 值
   

4.3 启动服务

假设本地服务运行在 9999 端口：

./ngrok http 9999

启动后会生成一个随机域名。首次访问可能会遇到浏览器安全警告，点击 Visit Site 跳过即可。

4.4 固定域名隧道

如果需要固定域名（例如用于生产环境回调），可在 Dashboard 中配置 Tunnel 选项，绑定自定义域名。这通常需要付费订阅，但能提供更稳定的连接标识。

5. 微信回调配置实战

5.1 注册测试公众号

开发者调试时可使用微信提供的测试号：

• 访问 https://mp.weixin.qq.com/debug/cgi-bin/sandboxinfo?action=showinfo&t=sandbox/index
• 扫码登录并激活测试号。

5.2 后端代码示例 (Spring Boot)

在 Controller 中处理 GET 和 POST 请求，接收微信推送的参数。注意：实际生产环境中需实现签名验证逻辑。

@GetMapping("/callback")
public String entryCallbackSign(@RequestParam(name = "signature", required = false) String signature,
                                @RequestParam(name = "timestamp", required = false) String timestamp,
                                @RequestParam(name = "nonce", required = false) String nonce,
                                @RequestParam(name = "echostr", required = false) String echostr) {
    log.info("微信回调 GET 请求");
    // 此处应添加签名校验逻辑
    return echostr;
}

@PostMapping(value = "/callback", produces = "application/xml; charset=UTF-8")
public String entryCallback(@RequestBody(required = false) String requestBody,
                            @RequestParam(name = "signature", required = false) String signature,
                            @RequestParam(name = "timestamp", required = false) String timestamp,
                            @RequestParam(name = "nonce", required = false) String nonce) {
    log.info("微信回调 POST 请求");
    log.debug("Request Body: {}", requestBody);
    // 此处应添加消息体解密与签名校验逻辑
    return "";
}

5.3 回调地址配置

1. 在测试号后台，填写服务器配置。
2. URL 填写内网穿透工具生成的公网地址（无需 http 前缀，具体视平台要求而定，通常包含 http://）。
3. Token 填写与代码中一致的 Token。
4. 启用后，发送消息测试连通性。

6. 常见问题排查

1. 权限问题：Linux/Mac 下确保二进制文件有执行权限 (chmod +x)。
2. 防火墙拦截：检查本地防火墙是否放行了穿透工具的监听端口。
3. 端口占用：确保本地服务端口未被其他进程占用。
4. 签名失败：微信回调常因签名算法不一致导致验证失败，请严格参照官方文档排序参数并计算 SHA1。

通过上述步骤，您可以快速搭建内网穿透环境并完成第三方回调对接，提升开发调试效率。