为何Traefik无法检测我的容器？切换toml配置后故障求助

我碰到过好几个Swarm模式下用Traefik监听独立容器的情况，你的问题核心在于：Traefik的Docker Provider在Swarm环境中默认只会监听Swarm服务，不会主动检测独立容器。换成traefik.toml后，你可能没明确配置这个行为，导致容器无法被发现。

下面是具体的解决步骤和配置要点：

1. 修正traefik.toml的Docker Provider配置 #

这是最关键的一步，你需要在配置文件里明确告诉Traefik要监听独立容器，而不是只看Swarm服务。参考这个配置：

# 定义入口点
[entryPoints]
  [entryPoints.web]
    address = ":80"

# 启用Web UI（测试用，生产环境建议关闭insecure，改用HTTPS）
[api]
  dashboard = true
  insecure = true

# Docker Provider核心配置
[providers.docker]
  # 指定Docker套接字路径，Traefik需要通过它获取容器信息
  endpoint = "unix:///var/run/docker.sock"
  # 启用自动监听容器变化，实时更新路由
  watch = true
  # 关键！关闭Swarm模式检测，让Traefik关注独立容器
  swarmMode = false
  # 可选：只暴露带有traefik.enable=true标签的容器，避免自动暴露所有容器
  exposedByDefault = false

配置参数说明： #

• swarmMode=false：这是解决你问题的核心。当服务器处于Swarm模式时，Traefik默认会开启swarmMode=true，只扫描Swarm服务；设置为false后，它就会像普通Docker环境一样监听独立容器了。
• endpoint：必须指定正确的Docker套接字，确保Traefik能访问Docker的API。
• watch=true：让Traefik实时监控容器的创建/删除/更新，自动同步路由规则。

2. 确保Traefik容器正确挂载Docker套接字 #

不管你用docker run还是docker-compose启动Traefik，都必须把宿主机的/var/run/docker.sock挂载到容器内部，否则Traefik根本无法获取容器信息。

用docker run启动的示例： #

docker run -d \
  --name traefik \
  -p 80:80 \
  -p 8080:8080 \
  # 挂载Docker套接字
  -v /var/run/docker.sock:/var/run/docker.sock \
  # 挂载你的traefik.toml配置文件
  -v $PWD/traefik.toml:/etc/traefik/traefik.toml \
  traefik:v2.10 # 替换成你使用的Traefik版本，比如v2.x系列

用docker-compose启动的示例： #

version: '3.8'
services:
  traefik:
    image: traefik:v2.10
    ports:
      - "80:80"
      - "8080:8080"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./traefik.toml:/etc/traefik/traefik.toml
    restart: unless-stopped

3. 给独立容器添加正确的Traefik标签 #

如果你在traefik.toml里设置了exposedByDefault=false，那么你的独立容器必须添加traefik.enable=true标签才能被Traefik识别。同时还要添加路由规则相关的标签，比如：

docker run -d \
  --name my-nginx \
  # 告诉Traefik启用这个容器的路由
  --label traefik.enable=true \
  # 定义路由规则：匹配指定域名
  --label traefik.http.routers.my-nginx.rule=Host(`myapp.yourdomain.com`) \
  # 指定使用的入口点
  --label traefik.http.routers.my-nginx.entrypoints=web \
  nginx:alpine

常见排查点 #

如果还是无法检测到容器，可以检查这几点：

• 确认Traefik容器的日志，看看有没有Docker API访问失败的错误（比如权限问题，或者套接字挂载错误）
• 检查独立容器的标签是否正确，有没有拼写错误
• 确保Traefik版本是v2.x，v1.x的配置语法和v2.x完全不同，不要混用

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