如何下载安装和使用 ngrok 免费版固定开发域名
- 2026-09-21 03:15:13
如何下载安装和使用 ngrok 免费版固定开发域名它比 Cloudflare Quick Tunnel 更方便的地方是：免费账号会自动分配一个固定的开发域名，例如： https://xxxx.ngrok-free.app 这个开发域名归你的账号使用，不需要每次重启都改地址。免费版目前提供 1 个自动分配的开发域名，适合本地接口和图片联调。 打开 ngrok 官网注册免费账号。 注册后进入控制台，找到： Your Authtoken 会看到类似命令： 不要把令牌发给别人，也不要写进 Git。 Windows 可以从 Microsoft Store 安装，也可以使用官网下载的 Windows 程序。安装完成后，在 CMD 验证： 能显示帮助信息就说明安装成功。 在 CMD 执行控制台提供的命令： 正常会提示配置已保存。 打开一个 CMD：cd到你的项目根目录 浏览器先确认： http://localhost:3000/api/v1/health 能够正常返回。 再打开一个新的 CMD： ngrok 会把公网 HTTPS 请求转发到你本机的 3000 端口。官方 CLI 的标准用法就是 ngrok http <本地端口>。 终端里会显示类似： 复制其中的 HTTPS 地址。 免费账号使用的是自动分配的固定 Dev Domain，不能自己改名字，但通常下次仍然使用该账号域名。 假设你的域名是： https://your-name.ngrok-free.app 打开： https://your-name.ngrok-free.app/api/v1/health 能返回： 再测试一张真实图片地址： https://your-name.ngrok-free.app/uploads/content/202607/某张图片.jpg 能打开图片，才说明 API 和图片代理都正常。 打开： 将开发环境改为： 替换成你的真实 ngrok 域名。 建议 API 和图片全部使用同一个 HTTPS 地址，不要再保留： 这样可以避免接口和图片分别走不同来源。 在微信开发者工具中： 清除全部缓存 → 重新编译 检查： 轮播显示后台真实图片； 活动封面显示； 案例封面显示； 二维码显示； Console 不再提示 HTTP 图片不支持； Network 请求都变成 https://...ngrok-free.app。 每次开发需要保持哪些窗口 至少保持： Docker：MySQL、Redis 后端：npm run dev:api ngrok：ngrok http 3000 微信开发者工具 关闭 ngrok 终端后，公网 HTTPS 地址会暂时无法访问；下次重新执行 ngrok http 3000 即可恢复。 免费方案适合开发测试，不适合作为正式生产环境。当前免费方案包括自动分配开发域名、最多 3 个在线端点，并有每月请求量限制。 正式上线仍建议使用： 云服务器 + 自有域名 + Nginx + HTTPS证书 + COS/OSS对象存储
第一步：注册 ngrok
ngrok config add-authtoken 你的令牌第二步：安装 ngrok
ngrok help第三步：绑定账号
ngrok config add-authtoken 你的真实Token第四步：先启动本地后端
cd /D:\AI_model\XXXXX\shijing-experiencedocker compose up -dnpm run dev:api
第五步：启动免费 HTTPS 隧道
ngrok http 3000Forwardinghttps://your-name.ngrok-free.app -> http://localhost:3000
第六步：浏览器验证
{"database": "ok","redis": "ok"}
第七步：修改小程序配置
D:\AI_model\AI_Mini_Program\shijing-experience\apps\miniprogram\utils\env.tsdevelop: {apiBaseUrl: 'https://your-name.ngrok-free.app/api/v1',assetBaseUrl: 'https://your-name.ngrok-free.app',},
apiBaseUrl: 'http://localhost:3000/api/v1'第八步：微信开发者工具重新编译
免费版的限制
本文来自网友投稿或网络内容，如有侵犯您的权益请联系我们删除，联系邮箱：wyl860211@qq.com 。
