SuperAPI AI 工具集

cloudflare-tunnel-troubleshoot

部署与运维

查看项目

更新于 10-15 20:34

技能介绍

用途:系统化诊断并修复 Cloudflare Tunnel 连接问题,解决远程访问服务失败的情况,适用于隧道未连接、隧道宕机、Error 1033、远程访问失效、cloudflared 不工作等触发场景,以及本地可用但远程不可用、仪表盘显示隧道断开、502 Bad Gateway、容器反复重启等隐式症状。

主要能力:检查 cloudflared 容器是否运行;验证 CLOUDFLARE_TUNNEL_TOKEN 是否设置;确认隧道近期(10 分钟内)是否完成注册;分析日志中的 Error 1033、QUIC 问题与连接失败;在 Cloudflare Zero Trust 仪表盘核对隧道状态;测试远程访问以验证路由;给出具体恢复命令。

使用方式:先执行 docker ps | grep cloudflared 查看容器状态,用 docker logs cloudflared --tail 100 | grep "Registered tunnel" 检查注册记录,用 docker logs cloudflared --tail 50 | grep -i error 查错。卡死时可执行 docker compose -f /home/dawiddutoit/projects/network/docker-compose.yml restart cloudflared 重启。令牌无效时从仪表盘获取新令牌,更新 .env 后执行 docker compose -f /home/dawiddutoit/projects/network/docker-compose.yml up -d --force-recreate cloudflared。网络问题可用 docker exec cloudflared ping -c 3 1.1.1.1 与 nslookup 排查。

适用场景:Docker 环境下的 Cloudflare Tunnel 运维排障,需具备有效隧道令牌、服务器联网、Cloudflare Zero Trust 账户及仪表盘中的隧道配置。

限制与注意:不要在仪表盘删除隧道以免产生孤立令牌;隧道未工作时不要暴露 80/443 端口;重启前先查日志;避免反复重启导致限流;远程测试应使用蜂窝网络或外部代理而非本地 WiFi;不要混淆隧道令牌与 API 令牌;修改隧道路由需同步更新 Caddyfile。隧道注册通常每隔几分钟发生一次,最长约 10 分钟无注册会自动断开。具体修复效果与平台细节以实际环境为准。