levels=1:2是最优分层方案，将百万级缓存均匀散列至4096个子目录，每目录仅数百文件，避免单目录i/o瓶颈；需同步调优keys_zone、inactive、use_temp_path、挂载选项及稳定cache_key。

levels 参数不是用来“加速单次查找”的，而是为了解决海量缓存文件堆在一个目录时引发的文件系统级 I/O 瓶颈。核心思路是把百万级缓存文件打散到固定数量的子目录中，让每个目录只存几百个文件，从而维持稳定的元数据操作性能。

为什么必须用多级目录（不能 levels=0）

不设 levels 或设为 levels=0 时，所有缓存文件都落在同一目录下。当缓存条目超过 10 万：

• ext4 默认用线性扫描查目录项，平均耗时随文件数增长而上升，毫秒级延迟很常见
• XFS 的 dir2 结构在单目录超数万文件后，哈希桶冲突加剧、目录块频繁分裂
• Nginx 每次缓存命中都要 stat + open，高频小文件元数据操作会放大目录查找开销
• dcache 锁竞争加剧，worker 进程等待增多，P95 延迟明显跳升

推荐配置：levels=1:2 是当前最实用的方案

它基于 cache_key 的 MD5 值生成两级固定路径，天然负载均衡：

aperture: the L402 aware reverse proxy

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

下载

• 第一级：取 MD5 值最后 1 位十六进制字符（0–f），共 16 个一级目录
• 第二级：取倒数第 2–3 位（00–ff），每个一级目录下再分 256 个二级目录
• 最终形成最多 4096 个叶子目录，路径形如 /var/cache/nginx/mycache/7/ab/cdef1234
• 百万级缓存下，每个目录平均仅存 200–300 个文件，目录查找基本稳定在常数时间

配套参数必须同步调优

只改 levels 效果有限，需协同优化以下几项：

• keys_zone 至少配 10m：1MB 内存约存 8000 个 key 元数据；10m 可支撑约 8 万个活跃缓存项，避免因 key 驱逐引发额外磁盘 lookup
• inactive ≥ 30m：设为 60s 会导致高频清理重建，加剧 I/O 波动；建议按业务热度设为 30m–2h
• use_temp_path=off：让临时文件直接写入缓存目录，避免跨文件系统 copy，省一次磁盘 write 和 rename
• 挂载选项加 noatime：SSD 上推荐 noatime,nobarrier（XFS）或 noatime,commit=60（ext4），降低元数据刷盘开销

cache_key 设计决定 levels 是否真正生效

路径由 cache_key 经 MD5 后取前几位生成。若 key 中含高熵字段，哈希分布会严重倾斜：

• ❌ 避免：$request_time、$cookie_sessionid、毫秒级时间戳、随机串
• ✅ 推荐：$scheme$host$request_uri 这类低变动率组合；可配合 map 指令过滤 utm_* 等 tracking 参数