Linux服务器部署Cloudflare Tunnel前,如何检查服务权限与出口连通性

发布人:A5数据发布时间:2026-10-19 11:05阅读量:143

首次部署 Cloudflare Tunnel 前,先确认两件事:运行服务的 Linux 账户能够执行 cloudflared、读取配置和凭据文件;服务器能够完成 DNS 解析,并通过允许的出口路径访问 Cloudflare 所需端点。只检查管理员账户能否执行命令并不能代表 systemd 服务一定能正常启动。

本文适用于 Debian、Ubuntu、RHEL、Rocky Linux、AlmaLinux 等使用 systemd 的 Linux 服务器,重点放在首次运行前的权限与出口检查,不展开域名接入、DNS 记录和完整业务上线流程。示例中的隧道名称、UUID、域名和端口均为占位值,实际操作时应替换为现场配置。

A5数据提供香港、美国、日本、韩国、中国台湾、新加坡、马来西亚等地区的物理服务器租用,覆盖常规建站、业务后台、接口服务和数据库等Linux部署场景。各地区根据产品系列提供CN2、国际或优化线路,并配备SSD、NVMe、不同内存及多IP方案,为依赖DNS解析、HTTPS出口和持续外联的服务提供相应的计算、存储与网络资源基础。

一、准备条件与检查边界

1. 确认系统、架构和服务管理方式

先确认服务器发行版、架构以及是否由 systemd 管理服务:

cat /etc/os-release
uname -m
command -v systemctl
systemctl --version | head -n 1

预期结果包括:

  • 能看到发行版名称和版本,例如 Debian、Ubuntu、Rocky Linux 等。
  • uname -m 返回 x86_64、aarch64 等架构信息。
  • 能找到 /usr/bin/systemctl 或其他有效路径。

如果系统运行在精简容器中,可能没有 systemd。这类环境不能直接套用 systemd 服务安装方式,应改用容器编排平台或宿主机进程管理器,并重新确认配置文件、凭据文件和运行账户的映射关系。

2. 确认 cloudflared 是否已经安装

command -v cloudflared
cloudflared --version

如果已经安装,记录实际路径和版本:

CLOUDFLARED_BIN="$(command -v cloudflared)"
stat -c '%A %U:%G %n' "$CLOUDFLARED_BIN"

常见的合格结果类似:

-rwxr-xr-x root:root /usr/local/bin/cloudflared

二进制文件通常需要对服务账户具备执行权限,但不需要让普通账户拥有写权限。若文件归属于普通用户且可被其他账户写入,存在被替换的风险,应先通过组织认可的软件来源重新安装或调整文件归属。

安装包或二进制文件的具体获取方式会随发行版和软件版本变化。不要在未核验来源的情况下直接执行远程脚本;至少应确认文件来源、版本、架构,并在部署前记录校验值:

sha256sum "$CLOUDFLARED_BIN"

这里的校验值用于留档和变更比对,不应把示例值当作实际版本的固定值。

3. 记录现有配置并备份敏感文件

如果 /etc/cloudflared 已经存在,先备份,尤其是配置文件和 JSON 凭据文件。备份中可能包含隧道身份信息,应限制为 root 可读:

sudo tar -C /etc -czf "/root/cloudflared-backup-$(date +%Y%m%d%H%M%S).tgz" cloudflared
sudo chmod 0600 /root/cloudflared-backup-*.tgz

如果目录不存在,可以先建立目录,但不要急于把权限放宽:

sudo install -d -o root -g root -m 0750 /etc/cloudflared

chmod、chown 和目录权限调整会影响服务读取配置的能力。修改前应保留原始权限记录,后续出现问题时按备份和记录恢复,不要直接对整个 /etc 或 /etc/cloudflared 执行递归放权。

二、确认服务运行账户与文件权限

1. 找到实际的 systemd 服务名

Cloudflare Tunnel 服务名可能是 cloudflared.service,也可能是安装方式自定义的名称。先列出相关单元:

