服务器与大带宽专家 · 持牌IDC/CDN/ISP服务商
简米科技官网JIANMI TECH
资讯 2026-11-20 简米科技 2,565 字 6 分钟阅读

ngrok如何绑定自定义域名到本地服务?ngrok设置域名教程大全

导读ngrok绑定自定义域名的核心操作是:在ngrok控制台添加域名、到DNS服务商配置CNAME解析、修改ngrok配置文件的domain参数,三步完成后即可通过专属域名访问本地服务,默认情况下,ngrok免费版分配的是随机公网地址,格式类似xxx.ngrok-free.app,这个地址有两个痛点:域名不固定,重……

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记录值是否完整复制,遗漏末尾的点号会导致解析失败。

分享本文
本文为 简米科技官网 原创,已由运维技术专家审核。转载请注明来源:原文链接
售前咨询 服务热线 售后 邮箱