Nginx大文件传输卡顿主因是缓冲区配置不当,需关闭proxy_buffering或调大proxy_buffers、proxy_busy_buffers_size、proxy_max_temp_file_size等参数,并优化超时与连接复用。

大文件传输卡顿,往往不是带宽不够,而是 Nginx 默认缓冲区太小、缓存策略不合理导致的。关键在于调整 proxy_buffering、proxy_buffers、proxy_busy_buffers_size 和 proxy_max_temp_file_size 这几个参数,让 Nginx 能平滑中转大响应体,避免阻塞和频繁磁盘落盘。
关闭或谨慎启用 proxy_buffering
默认开启的 proxy_buffering on 会让 Nginx 先收完整个后端响应再发给客户端——对大文件(如视频、安装包)非常不友好,容易造成首字节延迟高、连接假卡顿。
- 对静态大文件服务(如 /download/),建议直接设为
proxy_buffering off,让数据边收边传,降低内存占用和延迟 - 若需缓冲(例如做响应头改写或 gzip 压缩),则必须同步调大缓冲区,并确保
proxy_buffer_size足够容纳响应头(一般 4k–16k 即可)
合理设置 proxy_buffers 与 busy 缓冲区
proxy_buffers 决定了 Nginx 可用的内存缓冲区总数和单块大小;proxy_busy_buffers_size 控制最多有多少缓冲区可被“忙”着发送——这两个值不匹配会导致提前刷盘或阻塞。
- 典型配置示例:
proxy_buffers 8 128k;表示共 8 块、每块 128KB 的缓冲区(总内存 1MB) -
proxy_busy_buffers_size应 ≤ 所有缓冲区总大小的一半,且 ≥ 单块大小,例如设为128k或256k - 避免设过大(如
proxy_buffers 16 4m),易引发 OOM;也避免过小(如4 4k),导致频繁写临时文件
控制临时文件行为,防止磁盘 I/O 拖累
当响应超出内存缓冲区时,Nginx 会写临时文件。若 proxy_max_temp_file_size 过小或 proxy_temp_file_write_size 不合理,就会高频小块写盘,显著拖慢大文件传输。
- 对百 MB 级文件,建议:
proxy_max_temp_file_size 1024m;(允许单个临时文件最大 1GB) -
proxy_temp_file_write_size设为128k或256k,减少 write() 系统调用次数 - 确保
proxy_temp_path挂载在高速存储(如 SSD),并有足够空间和 inode 余量
补充:超时与连接复用优化
缓冲区调优要配合连接生命周期管理,否则仍可能因超时中断大文件流。
- 延长关键超时:
proxy_read_timeout 600;(后端读响应)、proxy_send_timeout 600;(发给客户端) - 开启连接复用:
proxy_http_version 1.1;+proxy_set_header Connection '';,避免 HTTP/1.0 下频繁建连 - 如后端支持流式响应(如 chunked),确认未被 Nginx 错误缓存或截断(可通过
curl -i检查响应头是否含Transfer-Encoding: chunked)










