必须配齐四个参数才能生效:open_file_cache、open_file_cache_valid、open_file_cache_min_uses、open_file_cache_errors,缺一不可;它缓存文件元信息而非内容,显著降低高频小文件访问的系统调用开销。

直接配齐四个关键参数才能生效,只写 open_file_cache on 没用。它不缓存文件内容,而是把文件是否存在、大小、修改时间、权限、句柄这些信息记在内存里,省掉反复调用 stat() 和 open() 的开销——这对高频访问小文件(比如 index.html、favicon.ico、CSS/JS)特别有效。
必须配全的四项基础参数
这四个指令要一起出现在 http 块中,缺一不可:
- open_file_cache max=10000 inactive=60s; —— 最多缓存 1 万个条目;60 秒内没被访问就淘汰
- open_file_cache_valid 60s; —— 每 60 秒检查一次缓存项是否还有效(比如文件是否被删或改名)
- open_file_cache_min_uses 2; —— 同一个文件至少被请求 2 次才进缓存,避免偶然访问污染缓存
- open_file_cache_errors on; —— 把“文件不存在(ENOENT)”“没权限(EACCES)”这类错误也缓存住,防止反复查错路径
根据场景微调参数值
默认配置适合日均请求几万到百万级的中小型静态服务,但你可以按需调整:
- 内存充足、文件种类多(如 CDN 或大型 SPA 应用),可把
max提到 20000~50000,每个条目约占 1KB - 文件极少变动(如构建后部署的 React/Vue 产物),可延长
inactive到 300s,valid到 120s,减少校验频率 - 容器环境或磁盘 I/O 偏弱(如云上小规格实例),建议保持
min_uses 2,避免缓存抖动 - 若后端有外部进程频繁更新配置文件(如动态路由规则 JSON),
valid值不宜过大,否则可能读到过期元数据
配合其他设置效果更稳
单独开 open_file_cache 已有明显收益,再加这几项能进一步压低系统调用压力:
- 确保
sendfile on;开启——让内核直接传输文件内容,不经过用户态,和 open_file_cache 是黄金搭档 - 静态资源 location 尽量用前缀匹配(
location /static/),避免正则匹配,减少每次请求的路径解析开销 - 搭配
try_files $uri =404;处理 SPA 路由时,index.html会被反复打开,这时 open_file_cache 的作用最突出 - 不用额外装模块,它属于
ngx_http_core_module,编译进 Nginx 就自带,只要配置对就能用
不复杂但容易忽略










