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

ngrok如何绑定自定义域名?指定域名的详细配置步骤,域名解析教程

导读ngrok绑定自定义域名的核心答案是:官方渠道必须付费,免费账号的隧道地址是随机分配的,想用自己的域名只能升级套餐或自建ngrok服务器,意味着你需要在开始之前做好心理准备:不是填个域名就能用,而是要先确认账号权限,再完成域名验证、解析指向、配置文件修改三个步骤,下面我会把整条路径拆开讲清楚,包含命令和操作位置……

ngrok绑定自定义域名的核心答案是:官方渠道必须付费,免费账号的隧道地址是随机分配的,想用自己的域名只能升级套餐或自建ngrok服务器。

意味着你需要在开始之前做好心理准备:不是填个域名就能用,而是要先确认账号权限,再完成域名验证、解析指向、配置文件修改三个步骤,下面我会把整条路径拆开讲清楚,包含命令和操作位置,照着做就能跑通。

ngrok绑定自定义域名需要付费吗

这是个绕不开的问题。如果你用的是ngrok官方云服务,自定义域名属于付费套餐的权益,免费版无法绑定固定域名。 免费账号启动隧道时,对外地址是系统随机生成的,1a2b3c4d5e6f.ngrok-free.app,而且每次重启隧道地址都会变化,这个限制决定了你做本地开发演示可以,生产环境不行。

ngrok官方定价将自定义域名放在Growth及以上档位,价格随套餐档位递增,虽然具体数字会调整,但逻辑是固定的:个人档只能临时地址,团队档才有固定域名配额,付费后在Dashboard里的Domains页面就能添加域名,然后绑定到你的Agent(客户端)。

为了让你直观对比,我把常见的使用方式列成一张表:

方案 自定义域名 地址稳定性 成本
ngrok免费版 不支持 重启即变 0元
ngrok付费版 支持 固定 按档位付费
自建ngrok服务器 支持 固定 VPS费用
反向代理或frp 支持 固定 VPS费用

已经决定用官方付费版的人,具体怎么操作?下一节是完整流程。

ngrok指定域名的详细配置步骤

整体流程分成三步:控制台验证域名、DNS解析指向ngrok、修改本地配置文件启动隧道。核心逻辑是让ngrok知道你拥有这个域名,同时让域名解析到ngrok的边缘节点。

先验证域名所有权

登录 dashboard.ngrok.com,左侧菜单点 Domains,再点 New Domain,输入你要绑定的完整域名,dev.example.com,这里注意,ngrok一般建议用二级域名,因为顶级域名解析关系到根域名证书和邮件记录,容易跟已有服务冲突。

创建后,ngrok会给你两条记录值:

  • 一条 CNAME记录,目标地址类似 dev.example.com.ngrok.io
  • 一条 TXT记录,用于验证域名控制权

回到你的DNS管理后台,添加这两条解析记录,TXT记录是验证用的,CNAME记录是流量转发用的。TXT验证通过后,这条TXT记录可以删除,但CNAME必须保留。

域名验证生效时间通常在几分钟内,但DNS缓存可能导致延迟,可以用 dig txt dev.example.com 查看TXT记录是否已生效。

完成DNS解析:ngrok绑定二级域名怎么设置

大多数人的诉求都是给某个二级域名绑定ngrok,因为主域名往往有其他业务。ngrok绑定二级域名的本质就是一条CNAME解析,不需要额外配置子域名转发或URL重定向。

以简米云DNS为例,操作位置在:域名解析列表 → 添加记录。

  • 记录类型:CNAME
  • 主机记录:dev
  • 记录值:ngrok提供的CNAME目标地址

如果你使用的是Cloudflare,注意代理状态要选择仅DNS,不要开启橙色云朵代理,否则会多一层代理导致WebSocket连接不稳定。

如果你非要绑定顶级域名,example.com,那需要设置A记录指向ngrok的边缘节点IP,但说实话这个玩法风险大,容易跟MX邮件记录冲突,行业共识是老老实实用二级域名。

修改ngrok配置文件并启动隧道

ngrok客户端在v3版本后统一使用YAML配置文件,先安装ngrok并完成登录:

ngrok config add-authtoken 你的Token

Token在Dashboard的 Your Authtoken 页面获取,然后修改配置文件,默认位置是:

  • Windows:%HOMEPATH%\.config\ngrok\ngrok.yml
  • Linux/macOS:~/.config/ngrok/ngrok.yml

用文本编辑器打开,写入如下配置:

version: "3"
agent:
  tunnels:
    mysite:
      proto: http
      addr: 8080
      domain: dev.example.com

解释一下这三个参数:proto 指定隧道类型,addr 是你本地服务的端口,domain 是刚绑定好的自定义域名,保存后启动:

ngrok start mysite

如果你只是想临时测试,也可以不写配置文件,直接用命令:

ngrok http --domain=dev.example.com 8080

