Traefik ReplacePath配置一致但服务表现不同的问题求助

在Traefik中使用ReplacePath中间件时，两个配置几乎一致的服务表现完全不同，具体情况如下：

预期与实际表现 #

正常表现（nginx2服务） #

访问https://hostname/nginx2时：

• 浏览器URL保持不变
• 页面显示nginx对应不存在内容的错误页（符合预期）

异常表现（pihole服务） #

访问https://hostname/pihole时：

• 浏览器被重定向至https://hostname/admin（预期URL保持不变）
• 打开Traefik的404页面（预期显示Pi-hole提供的页面）

相关Docker Compose配置 #

两个服务仅名称不同，配置如下：

pihole:
  container_name: pihole
  image: pihole/pihole:latest
  ports:
    - "53:53/tcp"
    - "53:53/udp"
  environment:
    TZ: 'Europe/Warsaw'
    DNS1: 127.0.0.1
    DNS2: 9.9.9.9
  volumes:
    - './etc-pihole:/etc/pihole'
    - './etc-dnsmasq.d:/etc/dnsmasq.d'
    - '/etc/resolv.conf:/etc/resolv.conf'
  restart: unless-stopped
  labels:
    - "traefik.enable=true"
    - "traefik.http.routers.pihole.middlewares=pihole"
    - "traefik.http.middlewares.pihole.replacepath.path=/admin"
    - "traefik.http.routers.pihole.entrypoints=web,websecure"
    - "traefik.http.routers.pihole.rule=Path(`/pihole`)"
    - "traefik.http.routers.pihole.tls=true"
    - "traefik.http.routers.pihole.tls.certresolver=production"
    - "traefik.http.services.pihole.loadbalancer.server.port=80"
    - "traefik.port=80"

nginx2:
  image: nginx:latest
  labels:
    - "traefik.enable=true"
    - "traefik.http.routers.nginx2.middlewares=nginx2"
    - "traefik.http.middlewares.nginx2.replacepath.path=/admin"
    - "traefik.http.routers.nginx2.entrypoints=web,websecure"
    - "traefik.http.routers.nginx2.rule=Path(`/nginx2`)"
    - "traefik.http.routers.nginx2.tls=true"
    - "traefik.http.routers.nginx2.tls.certresolver=production"
    - "traefik.http.services.nginx2.loadbalancer.server.port=80"
    - "traefik.port=80"

问题原因及解决方法 #

问题出在Pi-hole自身的重定向逻辑，而非Traefik配置：

1. 当Traefik通过ReplacePath把/pihole替换为/admin转发给Pi-hole容器时，Pi-hole的Web服务会检查请求上下文，发现路径/admin与原始请求的前缀不匹配，主动返回301/302重定向到/admin。
2. 这个重定向是Pi-hole服务内部发出的，Traefik转发该响应后，浏览器URL跳转到/admin，而Traefik没有匹配/admin的路由规则，因此返回404。

解决办法 #

使用ReplacePathRegex中间件替代ReplacePath，同时修改路由规则为前缀匹配，确保路径替换后保留完整上下文，避免Pi-hole触发重定向：

修改pihole服务的Traefik标签：

# 替换原ReplacePath中间件为正则替换
- "traefik.http.middlewares.pihole.replacepathregex.regex=^/pihole(.*)"
- "traefik.http.middlewares.pihole.replacepathregex.replacement=/admin$1"
# 路由规则改为前缀匹配，覆盖所有子路径
- "traefik.http.routers.pihole.rule=PathPrefix(`/pihole`)"
# 可选：添加自定义头告知Pi-hole原始请求前缀，避免内部重定向
- "traefik.http.middlewares.pihole.headers.customrequestheaders.X-Forwarded-Prefix=/pihole"

核心逻辑：

• PathPrefix匹配所有以/pihole开头的请求，包括后续子路径
• ReplacePathRegex把/pihole/xxx完整替换为/admin/xxx，保留请求的路径信息
• 自定义头让Pi-hole识别原始请求的前缀，避免主动触发重定向

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