树莓派Docker部署Traefik Dashboard无法外部访问问题咨询

核心问题原因 #

• 配置文件未显式声明Dashboard默认使用的traefik入口点，导致insecure模式下的8080服务默认仅绑定容器内回环地址127.0.0.1，即使做了端口映射也无法响应外部请求
• Docker Compose启动参数与静态配置文件重复定义配置，存在优先级覆盖导致配置不生效的风险
• 树莓派Ubuntu默认开启的UFW防火墙未放行8080端口，拦截外部访问请求

修复步骤 #

1. 修正traefik.yml静态配置，显式定义8080端口入口，绑定所有网卡地址：

api:
  dashboard: true
  insecure:  true
entryPoints:
  http:
    address: ":80"
  # 新增Dashboard专用入口配置
  traefik:
    address: ":8080"
providers:
  docker:
    endpoint: "unix:///var/run/docker.sock"
    exposedByDefault: false

2. 精简docker-compose.yml配置，移除与配置文件重复的启动参数，避免配置冲突：

services:
  proxy:
    image: traefik
    networks:
      - traefik
    ports:
      - "80:80"
      - "8080:8080"
    command:
       - "--log.level=DEBUG"
       - "--configFile=/home/ubuntu/traefik/traefik.yml"
    volumes:
      - $PWD/traefik.yml:/home/ubuntu/traefik/traefik.yml
      - $PWD/acme.json:/home/ubuntu/traefik/acme.json
      - /var/run/docker.sock:/var/run/docker.sock
    restart: unless-stopped
networks:
  traefik:
    external:
      name: traefik

3. 配置防火墙规则放行8080端口，执行以下命令：

sudo ufw allow 8080/tcp
sudo ufw reload

4. 重启Traefik容器加载新配置：

docker compose down && docker compose up -d

验证方式 #

• 服务器本地执行curl http://127.0.0.1:8080返回正常响应后，在同局域网其他设备访问http://<树莓派服务器内网IP>:8080/dashboard/即可打开面板，注意路径末尾的斜杠不能省略。
• 注意：当前开启的insecure模式无身份校验，仅适合本地测试使用，若需公网暴露请额外配置身份认证或关闭insecure模式通过路由规则转发访问。

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