nginx文件下载缓冲需分层配置：上传用client_max_body_size与client_body_buffer_size防413；静态下载启sendfile、aio和directio提效；反代下载建议proxy_buffering off直通，或调大proxy_buffer_size、buffers等参数并延长proxy_read_timeout防上游断连。
配置 Nginx 作为文件下载服务器时，缓冲区相关设置直接影响大文件传输的稳定性、内存占用和客户端体验。关键不是“越多越好”，而是按角色分层控制：接收请求体（上传）、代理中转（若用反向代理）、响应发送（下载）三类缓冲需分别对待。
上传请求体缓冲：防413错误，兼顾内存与兼容性
用户上传文件时，Nginx 先收请求体再转发给后端（如 PHP 或上游服务）。若不调大缓冲区，易触发 413 Request Entity Too Large 错误。
-
client_max_body_size：硬性上限，单位可为
m或g。例如设为500m表示单次上传最大支持 500MB -
client_body_buffer_size：内存缓冲区大小。默认仅 8KB，建议设为
1m～4m。若上传文件 ≤ 此值，全程走内存；超限则写临时磁盘文件（需确保client_body_temp_path目录有写权限） - 两者关系：若
client_body_buffer_size ，且上传体超过缓冲区，Nginx 自动落盘；若缓冲区 ≥ 最大允许上传体，可避免磁盘 IO，但会吃更多内存
下载响应缓冲：零拷贝 + 分块控制，避免卡顿或中断
直接提供静态文件下载（如 /files/ 目录）时，重点优化内核级传输效率：
- sendfile on：启用内核零拷贝，大幅降低 CPU 和内存复制开销，必须开启
-
sendfile_max_chunk 1m：限制每次 sendfile 系统调用传输量，防止大文件阻塞事件循环，推荐设为
512k～2m - tcp_nopush on：配合 sendfile，确保 TCP 包满载再发，减少小包数量
- aio on + directio 5m：对 ≥5MB 文件启用异步 I/O 和直接磁盘读取，绕过内核页缓存，降低内存压力（需文件系统支持）
反向代理场景缓冲：防上游断连，适配长下载
若 Nginx 作为下载代理（如前端 → Nginx → 后端存储服务），需防止因缓冲不足导致上游超时断连：
- proxy_buffering off：对纯下载流量建议关闭缓冲，让数据流直通，避免积压和静默超时
- 若必须开启缓冲，调大以下参数（单位均为字节）：
proxy_buffer_size 128k（首行+头缓冲）proxy_buffers 8 128k（主体缓冲区共 1MB）proxy_busy_buffers_size 256k（忙时可用上限）proxy_temp_file_write_size 256k（落盘阈值） - 同步调整超时：
proxy_read_timeout 300（等上游响应）、proxy_send_timeout 300（发给客户端），避免因慢速下载触发中断
临时文件与磁盘空间：隐性瓶颈要提前规划
当缓冲区溢出或禁用内存缓存时，Nginx 会写临时文件。忽略这点易致磁盘打满或权限失败：
- client_body_temp_path /var/tmp/nginx/client 1 2：指定上传临时目录，后两个数字是子目录层级和数量（提升 inode 效率）
- proxy_temp_path /var/tmp/nginx/proxy 1 2：代理场景临时目录，路径需独立于系统盘，建议挂 SSD 或专用分区
- proxy_max_temp_file_size 2g：单个临时文件最大尺寸，避免小文件碎片，也防止单个超大响应占满磁盘
