nginx默认过滤Set-Cookie、Expires、Cache-Control（含private等）、Location等响应头，proxy_pass_header用于解除对这些头的屏蔽以透传，需配合proxy_redirect重写绝对路径，并关闭nginx自动添加的缓存头。
nginx 默认会过滤掉一些被认为“不安全”或“不适用于代理场景”的响应头，比如 Set-Cookie、Expires、Cache-Control（部分情况）、Location（重定向时路径未重写）等。当后端服务设置了这些头，但前端 nginx 反向代理没透传，就可能导致登录失效、缓存异常、跳转路径错误等问题。
proxy_pass_header 的作用与限制
proxy_pass_header 用于显式启用原本被 nginx 屏蔽的响应头透传。它不是“添加头”，而是“解除屏蔽”。注意：它只对 nginx 默认过滤的头生效，对普通自定义头无效（那些本就不被过滤）。
- 默认被过滤的常见头包括：
Set-Cookie、Expires、Cache-Control（当值含private或no-cache等敏感指令时）、Server、X-Accel-*系列 - 该指令必须写在
location或server块中，且仅对当前作用域生效 - 不能用它传递请求头（那是
proxy_set_header的职责）
强制透传 Set-Cookie 和 Location 的典型配置
后端返回带 Set-Cookie 或绝对路径 Location 时，常因未透传导致 Cookie 丢失或跳转到后端地址。需在 proxy location 中明确放行：
location /api/ {
proxy_pass http://backend;
proxy_pass_header Set-Cookie;
proxy_pass_header Location;
# 若后端 Location 是绝对路径（如 http://internal:8080/login），还需重写为相对或前端域名路径
proxy_redirect http://internal:8080/ https://example.com/;
}
⚠️ 注意：proxy_pass_header Location 仅让 nginx 不丢弃该头；若值为绝对 URL，通常还需配合 proxy_redirect 重写路径，否则浏览器会跳转到后端地址。
处理 Cache-Control 和 Expires 的透传逻辑
nginx 默认会清除后端返回的 Expires 和部分 Cache-Control（如含 private），以避免缓存敏感内容。若你确认后端已正确控制缓存策略，可强制透传：
location /static/ {
proxy_pass http://cdn_backend;
proxy_pass_header Expires;
proxy_pass_header Cache-Control;
# 同时建议关闭 nginx 自动添加的过期头，避免冲突
expires off;
add_header Cache-Control "" off;
}
这样后端返回的 Cache-Control: public, max-age=3600 就能原样到达客户端。
验证是否生效的实用方法
配置完成后，别只信日志。用 curl 直接比对：
- 直连后端：
curl -I http://backend:8080/endpoint，记下响应头 - 走 nginx：
curl -I https://example.com/endpoint，对比关键头是否存在且值一致 - 若仍缺失，检查是否写在了错误的作用域（例如写在
http块却期望在location生效），或被其他模块（如proxy_hide_header）覆盖
不复杂但容易忽略。