启动成功后,终端会显示 https://dev.example.com 已经指向 http://localhost:8080,并且TLS证书会自动签发,ngrok会为你的域名申请Let's Encrypt证书,无需自己配置。

免费绑定ngrok自定义域名:自建与反向代理

如果你不想付费,又必须用自己的域名,那答案只有一条路:绕过ngrok官方云服务,自己搭一套内网穿透环境。 这需要你有台有公网IP的服务器,成本大约是一台最低配云服务器的费用。

自建ngrok服务器:VPS+公网IP

ngrok服务端源码是开源的,可以部署到自己服务器上,基本流程是:

  1. 在VPS上安装Go环境并编译ngrok服务端
  2. 服务端启动时指定一个根域名,ngrok.example.com
  3. 客户端配置 server_addr: ngrok.example.com:4443
  4. 连接成功后,你的隧道地址就是 随机子域.ngrok.example.com

这个方案最大的坑是你需要为ngrok服务器和隧道域名准备通配符SSL证书,否则HTTPS访问会报证书错误,国内服务器还有个特殊问题:如果用大陆VPS,需要做备案;如果不想备案,就选香港或海外的节点,这是ngrok国内如何使用的普适解,但延迟会相对高一些。

据ngrok开源项目的README说明,自建版本的功能完整度与官方基本一致,但要自己承担运维负担。

Nginx反向代理与frp的选型

另外一条思路更简单粗暴:既然你已经有公网VPS了,还要ngrok干什么?直接把域名解析到VPS,用Nginx反向代理转发到内网机器。

但这里有个前提:Nginx本身没办法直接穿透到你家里或公司的内网,它只能转发到公网IP的某个端口。 所以真正的穿透需求还是要靠隧道工具,2026年的社群讨论中,frp已经是另一个高频选择,frp和ngrok区别在哪?简单说:

  • ngrok强在免部署,官方服务开箱即用,适合快速分享、临时演示
  • frp强在自托管的灵活性,支持TCP、UDP、HTTP、STCP多种协议,配置直观,适合长期生产使用

如果你愿意折腾,frp的自定义域名玩法比ngrok更自由:服务端一个 frps.ini,客户端一个 frpc.ini,指定 custom_domains 就完事了,不需要验证域名所有权,业内专家指出,选择隧道工具时优先考虑团队长期维护能力和协议支持范围,不要只看表面配置难度。

ngrok固定域名不生效的排查清单

绑定过程只有三个环节:域名验证、解析记录、本地配置,固定域名不生效,按下面这个顺序逐个排除,基本上十分钟内能找到问题。

  • 域名解析未生效:用 ping dev.example.com 看返回的IP是否指向ngrok节点,或者用 nslookup dev.example.com 检查CNAME是否被正确解析,解析记录刚修改时会延迟,清空本地DNS缓存后再测。
  • TXT记录未删除但CNAME错误:有些人在DNS后台把CNAME值和TXT值弄混了,导致验证通过后流量无法进入ngrok节点,检查记录类型是不是CNAME,记录值是否以 ngrok.io
  • 启动报错 domain is not reserved:这个属于约定大于配置的典型案例,ngrok提示该域名未在当前账号下绑定,回到Dashboard的Domains页面确认状态是否为 Active,同时确认agent的authtoken是你付费账号的token。
  • 本地服务端口不对:配置文件里的 addr: 8080 必须对应你本地实际启动的服务端口,访问 https://dev.example.com 返回502,多半是本机服务没起来。
  • HTTPS证书异常:官方服务会自动签发证书,如果打开网页提示安全风险,一般是因为你的域名使用了Cloudflare代理,导致证书链断裂,把Cloudflare代理关掉,让流量直连ngrok即可。

在启动ngrok后,终端日志里会明确列出隧道的公网URL、本地转发地址、错误码,排查时永远以终端输出为第一依据。 它能告诉你请求是否真的抵达了ngrok边缘节点、是否成功转发到本地,如果终端显示连接正常但浏览器打不开,那就不是ngrok的问题,而是本地服务或浏览器代理设置的问题。

Q&A:ngrok绑定自定义域名常见问题

Q1:ngrok绑定自定义域名必须付费吗?

官方云服务是必须的,免费版无法在配置文件中指定自定义域名,即便填了启动也会报错,如果不想付费,只能自建ngrok服务器或用frp自己做穿透,前提是你有一台公网VPS。

Q2:ngrok自定义域名能用HTTPS吗?

可以,ngrok官方服务会自动为自定义域名签发Let's Encrypt证书,默认强制HTTPS访问,在配置文件中可以通过 schemes: [http, https] 同时开启HTTP和HTTPS,不需要自己上传证书。

Q3:ngrok固定域名重启后会变吗?

官方付费版的固定域名不会变,这是它和免费版最大的差异之一,免费版每次启动生成新的随机地址,重启后全部作废;付费版绑定关系存在ngrok云端的账号名下,只要套餐未过期,域名永远是同一个。

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