ngrok绑定自定义域名的核心操作是:在ngrok控制台添加域名、到DNS服务商配置CNAME解析、修改ngrok配置文件的domain参数,三步完成后即可通过专属域名访问本地服务。
默认情况下,ngrok免费版分配的是随机公网地址,格式类似xxx.ngrok-free.app,这个地址有两个痛点:域名不固定,重启服务后大概率变化;免费域名容易被浏览器拦截或提示不安全,绑定自定义域名后,你可以在固定域名下对外提供服务,配合HTTPS证书,访问体验和正式环境几乎没有差别。
ngrok绑定自定义域名前需要准备什么
动手之前,先确认四样东西齐了:
- 一个ngrok账号,直接在官网注册,登录后进入控制台
- 域名解析权限,你需要能在域名服务商后台添加解析记录,比如简米云、酷番云、Cloudflare
- 本地已安装ngrok客户端,建议使用官方最新版本,旧版本配置语法略有差异
- 已获取authtoken,在控制台首页可见,这段字符串是客户端连接官方服务器的凭证
ngrok免费域名和自定义域名有什么区别
很多用户搜索"ngrok免费域名和自定义域名对比",核心就关心两个问题:稳定性好不好、要不要花钱,直接看表:
| 对比项 | 免费域名 | 自定义域名 |
|---|---|---|
| 域名格式 | 随机分配,含ngrok标识 | api.yourdomain.com这种 |
| 稳定性 | 重启可能变化 | 固定不变 |
| 浏览器信任度 | 可能被拦截或警告 | 配置证书后正常 |
| 成本 | 免费 | 按月订阅付费套餐 |
| 适用场景 | 临时调试、个人测试 | 对外服务、小程序后台 |
免费域名适合临时验证,自定义域名适合稳定交付,付费套餐的价格以ngrok官方定价页面为准,国内用户按汇率折算后按月支付。
ngrok域名怎么设置:三步完成绑定
这一步是整个教程的核心。
第一步:在ngrok控制台添加自定义域名
登录ngrok控制台,左侧菜单进入Domains页面,点击New Domain输入你要绑定的完整域名,比如api.example.com,点击创建后,ngrok返回一个CNAME记录值,类似xxx.ngrok.io,复制保存,下一步用。
第二步:配置DNS解析记录
回到域名服务商后台,添加CNAME记录:
- 记录类型选择CNAME
- 主机记录填写子域前缀,比如
api - 记录值粘贴ngrok返回的CNAME地址
- TTL保持默认
保存后等待生效,用dig命令验证:
dig api.example.com
返回结果里出现ngrok的CNAME地址,说明解析已生效。
第三步:修改ngrok配置文件
找到ngrok配置文件,Windows路径是C:\Users\<用户名>\.ngrok2\ngrok.yml,macOS和Linux路径是~/.ngrok2/ngrok.yml,打开后写入:
version: "2"
authtoken: 你的authtoken
tunnels:
web:
proto: http
addr: 8080
domain: api.example.com
保存后运行ngrok:
ngrok start web
看到Session Status: online,自定义域名就成功绑定到本地8080端口了。
ngrok本地服务公网映射的实操场景
用一个真实场景来演示绑定过程。
本地跑着Node.js服务,端口3000,需要让外部合作伙伴临时查看页面效果,按上述步骤,把配置文件中的addr改为3000,域名换成preview.example.com,保存重启ngrok。
访问https://preview.example.com,就能看到本地服务发出的内容。
本地端口被占用怎么处理
ngrok不限制你映射哪个端口,配置文件里addr改成服务实际监听的端口即可,比如addr: 9000,注意配置多个隧道时,端口别重复。
HTTPS证书自动配置
ngrok付费套餐支持自动签发和续期HTTPS证书,域名绑定后在控制台会显示证书状态,无需手动上传证书文件,这一点比传统部署省事很多。
ngrok国内使用教程:速度和备案问题
回答国内用户最关心的两个问题。
访问速度优化建议
ngrok服务器节点在海外,国内访问延迟普遍在100-300毫秒左右,接口调试和静态页面展示勉强够用,延迟敏感的应用建议改用国内节点工具,或者给自定义域名接入Cloudflare加速。
自定义域名需要备案吗
ngrok的转发服务器在海外,不涉及国内服务器托管,所以域名不需要备案,这个结论适用于ngrok官方的服务,如果你用第三方国内中转服务,则不一定,务必先问清楚。
业内专家指出,内网穿透工具的选择要结合业务部署位置,海外服务器选ngrok顺手,国内服务器场景则要多对比。
ngrok和frp怎么选
这组对比经常出现在"ngrok和frp哪个好"的讨论里,ngrok胜在配置简单、自带HTTPS证书、有Web管理界面;frp是开源方案,可以自己部署在任意服务器上,流量不经过官方中转,私密性更好,但需要自己管理证书和反代,单纯追求省事,选ngrok;追求自主可控,frp更合适。
常见问题解答
ngrok免费版能绑定自定义域名吗
不能,免费版只提供随机临时域名,自定义域名属于付费功能,临时测试用免费版没问题,对外稳定服务建议升级付费套餐。
绑定后访问显示502错误怎么排查
先确认本地服务是否正常启动,在本地运行curl localhost:端口号验证;再检查配置文件里addr是否写对;最后看ngrok终端的日志输出,网关上如果有错误信息会直接打印出来。
域名解析生效时间长是什么原因
DNS生效时长由TTL和递归服务器缓存决定,大部分情况下,海外服务商如Cloudflare通常在个位数分钟内生效,国内服务商一般20分钟内完成,如果等待半小时仍未生效,检查CNAME记录值是否完整复制,遗漏末尾的点号会导致解析失败。