Nginx中proxy_cache指令实现反向代理层级缓存教程-Nginx-PHP中文网

Nginx的proxy_cache是一组协同工作的指令机制，用于反向代理层高效缓存HTTP响应；需先在http块配置proxy_cache_path定义缓存区，再在location中用proxy_cache和proxy_cache_valid启用并控制缓存，通过proxy_cache_key定制缓存键，并借助X-Cache-Status等调试验证行为。

nginx中proxy_cache指令实现反向代理层级缓存教程

在 Nginx 中，proxy_cache 不是单个指令，而是由一组缓存相关指令协同工作的机制，用于在反向代理层实现高效、可控的 HTTP 响应缓存。它不依赖后端应用，能显著降低源站压力、提升响应速度，并支持细粒度的缓存策略控制。

一、基础缓存区域配置（proxy_cache_path）

缓存功能的前提是定义一个本地磁盘上的缓存存储区域：

proxy_cache_path 必须写在 http 块中，不能放在 server 或 location 内
关键参数包括：path（缓存目录）、keys_zone（共享内存区名和大小，如 my_cache:10m）、max_size（磁盘上限）、inactive（未被访问多久后自动清理）
示例：
proxy_cache_path /var/cache/nginx/my_cache keys_zone=my_cache:10m max_size=1g inactive=60m use_temp_path=off;
其中 use_temp_path=off 推荐启用，避免多一次文件移动开销

二、启用并绑定缓存到 location（proxy_cache + proxy_cache_valid）

在具体 location 块中启用缓存，并设定不同状态码的缓存时长：

proxy_cache my_cache：指定使用上面定义的 keys_zone 名称
proxy_cache_valid 按响应状态码设置过期时间，例如：
proxy_cache_valid 200 302 10m;
proxy_cache_valid 404 1m;
proxy_cache_valid any 1m;
注意：any 是兜底规则，但不会覆盖已明确声明的状态码规则
建议配合 proxy_cache_use_stale 提升可用性，例如网络波动时仍可返回过期缓存：
proxy_cache_use_stale error timeout updating http_500 http_502 http_503 http_504;

三、缓存键与个性化控制（proxy_cache_key）

默认缓存键是 $scheme$proxy_host$request_uri，但常需排除干扰因素（如 Cookie、特定参数）或加入变量以支持多终端/灰度：

用 proxy_cache_key 自定义键值，例如忽略会话 Cookie 和 UTMs：
proxy_cache_key "$scheme$host$request_uri $http_accept_language";
若需区分移动端与 PC 端，可加入 $http_user_agent 的简单标识（注意控制长度）：
proxy_cache_key "$scheme$host$request_uri $arg_v $mobile_flag";
配合 map 指令提取 $mobile_flag
慎用完整 $cookie_* 或 $args，易导致缓存碎片化、命中率骤降

四、调试与验证缓存行为

上线前必须确认缓存是否按预期工作：

在响应头中添加 X-Cache-Status 方便调试：
add_header X-Cache-Status $upstream_cache_status;
可见值包括 HIT、MISS、BYPASS、EXPIRED、STALE 等
检查 Nginx 错误日志是否报 cache manager process ... exited on signal 11 等异常（常见于 keys_zone 太小或路径不可写）
用 curl -I 多次请求同一资源，观察 X-Cache-Status 和 Age 响应头变化
手动清理某类缓存可用 proxy_cache_purge（需启用 ngx_http_proxy_cache_purge_module，通常需编译安装）