如何配置Traefik实现带前缀的无感知后端响应重写？

问题背景 #

外部访问入口为 https://my.tld/customprefix，后端应用监听根路径 / 且未感知前缀。需实现：

• 入站请求剥离 /customprefix 前缀转发给后端
• 后端响应中的重定向（如 /login）改为 /customprefix/login
• 响应体中的资源路径（如 /style.css）改为 /customprefix/style.css
• 后端设置的 Cookie 路径从 / 改为 /customprefix

Traefik 默认的 StripPrefix 仅处理入站请求，需组合多个中间件完成全链路改写。

核心配置方案 #

以下配置基于 Traefik v2.x（v3.x 仅需微调中间件语法），以文件配置为例：

1. 启用响应体改写插件（如需处理响应体资源路径） #

若需修改响应体中的资源链接，需启用官方社区插件。在 traefik.yml 中添加静态配置：

experimental:
  plugins:
    modifyResponseBody:
      moduleName: github.com/traefik/plugin-modify-response-body
      version: v0.2.1

2. 定义中间件（动态配置，如 dynamic.yml） #

http:
  middlewares:
    # 剥离请求前缀：将 /customprefix/* 转为 /* 转发给后端
    strip-customprefix:
      stripPrefix:
        prefixes:
          - "/customprefix"
        forceSlash: false

    # 改写 Cookie 路径：将后端返回的 Cookie 路径从 / 改为 /customprefix
    rewrite-cookie-path:
      headers:
        cookiePath: "/customprefix"

    # 改写重定向 Location 头：替换根路径开头的地址为带前缀的路径
    rewrite-redirect-location:
      replaceRegex:
        regex: "^(https?://my\\.tld)?/(.*)$"
        replacement: "$1/customprefix/$2"
        headers:
          - Location

    # 改写响应体资源路径：匹配 href/src/action 等属性中的根路径链接
    rewrite-response-body:
      plugin:
        modifyResponseBody:
          replacements:
            - regex: '(href|src|action|link)="(/[^"]*)"'
              replacement: '$1="/customprefix$2"'

3. 路由关联中间件 #

将上述中间件按顺序绑定到目标路由，确保请求和响应的处理链路正确：

http:
  routers:
    my-app-router:
      rule: "Host(`my.tld`) && PathPrefix(`/customprefix`)"
      entryPoints:
        - websecure # 对应 SSL 终止的入口
      tls: {} # 根据实际配置证书（如 ACME 自动签发）
      middlewares:
        - strip-customprefix
        - rewrite-cookie-path
        - rewrite-redirect-location
        - rewrite-response-body
      service: my-app-service

  services:
    my-app-service:
      loadBalancer:
        servers:
          - url: "http://your-backend:8080" # 后端应用的实际地址

关键说明 #

• 中间件顺序：必须先剥离请求前缀，再处理响应改写，确保逻辑链路正确
• 正则调整：响应体替换的正则可根据实际页面资源属性扩展（如添加 data-src 等自定义属性）
• Traefik v3 适配：v3 中 ReplaceRegex 中间件的语法略有调整，需参考官方文档更新正则匹配规则
• SSL 配置：若使用 ACME 自动证书，需在静态配置中启用 certificatesResolvers

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