通过Traefik按路径转发端口：家中Portainer无法访问问题排查

问题根源 #

你当前的Traefik配置用了PathPrefix(/portainer)，这个规则会把完整的请求路径（比如/portainer/login）直接转发给家用的Portainer服务器，但Portainer默认只监听根路径/，它识别不了/portainer开头的请求，所以返回404。

方案一：用Traefik路径剥离（推荐） #

修改动态配置文件/etc/traefik/conf.d/config.yml，把路由规则里的PathPrefix换成PathPrefixStrip，这样Traefik会自动去掉/portainer前缀再转发请求：

http:
  routers:
    portainer-router:
      rule: PathPrefixStrip(`/portainer`)  # 替换成PathPrefixStrip
      service: portainer-service

  services:
    portainer-service:
      loadBalancer:
        servers:
          - url: http://10.0.0.4:9000/
        passHostHeader: false

修改后重启Traefik容器：

docker restart traefik

再访问http://<你的VPS公网IP>/portainer就能正常打开Portainer了。

方案二：调整Portainer运行路径 #

如果不想改Traefik配置，也可以让Portainer本身运行在/portainer子路径下：

1. 先停掉现有Portainer：

docker stop portainer && docker rm portainer

2. 带--path参数重新启动：

docker run -d -p 9000:9000 \
  --name portainer \
  --restart=always \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v portainer_data:/data \
  portainer/portainer-ce:latest --path /portainer

保持原Traefik配置不变，访问同样的地址就能正常使用。

额外排查点 #

• 确认VPS的80端口在防火墙/安全组里是开放状态
• 家用Ubuntu Server的9000端口没有被本地防火墙（比如ufw）拦截
• 在VPS上执行curl http://10.0.0.4:9000，确认能拿到Portainer的页面源码，确保网络连通没问题

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