# 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 验证 ```bash 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`,手动拷贝: ```bash 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。 **修复**: ```bash rm -f ~/.cloudflared/cert.pem ~/.cloudflared/config.yml cloudflared tunnel --url http://localhost:5001 # 重建 Quick Tunnel ``` **预防**:在 Quick Tunnel 和 Named Tunnel 模式之间切换时,先清理凭据文件。两种模式不兼容,不能共存。