使用 Cloudflare Tunnel 发布服务
借助 Cloudflare Tunnel 在 Debian 或 Ubuntu 上发布应用而无需开放入站端口,使用 Cloudflare Access 保护管理界面,并完成更新与备份。
本页内容
您的参数
只需填写一次,指南中的命令会自动更新。
本指南介绍如何在不开放入站端口的情况下发布服务器上的应用。程序 cloudflared 会向 Cloudflare 建立一条出站连接。访客访问 https://app.您的域名.com,由 Cloudflare 处理证书,并通过该隧道转发请求。
完成本指南后,应用仍只在本地监听,隧道会随服务器启动,您也将掌握如何让敏感界面仅对经过身份识别的人员开放。
订购服务器
本指南适用于由您自行管理的服务器:
前提条件
- 运行 Debian 12 或 13,或 Ubuntu 22.04 或 24.04 的服务器
- 使用具有
sudo权限的用户进行 SSH 访问 - 一个 Cloudflare 账户
- 该账户下一个处于活动状态的域名
- 一个在本地监听的应用,例如监听
127.0.0.1:3000
将域名添加到 Cloudflare
如果该域名尚未接入 Cloudflare:
- 在控制面板中添加它,然后选择一个套餐。
- 检查导入的 DNS 记录。请特别检查 MX 记录以及邮件相关记录,因为自动扫描可能会遗漏它们。
- 如果已启用 DNSSEC,请在您的域名注册商处将其禁用。
- 将域名的名称服务器替换为 Cloudflare 提供的名称服务器。对于在 HostMyServers 管理的域名,请参阅指南 DNS 服务器。
使用的端口
| 端口 | 方向 | 作用 | 操作 |
|---|---|---|---|
| 7844/tcp 和 7844/udp | 出站 | 隧道到 Cloudflare 的连接 | 如果出站流量被过滤,需要放行 |
| 443/tcp | 出站 | 附加功能,例如检查更新 | 可选 |
| 3000/tcp | 本地 | 示例应用 | 不要开放 |
| 无 | 入站 | 隧道不需要任何入站端口 | 无需开放任何端口 |
步骤 1:检查应用
应用必须在本地回环地址上响应:
curl -I http://127.0.0.1:3000
sudo ss -ltnp | grep 3000监听地址必须是 127.0.0.1。如果应用运行在 Docker 中,请以 127.0.0.1:3000:3000 的形式发布其端口。以 3000:3000 发布的端口仍可从互联网访问,因为 Docker 会插入自己的防火墙规则。
步骤 2:安装 cloudflared
添加 Cloudflare 的官方软件源,然后安装软件包:
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
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-get update
sudo apt-get install -y cloudflared
cloudflared --version步骤 3:创建隧道
对 cloudflared 进行认证。该命令会显示一个 URL,请在浏览器中打开并选择您的域名:
sudo cloudflared tunnel login账户证书会保存在 /root/.cloudflared/cert.pem 中。然后创建隧道:
sudo cloudflared tunnel create hms-tunnel
sudo cloudflared tunnel list记下显示的标识符,此处称为 TUNNEL_UUID。将其凭据文件复制到服务所使用的文件夹中:
sudo install -d -m 700 /etc/cloudflared
sudo install -m 600 /root/.cloudflared/TUNNEL_UUID.json /etc/cloudflared/TUNNEL_UUID.json步骤 4:配置隧道
sudo nano /etc/cloudflared/config.ymltunnel: TUNNEL_UUID
credentials-file: /etc/cloudflared/TUNNEL_UUID.json
ingress:
- hostname: app.您的域名.com
service: http://127.0.0.1:3000
- service: http_status:404规则按顺序读取。最后一条没有主机名,但必不可少:对于不匹配任何服务的请求,它会返回 404。
检查该文件以及某个 URL 的路由:
sudo cloudflared tunnel --config /etc/cloudflared/config.yml ingress validate
sudo cloudflared tunnel --config /etc/cloudflared/config.yml ingress rule https://app.您的域名.com步骤 5:保护管理界面
只有当服务面向公众并且自带身份认证时,才可以跳过此步骤。对于管理界面,请在发布域名之前先创建保护:没有 Access 应用时,该地址对整个互联网开放。
在 Cloudflare 控制面板中:
- 进入 Zero Trust > Access controls > Applications。
- 选择 Create new application,然后选择 Self-hosted and private。
- 选择 Add public hostname,并填写
app.您的域名.com。 - 在 Access policies 下,创建一条策略,操作选择 Allow,并添加一条类型为 Emails 的 Include 规则,填入您的邮箱地址。
- 选择登录方式。如果您希望通过电子邮件接收验证码,请在 Zero Trust > Integrations > Identity providers 中添加 One-time PIN。
- 选择 Create。
界面文字可能会有变化:如有出入,请参阅 Cloudflare Access 文档。
您还可以让 cloudflared 验证 Access 令牌。标签 Application Audience (AUD) Tag 位于应用的 Additional settings 中。请在 config.yml 中补充相应的规则:
ingress:
- hostname: app.您的域名.com
service: http://127.0.0.1:3000
originRequest:
access:
required: true
teamName: TEAM_NAME
audTag:
- AUD_TAG
- service: http_status:404TEAM_NAME 是您的 Cloudflare One 团队名称,即 .cloudflareaccess.com 之前的部分。然后重新执行步骤 4 中的验证。
步骤 6:发布域名
创建指向隧道的 DNS 记录:
sudo cloudflared tunnel route dns hms-tunnel app.您的域名.com如果您管理多个域名,请在控制面板中确认 CNAME 记录已创建在正确的区域中。它必须指向 TUNNEL_UUID.cfargotunnel.com。
步骤 7:将隧道作为服务运行
sudo cloudflared service install
systemctl status cloudflared --no-pager该命令会创建服务 cloudflared,将其设为开机启动,并使用 /etc/cloudflared/config.yml 运行它。
验证结果
sudo journalctl -u cloudflared --no-pager -n 50 | grep 'Registered tunnel connection'
sudo cloudflared tunnel info hms-tunnel
curl -I https://app.您的域名.com日志中应显示已注册的连接,并且该 URL 应有响应。如果您创建了 Access 应用,请在隐私浏览窗口中打开该地址:应先显示登录页面,然后才是应用。
在您的电脑上,直接访问应当失败:
curl -m 5 -I http://您的服务器IP:3000关闭不再需要的访问
如果应用此前发布在 Web 端口上,而现在已没有任何内容使用这些端口,请删除对应的 UFW 规则:
sudo ufw status numbered
sudo ufw delete allow 80/tcp
sudo ufw delete allow 443/tcp隧道在入站策略关闭的情况下也能工作。请务必保留您的 SSH 规则,除非您通过 Tailscale 之类的私有网络访问。
文件 cert.pem 可以管理账户下的所有隧道,而服务只需要隧道的凭据文件。如果您不在这台服务器上管理隧道,请删除它:
sudo shred -u /root/.cloudflared/cert.pem执行任何管理命令之前(例如 tunnel route dns 或 tunnel info),都需要重新运行 sudo cloudflared tunnel login。删除该文件并不会吊销其中包含的令牌:若要吊销,请在 My Profile > API Tokens 中删除令牌 Cloudflare Tunnel API Token 或 Argo Tunnel API Token。
发布另一个服务
在最后一条规则之前添加一条规则:
ingress:
- hostname: app.您的域名.com
service: http://127.0.0.1:3000
- hostname: docs.您的域名.com
service: http://127.0.0.1:8080
- service: http_status:404验证、创建 DNS 名称,然后重启服务:
sudo cloudflared tunnel --config /etc/cloudflared/config.yml ingress validate
sudo cloudflared tunnel route dns hms-tunnel docs.您的域名.com
sudo systemctl restart cloudflared如果已删除 cert.pem,您也可以在 Cloudflare 的 DNS 中创建一条指向 TUNNEL_UUID.cfargotunnel.com 的 CNAME 记录。
变体:通过控制面板管理隧道
Cloudflare 还允许远程管理隧道,无需 config.yml:
- 进入 Networking > Tunnels,然后选择 Create a tunnel。
- 为隧道命名,选择您的系统,并在服务器上执行页面给出的命令。该命令包含一个机密令牌。
- 在 Routes 选项卡中,选择 Add route,然后选择 Published application。
- 填写子域名、域名和服务的 URL,例如
http://127.0.0.1:3000。
一台机器只能运行一个 cloudflared 服务。请将您的应用添加到现有隧道中,而不是再安装第二个。
需要了解的限制
- 应用看到的请求都来自
cloudflared。访客的真实地址位于请求头CF-Connecting-IP中。 - 请求大小取决于您的 Cloudflare 套餐:Free 和 Pro 套餐为 100 MB。
- 在 Free、Pro 和 Business 套餐上,Cloudflare 的条款对视频和大文件的分发有所限制。
- 多级子域名(例如
a.b.您的域名.com)需要高级证书。 - 本指南涵盖 Web 应用。SSH 或其他 TCP 协议还需要在客户端进行配置。
更新
通过软件包安装的 cloudflared 使用 APT 更新,之后必须重启服务。正在进行的流量会被短暂中断:
sudo apt-get update
sudo apt-get install --only-upgrade -y cloudflared
sudo systemctl restart cloudflared
cloudflared --version备份与恢复
文件夹 /etc/cloudflared 包含配置和隧道的凭据文件:
sudo tar -czf /root/cloudflared-$(date +%F).tar.gz -C /etc cloudflared
sudo chmod 600 /root/cloudflared-$(date +%F).tar.gz该凭据文件不会过期,并且可用于运行隧道:请将归档加密后保存在服务器之外。
要在已安装 cloudflared 的服务器上恢复,请将 YYYY-MM-DD 替换为归档的日期:
sudo tar -xzf /root/cloudflared-YYYY-MM-DD.tar.gz -C /etc
sudo cloudflared service install如果您不希望两台服务器同时接收流量,请先在旧服务器上停止隧道。
故障排除
错误 1033
Cloudflare 找不到该隧道的任何活动实例。请检查服务及其日志:
systemctl status cloudflared --no-pager
sudo journalctl -u cloudflared --no-pager -n 100如果服务在运行,请确认 CNAME 指向正确的 TUNNEL_UUID.cfargotunnel.com。
502 错误与 Unable to reach the origin service
隧道已连接,但 cloudflared 无法连接到应用。请检查应用是否在运行,然后将其端口和协议与 service 行进行比对:
curl -I http://127.0.0.1:3000ERR_TOO_MANY_REDIRECTS
应用将 HTTP 重定向到 HTTPS,而规则使用的是 http://。请在应用中禁用这一重定向,或在 service 中使用 https:// 并配合有效证书。
x509: certificate signed by unknown authority 或 certificate is valid for
对于使用 HTTPS 的应用,cloudflared 无法识别其证书。请在 originRequest 中用 caPool 指定证书颁发机构,或用 originServerName 指定期望的名称。仅在诊断期间才使用 noTLSVerify。
remote error: tls: handshake failure
公开域名没有被任何证书覆盖,通常是因为它是多级子域名。请只使用一级子域名,或订购高级证书。
Tunnel credentials file ... doesn't exist or is not a file
credentials-file 的路径不正确。请确认它与 /etc/cloudflared 中实际存在的文件一致:
sudo ls -l /etc/cloudflaredAn A, AAAA, or CNAME record with that host already exists
该名称已在您的 DNS 区域中被使用。请在确认旧记录不再需要后,在 Cloudflare 中删除它,或选择其他名称。若要有意替换该记录:
sudo cloudflared tunnel route dns --overwrite-dns hms-tunnel app.您的域名.comcloudflared service is already installed
这台机器上已存在一个服务。请将您的应用添加到现有隧道中,或先卸载该服务再重新开始:
sudo cloudflared service uninstallpossible conflicting configuration
存在两个配置文件,通常是 /root/.cloudflared/config.yml 和 /etc/cloudflared/config.yml。请保留 /etc/cloudflared 中的那个,然后显式指定它:
sudo cloudflared --config /etc/cloudflared/config.yml service install隧道无法连接
cloudflared 使用基于 UDP 的 QUIC,如果 UDP 无法通过,则回退到基于 TCP 的 HTTP/2。因此出站端口 7844 必须开放。请在服务器上测试:
sudo apt-get install -y netcat-openbsd
nc -vz -w 3 region1.v2.argotunnel.com 7844
nc -uvz -w 3 region1.v2.argotunnel.com 7844即使数据包被过滤,UDP 测试也可能成功:TCP 测试更能说明问题。如果您的本地规则正确而该端口仍被阻止,请通过客户中心联系支持团队。
failed to sufficiently increase receive buffer size
此消息与 QUIC 的 UDP 缓冲区有关。它通常没有影响,无需任何操作。