Cloudflare Tunnel

AI摘要
【知识分享】本文是一份Cloudflare Tunnel自建教程,涵盖安装cloudflared、仪表盘Token托管与本地config.yml两种隧道方案、Public Hostname路由配置、Zero Trust访问控制、systemd自启、Quick Tunnel临时隧道、内网CIDR路由及常见排错与安全实践,面向无公网IP用户发布内网服务。

自建 Cloudflare Tunnel 完整指南

Cloudflare Tunnel(原名 Argo Tunnel):无需公网IP、不用端口映射、不用在路由器开端口,本地 cloudflared 主动向外建立加密出站隧道连到 Cloudflare 边缘,把内网服务安全发布到公网,免费可用,自动HTTPS。 两种方案:仪表盘托管隧道(新手推荐,token方式)、本地托管隧道(config.yml,适合多域名、复杂Ingress路由)

前置条件

  1. 注册 Cloudflare 账号,把你的域名 NS 托管到 Cloudflare

  2. 一台内网设备(Linux/Windows/macOS/群晖/软路由)运行 cloudflared,能正常访问外网(UDP优先,QUIC协议)

  3. 域名已经在 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

  1. 下载:github.com/cloudflare/cloudflared/...
  2. 解压 cloudflared.exe,放到固定目录,管理员CMD运行

Docker(推荐容器部署,隔离环境)

镜像:cloudflare/cloudflared:latest

二、方案A:仪表盘托管隧道(新手首选,Token模式,简单稳定)

步骤1:在Zero Trust面板创建隧道

  1. 进入 Cloudflare Zero Trust:one.cloudflare.com/

  2. 左侧菜单:Networks → Tunnels → Create a tunnel

  3. 连接器类型:Cloudflared,填写隧道名称(例如 homelab),创建

  4. 选择你的系统,页面会生成一条带 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 后:

  1. 隧道详情页 → Public Hostnames → Add a public hostname
  2. 填写:
    • Hostname:shturl.cc/bGujfR5wF
    • Service:[http://127.0.0.1:3000](http://127.0.0.1:3000)(指向你的内网服务,支持 http / https / tcp)
    • TLS 高级选项:如果后端是自签证书,打开 No TLS Verify
  3. 保存,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访问控制(可选,非常重要)

如果你不想服务公开所有人访问:

  1. Zero Trust → Access → Applications → Add an application

  2. 选 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服务):

  1. 创建CIDR路由:
cloudflared tunnel route ip add 192.168.1.0/24 homelab
  1. Zero Trust → Settings → Gateway → Enable Proxy(TCP/UDP/ICMP)

  2. 手机/电脑安装 WARP,登录你的Zero Trust组织,即可直接访问内网IP(192.168.1.x)

    ⚠️ 安全风险:不要随便开放整个内网,建议配合Gateway防火墙策略做白名单

六、常见坑与排错

  1. 502 Bad Gateway
    • 先确认运行cloudflared的机器可以正常curl访问后端服务地址
    • 后端是HTTPS自签证书:开启 noTLSVerify: true
  2. 1033 Error:隧道离线,Tunne状态不是Healthy,检查网络、token、防火墙出站UDP
  3. 域名打不开,DNS不生效:等待DNS缓存,或者在Cloudflare面板看CNAME记录是否生成;本地托管模式必须执行 route dns
  4. cloudflared频繁断连:优先放行UDP,QUIC比TCP稳定;部分运营商QoS会干扰长连接;添加 --no-autoupdate 关闭自动升级避免意外重启
  5. 容器内访问其他内网设备:docker不要用默认bridge,改用 network_mode:host
  6. Access页面循环跳转/登录失败:检查域名的SSL/TLS模式为「Full」或者「Flexible」,不要Strict(后端无证书时)

七、安全最佳实践

  1. 优先搭配 Cloudflare Access,不要直接裸奔公开内网管理面板(NAS、路由器后台)
  2. 不要用Quick Tunnel暴露敏感服务
  3. 定期轮换Tunnel Token;不要泄露UUID.json、cert.pem
  4. 尽量不要开放全内网CIDR路由,按需只发布单个应用
  5. 开启Cloudflare WAF、速率限制,防护暴力访问
  6. 后端服务尽量监听127.0.0.1,不要监听0.0.0.0,减少内网横向风险

八、协议支持

  • HTTP/HTTPS:网页、管理面板(最常用)
  • TCP:SSH、RDP、数据库(客户端需要 cloudflared access tcp 或者WARP)
  • 不支持UDP原生穿透(除了Gateway WARP模式)
本作品采用《CC 协议》,转载必须注明作者和本文链接
六月的风
Junwind
讨论数量: 0
(= ̄ω ̄=)··· 暂无内容!

讨论应以学习和精进为目的。请勿发布不友善或者负能量的内容,与人为善,比聪明更重要!
躺平大叔 @ 躺平社区
文章
349
粉丝
22
喜欢
116
收藏
64
排名:235
访问:4.0 万
私信
所有博文
社区赞助商