Nginx proxy_cache

定义

proxy_cache 是 Nginx 反向代理模块自带的响应缓存功能:将上游(upstream)返回的内容按缓存键存到本地磁盘,元数据放在共享内存区,后续请求直接由 Nginx 返回,免去回源。

配置要点

核心指令包括 proxy_cache_path(定义缓存目录、keys_zone 共享内存、最大容量与 inactive 时间)、proxy_cache_key(默认由 scheme、host、URI 组成)、proxy_cache_valid(按状态码设定缓存时长)。响应中的 Cache-Control、Expires 头默认会影响缓存行为。

进阶特性

proxy_cache_lock 让同一键的并发未命中只放行一个请求回源,缓解缓存击穿;proxy_cache_use_stale 允许在源站出错或更新时先返回过期内容;proxy_cache_purge(商业版或第三方模块)支持主动清除;还可通过 proxy_cache_bypass、proxy_no_cache 精细控制绕过与不缓存条件。

应用

它是自建小型 CDN、静态化接口加速、图片缩略图缓存等场景的常见方案,配合 X-Cache 类自定义头可观察 HIT/MISS 命中情况。