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服务端源码是开源的,可以部署到自己服务器上,基本流程是:
- 在VPS上安装Go环境并编译ngrok服务端
- 服务端启动时指定一个根域名,
ngrok.example.com - 客户端配置
server_addr: ngrok.example.com:4443 - 连接成功后,你的隧道地址就是
随机子域.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云端的账号名下,只要套餐未过期,域名永远是同一个。