关闭use_temp_path=off可彻底跳过临时目录中转,避免跨设备rename失败和双倍i/o;需在proxy_cache_path中显式配置,确保缓存目录空间充足、权限正确且文件系统支持原子写入。

核心是让大文件绕过磁盘临时目录,改走内存直通或零拷贝路径——二级缓存本身不卡,卡在 proxy_temp_path 的默认落盘行为上。
关闭 use_temp_path 彻底跳过临时目录中转
这是最直接有效的动作。Nginx 默认先写 proxy_temp_path、再 rename 到缓存目录,不仅双写放大 I/O,跨设备还会静默失败并卡住请求。
- 在
proxy_cache_path中显式添加use_temp_path=off,例如:proxy_cache_path /data/nginx/cache levels=1:2 keys_zone=static:128m max_size=5g inactive=1h use_temp_path=off; - 删掉独立配置的
proxy_temp_path,它已失效 - 确保缓存目录所在分区空间充足(建议预留 ≥ 1.5× max_size),因为所有响应体将直写此处
- 验证方式:请求同一资源多次,看
X-Proxy-Cache是否稳定返回HIT;检查缓存目录下是否生成真实文件而非空目录或 .tmp 文件
对大文件强制启用流式转发
即使开了缓存,中等大小响应(几百 MB)仍会触发临时文件写入。设 proxy_max_temp_file_size 0 可彻底禁用磁盘缓存,全程走内存缓冲 + 边收边发。
- 配合调优内存参数:
proxy_buffers 16 4m、proxy_busy_buffers_size 8m,保证足够缓冲空间 - 注意:该设置不关闭缓存逻辑,只是把“缓存”从磁盘移到内存+流式链路中
- 适用于视频分片、大报表导出、API 批量响应等场景,iowait 显著下降,P95 延迟更平稳
静态大文件优先走 sendfile + directio
若缓存的是静态资源(如 .mp4、.zip),可绕过代理缓冲机制,直接由内核零拷贝输出。
- 在对应 location 块中启用:
sendfile on;<br>directio 4m;
- 要求文件大于 4MB 才启用 O_DIRECT,跳过 page cache,减少内存拷贝和上下文切换
- 需确认文件系统支持(ext4/xfs 推荐),且后端是本地文件而非 upstream
隔离临时路径物理介质(备用兜底)
如果因兼容性必须保留 use_temp_path=on,那就把 proxy_temp_path 挂到独立 NVMe 分区,并优化文件系统行为。
- 挂载时加
noatime,nobarrier(业务允许前提下),减少元数据开销 - 配置多级子目录结构,例如:
proxy_temp_path /data/nginx/proxy_temp 2 2;,分散 inode 压力 - 配合
proxy_max_temp_file_size 0或设为合理上限(如 50m),避免小文件堆积











