把一个跑在自己服务器(甚至家里机器)上的 Web 服务发布到公网,传统做法绕不开三件事:在防火墙和安全组里开放 80/443 端口、在 DNS 里把域名解析到源站 IP、让全世界的请求直接打到你的机器上。这套做法本身没错,但它带来一个长期存在的暴露面:源站 IP 一旦被查到,攻击者就能绕过 Cloudflare 边缘直接打源站,你套在边缘上的 WAF、限速、质询规则全部失效,DDoS 更是直接灌进源站的带宽。历史上源站 IP 的泄露渠道太多了:历史 DNS 记录、证书透明度日志、邮件头、子域名遗漏,任何一个都能让你的”藏 IP”努力白费。
Cloudflare Tunnel(隧道,原名 Argo Tunnel)换了个思路:不再等外面的人连进来,而是由源站上的一个小守护进程 cloudflared 主动向外与 Cloudflare 边缘建立长连接,访客的请求先到边缘,再顺着这条已经建好的连接”塞”回源站。整个过程里,源站不需要开放任何入站端口,DNS 里也不出现源站 IP。本篇以 Debian 为主线,完整走通本地配置型隧道的安装、创建、绑域名、多服务分发和系统服务自启,最后讲清它与 Nginx 反向代理各自的适用场景。
主线先说清楚:理解原理 → 装 cloudflared → 登录授权 → 创建隧道 → 写 ingress 配置 → 绑定域名 → 试跑验证 → 装成系统服务 → 排障与选型。
传统发布方式的暴露面
先把问题摆全。用 Nginx 反向代理发布服务时(具体做法见 用 Docker 部署 Nginx 反向代理与自动 HTTPS),链路是这样的:
| 环节 | 传统反代发布 | 带来的暴露面 |
|---|---|---|
| 入站端口 | 源站开放 80/443 | 端口扫描可探测,服务指纹可识别 |
| DNS 记录 | A/AAAA 直接指向源站 IP(开橙云后由边缘代答) | 历史记录、旁路渠道可查到真实 IP |
| 流量路径 | 访客 → 边缘 → 源站公网 IP | 知道 IP 即可绕过边缘直连源站 |
| 证书 | 源站自己申请维护 | 证书透明度日志里有域名与源站线索 |
| 家庭/内网机器 | 需要公网 IP 或端口映射 | 没有公网 IP 时根本发不出去 |
其中最要命的是第三条。很多人给域名开了橙云代理,以为源站就藏好了,实际上只要源站 IP 通过任何渠道泄露过一次,攻击者就可以用 Host 头直连源站,边缘的防护一层都用不上。Tunnel 要解决的正是这个问题:从架构上消灭入站连接——源站只出不进,DNS 里只剩隧道,真实 IP 没有任何公开记录可查。
Tunnel 的工作原理
cloudflared 是 Cloudflare 官方的隧道守护进程,开源、单二进制、无运行时依赖。它启动后会主动向 Cloudflare 边缘发起并维持 4 条长连接(连接到就近的多个边缘节点,协议默认走 QUIC,网络不支持时可回退到 HTTP/2)。这 4 条连接就是隧道的全部:任何一条活着,隧道就是通的;单条断开会自动重连,不影响其余连接上的流量。
访客侧的路径是这样的:
访客浏览器 │ ① DNS 查询 app.example.com,得到的是指向隧道的 CNAME ▼Cloudflare 边缘节点 │ ② 边缘发现这个域名绑定了一条隧道 │ ③ 请求顺着 cloudflared 预先建好的长连接反向送回源站 ▼cloudflared(运行在源站上) │ ④ 按 ingress 规则把请求转给本机服务 ▼http://localhost:8080 上的实际应用注意第 ③ 步的方向:连接是源站建的,请求是”顺流而下”的,源站的防火墙对入站方向可以全关。这带来几个直接结果:
- 零入站端口:源站防火墙、安全组不需要为这个服务开放任何端口,
ss -tlnp里 cloudflared 只有出站连接。 - IP 不进 DNS:域名解析的结果是
<隧道ID>.cfargotunnel.com的 CNAME,解析不到源站 IP。 - 没有公网 IP 也能发布:家里宽带、NAT 后的机器、云上只有内网 IP 的实例,只要能出站访问互联网,就能建隧道。
- 边缘能力全保留:WAF、缓存、限速、Access 登录墙都照常生效,因为流量本来就先过边缘。
它和普通橙云代理的区别,很多人容易混,一张表分清:
| 对比项 | 橙云代理(普通模式) | Cloudflare Tunnel |
|---|---|---|
| 连接发起方 | 边缘按需回源连接源站 | 源站 cloudflared 主动建长连接 |
| 源站入站端口 | 必须开放 80/443 | 不需要开放任何端口 |
| DNS 记录内容 | A/AAAA 指向源站 IP | CNAME 指向 cfargotunnel.com |
| 源站 IP 泄露风险 | 有(历史记录等渠道) | 无公开记录可查 |
| 源站要求 | 有公网 IP | 只要能出站上网 |
| 源站组件 | Web 服务器/反代即可 | 额外常驻 cloudflared |
| 回源加密 | 取决于 SSL 模式配置 | 隧道连接本身加密,无需另配 |
WARNINGTunnel 不是”套了 CDN 的内网穿透玩具”。它改变的是连接方向与信任边界:以前你要防的是”全世界连我的 80/443”,现在你要守的是 cloudflared 的隧道凭据文件——凭据 JSON 一旦泄露,别人可以用它在任意机器上把你的隧道跑起来接管流量,所以这个文件要按私钥级别保管,权限收紧、不进 Git、不随手拷贝。
两种建法:先选路线
官方提供两种管理方式,先选一条,别混着来:
| 建法 | 配置存放位置 | 操作入口 | 适合场景 |
|---|---|---|---|
| 控制台远程管理型(Dashboard-managed) | Cloudflare 后台 | Zero Trust 控制台网页点选 | 多人协作、不想碰配置文件、要配合 Access 策略 |
| 本地配置文件型(Locally-managed) | 源站本机 config.yml | 命令行 tunnel 子命令 | 单人运维、配置要进版本管理、服务器上批量操作 |
两者跑的是同一个 cloudflared、同一套隧道协议,区别只在”配置从哪来”:远程管理型把配置存在 Cloudflare 那边,cloudflared 启动时拉取;本地型读本机文件。本篇主线走本地配置文件型,因为它全程命令行完成、配置可审计、和本系列的操作习惯一致。远程管理型的流程梗概是:登录 Zero Trust 控制台 → Networks → Tunnels → Create a tunnel → 选 Cloudflared → 给隧道起名 → 控制台会生成一条带 Token 的安装/运行命令,在源站执行 → 回到控制台添加 Public Hostname(子域名 + 本地服务地址)→ 保存即生效。它的凭据形态是 Token 而不是 JSON 文件,服务安装命令控制台会直接给全,后面”装成系统服务”一节的思路相通,遇到时对照官方文档操作即可(细节以官方文档为准)。
安装 cloudflared
Debian 上推荐走 Cloudflare 官方软件包仓库,版本跟得上、升级走 apt。依次执行:
# 添加官方仓库的签名密钥sudo mkdir -p --mode=0755 /usr/share/keyringscurl -fsSL https://pkg.cloudflare.com/cloudflare-main.gpg | sudo tee /usr/share/keyrings/cloudflare-main.gpg >/dev/null
# 添加 cloudflared 仓库源echo 'deb [signed-by=/usr/share/keyrings/cloudflare-main.gpg] https://pkg.cloudflare.com/cloudflared any main' | sudo tee /etc/apt/sources.list.d/cloudflared.list
# 安装sudo apt updatesudo apt install cloudflared
# 确认版本cloudflared --version能输出形如 cloudflared version 2025.x.x (built ...) 的版本号即安装成功。不想加仓库也可以去官方发布渠道下载对应架构的 .deb 包用 dpkg -i 安装,两种方式装的是同一个程序;但仓库方式后续 apt upgrade 能一起升级,长期运维更省事。包名、仓库地址这类细节若与你看到的不一致,以官方文档为准。
WARNINGcloudflared 只能从 Cloudflare 官方渠道下载。不要从来路不明的镜像站或网盘下载 cloudflared 二进制——它手里握着你的隧道凭据,又是常驻进程,被人动过手脚等于把源站大门钥匙送出去。
全流程实战:建第一条隧道
假设我们要发布的服务是源站本机 8080 端口上的一个应用,域名用 app.example.com(请换成你自己的、已托管在 Cloudflare 的域名)。整个流程五步。
第一步:登录授权
cloudflared tunnel login这条命令会给出一个授权链接(在终端里能直接打开的话会自动拉起浏览器;纯 SSH 环境就把链接复制到本地浏览器打开)。登录你的 Cloudflare 账号后,选择要授权的域名,确认后浏览器会把证书下载回来,命令执行完毕会在 ~/.cloudflared/ 目录下生成 cert.pem。验证一下:
ls -l ~/.cloudflared/能看到 cert.pem 就说明授权完成。这个证书是你的账号级凭据,用它可以创建和管理该账号下的隧道,同样按私钥对待。
无头服务器上浏览器不在同一台机器完全没问题:链接在哪台设备上打开都行,授权结果会通过回调落回执行命令的这台机器。如果命令长时间等不到授权结果,多半是网络到 Cloudflare 的出站不通,先排查出站连通性而不是反复重试。
第二步:创建隧道
cloudflared tunnel create my-tunnelmy-tunnel 是隧道名,自己起个好认的。命令成功后输出大致如下:
Tunnel credentials written to /home/yourname/.cloudflared/3f8a1c2e-xxxx-xxxx-xxxx-xxxxxxxxxxxx.json.Created tunnel my-tunnel with id 3f8a1c2e-xxxx-xxxx-xxxx-xxxxxxxxxxxx两个信息记好:隧道 ID(那串 UUID)和凭据文件路径(~/.cloudflared/<隧道ID>.json)。凭据文件是这条隧道独一份的钥匙,下一步写配置要用。随时可以用下面的命令查看已有隧道:
cloudflared tunnel list第三步:写配置文件
在 ~/.cloudflared/config.yml 写入:
tunnel: 3f8a1c2e-xxxx-xxxx-xxxx-xxxxxxxxxxxxcredentials-file: /home/yourname/.cloudflared/3f8a1c2e-xxxx-xxxx-xxxx-xxxxxxxxxxxx.json
ingress: - hostname: app.example.com service: http://localhost:8080 - service: http_status:404逐行讲清:
| 配置项 | 含义 |
|---|---|
tunnel | 隧道 ID,指明这个进程跑的是哪条隧道 |
credentials-file | 凭据 JSON 的绝对路径,写相对路径是常见翻车点 |
ingress | 分发规则列表,从上到下依次匹配 |
hostname | 访客访问的主机名,命中后走这条规则 |
service | 命中后转发到的本地服务地址 |
最后一条 http_status:404 | 兜底规则:前面全没命中的请求直接由 cloudflared 返回 404 |
service 不只能写 HTTP 地址,也支持 https://localhost:8443(回源不校验证书等细节参数以官方文档为准)、tcp://、ssh:// 等协议,但不同协议的访客侧接入方式差别很大,本篇主线只走最顺的 HTTP 类服务,非 HTTP 的情况在”适用边界”一节说明。
第四步:绑定域名
cloudflared tunnel route dns my-tunnel app.example.com这条命令会在 example.com 的 DNS 里自动建一条 CNAME 记录:app 指向 <隧道ID>.cfargotunnel.com 并开启代理。这一步也可以手动去控制台 DNS 页面加同样的 CNAME,效果一致。注意:如果这个子域名已经有 A 记录或其他记录占着,命令会报错,先删掉旧记录再执行;绑完去控制台确认记录存在、CNAME 目标正确。
第五步:前台试跑验证
先别急着装服务,前台跑一遍看日志最稳妥:
cloudflared tunnel run my-tunnel正常日志里会出现 4 条连接注册成功的记录,形如 Registered tunnel connection,并标注连接走的协议(quic 或 http2)和边缘位置。这时在浏览器打开 https://app.example.com,应该直接看到本机 8080 应用的页面。用 curl -I https://app.example.com 也能验证状态码。确认无误后 Ctrl+C 停掉,下一节把它变成常驻服务。
到这一步可以停下来体会一下成果:你的源站没有开任何新端口,app.example.com 的 DNS 里也没有你的 IP,但服务已经在公网可达了。这就是 Tunnel 的核心价值:发布与暴露被彻底解耦。
一个隧道分发多个服务:ingress 详解
一条隧道可以承载同一台机器上的多个服务,靠的就是 ingress 规则按主机名分发。比如同一台机器上还跑着博客(3000 端口)和一个状态面板(9000 端口),配置扩成:
tunnel: 3f8a1c2e-xxxx-xxxx-xxxx-xxxxxxxxxxxxcredentials-file: /home/yourname/.cloudflared/3f8a1c2e-xxxx-xxxx-xxxx-xxxxxxxxxxxx.json
ingress: - hostname: app.example.com service: http://localhost:8080 - hostname: blog.example.com service: http://localhost:3000 - hostname: status.example.com service: http://localhost:9000 - service: http_status:404要点有三条:
- 顺序即优先级:请求从上往下匹配,第一条命中就走,不再往下看。带
path限定的规则(如只匹配某个路径前缀)要放在同主机名的通用规则前面。 - 兜底规则必须存在:ingress 列表最后一条必须是没有任何匹配条件的收尾规则(通常写 http_status:404),缺了它配置校验直接不过,隧道起不来。
- 每个子域名都要单独绑 DNS:新增一个主机名,就多执行一次
cloudflared tunnel route dns my-tunnel blog.example.com,或者在控制台手动加指向同一个<隧道ID>.cfargotunnel.com的 CNAME。
改完配置先校验再重启,别拿线上流量试错:
# 校验 ingress 配置语法与规则完整性cloudflared tunnel ingress validate
# 测试某个 URL 实际会命中哪条规则cloudflared tunnel ingress rule https://blog.example.com/第二条命令会告诉你这个 URL 命中的是第几条规则、转发到哪个 service,排查”为什么这个域名进错了服务”时非常好用。
装成系统服务
试跑通过后,把它交给 systemd 常驻:
sudo cloudflared service installsudo systemctl status cloudflaredservice install 会把当前用户的隧道配置与凭据复制到系统位置(/etc/cloudflared/),生成 systemd 单元并设为开机自启。注意这意味着服务以 root 身份读取的是 /etc/cloudflared/config.yml 那份拷贝,之后你改 ~/.cloudflared/config.yml 不会同步过去——改配置后要同步更新系统目录下的那份,再 sudo systemctl restart cloudflared。这是本地配置型最容易踩的运维坑,记住”运行的那份在 /etc 里”。
日常运维命令:
# 查看运行状态与最近日志sudo systemctl status cloudflaredsudo journalctl -u cloudflared -f
# 改完配置后重启sudo systemctl restart cloudflared
# 确认隧道在线(在账号层面看连接状态)cloudflared tunnel info my-tunneltunnel info 能看到当前有几个 cloudflared 连接器在线、分别连到哪些边缘节点。多机冗余也是基于这个机制:同一条隧道可以在第二台机器上用同一份凭据再跑一个 cloudflared,边缘会自动在多个连接器之间分发,单机宕机不影响服务——但凭据多一份拷贝就多一份泄露风险,权衡着来。
适用边界:先把预期放对
Tunnel 很好用,但不是万能发布器,边界要先认清:
| 维度 | 实际情况 |
|---|---|
| HTTP/HTTPS 类服务 | 最顺,浏览器直达,本篇主线场景 |
| WebSocket | 支持,隧道原生透传 |
| SSH、TCP 等非 HTTP 协议 | 访客侧需配合 Cloudflare Access 或 WARP 客户端,不是浏览器输个域名就能连,配置方式另成一套(以官方文档为准) |
| UDP 类服务 | 常规隧道不面向公网 UDP 发布,别拿它套游戏/语音服务 |
| 性能 | 流量绕边缘一跳,延迟取决于机器到边缘的距离;静态资源可叠加边缘缓存抵消 |
| 稳定性 | 依赖源站出站网络与 cloudflared 进程存活,进程要交给 systemd 并开自启 |
| 费用 | Tunnel 本身免费可用,不按流量另收费(以官方现行政策为准) |
一句话总结适用面:发布 Web 服务是它的主场;要发布任意 TCP/UDP,先想清楚访客侧怎么接入,再决定用不用它。
与 Nginx 反代的分工
已经有公网服务器、Nginx 反代跑得好好的(见 Docker 部署 Nginx 反向代理篇),还要不要 Tunnel?按场景分:
| 场景 | 推荐 | 理由 |
|---|---|---|
| 公网服务器,源站 IP 暴露无所谓 | 继续 Nginx 反代 | 链路短、延迟低、不依赖第三方进程 |
| 公网服务器,但被绕过边缘直打过源站 | Nginx 前面叠 Tunnel | 反代配置不用动,源站关掉 80/443 入站,只留隧道出站 |
| 机器没有公网 IP(家里宽带、NAT 后) | Tunnel | 传统反代根本无从发布,隧道是少数可行解 |
| 临时给人演示内网服务 | Tunnel(或一次性快速隧道) | 不用改防火墙、不用备案域名解析折腾 |
| 对延迟极度敏感的接口 | Nginx 直连 | 少一跳是一跳 |
两者叠用的姿势很常见:cloudflared 的 ingress 直接指向本机 Nginx 的端口,Nginx 继续管它的虚拟主机、限流和静态文件,Tunnel 只负责”把流量安全地送进来”。这时源站防火墙把 80/443 的入站全关掉,Nginx 只听本机回环或只接受 cloudflared 的转发,边缘防护再也绕不过去。
排障
1033:Cloudflare Tunnel error
浏览器报 1033,意思是边缘找不到这条隧道的在线连接。九成是 cloudflared 没在运行:
sudo systemctl status cloudflaredsudo journalctl -u cloudflared -n 50cloudflared tunnel info my-tunnel进程不在就先拉起来;进程在但 info 显示无连接,查源站出站网络(到 Cloudflare 边缘的连接被防火墙出站规则或代理干扰最常见)。
502 Bad Gateway
边缘或 cloudflared 返回 502,通常是隧道通了、但最后一米没通:本地服务没起、端口写错、或者服务只监听了某个网卡而 ingress 写的是 localhost 对不上。在源站本机直接验证:
curl -v http://localhost:8080ss -tlnp | grep 8080本机 curl 不通就先修应用本身,别在隧道上瞎折腾。
ingress 不匹配:域名进了错的服务或吃 404
先跑 cloudflared tunnel ingress validate 排除语法与兜底缺失,再用 cloudflared tunnel ingress rule <出问题的URL> 看实际命中哪条。常见原因:规则顺序写反(通用规则把细分规则挡在前面)、主机名拼写和 DNS 绑定的不一致、改的是家目录配置而服务跑的是 /etc/cloudflared/ 那份。
服务正常但域名打不开/解析不生效
按链路顺序查:控制台 DNS 里确认 CNAME 存在且指向 <隧道ID>.cfargotunnel.com;dig app.example.com 看解析结果是否为 Cloudflare 的地址段;刚绑定的记录等一两分钟再试,别在生效窗口里反复改配置。如果这个子域名之前有其他记录,先确认旧记录已删除——同名记录冲突时 route dns 会失败,页面上也会互相打架。
改完配置重启不生效
十有八九是改错了文件:服务化之后生效的是 /etc/cloudflared/config.yml。把新配置同步过去再 systemctl restart cloudflared,并用 journalctl -u cloudflared 看重启后的连接注册日志确认。
小结
- 传统反代发布的暴露面在源站 IP:IP 一泄露,边缘防护可被整体绕过;Tunnel 用”源站主动外连”的架构把这个面从根上消掉。
- cloudflared 维持 4 条长连接,DNS 里只有指向 cfargotunnel.com 的 CNAME,源站零入站端口、IP 不公开。
- 本地配置型的完整链路是:
tunnel login授权 →tunnel create拿凭据 → 写config.yml的 ingress →tunnel route dns绑域名 → 前台试跑 →service install交给 systemd。 - ingress 从上往下匹配,最后一条必须是无条件兜底规则;多服务靠多主机名规则加多条 DNS 绑定扩展。
- 服务化后真正生效的配置在
/etc/cloudflared/,改配置别改错地方。 - 选型上:无公网 IP、怕源站被直打,用 Tunnel;链路越短越好的公网服务,Nginx 反代依然是正解,两者也可以叠用。
- 凭据 JSON 和 cert.pem 是整套体系的钥匙,按私钥级别保管。