Nginx本地缓存

一、前言：为什么需要 Nginx 本地缓存？

你是否面临这些痛点？

• ❌ 后端服务压力大，大量重复请求打到应用层
• ❌ 静态资源（图片、JS、CSS）频繁回源
• ❌ 接口响应慢，用户体验差
• ❌ 后端宕机时，整个服务不可用

Nginx 本地缓存（proxy_cache）是官方提供的服务端缓存机制，它能：
✅将后端响应缓存到本地磁盘或内存
✅相同请求直接返回缓存，绕过后端
✅实现“缓存托底”——后端挂了也能返回旧数据

本文将带你从零配置proxy_cache，并提供生产级最佳实践。

二、核心原理：proxy_cache 如何工作？

💡关键点：

• 缓存存储在本地磁盘（可配置内存）
• 缓存键（key）默认基于$scheme$proxy_host$request_uri
• 支持按状态码、Header 控制是否缓存

三、基础配置：5 步开启 Nginx 缓存

步骤 1：定义缓存区域（http 块）

http { # 定义缓存路径和参数 proxy_cache_path /var/cache/nginx levels=1:2 # 目录层级（防单目录文件过多） keys_zone=my_cache:100m # 共享内存区名:大小（存放 key 和元数据） inactive=60m # 60分钟未访问则删除 max_size=10g # 磁盘最大缓存大小 use_temp_path=off; # 直接写入缓存目录，避免临时文件拷贝 # 创建缓存目录并授权 # mkdir -p /var/cache/nginx && chown -R nginx:nginx /var/cache/nginx }

🔍参数详解：

• levels=1:2：生成两级子目录（如/a/bc/abcdef...），避免单目录 inode 耗尽
• keys_zone：1MB 内存约可存 8000 个 key
• use_temp_path=off：必须关闭，否则性能下降 30%+

步骤 2：在 server/location 启用缓存

server { listen 80; server_name api.example.com; location / { # 启用缓存，使用名为 my_cache 的区域 proxy_cache my_cache; # 设置缓存 key（可自定义） proxy_cache_key "$host$request_uri"; # 哪些状态码响应可以被缓存 proxy_cache_valid 200 302 10m; proxy_cache_valid 404 1m; proxy_cache_valid any 5m; # 透传 Host 和真实 IP proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_pass http://backend; } }

步骤 3：定义上游服务

upstream backend { server 10.0.0.10:8080; server 10.0.0.11:8080; }

四、高级配置：精准控制缓存行为

4.1 自定义缓存 Key

# 按用户 ID + URL 缓存（个性化内容） proxy_cache_key "$host|$request_uri|$cookie_user_id"; # 忽略查询参数中的 token（避免缓存爆炸） proxy_cache_key "$host|$uri";

4.2 缓存状态透传（用于监控）

# 添加缓存状态头 add_header X-Cache-Status $upstream_cache_status; # 可能的值： # - MISS：未命中 # - HIT：命中 # - EXPIRED：过期（正在更新） # - BYPASS：强制跳过缓存

4.3 强制跳过缓存（调试用）

# 请求带 nocache=1 时不走缓存 if ($arg_nocache = "1") { set $nocache "1"; } proxy_cache_bypass $nocache; proxy_no_cache $nocache;

五、生产级最佳实践

5.1 缓存托底（后端宕机时返回旧数据）

location /api/ { proxy_cache my_cache; proxy_cache_valid 200 5m; # 即使后端返回 5xx，也允许使用过期缓存 proxy_cache_use_stale error timeout updating http_500 http_502 http_503 http_504; # 后端挂了？直接返回 stale（过期但可用）缓存 proxy_cache_background_update on; # 后台更新缓存 proxy_pass http://backend; }

✅效果：

• 后端宕机 → 用户仍能看到最近一次有效数据
• 服务 SLA 从 99% 提升至99.99%

5.2 性能优化建议

5.3 清理缓存（Purging）

Nginx 开源版不支持 PURGE，可通过删除文件 + reload实现：

# 删除特定 URL 缓存（需知道 key 的哈希值） rm -f /var/cache/nginx/a/bc/abcdef123456... # 或清空整个缓存 rm -rf /var/cache/nginx/* nginx -s reload

💡企业方案：使用 Nginx Plus 的proxy_cache_purge指令。

六、验证与监控

6.1 检查缓存是否生效

curl -I http://api.example.com/user/profile # 查看响应头 # X-Cache-Status: HIT

6.2 监控缓存指标

# 查看缓存目录大小 du -sh /var/cache/nginx # 统计缓存文件数 find /var/cache/nginx -type f | wc -l # 日志记录缓存状态（access_log） log_format cache '$remote_addr - $upstream_cache_status [$time_local] ' '"$request" $status $body_bytes_sent'; access_log /var/log/nginx/cache.log cache;

七、常见问题排查

八、结语

感谢您的阅读！如果你有任何疑问或想要分享的经验，请在评论区留言交流！