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

levels 参数本身不加快单次文件查找速度，但它能有效防止高并发下因单目录文件堆积引发的 I/O 瓶颈。核心是把百万级缓存均匀打散到多级子目录中，避免文件系统在超大目录里“大海捞针”。

为什么 levels=0 在大规模缓存下会明显变慢

所有缓存文件都堆在一个目录里，当数量超过 10 万，ext4 或 XFS 就会暴露底层限制：

• ext4 默认用线性扫描查目录项，平均查找延迟可达毫秒级
• XFS 的 dir2 结构在单目录超数万文件后，哈希桶冲突加剧、目录块频繁分裂
• Nginx 每次缓存命中都要执行 stat 和 open，高频小文件元数据操作直接压垮 dcache 查找效率

推荐用 levels=1:2，而不是其他组合

这是当前最平衡、实用的分层方式，基于缓存 key 的 MD5 值生成固定路径：

CPA Update - Secure CLI Proxy API Maintenance

安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。

下载

• 第一级：取 MD5 最后 1 位（0–f），共 16 个目录
• 第二级：取倒数第 2–3 位（00–ff），每个一级目录下再分 256 个子目录
• 最终形成最多 4096 个叶子目录，百万级缓存下每目录平均仅几百个文件
• 路径示例：/var/cache/nginx/mycache/a/1b/a1b2c3
• 相同请求总落在同一子目录，利于 page cache 复用和磁盘预读

只设 levels 不够，必须同步调优关键配套项

单独配置 levels=1:2 效果有限，需协同优化以下四点：

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

缓存 key 设计决定 levels 是否真正起效

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

• 含时间戳、随机串、$cookie_sessionid、$request_time 等字段，会导致某些子目录爆满、另一些长期空置
• 结果仍是局部 I/O 压力集中，levels 白配
• 推荐构造稳定 key：$scheme$host$request_uri，去掉动态查询参数
• 上线后可用命令验证分布：find /var/cache/nginx/mycache -mindepth 3 -maxdepth 3 -type f | cut -d'/' -f5,6 | sort | uniq -c | sort -n