Nginx 缓存代理写满磁盘:max_size 与缓存目录清理实战

    发布时间: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 三个关键参数的分工、磁盘占用为什么会超出预期、以及缓存目录怎么安全清空讲清楚。

    keys_zone、max_size、inactive 各管什么

    先看一段典型配置:

    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 不成正比

    把上面几点串起来就清楚了: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