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 值生成两级固定路径，天然负载均衡：
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
- 第一级：取 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 参数
