proxy_cache_path 配置中 max_size 参数如何触发自动清理
在 nginx 的 proxy_cache_path 指令中设置 max_size 参数，nginx 会自动管理缓存目录的磁盘空间。当缓存大小超过设定的阈值时，nginx 会启动后台清理机制，删除最久未使用的缓存文件，直到空间回落到限制范围内。
worker_processes 1;
http {
# 定义缓存路径、名称和最大容量为 1G
proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=my_cache:10m max_size=1g inactive=60m;
server {
listen 80;
server_name example.com;
location / {
proxy_pass http://backend;
# 启用缓存并关联上面定义的 zone
proxy_cache my_cache;
proxy_cache_valid 200 302 10m;
proxy_cache_valid 404 1m;
}
}
}
上述配置中，/var/cache/nginx 是缓存存储的实际目录。levels=1:2 指定了缓存文件的层级结构，有助于提高文件系统性能。keys_zone=my_cache:10m 定义了共享内存区域，用于存储缓存键和元数据。max_size=1g 是关键参数，它限制了该缓存路径下所有文件的总大小上限。inactive=60m 表示如果缓存文件在 60 分钟内未被访问，即使未达到 max_size 限制，也会被清理。当 Nginx 尝试写入新缓存且当前大小已超过 1GB 时，它会选择删除 LRU（最近最少使用）的文件来腾出空间。
Nginx 缓存清理机制的工作原理与触发条件
Nginx 的缓存清理不是实时的，而是由专门的缓存管理器进程异步执行的。这个进程定期检查缓存目录的大小，并在需要时进行清理。这种设计避免了在主工作进程处理请求时产生额外的 I/O 开销。
# 查看缓存目录使用情况 du -sh /var/cache/nginx # 手动触发清理（通过信号或脚本） # Nginx 没有内置的“立即清理”命令，但可以通过以下方式间接实现： # 1. 重启 Nginx 服务（不推荐生产环境频繁操作） # 2. 编写脚本定期删除旧文件 # 3. 调整 max_size 为一个较小的值，迫使 Nginx 快速清理
理解这一机制对于排查问题至关重要。例如，如果你发现磁盘空间并未立即释放，可能是因为缓存管理器尚未运行清理任务。此外，max_size 的单位可以是 k、m、g 或 t。如果未设置 max_size，Nginx 将不会自动清理缓存，仅依赖 inactive 参数进行过期清理。这意味着在高并发写入场景下，如果不设置 max_size，缓存目录可能会无限增长直至占满磁盘。
当缓存目录达到 max_size 上限时具体删除哪些文件
当缓存目录大小超过 max_size 设定的阈值时，Nginx 的缓存管理器会优先删除那些最近最少被访问（LRU, Least Recently Used）的缓存文件。这是为了确保最常用的内容仍然保留在高速缓存中，从而优化整体命中率。
# 模拟测试：创建一个小的缓存路径进行测试
mkdir -p /tmp/test_cache
chmod 777 /tmp/test_cache
# 在 nginx.conf 中添加以下测试配置
# proxy_cache_path /tmp/test_cache levels=1 keys_zone=test_cache:10m max_size=10k;
# 然后发送大量请求以填满缓存
for i in {1..100}; do curl http://example.com/page$i; done
# 观察缓存目录中的文件变化
ls -lt /tmp/test_cache/* | head -n 10
在实际操作中，你可以通过观察缓存目录中文件的修改时间（mtime）来验证 LRU 策略。最新访问的文件通常具有最近的 mtime，而最久未访问的文件则具有较早的 mtime。Nginx 的清理算法会扫描这些文件，并优先删除 mtime 最早的那些。需要注意的是，Nginx 的清理过程是渐进式的，它不会一次性删除所有超出限制的文件，而是分批次删除，以避免对系统 I/O 造成剧烈冲击。因此，在某些极端情况下，缓存目录的大小可能会短暂超过 max_size，但最终会稳定在限制范围内。
