Traefik作为反向代理持续返回404及配置不生效问题求助

1. 确认静态配置文件加载逻辑 #

Traefik不会自动识别traefik.yml，必须在启动命令中明确指定配置文件路径。检查你的Docker Compose配置，确保挂载了配置文件并指定加载路径：

services:
  traefik:
    image: traefik:v2.x
    command:
      - "--configfile=/etc/traefik/traefik.yml"
    volumes:
      - ./traefik.yml:/etc/traefik/traefik.yml:ro
      - /var/run/docker.sock:/var/run/docker.sock:ro

2. 配置Docker Provider禁用标签依赖 #

既然不用Docker标签，需在traefik.yml的Docker Provider配置中关闭自动暴露和标签解析：

providers:
  docker:
    endpoint: "unix:///var/run/docker.sock"
    exposedByDefault: false  # 禁止自动暴露未配置容器
    defaultRule: ""  # 清空默认规则，避免标签干扰
    useBindPortIP: false

3. 动态配置中正确关联Docker服务 #

确保路由和服务的定义指向正确的Docker容器名称（需与Docker Compose中的服务名一致，Traefik通过Docker内部DNS解析容器）：

http:
  routers:
    demo-service-router:
      rule: "Host(`demo.yourlocal.com`)"
      service: demo-service
  services:
    demo-service:
      loadBalancer:
        servers:
          - url: "http://demo-service:8080"  # 容器名:内部端口

4. 检查容器网络互通性 #

Traefik和被代理服务必须处于同一Docker网络，否则无法访问容器内服务。在Docker Compose中定义统一网络：

networks:
  traefik-net:
    external: false

services:
  traefik:
    networks:
      - traefik-net
  demo-service:
    networks:
      - traefik-net

5. 查看启动日志定位错误 #

通过日志排查配置加载或连接问题：

docker logs traefik

重点关注配置文件格式错误、Docker套接字权限不足、服务路由解析失败等提示。

6. 验证仪表盘路由配置 #

如果仪表盘看不到路由，需确保静态配置启用仪表盘，并在动态配置中添加对应的路由规则：

# 静态配置
api:
  dashboard: true

# 动态配置
http:
  routers:
    traefik-dashboard:
      rule: "Host(`traefik.yourlocal.com`)"
      service: api@internal

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