发布时间:2026-09-28 12:30 更新时间:2026-09-28 12:30 阅读量:5
用 Nginx 做反向代理缓存,跑一段时间后 /var/cache/nginx 把磁盘写满,是很多站长遇到过的事故。麻烦的地方在于:配置里明明写了 max_size=10g,df -h 却显示缓存目录占了三十多个 G;或者 keys_zone 只给了 10m,就以为磁盘最多用 10m。这篇就把 proxy_cache_path 三个关键参数的分工、磁盘占用为什么会超出预期、以及缓存目录怎么安全清空讲清楚。
先看一段典型配置:
proxy_cache_path /var/cache/nginx/proxy_cache
levels=1:2
keys_zone=my_cache:10m
max_size=10g
inactive=60m
use_temp_path=off;
server {
location / {
proxy_cache my_cache;
proxy_cache_valid 200 302 10m;
proxy_cache_valid 404 1m;
proxy_pass http://backend;
}
}
三个参数对应三件不同的事。第一,keys_zone=my_cache:10m 是共享内存区,它只存缓存键(URL 的哈希)和元信息,比如文件路径、状态码、过期时间,不存响应正文。正文落在磁盘文件里。所以 10m 的 keys_zone 大约能装下几万到十几万个缓存条目(具体数量受键长度影响,以实际环境为准),和磁盘占用没有直接比例关系。
第二,max_size=10g 是整个缓存目录的磁盘上限,由 Nginx 的 cache manager 进程负责在后台淘汰超出部分。这里有个常见误解:它不是硬性闸门。cache manager 是周期性扫描的,不是每写一个文件就立刻检查,所以磁盘占用在短时间内超过 max_size 是正常现象,只是不会长期失控。
第三,inactive=60m 是不活跃淘汰时间。一个缓存文件 60 分钟内没有被再次访问,即使还没到 max_size,也会被清理掉。它管的是「冷数据」而不是「总量」。如果站点访问量小、缓存命中率低,缓存文件会因 inactive 到期被删,磁盘反而不会涨;反过来,热点内容反复被访问,inactive 一直不触发,就只能靠 max_size 兜底。
把上面几点串起来就清楚了:keys_zone 记的是「有哪些缓存」,磁盘目录存的是「缓存内容有多大」。一个 key 对应的正文可能是一张 200KB 的图片,也可能是一个 2MB 的接口响应,元信息本身只有几十到几百字节。所以 keys_zone 给 10m,磁盘完全可能写出几十 G。
另外几个容易踩的点:levels 目录层级只影响文件分布,不影响总量;use_temp_path=off 让临时文件直接写进缓存目录,写大文件时会短暂放大占用;如果多个 proxy_cache_path 指向同一个磁盘分区,各自的 max_size 是独立计算的,加起来可能超过分区容量。还有一点,被缓存的是上游返回的完整响应,包括响应头,压缩与否也影响落盘大小。
排查时先确认缓存目录到底多大、文件有多少:
# 查看缓存目录总体积与文件数量
du -sh /var/cache/nginx/proxy_cache
df -h /var/cache/nginx
find /var/cache/nginx/proxy_cache -type f | wc -l
按大小排序,看看是哪些大文件占地方
find /var/cache/nginx/proxy_cache -type f -printf '%s %p\n' \
| sort -rn | head -20
如果发现目录里存在大量 .tmp 结尾的临时文件,说明有请求在写缓存的过程中被打断(上游超时、客户端断开),这类文件不会计入有效缓存,但会实实在在占磁盘。清理它们不影响正常缓存命中。
最直接的想法是 rm -rf /var/cache/nginx/proxy_cache/*,但 Nginx 正在往这个目录读写,直接删会带来两个问题:一是 cache manager 的内存索引和磁盘文件对不上,后续可能报错或行为异常;二是有进程句柄还指向被删文件时,df 看到的占用不会立刻释放(这一点和系统盘被删文件占用是同一类问题)。
更稳妥的顺序是:先停掉写入,再清目录,最后 reload。如果业务能接受短暂中断,停服务最干净:
# 1. 停止 Nginx,确保没有进程再写缓存目录
systemctl stop nginx
2. 确认真没有 nginx 进程持有该目录
lsof +D /var/cache/nginx/proxy_cache 2>/dev/null | head
3. 删除缓存内容(保留目录本身和权限)
find /var/cache/nginx/proxy_cache -mindepth 1 -delete
4. 启动并观察
df -h /var/cache/nginx
systemctl start nginx
不能停服务时,可以先把缓存目录改到一个新路径,reload 生效后再清旧目录,让在线请求平滑过渡:
# 新建空目录并保持属主一致(以实际运行用户为准)
mkdir -p /var/cache/nginx/proxy_cache_new
chown -R nginx:nginx /var/cache/nginx/proxy_cache_new
改配置里的 proxy_cache_path 指向新目录,然后热加载
nginx -t && nginx -s reload
确认旧目录已无进程引用后再删除
lsof +D /var/cache/nginx/proxy_cache 2>/dev/null | head
find /var/cache/nginx/proxy_cache -mindepth 1 -delete
清理完别急着收工,回头调参数才是治本。建议把 max_size 设为分区可用空间的 60%~70%,给日志、临时文件留余量;适当缩短 inactive,让冷数据更快退场;对图片、视频这类大文件,考虑用 proxy_cache_bypass、proxy_no_cache 或按 location 分开缓存策略,避免大对象挤占小接口的空间。改完执行 nginx -t 校验,再 reload,具体参数取值以官方文档和实际压测结果为准。
记住一句话:keys_zone 管的是内存里的索引,max_size 管的是磁盘上的总量,inactive 管的是冷数据什么时候走。磁盘写满往往不是配置写错了,而是把 keys_zone 当成了磁盘配额,或者上游返回的大对象太多。建议给缓存目录单独挂一块盘或分区、配一个磁盘使用率告警,再定期用 du 和 find 抽查缓存构成,出问题时按「停写 → 清理 → 调参 → 校验」的顺序处理,基本不会把线上搞乱。
| 📑 | 📅 |
|---|---|
| Linux TCP backlog 溢出排查:ss -lnt 的 Send-Q 怎么看 | 2026-09-28 |
| Docker 容器内 cron 与宿主 crontab 取舍:重复执行与时区错乱排查 | 2026-09-28 |
| MySQL隐形变慢排查:buffer pool命中率与磁盘临时表 | 2026-09-28 |
| Linux僵尸进程排查:ps状态Z到父进程不回收定位 | 2026-09-28 |
| PostgreSQL连接池选型与pgbouncer事务池踩坑 | 2026-09-27 |
| MySQL 8 临时表爆满排查:内存临时表与磁盘落盘定位 | 2026-09-28 |
| Redis内存碎片率异常:used_memory与RSS差在哪 | 2026-09-28 |
| Docker容器DNS解析异常:127.0.0.11与自定义网络排查 | 2026-09-28 |
| Linux SYN_RECV 堆积排查:半连接队列与 tcp_syncookies | 2026-09-29 |
| Nginx 长连接被中间设备掐断排查:从抓包 RST 到 keepalive_timeout 调优 | 2026-09-29 |