systemctl list-unit-files --type=service | grep -i cloudflared
systemctl list-units --type=service --all | grep -i cloudflared

如果尚未创建服务,先完成账户和配置文件检查,再按照所采用的安装方式生成服务单元。不要仅凭服务名猜测运行身份。

假设实际服务名为 cloudflared.service,查看它的运行账户、组和启动命令:

sudo systemctl show cloudflared.service \
  -p User -p Group -p ExecStart -p SupplementaryGroups

sudo systemctl cat cloudflared.service

判断方式如下:

  • User= 为空时,systemd 默认以 root 运行。
  • User=cloudflared 时,服务需要以 cloudflared 用户身份读取配置和凭据。
  • Group= 或 SupplementaryGroups= 会影响文件组权限和本地资源访问。
  • ExecStart= 可以确认实际使用的是哪个配置文件、哪个凭据文件以及是否使用了令牌模式。

不要把包含令牌的 ExecStart 输出复制到工单、聊天记录或公开日志中。令牌和凭据文件都应按密码级别保护。

2. 检查专用账户是否存在

如果计划使用专用账户,先确认账户和组:

getent passwd cloudflared
getent group cloudflared
id cloudflared

没有账户时,可以先创建系统组和系统用户,但应先确认安装包没有自动创建同名账户:

sudo groupadd --system cloudflared
sudo useradd --system \
  --gid cloudflared \
  --home-dir /var/lib/cloudflared \
  --create-home \
  --shell /usr/sbin/nologin \
  cloudflared

如果 groupadd 或 useradd 提示对象已存在,不要强行覆盖,先使用 id cloudflared 和 getent 检查现有账户属性。服务账户一般不需要交互式登录权限,也不应加入不必要的管理组。

3. 逐级检查目录、文件和执行权限

假设配置文件为 /etc/cloudflared/config.yml,凭据文件为 /etc/cloudflared/00000000-0000-0000-0000-000000000000.json,可以执行:

sudo namei -l /etc/cloudflared/config.yml
sudo namei -l /etc/cloudflared/00000000-0000-0000-0000-000000000000.json

sudo stat -c '%A %U:%G %n' \
  /etc/cloudflared \
  /etc/cloudflared/config.yml \
  /etc/cloudflared/00000000-0000-0000-0000-000000000000.json

常见的专用账户权限示例为:

drwxr-x--- root cloudflared /etc/cloudflared
-rw-r----- root cloudflared /etc/cloudflared/config.yml
-rw-r----- root cloudflared /etc/cloudflared/00000000-....json

重点不是机械套用某一组数字,而是满足以下关系:

二、确认服务运行账户与文件权限配图

  • 配置目录的每一级父目录都允许服务账户进入。
  • 配置文件对服务账户可读。
  • 凭据文件对服务账户可读,但不应对所有用户可读。
  • 二进制文件对服务账户可执行,普通用户不应拥有写权限。

使用与服务相同的账户进行读取测试:

sudo -u cloudflared test -r /etc/cloudflared/config.yml
sudo -u cloudflared test -r /etc/cloudflared/00000000-0000-0000-0000-000000000000.json
sudo -u cloudflared test -x /usr/local/bin/cloudflared

echo $?

最后一个返回值为 0,表示上一条测试成功。为了避免把错误归因到错误的文件,可以分别执行:

sudo -u cloudflared test -r /etc/cloudflared/config.yml && echo "config readable"
sudo -u cloudflared test -r /etc/cloudflared/00000000-0000-0000-0000-000000000000.json && echo "credentials readable"
sudo -u cloudflared test -x /usr/local/bin/cloudflared && echo "binary executable"

如果服务实际运行账户不是 cloudflared,应把命令中的账户替换为 systemctl show 查到的账户。root 服务读取文件通常不会遇到普通 Unix 权限问题,但仍应检查路径是否正确、文件是否存在以及是否受到 SELinux 或 AppArmor 限制。

