使用Traefik搭配Docker部分容器出现502 Bad Gateway错误求助

遇到Traefik搭配Docker时部分容器正常、部分报502 Bad Gateway，这是很常见的场景，我帮你梳理几个核心排查方向，按顺序走基本能定位到问题：

1. 先确认网络连通性 #

Traefik和容器必须在同一个Docker网络里才能正常通信，这是最容易踩的坑：

• 用命令检查自定义网络（如果用了的话）里的容器列表：

  docker network inspect <你的自定义网络名称>
  

  看输出里的Containers字段，确保出问题的容器和Traefik都在这个网络里。如果是用默认bridge网络，也得确认两者都在里面。
• 手动测试Traefik到容器的连通性：
  先进入Traefik容器：

  docker exec -it <traefik容器名称> sh
  

  然后ping问题容器的名称：

  ping <问题容器名称>
  

  如果ping不通，直接就是网络隔离的问题，把容器加入Traefik所在的网络即可。

2. 检查容器端口配置是否匹配 #

很多502都是因为Traefik指向的端口和容器实际监听的端口不一致：

• 先确认容器内部服务的监听端口：看容器日志（docker logs <问题容器名称>），找类似“Listening on port XXXX”的日志；或者用docker inspect <问题容器名称>查看NetworkSettings.Ports字段。
• 核对Traefik的路由配置：如果用Docker标签配置，检查traefik.http.services.<服务名>.loadbalancer.server.port的值是不是和容器实际端口一致；如果用静态配置文件，检查对应的服务端口是否正确。

比如如果容器实际监听8000，但你标签里写了8080，Traefik去连8080就会被拒绝，直接报502。

3. 利用Traefik日志定位具体错误 #

你已经在traefik.toml里开启了debug和DEBUG级别的日志，这太有用了！直接看Traefik的日志：

docker logs <traefik容器名称>

搜索问题容器相关的条目，常见的错误比如：

• dial tcp <容器IP>:<端口>: connect: connection refused：说明Traefik能找到容器，但连不上指定端口，大概率是端口配置错了或者容器服务没启动。
• no such service：说明Traefik没识别到容器的服务配置，可能是标签写错了或者容器没在Traefik的监控范围内。

4. 排查防火墙或端口冲突 #

• 宿主机的防火墙（比如iptables、ufw）有没有拦截Docker网络的流量？可以临时关闭防火墙测试一下，如果恢复正常，就需要调整防火墙规则允许Docker网络通信。
• 问题容器内部的服务有没有因为端口被占用而启动失败？看容器日志里有没有类似address already in use的报错，有的话需要调整容器内部服务的端口。

5. 核对Traefik版本兼容性 #

如果你用的是Traefik v2+，但配置还沿用v1的语法（比如用frontend/backend而不是routers/services），也会导致路由失效。检查你的配置语法是否和当前Traefik版本匹配，比如v2的路由标签应该是traefik.http.routers.<路由名>.rule而不是v1的traefik.frontend.rule。

先按这些步骤排查，基本能找到问题。如果看完日志还有具体的报错片段，可以贴出来，我再帮你分析细节。

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