Linux服务器部署Cloudflare Tunnel前,如何检查服务权限与出口连通性
首次部署 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/
重点观察:

- 是否成功解析到地址。
- 是否建立 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 的注册成功信息,并显示连接使用的协议或边缘区域。看到这些信息,通常可以说明以下链路已经基本打通:

- 运行账户可以执行二进制文件。
- 配置和凭据文件可读。
- DNS 解析成功。
- 至少一条出口路径可用。
- Tunnel 身份认证通过。
如果日志出现 ICMP 权限提示,但 HTTP/HTTPS 上游连接和 Tunnel 注册均正常,不一定代表部署失败。只提供 Web 服务时,不要为了消除一条非关键提示而授予过大的系统能力。
确认日志后按 Ctrl+C 停止前台测试,再交给 systemd 管理。测试期间不要同时启动两个使用同一配置和凭据的进程,避免重复连接和日志混淆。
六、常见失败情况与处理顺序
| 现象 | 优先检查项 | 处理方向 |
|---|---|---|
Permission denied 读取配置 | namei -l、stat、服务账户 | 修正父目录进入权限和文件读取权限,避免直接执行递归 chmod |
cloudflared: command not found | command -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 启动后影响既有业务,按以下顺序回退:
- 先按
Ctrl+C停止前台测试进程。 - 如果是新建服务且尚未承载业务,执行
sudo systemctl disable --now <实际服务名>;已有生产隧道不要直接停止,先确认影响范围。 - 使用部署前保存的备份恢复
config.yml和凭据文件,并恢复原有归属与权限。 - 如果修改过防火墙,只恢复此前导出的规则,不要执行全量清空。
- 如果令牌或 JSON 凭据曾出现在日志、命令历史或错误工单中,应撤销并重新签发,不要仅依赖删除文本记录。
- 使用
systemctl status和journalctl确认服务已经停止,避免旧进程仍在后台占用连接。
完成回滚后,保留失败时的版本号、服务账户、错误时间点和出口测试结果。下一次重新部署时,应优先复查导致失败的那一层,而不是重复修改所有权限和防火墙规则。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/4586.html



