Traefik V2部署至Docker Swarm集群（仅管理节点）时服务循环重启故障排查求助

错误原因分析 #

你遇到的field not found, node: docker错误，核心原因是Traefik v2彻底重构了配置体系，完全废弃了v1时代的--docker这类顶层参数，改用Providers体系来配置数据源。你沿用的是v1的老参数，自然会导致启动失败。

正确的部署方案 #

Traefik v2部署到Swarm管理节点，需要使用v2专属的配置参数，下面分两种常用部署方式给出示例：

方式1：直接用docker service create命令 #

docker service create \
 --name traefik \
 --constraint=node.role==manager \
 --publish 80:80 --publish 8080:8080 \
 --mount type=bind,source=/var/run/docker.sock,target=/var/run/docker.sock:ro \
 --network traefik-net \
 traefik:v2.11 \ # 建议指定具体稳定版本，避免latest自动升级出问题
 --api.insecure=true \ # 开启不安全的API UI（生产环境建议配置证书）
 --entrypoints.web.address=:80 \ # 定义HTTP入口点
 --providers.docker=true \ # 启用Docker数据源Provider
 --providers.docker.swarmMode=true \ # 开启Swarm模式支持
 --providers.docker.watch=true \ # 监听Docker事件自动更新配置
 --providers.docker.exposedByDefault=false # 只处理显式标注了Traefik路由的服务

方式2：用Docker Compose（Swarm Stack部署） #

下面是适配v2的Compose文件，所有参数和标签都采用v2格式：

version: '3.8' # 推荐用较高版本，兼容Swarm新特性
networks:
  swarm-network:
    driver: overlay
    attachable: true # 允许其他服务手动连接该网络（可选）
services:
  traefik:
    image: traefik:v2.11 # 指定具体版本更稳定
    deploy:
      restart_policy:
        condition: on-failure
        max_attempts: 3
      placement:
        constraints:
          - node.role == manager
      update_config:
        parallelism: 1
        delay: 10s
        order: start-first # 先启动新实例再停旧的，避免服务中断
    command:
      - "--api.insecure=true"
      - "--entrypoints.web.address=:80"
      # Docker Provider核心配置
      - "--providers.docker=true"
      - "--providers.docker.swarmMode=true"
      - "--providers.docker.watch=true"
      - "--providers.docker.exposedByDefault=false"
      - "--providers.docker.network=swarm-network" # 指定默认监听的Swarm网络
    ports:
      - "80:80"
      - "8080:8080"
    networks:
      - swarm-network
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro # 只读挂载，降低安全风险
    labels:
      # 配置Traefik自身的路由（v2专属标签格式）
      - "traefik.enable=true"
      - "traefik.http.routers.traefik.rule=Host(`traefik.docker.swarm`)"
      - "traefik.http.routers.traefik.entrypoints=web"
      - "traefik.http.services.traefik.loadbalancer.server.port=8080"

部署这个Stack的命令：

docker stack deploy -c docker-compose.yml traefik

关键配置说明 #

• 指定Traefik版本：不要用latest标签，建议锁定具体稳定版本（比如v2.11），避免自动更新引发兼容性问题
• 只读挂载docker.sock：添加:ro权限，减少容器被入侵后对宿主Docker的影响
• exposedByDefault=false：只处理显式添加了traefik.enable=true标签的服务，避免自动路由所有Swarm服务
• v2标签格式：v1的traefik.frontend.rule等标签已废弃，必须改用traefik.http.routers.xxx.rule这类v2格式

验证部署成功 #

1. 查看服务状态：docker service ps traefik，确保服务没有陷入重启循环
2. 查看启动日志：docker service logs -f traefik，确认无启动错误
3. 访问Traefik UI：在浏览器打开http://<管理节点IP>:8080，能看到Dashboard即说明部署成功

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