Traefik添加自定义响应头仅部分生效问题求助

问题根因汇总 #

1. HTTPS路由未绑定header处理中间件：你定义的https-redirect中间件仅绑定到了HTTP的nginx路由（该路由仅负责跳转至HTTPS，不处理实际业务请求），处理业务请求的nginx-httpsHTTPS路由没有绑定任何加自定义响应头的中间件，导致你配置的自定义响应头完全没作用到实际业务响应上。
2. 全局中间件未生效：traefik.yaml中定义的all-sites全局安全中间件没有绑定到入口点或对应路由，配置完全闲置。
3. 中间件命名冲突：同时定义了https_redirect（下划线命名）和https-redirect（中划线命名）两个功能重复的跳转中间件，逻辑混乱容易引发配置匹配错误。
4. 未配置头覆盖规则：Traefik默认不会主动覆盖下游服务返回的响应头，下游Nginx、PHP服务返回的Server: nginx、X-Powered-By: PHP/7.4.21会覆盖或和Traefik配置的头共存。
5. 配置拼写错误：traefik.yaml中rateLimit的brust拼写错误（正确为burst），sslRedirec拼写错误（正确为sslRedirect），导致配置加载异常。
6. Nginx add_header继承问题：Nginx的add_header规则不继承上层块配置，如果你的站点有单独location块配置了自定义header，server块下定义的公共header会在该location下完全失效，这是部分资源头不生效的核心原因。

修复方案 #

1. 修正Traefik路由中间件绑定

在docker-compose.yml的labels中新增HTTPS路由的中间件绑定配置：

# 给HTTPS业务路由绑定自定义header中间件和全局安全中间件
- 'traefik.http.routers.nginx-https.middlewares=https-redirect@docker,all-sites@file'

如果要让全局安全中间件自动对所有路由生效，可在traefik.yaml的入口点配置中新增默认中间件绑定：

entryPoints:
  http:
    address: ":80"
    http:
      middlewares:
        - all-sites@file
  https:
    address: ":443"
    http:
      middlewares:
        - all-sites@file

2. 清理重复中间件、补充头覆盖规则

删除重复的https_redirect（下划线命名）中间件配置，修改https-redirect中间件配置，先删除下游返回的敏感头再添加自定义头：

# 先删除下游返回的服务标识头
- 'traefik.http.middlewares.https-redirect.headers.removeHeaders=Server,X-Powered-By'
# 再覆盖为自定义头
- 'traefik.http.middlewares.https-redirect.headers.customResponseHeaders.Server=PHP'
- 'traefik.http.middlewares.https-redirect.headers.customResponseHeaders.X-Powered-By=PHP'
- 'traefik.http.middlewares.https-redirect.headers.customResponseHeaders.Set-Cookie=Path=/; HttpOnly; Secure'
- 'traefik.http.middlewares.https-redirect.headers.customResponseHeaders.HTTPServer=PHP'

3. 修正traefik.yaml拼写错误

rateLimit:
  average: 100
  burst: 50 # 原brust改为burst
# ...
headers:
  # ...
  sslRedirect: true # 原sslRedirec改为sslRedirect

4. Nginx端优化（可选，推荐）

如果选择统一在Traefik层管理所有响应头，可删除Nginx中所有add_header配置，避免两边配置冲突。如果要保留Nginx侧的header配置，需要给所有自定义location块重复添加需要的公共header，或者安装headers-more模块强制全局生效：

# 需先安装headers-more模块
more_set_headers 'Server: PHP';
more_clear_headers 'X-Powered-By';

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