Nginx 中 proxy_cache_min_uses 设置缓存激活基准-Nginx-PHP中文网

proxy_cache_min_uses 是缓存写入的热度门槛，设为2时需同key请求达2次才落盘，首次不占磁盘，配合proxy_cache_lock可减少40%～60%无效小文件。

nginx 中 proxy_cache_min_uses 设置缓存激活基准

proxy_cache_min_uses 不是缓存“开关”，而是缓存写入的热度门槛：它决定同一个缓存 key 的响应体，要被访问多少次后才真正落盘保存。设为 2，意味着第 1 次请求仍回源、不写磁盘；第 2 次同 key 请求触发落盘，后续才可 HIT；它不拦截请求、不跳过回源，只管“什么时候把响应存下来”。

静态资源设为 2，过滤单次试探流量

这类文件（.js、.css、.png、.woff2 等）本该复用，但常被构建预览、爬虫扫描或本地调试一次性加载。

设 proxy_cache_min_uses 2 后，首次访问不占磁盘空间，第二次才写入
实测可减少 40%～60% 的 KB 级无效小文件
必须搭配 proxy_cache_lock on，否则前两次请求可能并发回源，反而增加后端和 SSD 压力

示例配置：

location ~* \.(js|css|png|jpg|gif|webp|woff2?)$ {
    proxy_cache static_cache;
    proxy_cache_valid 200 1d;
    proxy_cache_min_uses 2;
    proxy_cache_lock on;
    proxy_cache_lock_timeout 5s;
}

动态路径按语义分层设置，避免一刀切

不同业务路径的复用逻辑差异很大，统一设高值会误伤真实中频内容：

首页 / 或公共 API /api/config：保持 min_uses 1，首次即缓存更合理
带用户标识的路径（如 /user/123、/order?id=456）：设为 2 或 3，匹配真实回访节奏
含随机参数的接口（如 /track?r=xxx&t=1746216840）：不用 min_uses，直接用 proxy_no_cache 1 或 proxy_cache_bypass $arg_r $arg_t 绕过整个缓存流程

关键前提：proxy_cache_key 必须精简，剔除 $args 或时间戳类干扰项，否则每个带不同参数的 URI 都算新 key，永远达不到计数门槛。

aperture: the L402 aware reverse proxy

安装并运行 Aperture（Lightning Labs 的 L402 闪电反向代理），用于创建 L402 付费墙、配置付费 API 端点、为其他代理托管付费内容或测试 L402 认证流程。

下载

必须启用 proxy_cache_lock，否则 min_uses 失效

仅设 min_uses 2 而不加锁，前两次请求仍会并发穿透回源：

第 1 次请求回源并尝试写缓存
第 2 次请求也同时回源，可能触发重复索引更新或临时文件生成
加锁后变成：第 1 次回源 + 加锁 → 第 2 次等待锁 → 锁释放时统一写入一次 → 自然满足“2 次才落盘”

务必同步配置：

proxy_cache_lock on;
proxy_cache_lock_timeout 5s;  # 建议略大于后端 P95 响应时间

验证是否真在节省磁盘与内存

别只改配置，要看实际效果：

在响应头中加入 add_header X-Cache-Status $upstream_cache_status;，观察哪些路径长期 MISS 却无 HIT
统计缓存目录新建文件数：find /var/cache/nginx/my_cache -type f -mmin -5 | wc -l，对比调参前后 5 分钟增量
监控 keys_zone 内存占用率变化，若小文件数量锐减而总缓存容量稳定，说明长尾请求已被有效过滤

不复杂但容易忽略