如何通过 proxy_cache_path 的 manager_files 指令调优海量小文件缓存下的扫描逻辑-Nginx-PHP中文网

nginx 中不存在 proxy_cache_path 的 manager_files 参数，它并非官方指令；实际需通过优化 levels、max_size、inactive 等配置及外部清理脚本等方式缓解 cache manager 扫描压力。

如何通过 proxy_cache_path 的 manager_files 指令调优海量小文件缓存下的扫描逻辑

nginx 的 proxy_cache_path 指令中并没有 manager_files 这个参数——它并不存在于官方文档或任何稳定版本的 nginx 中。

很多用户误以为存在类似 manager_files 的配置项，实际是混淆了以下两个概念：

cache manager 进程的行为本身不可直接通过配置项控制文件扫描数量，其逻辑由 nginx 内部硬编码决定（如每次遍历目录时最多处理若干 cache entries）；
部分第三方模块或旧版定制分支可能添加过类似功能，但标准开源 nginx（包括 mainline、stable 及 Tengine 等主流衍生版）均未提供 manager_files 指令。

当缓存中存在海量小文件（例如数千万级），cache manager 频繁扫描导致 CPU 升高、延迟波动，应从如下方向调优：

增大 levels 目录层级深度：例如设为 levels=1:2:2，可将单目录文件数从百万级降至百级，显著降低 readdir() 开销；
合理设置 max_size：避免磁盘长期接近满载，否则 manager 会频繁触发清理，加剧扫描压力；
调整 inactive 时间：对小文件访问模式较集中的场景，适当缩短（如 inactive=5m）可减少无效 entry 积压，间接降低扫描负担；
启用 use_temp_path=off：防止临时文件与缓存文件混布，提升目录结构稳定性。

若业务确认 manager 成为性能瓶颈，且无法通过结构优化缓解，可考虑：

Umbrel Proxy Manager

高效管理与交互 Umbrel 代理服务，支持 Docker 容器。自动发现运行服务，将内部 Docker IP 映射为可访问的外部地址。

下载

用外部脚本定期清理过期缓存：结合 $upstream_http_expires 或自定义响应头 + 文件 mtime，用 find + xargs 清理，再向 nginx 发送 proxy_cache_purge 或 reload 触发重载；
改用 shared memory-based 缓存方案：如 proxy_cache_use_stale updating 配合短 updating 窗口，减少磁盘 I/O 依赖；
评估迁移到 cache_zone（nginx 1.19+）或 proxy_cache_bypass 动态控制策略，将高频小资源交由内存缓存或 CDN 处理。