如何配置Traefik对接远程Docker API以使用远程主机IP与NAT端口

我太懂你这个痛点了——Traefik不在Docker主机本地，默认抓的都是容器内部的私有IP，外部根本访不到，对吧？别慌，咱们通过调整Traefik的Docker Provider配置，就能让它改用远程Docker主机的可路由IP，配合容器的NAT端口来转发流量。

核心原理 #

Traefik默认会优先使用容器的内部IP和暴露端口，但当它不在同一Docker网络时，这些私有IP是跨主机不可达的。我们需要开启useBindPortIP参数，让Traefik转而使用容器绑定到Docker主机的公网/可路由IP和对应的NAT端口，这样流量就能正确转发了。

步骤1：确保远程Docker主机API可访问 #

首先得让Traefik能连到远程Docker的API。编辑Docker daemon的配置文件（比如/etc/docker/daemon.json），添加API监听：

{
  "hosts": ["unix:///var/run/docker.sock", "tcp://0.0.0.0:2375"]
}

重启Docker服务生效：

sudo systemctl restart docker

注意：生产环境一定要给Docker API加TLS加密，别用明文2375端口！后面会补充TLS配置。

步骤2：修改Traefik配置文件（traefik.toml） #

在Docker Provider部分添加关键配置，重点是useBindPortIP = true：

defaultEntryPoints = ["http"]

[entryPoints]
  [entryPoints.http]
  address = ":80"

# 远程Docker主机配置
[docker]
endpoint = "tcp://192.168.1.100:2375"  # 替换成你的远程Docker主机IP
watch = true
useBindPortIP = true  # 关键：改用Docker主机的绑定IP和端口
exposedByDefault = false  # 只处理标记了traefik.enable=true的容器
domain = "your-domain.com"  # 自定义域名后缀

# 可选：开启Traefik仪表盘方便调试
[api]
entryPoint = "traefik"
dashboard = true

步骤3：配置容器的Traefik标签 #

启动容器时，必须指定端口绑定（-p参数），并添加Traefik标签：

docker run -d \
  --name my-nginx-app \
  -p 192.168.1.100:8080:80 \  # 绑定Docker主机的8080端口到容器的80端口
  -l traefik.enable=true \
  -l traefik.port=80 \  # 容器内部的服务端口
  -l traefik.frontend.rule=Host:app.your-domain.com \  # 访问域名
  nginx:alpine

这样Traefik会自动识别容器绑定的192.168.1.100:8080，把app.your-domain.com的请求转发到这个地址。

生产环境安全补充：Docker API TLS加密 #

如果是生产环境，一定要给Docker API启用TLS。先生成证书，然后修改Docker daemon配置：

{
  "hosts": ["unix:///var/run/docker.sock", "tcp://0.0.0.0:2376"],
  "tls": true,
  "tlscacert": "/path/to/ca.pem",
  "tlscert": "/path/to/server-cert.pem",
  "tlskey": "/path/to/server-key.pem",
  "tlsverify": true
}

然后在Traefik的配置里添加TLS认证：

[docker.tls]
ca = "/path/to/ca.pem"
cert = "/path/to/client-cert.pem"
key = "/path/to/client-key.pem"

同时把endpoint改成tcp://<Docker主机IP>:2376。

验证配置 #

启动Traefik后，访问仪表盘（比如http://traefik-host:8080），查看后端服务的地址是不是远程Docker主机的IP加NAT端口。如果是的话，就可以通过配置的域名访问容器服务了。

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