nginx通过proxy_ignore_headers忽略cache-control、expires、set-cookie、vary等干扰头，再由proxy_cache_valid显式设定缓存规则，从而收回缓存决策权；该指令须置于启用缓存的location块内、proxy_pass之前，且需同步配置proxy_hide_header防透传、x-cache-status验证生效。

直接用 proxy_ignore_headers 屏蔽后端返回的干扰响应头，再配合 proxy_cache_valid 显式设定缓存规则，Nginx 就能绕过错误指令、自主决定是否缓存、缓多久——这不是妥协，而是把缓存决策权收回到代理层。

必须忽略的关键响应头

后端常因框架默认、开发疏忽或历史兼容问题，对本该缓存的内容返回不合理指令。真正影响 Nginx 缓存行为的只有这几个头，需针对性忽略：

• Cache-Control：含 no-cache、no-store、private、max-age=0 时，Nginx 默认放弃缓存；忽略后，它就只认你写的 proxy_cache_valid
• Expires：服务端设成 1970-01-01 或过去时间，会强制跳过缓存；忽略后，Nginx 完全按本地规则执行
• Set-Cookie：哪怕只是埋点 ID 或匿名跟踪 Cookie，Nginx 默认拒缓存整条响应；确认响应体不含 session、token、用户字段后，可安全忽略
• Vary：当后端按 User-Agent 或 Accept-Encoding 返回不同值，会导致同一 URL 生成多份缓存（cache key 分裂）；若内容实际与这些字段无关，忽略可大幅提升命中率

配置必须写在正确位置

这个指令不生效，90% 是因为放错了地方：

aperture: the L402 aware reverse proxy

安装并运行 Aperture（Lightning Labs 的 L402 闪电反向代理），用于创建 L402 付费墙、配置付费 API 端点、为其他代理托管付费内容或测试 L402 认证流程。

下载

• 只在启用了缓存的 location 块中有效，不能放在 http 或 server 顶层（除非所有子 location 都明确启用缓存）
• 必须出现在 proxy_pass 之前，且紧邻缓存相关指令（如 proxy_cache、proxy_cache_valid）
• 多个头名用空格分隔，严格区分大小写：proxy_ignore_headers Cache-Control Set-Cookie Vary; ✅，cache-control 或 Set-cookie ❌

忽略之后，必须补上缓存策略

proxy_ignore_headers 只是“松绑”，不是“自动缓存”。你不告诉 Nginx 怎么缓，它就不会缓：

• 用 proxy_cache_valid 200 302 1h; 指定成功响应统一缓存 1 小时
• 对错误页单独控制：proxy_cache_valid 404 1m;（避免长期返回 404 加重后端压力）
• 若面向 CDN 或浏览器分发，建议加：add_header Cache-Control "public, max-age=3600" always;
• 同时加 proxy_hide_header Set-Cookie; 和 proxy_hide_header Cache-Control;，防止被忽略的干扰头透传给客户端

验证是否真生效了

别只看配置文件，要观察真实请求响应：

• 用 curl -I 请求同一 URL 两次：首次 X-Cache-Status: MISS，第二次 HIT
• 检查响应头中是否已无 Set-Cookie（说明 proxy_hide_header 生效）
• 确认原始 Cache-Control: no-cache 仍存在（说明 proxy_ignore_headers 起作用，只是不参与缓存判断）