Nginx与反向代理缓存（proxy_cache）共存时的文件描述符消耗分析-Nginx-PHP中文网

nginx启用proxy_cache时fd消耗显著升高，主因是缓存键查找、实体文件读写及后台更新等多阶段持续持有多重文件描述符，实际fd用量可达连接数的1.8～2.5倍，需通过禁用open_file_cache、启用proxy_cache_lock、精简levels层级和合理设置inactive时间来收敛fd占用。

nginx与反向代理缓存（proxy_cache）共存时的文件描述符消耗分析

当 Nginx 同时启用反向代理（proxy_pass）和内置缓存（proxy_cache）时，文件描述符（file descriptor, FD）消耗会显著高于纯代理模式，主要源于缓存元数据管理、缓存实体文件读写、以及缓存校验与淘汰等后台行为。理解其消耗路径，有助于合理设置 worker_rlimit_nofile 和缓存区参数，避免“Too many open files”错误。

缓存相关 FD 消耗的三大来源

Nginx 的 proxy_cache 并非仅在响应落盘时打开文件——它在多个阶段主动持有 FD：

缓存键查找与元数据检查：每次请求命中缓存前，Nginx 需打开对应 cache key 的 cache keys zone 中的索引项，并可能访问缓存目录下的 cache file header（如时间戳、状态标志），这涉及至少 1–2 个只读 FD；
缓存实体文件读取：若缓存已存在且未过期，Nginx 以 sendfile 或 mmap 方式返回内容；但为支持条件请求（如 If-None-Match）、范围请求（Range）或头信息校验，常需先 open() 缓存文件获取 inode、大小、mtime 等，该 FD 在响应结束前保持打开；
缓存写入与后台更新：首次缓存写入时，Nginx 创建临时文件（ngx_temp_*）、写入内容、重命名提交；同时开启异步线程执行 proxy_cache_use_stale、proxy_cache_background_update 等逻辑，每个后台更新请求都可能额外打开源站连接 + 本地缓存文件（用于覆盖写），形成并发 FD 峰值。

单 worker 进程典型 FD 占用估算

假设一个 worker 处理 1000 并发请求，启用 proxy_cache 后，FD 消耗远不止 1000（连接数）：

CPA Update - Secure CLI Proxy API Maintenance

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

下载

每个活跃客户端连接 ≈ 1 FD（socket）；
每个缓存命中的响应 ≈ +1 FD（指向缓存文件，尤其开启 open_file_cache 时会复用）；
每个正在写入/更新的缓存条目 ≈ +2～3 FD（临时文件 + 目标文件句柄 + 可能的源站 socket）；
若配置了 proxy_cache_path ... levels=1:2 keys_zone=mycache:10m max_size=1g inactive=1h;，Nginx 内部还为 cache manager 和 loader 进程预留少量固定 FD（通常 ≤ 5）；
实际观测中，高缓存命中率（>70%）+ 中等写入压力下，单 worker 的 FD 使用常达连接数的 1.8～2.5 倍。

降低 FD 压力的关键配置建议

不依赖盲目调大系统 limit，而应从机制上收敛 FD 泄漏与冗余占用：

关闭不必要的缓存文件预打开：禁用 open_file_cache（除非静态资源多），或设为 off；若启用，务必配 open_file_cache_valid 和 open_file_cache_min_uses 避免缓存低频文件句柄；
限制并发缓存写入数：使用 proxy_cache_lock on + proxy_cache_lock_timeout 5s，防止同一 key 多个请求同时回源并各自创建临时缓存文件；
精简缓存层级与路径深度：levels=1:2 比 levels=1:2:2 减少两级子目录遍历开销，间接降低 opendir()/readdir() 引发的临时 FD；
定期清理无效缓存句柄：确保 proxy_cache_path 中的 inactive 时间合理（如 inactive=10m），使过期未访问缓存文件及时被 manager 进程释放对应 FD。

监控与验证方法

判断是否真由 proxy_cache 引发 FD 紧张：

用 lsof -p $(cat /var/run/nginx.pid) | wc -l 实时统计当前 FD 数；
配合 ss -s 查看 socket 总数，差值较大则说明大量 FD 被文件占用；
启用 error_log /var/log/nginx/error.log debug;（谨慎！），搜索 "open() "/var/cache/nginx/..." failed" 或 "too many open files" 日志行；
临时注释 proxy_cache 相关指令（保留 proxy_pass），压测对比 FD 增长曲线，可明确归因。