nginx proxy_cache无定时扫描功能，依赖cache manager进程异步清理；核心参数inactive决定冷数据淘汰（如inactive=4h表示4小时未访问即删），manager_sleep和manager_files调控扫描节奏，purger系废弃第三方参数，官方不支持。
Nginx 的 proxy_cache 并不提供“定时扫描清理”的显式调度功能，它依赖内置的 cache manager 进程 持续、异步地扫描缓存目录，按规则自动回收空间。所谓“自动定时”，其实是通过调优 inactive、manager_sleep 和 manager_files 三个参数，控制淘汰节奏和触发条件。
核心机制：inactive 决定“删不删”
inactive 是唯一决定缓存文件是否会被物理删除的关键参数——它不是看响应头里的 Cache-Control 或 Expires，而是看该缓存项最后一次被访问（atime）距今是否超过设定时长。
- 例如
inactive=2h：只要某缓存文件在 2 小时内没有任何请求命中，manager 进程在扫描时就会把它从磁盘上删除 - 即使你用
proxy_cache_valid 200 7d设了逻辑缓存 7 天，只要 2 小时没被访问，它仍会被清理 - 如果不设
inactive，缓存文件会一直留在磁盘上，哪怕早已逻辑过期
扫描节奏：manager_sleep 和 manager_files 控制“怎么扫”
这两个是 proxy_cache_path 的合法官方参数，用于调节 manager 进程的工作节拍：
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
-
manager_sleep=150：每轮处理完后休眠 150 毫秒，再启动下一轮（默认 200ms） -
manager_files=300：每轮最多检查并清理 300 个缓存文件（默认 200） - 数值越小，扫描越保守；越大+休眠越短，回收越积极（适合 SSD 和中小缓存规模）
完整配置示例
以下是一段典型、可直接使用的配置：
proxy_cache_path /var/cache/nginx/my_cache levels=1:2 keys_zone=my_cache:20m max_size=5g inactive=4h manager_files=250 manager_sleep=100 use_temp_path=off;
说明：
-
inactive=4h：4 小时内无访问即视为冷数据，可删除 -
manager_files=250+manager_sleep=100：每轮查 250 个文件，只等 100ms 就继续，加快空间回收速度 -
use_temp_path=off：避免写临时文件，提升稳定性
注意：别被 purger 参数误导
网上常提到的 purger=on、purger_sleep 等，不是 Nginx 官方支持的参数，它们来自已废弃的第三方模块（如旧版 ngx_cache_purge），当前所有稳定版（包括 1.20+ 及 Nginx Plus）均不识别。真正起作用的只有 inactive、manager_sleep 和 manager_files。
