proxy_ignore_headers 用于让 Nginx 完全忽略上游响应中的 Expires、Cache-Control、Set-Cookie、Vary 等头字段，从而为手动设置强缓存策略（如 expires 1y 或 add_header Cache-Control）扫清障碍，特别适用于静态资源缓存。
proxy_ignore_headers 不是用来“重写”缓存头的，而是让 Nginx **完全忽略**上游（如后端服务器、静态文件服务）返回的某些响应头字段，包括 Expires、Cache-Control、Set-Cookie 等。它本身不修改头，但为后续手动设置缓存策略（比如用 add_header 或 expires）扫清障碍——因为一旦 Nginx 读到上游的 Cache-Control: no-cache，默认就不会缓存；而忽略它之后，你才能按需强制缓存静态资源。
哪些缓存头会被影响？
该指令可忽略以下标准响应头（大小写不敏感）：
-
Expires：决定绝对过期时间 -
Cache-Control：控制缓存行为（如no-cache、max-age=0、private） -
Set-Cookie：Nginx 默认不缓存带此头的响应（因涉及用户状态），忽略后才可能缓存 -
Vary：影响缓存键（cache key）的构成，忽略后 Nginx 不再按其值区分缓存版本 -
X-Accel-Expires、X-Accel-Redirect、X-Accel-Limit-Rate、X-Accel-Buffering、X-Accel-Charset：属于 Nginx 内部控制头，一般由后端应用注入
为什么对静态资源缓存特别关键？
常见场景：前端构建产物（JS/CSS/图片）由 Node.js 服务或 Python 应用托管，但这些服务出于开发习惯或框架默认，返回 Cache-Control: no-cache 或 max-age=0。若不忽略，Nginx 的 proxy_cache 将拒绝缓存这些响应，哪怕它们实际是不可变的（如文件名含哈希：app.a1b2c3.js）。
正确做法是：
- 在 location 块中启用
proxy_ignore_headers Cache-Control Expires - 再用
expires 1y或add_header Cache-Control "public, immutable, max-age=31536000"主动注入强缓存策略 - 确保
proxy_cache_valid对应状态码（如200 302）设置了合理缓存时长
典型配置示例
假设你用 Nginx 反向代理一个提供静态资源的 Express 服务（它默认加了 Cache-Control: no-cache）：
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
upstream static_backend {
server 127.0.0.1:3000;
}
<p>proxy_cache_path /var/cache/nginx/static_cache levels=1:2 keys_zone=static:10m max_size=1g;</p><p>server {
location ~* .(js|css|png|jpg|jpeg|gif|ico|svg|woff2?)$ {
proxy_pass <a href="https://www.php.cn/link/bbba677a7830a14343512ae9637e3879">https://www.php.cn/link/bbba677a7830a14343512ae9637e3879</a>;
proxy_cache static;
proxy_cache_valid 200 302 1y;
proxy_cache_valid 404 1m;</p><pre class="brush:php;toolbar:false;"> # 关键：忽略上游的干扰缓存头
proxy_ignore_headers Cache-Control Expires;
# 强制覆盖为长期公共缓存
expires 1y;
add_header Cache-Control "public, immutable, max-age=31536000";
# 可选：避免 Vary 头导致缓存碎片化
proxy_ignore_headers Vary;
add_header Vary "Accept-Encoding";
}}
注意：expires 指令会自动设置 Expires 和 Cache-Control，优先级高于上游头（前提是已用 proxy_ignore_headers 屏蔽掉原始头）。
容易踩的坑
-
proxy_ignore_headers必须写在location或server块内，不能放在http全局块（语法错误） - 忽略
Set-Cookie后若仍缓存含敏感 Cookie 的响应，可能引发安全或状态混乱，仅适用于确认上游不会返回真实 Cookie 的静态资源路径 - 忽略
Vary后，所有用户请求（无论Accept-Encoding如何）将共享同一缓存副本；若需支持 gzip/br 压缩，应在add_header Vary中显式声明，而非依赖上游 - 该指令不影响 Nginx 自身生成的头（如
X-Proxy-Cache），也不改变proxy_cache_bypass或proxy_no_cache的逻辑
