proxy_cache_valid 才真正控制缓存时长,需显式声明各状态码的缓存时间(如200/302缓存1h、404缓存1m、5xx缓存10s),而proxy_ignore_headers仅忽略干扰响应头,不能替代其作用;必须配合proxy_cache_path定义缓存区、proxy_cache启用缓存,三者缺一不可。

只配 proxy_ignore_headers 不能决定缓存有效期,它只是“不看后端写的过期时间”,真正控制缓存时长的是 proxy_cache_valid。你需要用它明确告诉 Nginx:哪些响应码、缓存多久。
必须配 proxy_cache_valid 才算真正掌控时间
忽略上游头只是清除了干扰,Nginx 不会自动给你设缓存时间。你得显式声明:
-
proxy_cache_valid 200 302 1h;→ 成功响应统一缓存 1 小时 -
proxy_cache_valid 404 1m;→ 404 页面缓存 1 分钟,防高频探测拖垮后端 -
proxy_cache_valid 500 502 503 504 10s;→ 错误页短缓存,避免雪崩
proxy_ignore_headers 要忽略哪些头才不影响时间判断
这些头如果存在且不合理,会直接覆盖或否决你的 proxy_cache_valid:
-
Cache-Control: no-cache或max-age=0→ Nginx 默认跳过缓存 -
Expires: Thu, 01 Jan 1970 00:00:00 GMT→ 被视为已过期,拒绝写入 -
Set-Cookie→ 即使只是埋点 ID,Nginx 默认禁用缓存
所以典型写法是:proxy_ignore_headers Cache-Control Expires Set-Cookie;
安装并运行 Aperture(Lightning Labs 的 L402 闪电反向代理),用于创建 L402 付费墙、配置付费 API 端点、为其他代理托管付费内容或测试 L402 认证流程。
时间生效的前提:缓存区和 location 都得配对
光有上面两步还不够,缺一不可:
- 在
http块中已定义缓存区:proxy_cache_path /var/cache/nginx/mycache levels=1:2 keys_zone=mycache:10m max_size=1g; - 在对应
location中启用它:proxy_cache mycache; -
proxy_ignore_headers和proxy_cache_valid必须写在同一个location块内,且都在proxy_pass之前
让浏览器也按你定的时间走
proxy_ignore_headers 只影响 Nginx 自身缓存逻辑,不影响客户端。要让浏览器也遵守你的有效期,得额外注入:
add_header Cache-Control "public, max-age=3600" always;- 同时加
proxy_hide_header Cache-Control;,防止后端的no-cache透传过去造成冲突
这样,Nginx 按 proxy_cache_valid 缓存,浏览器按你注入的 Cache-Control 执行本地缓存。

