三、检查出口 DNS 与网络连通性

Cloudflare Tunnel 的连接方向主要是服务器主动访问外部服务。通常不需要为了建立隧道而把服务器的 7844 或 443 端口直接暴露给互联网,但出口防火墙、上游 ACL 和 DNS 策略必须允许软件完成连接。

1. 检查 DNS 解析

先解析 Cloudflare API 和 Tunnel 边缘端点:

getent ahosts api.cloudflare.com
getent ahosts region1.v2.argotunnel.com
getent ahosts region2.v2.argotunnel.com

如果系统使用 systemd-resolved,还可以检查:

resolvectl status
resolvectl query api.cloudflare.com

预期结果是返回至少一个 IPv4 或 IPv6 地址。若出现以下情况,应先处理 DNS:

  • Name or service not known:本机无法解析名称。
  • Temporary failure in name resolution:DNS 服务暂时不可用或被出口策略拦截。
  • 只返回 IPv6,但服务器没有可用 IPv6 路由:需要确认软件是否应使用 IPv4,或者补齐 IPv6 出口。

可以分别验证两种地址族的 HTTPS 连接:

curl -4 -sS -o /dev/null \
  -w 'IPv4 HTTP %{http_code}\n' \
  --connect-timeout 8 --max-time 15 \
  https://api.cloudflare.com/client/v4/

curl -6 -sS -o /dev/null \
  -w 'IPv6 HTTP %{http_code}\n' \
  --connect-timeout 8 --max-time 15 \
  https://api.cloudflare.com/client/v4/

未携带 API 身份验证信息时,返回 401 或 403 并不代表网络失败,它说明 DNS、TCP、TLS 和 HTTP 请求至少已经到达服务端。若显示 000、连接超时或证书握手失败,才需要继续检查出口链路。

2. 检查 HTTPS 出口

Cloudflare Tunnel 的控制面和部分连接场景会使用 TCP 443。用 curl 查看完整握手信息:

curl -v -I \
  --connect-timeout 8 \
  --max-time 15 \
  https://api.cloudflare.com/client/v4/

重点观察:

三、检查出口 DNS 与网络连通性配图

  • 是否成功解析到地址。
  • 是否建立 TCP 连接。
  • 是否完成 TLS 握手。
  • 是否出现 certificate verify failed、Connection timed out 或 No route to host。

如果出现证书验证错误,先检查服务器时间:

timedatectl status
timedatectl show -p NTPSynchronized --value

NTPSynchronized=yes 是较理想的结果。若系统时间明显偏差,TLS 证书可能被判定为尚未生效或已经过期。若服务器使用企业内部证书链,还要确认该证书链是否适用于 cloudflared 的运行环境,不要为了绕过错误而关闭证书验证。

3. 检查 7844 出口

Cloudflare Tunnel 常见的边缘连接端口是 7844,具体使用 TCP、UDP 还是回退到其他连接方式,会受到 cloudflared 版本和网络策略影响。可以先对已知端点做 TCP 探测:

for host in region1.v2.argotunnel.com region2.v2.argotunnel.com; do
  echo "checking $host:7844"
  nc -vz -w 5 "$host" 7844
done

成功时通常会看到 succeeded 或 open。如果 nc 不存在,可以安装系统提供的网络诊断工具,或者直接进入前台运行验证。

需要注意,nc -u 发送 UDP 数据报不能可靠证明 UDP 双向通信已经建立。即使命令没有报错,也不能据此认定 7844/UDP 已经放行。最终应以 cloudflared 前台运行日志为准。

4. 检查本机出口防火墙规则

只查看规则,不要在尚未确认现有策略的情况下执行清空或重置命令:

sudo nft list ruleset

如果服务器仍使用 iptables:

sudo iptables -S
sudo iptables -L OUTPUT -n -v

如果使用 UFW:

sudo ufw status verbose

