Traefik路由异常排查：localhost仅转发至frontend及网络问题

一、先搞定网络问题（核心原因） #

• 所有服务（Traefik、backend、frontend）必须加入同一个traefik-public网络，别用默认桥接（默认桥接IP随机，跨网络无法访问）
  1. 创建网络（如果还没建）：docker network create traefik-public
  2. 每个服务的docker-compose配置里必须指定这个网络，示例：

     networks:
       - traefik-public
     

  3. 重点：Traefik本身也要挂载这个网络，不然找不到同网络下的容器
• 绝对别用容器IP访问，改用容器名称当服务地址——Docker DNS会在同网络里自动解析容器名称到正确IP，彻底解决IP随机变的问题

二、配置路由规则实现需求 #

1. 让localhost默认指向frontend #

给frontend加Traefik标签，规则直接匹配localhost主机：

labels:
  - "traefik.enable=true"
  - "traefik.http.routers.frontend.rule=Host(`localhost`)"
  - "traefik.http.routers.frontend.entrypoints=web"
  - "traefik.http.services.frontend.loadbalancer.server.port=你的frontend端口" # 比如80

2. 把localhost/docs转发到backend/docs #

给backend加Traefik标签，用Host+PathPrefix组合规则匹配，还可以加路径重写（按需）：

labels:
  - "traefik.enable=true"
  - "traefik.http.routers.backend-docs.rule=Host(`localhost`) && PathPrefix(`/docs`)"
  - "traefik.http.routers.backend-docs.entrypoints=web"
  - "traefik.http.services.backend.loadbalancer.server.port=你的backend端口" # 比如8000
  # 如果backend的文档根路径是/，不是/docs，就加下面这两行把请求里的/docs前缀去掉
  - "traefik.http.middlewares.backend-docs-stripprefix.stripprefix.prefixes=/docs"
  - "traefik.http.routers.backend-docs.middlewares=backend-docs-stripprefix@docker"

说明：如果backend本身的文档路径就是/docs，那路径重写的中间件可以删掉

三、完整docker-compose示例 #

version: '3.8'

networks:
  traefik-public:
    external: true # 用已经创建好的网络

services:
  traefik:
    image: traefik:v2.10
    command:
      - "--api.insecure=true" # 本地调试用，生产环境一定要关掉
      - "--providers.docker=true"
      - "--providers.docker.exposedbydefault=false" # 只启用加了traefik.enable=true的服务
      - "--entrypoints.web.address=:80"
    ports:
      - "80:80"
      - "8080:8080" # Traefik控制台，用来调试看路由
    volumes:
      - "/var/run/docker.sock:/var/run/docker.sock:ro" # 只读挂载docker sock
    networks:
      - traefik-public

  frontend:
    image: 你的前端镜像地址
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.frontend.rule=Host(`localhost`)"
      - "traefik.http.routers.frontend.entrypoints=web"
      - "traefik.http.services.frontend.loadbalancer.server.port=80"
    networks:
      - traefik-public

  backend:
    image: 你的后端镜像地址
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.backend-docs.rule=Host(`localhost`) && PathPrefix(`/docs`)"
      - "traefik.http.routers.backend-docs.entrypoints=web"
      - "traefik.http.services.backend.loadbalancer.server.port=8000"
      - "traefik.http.middlewares.backend-docs-stripprefix.stripprefix.prefixes=/docs"
      - "traefik.http.routers.backend-docs.middlewares=backend-docs-stripprefix@docker"
    networks:
      - traefik-public

四、验证步骤 #

• 启动服务：docker-compose up -d
• 访问localhost：应该显示前端内容
• 访问localhost/docs：应该跳转到后端的文档页面
• 打开localhost:8080看Traefik控制台：确认两个路由都已加载，服务都在traefik-public网络下

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