proxy_cache_min_uses 是缓存写入的热度门槛，设为2时需同key请求达2次才落盘，首次不占磁盘，配合proxy_cache_lock可减少40%～60%无效小文件。
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内存占用率变化，若小文件数量锐减而总缓存容量稳定，说明长尾请求已被有效过滤
不复杂但容易忽略