重点确认:

  • OUTPUT 链或对应 nftables 输出链没有无条件拒绝。
  • DNS 请求使用的 UDP/TCP 53 可达。
  • TCP 443 可达。
  • 组织网络要求使用 7844 时,TCP/UDP 7844 没有被出口 ACL 拦截。
  • 没有把“服务器不监听 7844”误判成出口失败。

不要为了测试临时执行 iptables -F、nft flush ruleset 或关闭主机防火墙。这类操作会影响整台服务器的既有业务,且可能导致远程连接中断。若确实需要放行,应先导出当前规则,限定目标、方向和端口,完成测试后按原规则回滚。

四、检查配置语法和本地上游服务

1. 验证 Tunnel 配置文件

一个使用凭据文件的最小示例可以是:

tunnel: 00000000-0000-0000-0000-000000000000
credentials-file: /etc/cloudflared/00000000-0000-0000-0000-000000000000.json

ingress:
  - hostname: app.example.com
    service: http://127.0.0.1:8080
  - service: http_status:404

验证入口规则和配置格式:

sudo -u cloudflared \
  /usr/local/bin/cloudflared tunnel ingress validate \
  --config /etc/cloudflared/config.yml

成功时通常会显示规则验证通过,命令返回码为 0。这一步主要验证 YAML 结构、入口规则和兜底规则,不能证明凭据有效,也不能证明外部网络已连通。

如果出现以下错误,应按对应方向处理:

  • no such file or directory:配置路径或凭据路径错误。
  • permission denied:服务账户无法进入目录或读取文件。
  • YAML 缩进错误:检查空格、冒号和列表层级。
  • 缺少兜底规则:为未匹配请求保留明确的最终处理规则。
  • UUID 或凭据不匹配:确认配置中的 Tunnel 标识与 JSON 凭据属于同一隧道。

2. 验证本机业务端口

Tunnel 连接成功后还需要访问本机上游服务。先确认业务服务是否监听目标地址:

sudo ss -lntp | grep ':8080'

然后用计划中的服务账户访问健康检查地址:

sudo -u cloudflared \
  curl -sS -o /dev/null \
  -w 'origin HTTP %{http_code}\n' \
  --connect-timeout 5 --max-time 10 \
  http://127.0.0.1:8080/healthz

预期可以是 200、204 或业务约定的其他状态码。出现 Connection refused 通常表示本地服务未启动或监听端口不一致;出现 Permission denied 时,应检查本地 Unix Socket、SELinux 或 AppArmor,而不是先修改 Tunnel 权限。

这一步只验证服务器本地到上游服务的访问,不等同于外部用户访问验证。

五、用前台运行完成一次低风险验证

完成权限、DNS 和出口检查后,再进行一次前台运行。前台运行便于直接观察连接协议、认证错误和出口失败原因,且不会立即把问题隐藏在 systemd 重启循环中。

使用凭据文件的隧道可以按实际名称或 UUID 执行:

sudo -u cloudflared \
  /usr/local/bin/cloudflared tunnel \
  --config /etc/cloudflared/config.yml \
  run 00000000-0000-0000-0000-000000000000

如果采用令牌模式,应使用安全的密钥注入方式,不要把真实令牌直接写入 shell 历史、工单或公开脚本。令牌模式和凭据文件模式应按所采用的安装方式配置,不要随意混用。

正常情况下,日志会包含启动信息以及类似 Registered tunnel connection 的注册成功信息,并显示连接使用的协议或边缘区域。看到这些信息,通常可以说明以下链路已经基本打通:

五、用前台运行完成一次低风险验证配图

  1. 运行账户可以执行二进制文件。
  2. 配置和凭据文件可读。
  3. DNS 解析成功。
  4. 至少一条出口路径可用。
  5. Tunnel 身份认证通过。

如果日志出现 ICMP 权限提示,但 HTTP/HTTPS 上游连接和 Tunnel 注册均正常,不一定代表部署失败。只提供 Web 服务时,不要为了消除一条非关键提示而授予过大的系统能力。

