cloudflared-tunnel.md 2.73 KB

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 模式之间切换时,先清理凭据文件。两种模式不兼容,不能共存。