中文

应用程序

使用 Cloudflare Tunnel 发布服务

借助 Cloudflare Tunnel 在 Debian 或 Ubuntu 上发布应用而无需开放入站端口,使用 Cloudflare Access 保护管理界面,并完成更新与备份。

阅读约 9 分钟, 更新于 2026年11月18日

本页内容

您的参数

只需填写一次,指南中的命令会自动更新。

本指南介绍如何在不开放入站端口的情况下发布服务器上的应用。程序 cloudflared 会向 Cloudflare 建立一条出站连接。访客访问 https://app.您的域名.com,由 Cloudflare 处理证书,并通过该隧道转发请求。

完成本指南后,应用仍只在本地监听,隧道会随服务器启动,您也将掌握如何让敏感界面仅对经过身份识别的人员开放。

订购服务器

本指南适用于由您自行管理的服务器:

前提条件

  • 运行 Debian 12 或 13,或 Ubuntu 22.04 或 24.04 的服务器
  • 使用具有 sudo 权限的用户进行 SSH 访问
  • 一个 Cloudflare 账户
  • 该账户下一个处于活动状态的域名
  • 一个在本地监听的应用,例如监听 127.0.0.1:3000

将域名添加到 Cloudflare

如果该域名尚未接入 Cloudflare:

  1. 在控制面板中添加它,然后选择一个套餐。
  2. 检查导入的 DNS 记录。请特别检查 MX 记录以及邮件相关记录,因为自动扫描可能会遗漏它们。
  3. 如果已启用 DNSSEC,请在您的域名注册商处将其禁用。
  4. 将域名的名称服务器替换为 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.yml
YAML
tunnel: 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 控制面板中:

  1. 进入 Zero Trust > Access controls > Applications。
  2. 选择 Create new application,然后选择 Self-hosted and private。
  3. 选择 Add public hostname,并填写 app.您的域名.com。
  4. 在 Access policies 下,创建一条策略,操作选择 Allow,并添加一条类型为 Emails 的 Include 规则,填入您的邮箱地址。
  5. 选择登录方式。如果您希望通过电子邮件接收验证码,请在 Zero Trust > Integrations > Identity providers 中添加 One-time PIN。
  6. 选择 Create。

界面文字可能会有变化:如有出入,请参阅 Cloudflare Access 文档。

您还可以让 cloudflared 验证 Access 令牌。标签 Application Audience (AUD) Tag 位于应用的 Additional settings 中。请在 config.yml 中补充相应的规则:

YAML
ingress:
  - hostname: app.您的域名.com
    service: http://127.0.0.1:3000
    originRequest:
      access:
        required: true
        teamName: TEAM_NAME
        audTag:
          - AUD_TAG
  - service: http_status:404

TEAM_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。

发布另一个服务

在最后一条规则之前添加一条规则:

YAML
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:

  1. 进入 Networking > Tunnels,然后选择 Create a tunnel。
  2. 为隧道命名,选择您的系统,并在服务器上执行页面给出的命令。该命令包含一个机密令牌。
  3. 在 Routes 选项卡中,选择 Add route,然后选择 Published application。
  4. 填写子域名、域名和服务的 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:3000

ERR_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/cloudflared

An A, AAAA, or CNAME record with that host already exists

该名称已在您的 DNS 区域中被使用。请在确认旧记录不再需要后,在 Cloudflare 中删除它,或选择其他名称。若要有意替换该记录:

终端
sudo cloudflared tunnel route dns --overwrite-dns hms-tunnel app.您的域名.com

cloudflared service is already installed

这台机器上已存在一个服务。请将您的应用添加到现有隧道中,或先卸载该服务再重新开始:

终端
sudo cloudflared service uninstall

possible 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 缓冲区有关。它通常没有影响,无需任何操作。

参考资料