Nginx磁盘缓存与内存管理协同工作：keys_zone仅存元数据（如50m支持约5万key），levels=1:2防目录膨胀，max_size与inactive配合LRU清理，use_temp_path=off确保直写，SSD+合理cache_key提升动态资源缓存效率。
Nginx 缓存的磁盘存储与内存管理不是两个独立模块，而是协同工作的整体：内存负责快速索引和元数据管理，磁盘负责实际响应内容的持久化存储。配置不合理会导致缓存命中率低、I/O瓶颈或内存溢出。
磁盘缓存路径与空间策略
核心是 proxy_cache_path 指令，它定义缓存“存哪儿”和“怎么管”：
-
路径与层级：指定本地目录（如
/var/cache/nginx/prod），配合levels=1:2创建多级子目录结构，避免单目录文件过多引发 inode 或查找性能问题； -
keys_zone：例如
keys_zone=prod_cache:50m，这 50MB 是纯内存开销，只存缓存键（key）、状态、过期时间等元数据，不存响应体，大小需根据预计缓存 URL 数量估算（一般每万 key 占用约 1–1.5MB）； -
max_size：硬性限制磁盘总用量（如
max_size=20g），超出后 Nginx 自动按 LRU 清理最久未访问项； -
inactive：关键参数，比如
inactive=4h表示某缓存条目 4 小时内没被命中就淘汰，无论是否过期——这对冷热分离很实用； - use_temp_path=off：推荐关闭，让缓存文件直接写入目标目录，避免临时文件拷贝带来的额外 I/O 和锁竞争。
内存相关配置的真实作用
很多人误以为 Nginx 缓存本身能“用内存缓存响应体”，其实它不支持纯内存响应缓存（像 Redis 那样）。所谓“内存管理”主要体现在三方面：
- keys_zone 内存：如前所述，仅存索引信息，必须足量但不过量；太小会频繁淘汰 key，导致缓存失效；太大则浪费；
-
worker 进程内存池：通过
worker_processes auto和worker_rlimit_nofile合理分配系统资源，确保每个 worker 能高效处理并发请求与缓存元数据操作； -
临时缓冲区：
proxy_buffer_size、proxy_buffers、proxy_busy_buffers_size等控制代理响应读取过程中的内存暂存，影响大响应体的吞吐效率，但不改变缓存落盘行为。
动态资源缓存的磁盘优化要点
对 API、带参数的页面等动态内容，磁盘缓存仍可生效，但需注意：
-
缓存键设计要合理：默认
$scheme$proxy_host$request_uri会把 Cookie、UTM 参数等也纳入，容易造成缓存碎片。建议显式控制，例如：proxy_cache_key "$host$request_uri$is_args$args";（忽略 Cookie）或加入特定 header：proxy_cache_key "$host$request_uri$cookie_user_id";（按用户隔离）； -
区分状态码缓存时间：用
proxy_cache_valid分别设置，例如：proxy_cache_valid 200 302 5m;proxy_cache_valid 404 10s;（空结果也缓存短时间，防穿透）； -
启用缓存锁：
proxy_cache_lock on;防止相同未命中请求并发回源，减少后端压力； -
SSD 是刚需：HDD 在高并发小文件读写场景下易成瓶颈，尤其在
inactive触发批量清理时；建议使用 ext4/XFS 文件系统，并挂载时加noatime减少元数据更新。
清理与监控不能靠“rm -rf”解决所有问题
手动清空目录虽快，但有风险：正在读取的缓存文件可能被删，导致 500 或不完整响应。更稳妥的方式包括：
- 利用
proxy_cache_purge模块（需编译时启用）按 key 精准清除，例如配置location ~ /purge(/.*)实现接口触发； - 通过
inactive和max_size让 Nginx 自动回收，适合稳态服务； - 添加调试头：
add_header X-Cache-Status $upstream_cache_status;，值为HIT/MISS/EXPIRED/BYPASS，便于定位缓存是否真正生效； - 定期检查
du -sh /var/cache/nginx/prod和nginx -T | grep proxy_cache_path，确认配置已加载且路径权限正确（nginx 用户需有读写权限）。
