4980 字
25 分钟
Cloudflare Tunnel:不暴露源站发布服务

把一个跑在自己服务器(甚至家里机器)上的 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 指向源站 IPCNAME 指向 cfargotunnel.com
源站 IP 泄露风险有(历史记录等渠道)无公开记录可查
源站要求有公网 IP只要能出站上网
源站组件Web 服务器/反代即可额外常驻 cloudflared
回源加密取决于 SSL 模式配置隧道连接本身加密,无需另配
WARNING

Tunnel 不是”套了 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。依次执行:

Terminal window
# 添加官方仓库的签名密钥
sudo mkdir -p --mode=0755 /usr/share/keyrings
curl -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 update
sudo apt install cloudflared
# 确认版本
cloudflared --version

能输出形如 cloudflared version 2025.x.x (built ...) 的版本号即安装成功。不想加仓库也可以去官方发布渠道下载对应架构的 .deb 包用 dpkg -i 安装,两种方式装的是同一个程序;但仓库方式后续 apt upgrade 能一起升级,长期运维更省事。包名、仓库地址这类细节若与你看到的不一致,以官方文档为准。

WARNING

cloudflared 只能从 Cloudflare 官方渠道下载。不要从来路不明的镜像站或网盘下载 cloudflared 二进制——它手里握着你的隧道凭据,又是常驻进程,被人动过手脚等于把源站大门钥匙送出去。

全流程实战:建第一条隧道#

假设我们要发布的服务是源站本机 8080 端口上的一个应用,域名用 app.example.com(请换成你自己的、已托管在 Cloudflare 的域名)。整个流程五步。

第一步:登录授权#

Terminal window
cloudflared tunnel login

这条命令会给出一个授权链接(在终端里能直接打开的话会自动拉起浏览器;纯 SSH 环境就把链接复制到本地浏览器打开)。登录你的 Cloudflare 账号后,选择要授权的域名,确认后浏览器会把证书下载回来,命令执行完毕会在 ~/.cloudflared/ 目录下生成 cert.pem。验证一下:

Terminal window
ls -l ~/.cloudflared/

能看到 cert.pem 就说明授权完成。这个证书是你的账号级凭据,用它可以创建和管理该账号下的隧道,同样按私钥对待。

无头服务器上浏览器不在同一台机器完全没问题:链接在哪台设备上打开都行,授权结果会通过回调落回执行命令的这台机器。如果命令长时间等不到授权结果,多半是网络到 Cloudflare 的出站不通,先排查出站连通性而不是反复重试。

第二步:创建隧道#

Terminal window
cloudflared tunnel create my-tunnel

my-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)。凭据文件是这条隧道独一份的钥匙,下一步写配置要用。随时可以用下面的命令查看已有隧道:

Terminal window
cloudflared tunnel list

第三步:写配置文件#

在 ~/.cloudflared/config.yml 写入:

tunnel: 3f8a1c2e-xxxx-xxxx-xxxx-xxxxxxxxxxxx
credentials-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 的情况在”适用边界”一节说明。

第四步:绑定域名#

Terminal window
cloudflared tunnel route dns my-tunnel app.example.com

这条命令会在 example.com 的 DNS 里自动建一条 CNAME 记录:app 指向 <隧道ID>.cfargotunnel.com 并开启代理。这一步也可以手动去控制台 DNS 页面加同样的 CNAME,效果一致。注意:如果这个子域名已经有 A 记录或其他记录占着,命令会报错,先删掉旧记录再执行;绑完去控制台确认记录存在、CNAME 目标正确。

第五步:前台试跑验证#

先别急着装服务,前台跑一遍看日志最稳妥:

Terminal window
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-xxxxxxxxxxxx
credentials-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

要点有三条:

  1. 顺序即优先级:请求从上往下匹配,第一条命中就走,不再往下看。带 path 限定的规则(如只匹配某个路径前缀)要放在同主机名的通用规则前面。
  2. 兜底规则必须存在:ingress 列表最后一条必须是没有任何匹配条件的收尾规则(通常写 http_status:404),缺了它配置校验直接不过,隧道起不来。
  3. 每个子域名都要单独绑 DNS:新增一个主机名,就多执行一次 cloudflared tunnel route dns my-tunnel blog.example.com,或者在控制台手动加指向同一个 <隧道ID>.cfargotunnel.com 的 CNAME。

改完配置先校验再重启,别拿线上流量试错:

Terminal window
# 校验 ingress 配置语法与规则完整性
cloudflared tunnel ingress validate
# 测试某个 URL 实际会命中哪条规则
cloudflared tunnel ingress rule https://blog.example.com/

第二条命令会告诉你这个 URL 命中的是第几条规则、转发到哪个 service,排查”为什么这个域名进错了服务”时非常好用。

装成系统服务#

试跑通过后,把它交给 systemd 常驻:

Terminal window
sudo cloudflared service install
sudo systemctl status cloudflared

service install 会把当前用户的隧道配置与凭据复制到系统位置(/etc/cloudflared/),生成 systemd 单元并设为开机自启。注意这意味着服务以 root 身份读取的是 /etc/cloudflared/config.yml 那份拷贝,之后你改 ~/.cloudflared/config.yml 不会同步过去——改配置后要同步更新系统目录下的那份,再 sudo systemctl restart cloudflared。这是本地配置型最容易踩的运维坑,记住”运行的那份在 /etc 里”。

日常运维命令:

Terminal window
# 查看运行状态与最近日志
sudo systemctl status cloudflared
sudo journalctl -u cloudflared -f
# 改完配置后重启
sudo systemctl restart cloudflared
# 确认隧道在线(在账号层面看连接状态)
cloudflared tunnel info my-tunnel

tunnel 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 没在运行:

Terminal window
sudo systemctl status cloudflared
sudo journalctl -u cloudflared -n 50
cloudflared tunnel info my-tunnel

进程不在就先拉起来;进程在但 info 显示无连接,查源站出站网络(到 Cloudflare 边缘的连接被防火墙出站规则或代理干扰最常见)。

502 Bad Gateway#

边缘或 cloudflared 返回 502,通常是隧道通了、但最后一米没通:本地服务没起、端口写错、或者服务只监听了某个网卡而 ingress 写的是 localhost 对不上。在源站本机直接验证:

Terminal window
curl -v http://localhost:8080
ss -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 是整套体系的钥匙,按私钥级别保管。
Cloudflare Tunnel:不暴露源站发布服务
https://www.anexns.cloudns.org/posts/cloudflare-tunnel/
作者
Anexns
发布于
2026-11-15
许可协议
CC BY-NC-SA 4.0