Cloudflare Tunnel 踩坑记录
环境
Android 16 / Termux / aarch64 / wechat-viewer Flask on port 5001
cloudflared 安装
- 不要从 GitHub Releases 下载:
curl -sL github.com/cloudflare/.../cloudflared-linux-arm64在 Termux 上容易超时(exit code 28) - 用 apt:
pkg update && pkg install -y cloudflared(Termux 官方仓库有,2026.7.3-1)
Quick Tunnel 验证
cloudflared tunnel --url http://localhost:5001
输出示例:
+--------------------------------------------------------------------------------------------+
| Your quick Tunnel has been created! Visit it at: |
| https://billy-pubs-disclose-conventional.trycloudflare.com |
+--------------------------------------------------------------------------------------------+
连接检查通过后,外网 curl 能拿到 HTTP 200。
tunnel login 网络问题
cloudflared tunnel login 输出授权链接后,cloudflared 自行轮询 login.cloudflareaccess.org 等待回调。该域名可能被墙,导致 i/o timeout 或 EOF。
解决:忽略 cloudflared 的报错,浏览器授权后会自动下载 cert.pem,手动拷贝:
mkdir -p ~/.cloudflared
cp /path/to/cert.pem ~/.cloudflared/cert.pem
与 Flask 的集成
cloudflared 是纯 TCP 隧道,Flask 重启不影响隧道(不用重启 cloudflared)。隧道 URL 保持不变。
网络不稳定性
Quick Tunnel 的 api.trycloudflare.com API endpoint 可能被墙导致间歇性不可达:
- 症状:
cloudflared tunnel --url输出failed to request quick Tunnel: Post "https://api.trycloudflare.com/tunnel": EOF - 验证:
curl https://api.trycloudflare.com/tunnel -X POST返回 HTTP 000 api.cloudflare.com(正式 Tunnel 使用)通常可达,更稳定- 临时方案:切换 WiFi/移动数据网络后重试
残留凭据导致 Quick Tunnel 404(2026-07-31)
症状:tunnel 日志显示 "Registered tunnel connection" + 所有 connectivity checks PASS,但访问返回 Cloudflare 404(不带 Flask 响应头)。
根因:之前运行过 cloudflared tunnel login(方案 B 正式 Tunnel 的第一步),生成了 ~/.cloudflared/cert.pem 和 ~/.cloudflared/config.yml。这些凭据文件会让 cloudflared 尝试使用 named tunnel 认证而非 Quick Tunnel 模式,导致连接成功但路由错乱——Cloudflare 找不到对应 tunnel 返回 404。
修复:
rm -f ~/.cloudflared/cert.pem ~/.cloudflared/config.yml
cloudflared tunnel --url http://localhost:5001 # 重建 Quick Tunnel
预防:在 Quick Tunnel 和 Named Tunnel 模式之间切换时,先清理凭据文件。两种模式不兼容,不能共存。