Traefik 2与Vikunja容器网络配置引发网关超时故障

以下是逐步排查的步骤，从网络连通性到服务配置逐一验证：

1. 验证容器网络归属与连通性 #

• 执行docker network inspect web，检查输出的Containers字段，确认Traefik、vikunja_api、vikunja_frontend、vikunja_db都在这个网络中。如果有容器不在，说明网络配置未生效，需重启对应容器或检查docker-compose的networks配置。
• 从Traefik容器测试到Vikunja服务的连通性：

  # 替换<traefik-container-id/name>为你的Traefik容器ID或名称
  docker exec -it <traefik-container-id/name> ping vikunja-api
  docker exec -it <traefik-container-id/name> ping vikunja-frontend
  

  如果ping不通，说明网络解析或连通性存在问题，可尝试重启相关容器或重新创建web网络。

2. 确认Traefik正确识别Vikunja服务 #

• 打开Traefik仪表盘（默认8080端口），查看HTTP Routers列表，确认vikunja-api和vikunja-frontend路由存在，且对应的Services状态正常。
• 检查Traefik配置文件traefik.http.yml，确保已启用Docker Provider，配置示例：

  providers:
    docker:
      endpoint: "unix:///var/run/docker.sock"
      exposedByDefault: false # 配合traefik.enable=true使用
  

  若未配置Docker Provider，Traefik无法读取容器的labels规则。同时确认Traefik容器挂载的/var/run/docker.sock权限正常，可执行docker exec -it <traefik-container> ls -l /var/run/docker.sock检查。

3. 显式指定Vikunja服务的转发端口 #

Vikunja的API默认端口为3456，前端默认端口为80，Traefik可能无法自动检测端口导致转发失败。需在Vikunja的docker-compose.yml中为服务添加端口指定：

• 给api服务的labels新增：

  - "traefik.http.services.vikunja-api.loadbalancer.server.port=3456"
  

• 给frontend服务的labels新增：

  - "traefik.http.services.vikunja-frontend.loadbalancer.server.port=80"
  

修改后重启Vikunja容器：docker-compose down && docker-compose up -d

4. 检查Vikunja内部服务的健康状态 #

• 测试API容器到数据库的连通性：

  docker exec -it <vikunja-api-container-id/name> ping db
  

  如果ping不通，可尝试将db放回default网络（api同时在web和default网络，仍可通过default网络访问db），避免不必要的跨网络配置。
• 查看API容器日志，检查是否有启动失败或数据库连接错误：

  docker logs <vikunja-api-container-id/name>
  

  若日志中出现数据库连接失败的信息，需检查数据库的环境变量配置（如密码、用户名）是否正确。

5. 验证Traefik Entrypoints与TLS配置 #

• 检查Traefik配置中的entrypoints定义，确保websecure指向443端口：

  entryPoints:
    web:
      address: ":80"
    websecure:
      address: ":443"
  

• 确认myresolver证书解析器配置正确（如Let's Encrypt邮箱、ACME服务器地址），若证书生成失败，可能导致路由无法正常生效，但Gateway Timeout更多与后端连通相关，可先排除此点。

6. 检查宿主机防火墙与端口转发 #

• 确认宿主机的80、443端口未被防火墙（如ufw、iptables）拦截，执行ufw status查看规则，必要时添加允许规则：

  ufw allow 80/tcp
  ufw allow 443/tcp
  

• 若使用云服务器，检查安全组是否开放80、443端口的入站流量。

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