它比 Cloudflare Quick Tunnel 更方便的地方是:免费账号会自动分配一个固定的开发域名,例如:https://xxxx.ngrok-free.app这个开发域名归你的账号使用,不需要每次重启都改地址。免费版目前提供 1 个自动分配的开发域名,适合本地接口和图片联调。第一步:注册 ngrok
ngrok config add-authtoken 你的令牌
第二步:安装 ngrok
Windows 可以从 Microsoft Store 安装,也可以使用官网下载的 Windows 程序。安装完成后,在 CMD 验证:第三步:绑定账号
ngrok config add-authtoken 你的真实Token
第四步:先启动本地后端
cd /D:\AI_model\XXXXX\shijing-experiencedocker compose up -d npm run dev:api
http://localhost:3000/api/v1/health第五步:启动免费 HTTPS 隧道
ngrok 会把公网 HTTPS 请求转发到你本机的 3000 端口。官方 CLI 的标准用法就是 ngrok http <本地端口>。Forwardinghttps://your-name.ngrok-free.app -> http://localhost:3000
免费账号使用的是自动分配的固定 Dev Domain,不能自己改名字,但通常下次仍然使用该账号域名。第六步:浏览器验证
https://your-name.ngrok-free.apphttps://your-name.ngrok-free.app/api/v1/health{ "database": "ok", "redis": "ok"}
https://your-name.ngrok-free.app/uploads/content/202607/某张图片.jpg第七步:修改小程序配置
D:\AI_model\AI_Mini_Program\shijing-experience\apps\miniprogram\utils\env.ts
develop: { apiBaseUrl: 'https://your-name.ngrok-free.app/api/v1', assetBaseUrl: 'https://your-name.ngrok-free.app',},
建议 API 和图片全部使用同一个 HTTPS 地址,不要再保留:apiBaseUrl: 'http://localhost:3000/api/v1'
第八步:微信开发者工具重新编译
Network 请求都变成 https://...ngrok-free.app。关闭 ngrok 终端后,公网 HTTPS 地址会暂时无法访问;下次重新执行 ngrok http 3000 即可恢复。免费版的限制
免费方案适合开发测试,不适合作为正式生产环境。当前免费方案包括自动分配开发域名、最多 3 个在线端点,并有每月请求量限制。