Traefik V2 redirect-regex中间件捕获组变量未展开问题求助

问题根源 #

1. $符号解析逻辑差异：Toml配置文件中$可直接用于捕获组，但Docker标签是通过Shell环境传递，未转义的$会被Shell提前解析，导致Traefik收到的是${1}而非实际捕获值。
2. 正则匹配精度不足：若正则未精准限定“单个路径元素无尾斜杠”的场景，会导致捕获组失效或匹配范围不符合需求。

正确配置方案 #

1. Dynamic Conf（dynamic_conf.toml）通用中间件 #

直接编写Toml配置，无需转义$，正则精准匹配目标路径：

[http.middlewares]
  [http.middlewares.add-trailing-slash.redirectRegex]
    regex = "^https?://([^/]+)/([^/]+)$"
    replacement = "${1}/${2}/"
    permanent = true
    regexCaseSensitive = false

• 正则说明：^https?://([^/]+)/([^/]+)$仅匹配域名后单个路径段且无尾斜杠的请求，捕获组1为域名，捕获组2为目标路径段。
• 替换规则：将匹配到的请求重定向为带尾斜杠的格式，如https://domain.tld/dockerservice → https://domain.tld/dockerservice/。

2. Docker标签配置（适配GitLab Runner部署场景） #

由于Docker标签会被Shell解析，需对$做转义处理，两种方式任选：

方式一：双引号包裹，$转义为$$

traefik.http.middlewares.add-trailing-slash.redirectregex.regex="^https?://([^/]+)/([^/]+)$"
traefik.http.middlewares.add-trailing-slash.redirectregex.replacement="$${1}/$${2}/"
traefik.http.middlewares.add-trailing-slash.redirectregex.permanent="true"

方式二：单引号包裹，避免Shell解析$

traefik.http.middlewares.add-trailing-slash.redirectregex.regex='^https?://([^/]+)/([^/]+)$'
traefik.http.middlewares.add-trailing-slash.redirectregex.replacement='${1}/${2}/'
traefik.http.middlewares.add-trailing-slash.redirectregex.permanent='true'

给目标服务绑定中间件：

traefik.http.routers.dockerservice.middlewares=add-trailing-slash@docker

3. 验证与调试 #

• 确认正则匹配范围：仅对https://domain.tld/dockerservice生效，对https://domain.tld/dockerservice/page（多路径段）、https://domain.tld/dockerservice/（已有尾斜杠）不触发跳转。
• 通过Traefik Dashboard查看中间件配置是否正确加载，或开启traefik --log.level=DEBUG查看请求处理日志，验证正则匹配与替换逻辑。

额外注意事项 #

• 路由的PathPrefix规则保持为/dockerservice，无需添加尾斜杠，让中间件完成跳转后再由Traefik转发至MkDocs服务。
• 若使用链式中间件，确保add-trailing-slash优先级最高，避免其他中间件修改路径导致正则失效。

内容的提问来源于stack exchange，提问作者exa.byte