Cloudflare Tunnel
自建 Cloudflare Tunnel 完整指南
Cloudflare Tunnel(原名 Argo Tunnel):无需公网IP、不用端口映射、不用在路由器开端口,本地
cloudflared主动向外建立加密出站隧道连到 Cloudflare 边缘,把内网服务安全发布到公网,免费可用,自动HTTPS。 两种方案:仪表盘托管隧道(新手推荐,token方式)、本地托管隧道(config.yml,适合多域名、复杂Ingress路由)
前置条件
注册 Cloudflare 账号,把你的域名 NS 托管到 Cloudflare
一台内网设备(Linux/Windows/macOS/群晖/软路由)运行
cloudflared,能正常访问外网(UDP优先,QUIC协议)域名已经在 Cloudflare DNS 面板识别正常
⚠️ 区分:Quick Tunnel(临时随机域名,不用域名) vs 命名隧道(绑定自己域名,长期使用)
一、安装 cloudflared
Ubuntu / Debian(官方源)
sudo mkdir -p --mode=0755 /usr/share/keyrings
curl -fsSL [https://pkg.cloudflare.com/cloudflare-main.gpg](https://pkg.cloudflare.com/cloudflare-main.gpg) | sudo tee /usr/share/keyrings/cloudflare-main.gpg >/dev/null
echo 'deb [signed-by=/usr/share/keyrings/cloudflare-main.gpg] [https://pkg.cloudflare.com/cloudflared](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
RHEL / CentOS
curl -fsSL [https://pkg.cloudflare.com/cloudflare-main.gpg](https://pkg.cloudflare.com/cloudflare-main.gpg) | sudo tee /etc/pki/rpm-gpg/RPM-GPG-KEY-cloudflare
echo '[cloudflare]
name=Cloudflare
baseurl=[https://pkg.cloudflare.com/cloudflared/rpm/x86_64/](https://pkg.cloudflare.com/cloudflared/rpm/x86_64/)
enabled=1
gpgcheck=1' | sudo tee /etc/yum.repos.d/cloudflare.repo
sudo dnf install cloudflared
macOS(Homebrew)
brew install cloudflared
Windows
- 下载:github.com/cloudflare/cloudflared/...
- 解压
cloudflared.exe,放到固定目录,管理员CMD运行
Docker(推荐容器部署,隔离环境)
镜像:cloudflare/cloudflared:latest
二、方案A:仪表盘托管隧道(新手首选,Token模式,简单稳定)
步骤1:在Zero Trust面板创建隧道
进入 Cloudflare Zero Trust:one.cloudflare.com/
左侧菜单:Networks → Tunnels → Create a tunnel
连接器类型:
Cloudflared,填写隧道名称(例如homelab),创建选择你的系统,页面会生成一条带
TUNNEL_TOKEN的安装命令,复制保存这个Token这个Token就是认证凭据,不需要本地cert证书文件
步骤2:在服务器安装服务、启动隧道
Linux:
sudo cloudflared service install 【你的TUNNEL_TOKEN】
sudo systemctl enable cloudflared
sudo systemctl start cloudflared
# 查看状态
sudo systemctl status cloudflared
# 查看日志
journalctl -u cloudflared -f
Docker Compose 版本(token模式)
version: '3.8'
services:
cloudflared:
image: cloudflare/cloudflared:latest
container_name: cloudflared
restart: unless-stopped
command: tunnel --no-autoupdate run --token ${TUNNEL_TOKEN}
environment:
- TUNNEL_TOKEN=在这里粘贴你的token
network_mode: host
network_mode:host 可以直接访问宿主机内网其他机器服务;如果是桥接模式,只能访问同docker网络内服务
步骤3:添加Public Hostname(域名路由,核心)
隧道状态变为 Healthy 后:
- 隧道详情页 → Public Hostnames → Add a public hostname
- 填写:
- Hostname:
shturl.cc/bGujfR5wF - Service:
[http://127.0.0.1:3000](http://127.0.0.1:3000)(指向你的内网服务,支持 http / https / tcp) - TLS 高级选项:如果后端是自签证书,打开 No TLS Verify
- Hostname:
- 保存,Cloudflare自动生成CNAME解析记录,不需要手动去DNS面板添加记录
支持多个子域名,每个子域名可以指向不同内网服务:
shturl.cc/G26PBfQ6→[http://192.168.1.100:5000](http://192.168.1.100:5000)shturl.cc/D7JywFND7A→[http://192.168.1.200:3000](http://192.168.1.200:3000)
步骤4:Zero Trust访问控制(可选,非常重要)
如果你不想服务公开所有人访问:
Zero Trust → Access → Applications → Add an application
选
Self-hosted,填入刚才的域名,配置访问策略:邮箱白名单、GitHub/Google登录、一次性PIN码等
没有通过Access认证的人无法打开页面
Access免费版足够家庭使用
三、方案B:本地托管隧道(config.yml 模式,适合复杂Ingress路由)
适合场景:一条隧道承载大量域名、按hostname分流后端服务,所有路由写在本地yml,用命令管理,不依赖仪表盘逐个添加Hostname
1. 登录认证(只做一次,生成cert.pem)
cloudflared tunnel login
会弹出链接,浏览器登录Cloudflare并选择域名,自动在 ~/.cloudflared/cert.pem 生成证书(用于操作DNS、创建隧道)
2. 创建隧道
cloudflared tunnel create homelab
执行后:
- 输出隧道UUID
- 在
~/.cloudflared/UUID.json生成凭证文件
3. 创建 config.yml
mkdir -p ~/.cloudflared
nano ~/.cloudflared/config.yml
示例配置:
tunnel: homelab
credentials-file: /root/.cloudflared/这里替换成你的UUID.json
# 入口路由 Ingress(从上往下匹配,最后一条必须是404兜底)
ingress:
- hostname: shturl.cc/bGujfR5wF
service: [http://127.0.0.1:3000](http://127.0.0.1:3000)
- hostname: shturl.cc/G26PBfQ6
service: [http://192.168.1.100:5000](http://192.168.1.100:5000)
- hostname: shturl.cc/e2mFsLF3
service: [http://192.168.1.150:3000](http://192.168.1.150:3000)
originRequest:
noTLSVerify: true # 后端HTTPS自签证书时开启
- service: http_status:404
# 日志、指标(可选)
logfile: /var/log/cloudflared.log
metrics: 0.0.0.0:9000
校验配置文件是否合法:
cloudflared tunnel --config ~/.cloudflared/config.yml ingress validate
4. DNS路由绑定(命令行自动创建CNAME)
cloudflared tunnel route dns homelab shturl.cc/bGujfR5wF
cloudflared tunnel route dns homelab shturl.cc/G26PBfQ6
cloudflared tunnel route dns homelab shturl.cc/e2mFsLF3
等价于仪表盘添加Public Hostname,自动在Cloudflare DNS添加CNAME记录,指向
UUID.cfargotunnel.com
5. 启动隧道
cloudflared tunnel --config ~/.cloudflared/config.yml run homelab
看到 Connection registered 代表隧道连通成功。
6. 设置systemd开机自启(本地托管模式)
sudo tee /etc/systemd/system/cloudflared.service > /dev/null <<'EOF'
[Unit]
Description=Cloudflare Tunnel
After=network-online.target
Wants=network-online.target
[Service]
User=root
ExecStart=/usr/local/bin/cloudflared tunnel --config /root/.cloudflared/config.yml run homelab
Restart=always
RestartSec=10
NoNewPrivileges=true
[Install]
WantedBy=multi-user.target
EOF
sudo systemctl daemon-reload
sudo systemctl enable cloudflared
sudo systemctl start cloudflared
常用本地隧道命令汇总
# 隧道列表
cloudflared tunnel list
# 隧道详情
cloudflared tunnel info homelab
# 删除隧道
cloudflared tunnel delete homelab
# 删除DNS路由
cloudflared tunnel route dns delete homelab shturl.cc/bGujfR5wF
# 查看路由
cloudflared tunnel route dns list
四、快速临时隧道 Quick Tunnel(测试用,不需要域名)
一条命令,直接生成随机 trycloudflare.com HTTPS地址,适合临时分享本地开发服务:
cloudflared tunnel --url [http://localhost:8080](http://localhost:8080)
缺点:域名每次重启都会变,不适合长期使用
五、内网全网段路由(替代VPN,WARP客户端接入)
如果你想让装了WARP客户端的设备访问整个局域网(而不只是单个web服务):
- 创建CIDR路由:
cloudflared tunnel route ip add 192.168.1.0/24 homelab
Zero Trust → Settings → Gateway → Enable Proxy(TCP/UDP/ICMP)
手机/电脑安装 WARP,登录你的Zero Trust组织,即可直接访问内网IP(192.168.1.x)
⚠️ 安全风险:不要随便开放整个内网,建议配合Gateway防火墙策略做白名单
六、常见坑与排错
- 502 Bad Gateway
- 先确认运行cloudflared的机器可以正常curl访问后端服务地址
- 后端是HTTPS自签证书:开启
noTLSVerify: true
- 1033 Error:隧道离线,Tunne状态不是Healthy,检查网络、token、防火墙出站UDP
- 域名打不开,DNS不生效:等待DNS缓存,或者在Cloudflare面板看CNAME记录是否生成;本地托管模式必须执行
route dns - cloudflared频繁断连:优先放行UDP,QUIC比TCP稳定;部分运营商QoS会干扰长连接;添加
--no-autoupdate关闭自动升级避免意外重启 - 容器内访问其他内网设备:docker不要用默认bridge,改用
network_mode:host - Access页面循环跳转/登录失败:检查域名的SSL/TLS模式为「Full」或者「Flexible」,不要Strict(后端无证书时)
七、安全最佳实践
- 优先搭配 Cloudflare Access,不要直接裸奔公开内网管理面板(NAS、路由器后台)
- 不要用Quick Tunnel暴露敏感服务
- 定期轮换Tunnel Token;不要泄露UUID.json、cert.pem
- 尽量不要开放全内网CIDR路由,按需只发布单个应用
- 开启Cloudflare WAF、速率限制,防护暴力访问
- 后端服务尽量监听127.0.0.1,不要监听0.0.0.0,减少内网横向风险
八、协议支持
- HTTP/HTTPS:网页、管理面板(最常用)
- TCP:SSH、RDP、数据库(客户端需要
cloudflared access tcp或者WARP) - 不支持UDP原生穿透(除了Gateway WARP模式)
本作品采用《CC 协议》,转载必须注明作者和本文链接
关于 LearnKu