配置 nginx 反向代理缓存的核心在于定义 proxy_cache_path 存储路径并启用 proxy_cache。需要在 http 块中设置磁盘目录、内存大小和过期时间,在 location 块中开启缓存开关并指定缓存区域名称。这样 nginx 会根据响应头自动管理缓存文件的存储与更新。

如何定义全局缓存存储路径?
必须在 http 上下文中使用 proxy_cache_path 指令来定义缓存数据的存放位置。该指令需要指定本地文件系统的路径、共享内存区域的大小以及缓存键的匹配规则。如果未正确设置,Nginx 启动时会报错或无法写入缓存文件。

http {
# 定义缓存路径:/var/cache/nginx
# keys_zone: 内存区域名 my_cache,大小 10m
# max_size: 磁盘最大占用 1g
# inactive: 60分钟未被访问则删除
proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=my_cache:10m max_size=1g inactive=60m use_temp_path=off;
server {
listen 80;
server_name example.com;
location / {
proxy_pass http://backend_server;
proxy_cache my_cache;
proxy_cache_valid 200 304 10m;
add_header X-Cache-Status $upstream_cache_status;
}
}
}上述配置中,levels=1:2 表示缓存目录层级结构,keys_zone 定义了用于存储缓存键的共享内存区域。use_temp_path=off 确保原子性写入,避免读取到不完整的缓存文件。实际运行时,需确保 Nginx 用户(通常是 www-data 或 nginx)对 /var/cache/nginx 目录有读写权限。
如何在 Location 中启用并控制缓存行为?
在 location 块中通过 proxy_cache 指令引用之前定义的内存区域即可启用缓存。配合 proxy_cache_valid 可以针对不同 HTTP 状态码设置不同的缓存有效期。此外,$upstream_cache_status 变量可用于调试,查看当前请求是否命中缓存。

server {
listen 80;
server_name example.com;
location /api/ {
proxy_pass http://backend_api;
proxy_cache my_cache;
# 仅缓存 200 和 301 响应,有效期 5 分钟
proxy_cache_valid 200 301 5m;
# 添加头部显示缓存状态:HIT, MISS, EXPIRED
add_header X-Cache-Status $upstream_cache_status;
# 忽略客户端的 Cache-Control: no-cache
proxy_ignore_headers Cache-Control Set-Cookie;
}
}在此配置中,proxy_cache_valid 明确指定了哪些状态码可以被缓存以及存活时间。proxy_ignore_headers 允许 Nginx 忽略后端服务器返回的禁止缓存指令,强制进行缓存。这对于静态资源或 API 响应头配置不当的场景非常有用。若后端返回 Set-Cookie,默认情况下 Nginx 不会缓存该响应,除非显式忽略。
当后端返回 404 时缓存会如何处理?
默认情况下,Nginx 不会缓存 404 Not Found 响应,因为 proxy_cache_valid 默认只包含 200, 301, 302, 404 和 405 中的部分状态码,且通常建议单独处理错误页面。如果希望缓存 404 以防止缓存穿透,需要显式配置 proxy_cache_valid 404 1m。否则,每次请求不存在资源都会直接转发到后端。
# 在 location 块中添加以下行 proxy_cache_valid 404 1m;
此配置会将 404 响应缓存 1 分钟。在此期间,相同 URL 的请求将直接返回缓存的 404 页面,不再向后端发起请求。这有助于减轻后端压力,但需注意不要过度缓存错误页面,以免掩盖临时故障。验证方法是通过 curl 请求一个不存在的 URL,观察首次为 MISS,随后几次为 HIT,直到缓存过期。


