确认日志后按 Ctrl+C 停止前台测试,再交给 systemd 管理。测试期间不要同时启动两个使用同一配置和凭据的进程,避免重复连接和日志混淆。

六、常见失败情况与处理顺序

现象优先检查项处理方向
Permission denied 读取配置namei -l、stat、服务账户修正父目录进入权限和文件读取权限,避免直接执行递归 chmod
cloudflared: command not foundcommand -v cloudflared、systemd 的 ExecStart使用绝对路径,确认二进制已安装且对服务账户可执行
域名无法解析getent ahosts、resolvectl status检查 DNS 地址、出口 ACL 和本机解析服务
HTTPS 超时curl -v、防火墙 OUTPUT 规则检查 TCP 443、默认路由和上游出口策略
7844 探测失败TCP 探测结果、Tunnel 前台日志确认 TCP/UDP 7844 是否被拦截,必要时按版本支持的方式使用 HTTPS 回退
TLS 证书错误timedatectl、系统 CA校准时间,补齐受信任 CA,不要关闭证书校验
Tunnel 已注册但上游连接失败ss -lntp、本地 curl检查 127.0.0.1:8080、应用健康状态和本地安全策略
服务不断重启journalctl -u、systemctl status先停止自动重启,前台运行读取第一条真实错误,不要只看最后一条退出日志

查看服务日志时,建议限制输出范围:

sudo journalctl -u cloudflared.service -n 100 --no-pager
sudo systemctl status cloudflared.service --no-pager

如果日志中出现凭据、令牌或完整环境变量,应立即停止传播并按凭据泄露流程处理。

验收与回滚检查项

验收清单

正式启用 systemd 服务前,至少确认:

  • cloudflared --version 能正常返回,二进制路径与 ExecStart 一致。
  • systemd 使用的账户、组和手工测试账户一致。
  • 服务账户可以读取配置文件和凭据文件,但其他普通账户不能读取敏感凭据。
  • cloudflared tunnel ingress validate 返回成功。
  • api.cloudflare.com 和 Tunnel 边缘端点可以完成 DNS 解析。
  • TCP 443 可用;需要 7844 时,Tunnel 前台日志能证明对应连接路径可用。
  • 本地上游服务端口已监听,服务账户可以访问健康检查地址。
  • 前台运行日志出现 Tunnel 注册成功信息。
  • 没有为了建立出口连接而新增不必要的公网入站端口。
  • systemd 启动后状态为 active,且没有快速重启:
sudo systemctl is-active cloudflared.service
sudo systemctl show cloudflared.service -p NRestarts -p SubState

服务器不出现 7844 入站监听并不一定是异常。Cloudflare Tunnel 的连接通常由服务器主动建立,是否存在本地监听端口应以实际部署模式为准,不能单凭 ss 中没有 7844 判断失败。

回滚清单

如果前台验证失败或 systemd 启动后影响既有业务,按以下顺序回退:

  1. 先按 Ctrl+C 停止前台测试进程。
  2. 如果是新建服务且尚未承载业务,执行 sudo systemctl disable --now <实际服务名>;已有生产隧道不要直接停止,先确认影响范围。
  3. 使用部署前保存的备份恢复 config.yml 和凭据文件,并恢复原有归属与权限。
  4. 如果修改过防火墙,只恢复此前导出的规则,不要执行全量清空。
  5. 如果令牌或 JSON 凭据曾出现在日志、命令历史或错误工单中,应撤销并重新签发,不要仅依赖删除文本记录。
  6. 使用 systemctl status 和 journalctl 确认服务已经停止,避免旧进程仍在后台占用连接。

完成回滚后,保留失败时的版本号、服务账户、错误时间点和出口测试结果。下一次重新部署时,应优先复查导致失败的那一层,而不是重复修改所有权限和防火墙规则。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/4586.html

相关推荐