用内网穿透调试本地接口

调试 Webhook、支付回调、第三方 OAuth 时，本地服务需要公网可访问地址。下面按「临时调试」和「长期固定域名」两类对比常用工具，并附上启动命令。

工具对比

推荐

• 临时调试、不想注册：Cloudflare Quick Tunnel（cloudflared tunnel --url）。
• 只接 GitHub Webhook：smee 或 Hookdeck CLI（带重放更方便）。
• 要 TCP、固定子域或团队习惯：ngrok。
• 微软 / GitHub 生态：dev tunnel。
• 长期固定域名、自有域：Cloudflare Tunnel（面板配置）。

Cloudflare Quick Tunnel

官方文档

安装：

brew install cloudflared
winget install --id Cloudflare.cloudflared

启动（将 8080 换成本地端口）：

cloudflared tunnel --url http://localhost:8080

smee

smee.io — 获取隧道地址 后转发到本地 path。

# 将 URL 换成 https://smee.io/new 生成的地址
npx smee-client --url https://smee.io/xxx --path /integration/webhook/github --port 8080

Hookdeck CLI

GitHub

npx hookdeck-cli login
npx hookdeck-cli listen 8080 github --path /integration/webhook/github

ngrok

控制台

安装：

brew install ngrok/ngrok/ngrok
winget install ngrok -s msstore

写入 token（登录后页面会给出命令）：

ngrok config add-authtoken XXX

启动：

ngrok http http://localhost:8080

dev tunnel

官方入门

安装（brew 版本可能过旧，推荐官方脚本）：

curl -sL https://aka.ms/DevTunnelCliInstall | bash

登录（-g 为 GitHub，否则微软账号）：

devtunnel user login -g

启动：

devtunnel host -p 8080

Localtunnel

官网

npx localtunnel --port 8000

首次访问页面会要求隧道密码，二选一获取：

curl https://loca.lt/mytunnelpassword
wget -q -O - https://loca.lt/mytunnelpassword

Cloudflare Tunnel（固定域名）

Cloudflare One 面板 — 适合需要稳定公网域名的场景。

1. Networks → Tunnels → Create a tunnel → 选 Cloudflared，填写名称并保存。
2. 按页面提示安装 connector，示例：

brew install cloudflared &&
sudo cloudflared service install XXX

3. Public Hostnames 里配置 Subdomain、Domain、Path、Type、后端 URL（不要写 http:// / https:// 前缀）。
4. 保存后测试路由是否可达。