UNRAID中Cloudflare Tunnel对接Docker版File Browser出现502错误求助

1. 确认容器网络互通性 #

• 进入cloudflared容器，测试与目标服务的连通性：

  curl http://[FileBrowser容器IP]:[端口]
  curl http://[Nextcloud容器IP]:[端口]
  

  如果返回服务响应，说明网络没问题；如果提示连接拒绝/超时，检查：
  • 是否将cloudflared和目标服务放在同一Docker网络（自定义网络或默认bridge），跨网络会导致无法访问
  • 不要用localhost作为目标地址，改用容器名或内部IP（Docker容器间可通过容器名解析）

2. 修改服务监听地址 #

• File Browser默认仅监听127.0.0.1，需改为监听所有网卡：
  • 启动容器时添加参数：docker run -p 8080:80 filebrowser/filebrowser --address 0.0.0.0
  • 或挂载配置文件config.json，设置"address": "0.0.0.0"
• Nextcloud需检查Web服务（Apache/Nginx）配置，确保监听0.0.0.0而非仅127.0.0.1

3. 核对Cloudflare Tunnel路由配置 #

• 确认隧道 ingress 规则的目标地址正确：
  • 示例配置（config.yml）：

    ingress:
      - hostname: filebrowser.yourdomain.com
        service: http://filebrowser:8080  # 用容器名+端口，而非localhost
      - hostname: nextcloud.yourdomain.com
        service: http://nextcloud:80
      - service: http_status:404
    

  • 不要给目标地址加https，除非你的服务本身配置了SSL证书，否则cloudflared无法建立连接

4. 排查服务自身状态 #

• 查看容器日志，确认服务正常启动：

  docker logs [filebrowser容器名]
  docker logs [nextcloud容器名]
  

  检查是否有端口绑定失败、配置错误等日志
• 局域网内直接访问服务（http://[主机IP]:[端口]），验证服务本身是否能正常响应，排除服务自身故障

5. 调整Cloudflare Tunnel超时设置 #

• Nextcloud等服务初始化响应较慢，可增加超时时间避免502：
  在config.yml的对应 ingress 规则中添加originRequest配置：

  - hostname: nextcloud.yourdomain.com
    service: http://nextcloud:80
    originRequest:
      connectTimeout: 30s
      tcpKeepAlive: true
  

6. 检查防火墙规则 #

• 确认主机防火墙未阻止cloudflared访问目标服务的端口
• 检查Docker iptables规则，确保容器间流量被允许（默认Docker会自动配置，若手动修改过iptables需恢复）

内容的提问来源于stack exchange，提问作者Jonas