大文件下载慢、卡顿的根本原因是nginx默认开启proxy_buffering导致全量接收再转发，引发首字节延迟、频繁磁盘写入及proxy_max_temp_file_size中断；应优先关闭proxy_buffering实现流式透传，或在必须开启时严格调大proxy_buffers、proxy_busy_buffers_size、proxy_max_temp_file_size等参数并优化临时文件i/o与超时设置。
大文件下载慢、卡顿，根本原因往往不是带宽不足，而是 Nginx 的缓冲机制与传输特性不匹配——默认开启的 proxy_buffering 会把整个响应体先收全再发，导致首字节延迟高、磁盘频繁写临时文件、甚至因 proxy_max_temp_file_size 触发中断。解决思路很明确：按场景选“直通”还是“可控缓存”，再精细调参。
优先关闭 proxy_buffering（流式直传场景）
适用于静态大文件直传（如 /download/、/videos/）、CDN 回源无改写需求、或后端已支持 chunked 流式输出的情况。关闭后，Nginx 不再攒数据，而是边收边发，彻底规避首字节等待和临时文件瓶颈：
-
proxy_buffering off;—— 强制流式透传，所有proxy_buffers和proxy_max_temp_file_size参数失效 -
proxy_buffer_size 16k;—— 单独保留响应头空间，防重定向、Set-Cookie 或鉴权头溢出 -
proxy_read_timeout 3600;和proxy_send_timeout 3600;—— 防移动网络或弱网下超时断连
必须开启 buffering 时，精准扩大内存缓冲并约束落盘
仅在需动态计算 ETag/Content-MD5、统一启用 gzip 压缩、或后端不支持流式但又必须做响应头改写等少数场景才开启。此时不能只开开关，必须同步扩容并匹配参数：
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
-
proxy_buffers 16 1M;—— 总内存缓冲 16MB，单块 1MB，适配百 MB 级文件的平滑接收 -
proxy_busy_buffers_size 8M;—— 允许最多 8MB 处于“正在发送”状态，避免空闲缓冲积压阻塞 -
proxy_max_temp_file_size 2048m;—— 提升单个临时文件上限至 2GB，防止写满中断 -
proxy_temp_file_write_size 256k;—— 每次写盘至少 256KB，大幅减少系统调用与磁盘 I/O 压力
配套优化：超时、协议与路径隔离
缓冲区调优若不配生命周期管理，依然会卡在连接阶段：
-
proxy_http_version 1.1;+proxy_set_header Connection '';—— 启用长连接复用，避免大文件传输中反复建连 -
proxy_temp_path /ssd/nginx/temp;—— 将临时文件路径挂载在独立 SSD 分区，避开系统盘 IO 拥塞 - 对下载路径单独配置（如
location ^~ /dl/），避免全局参数影响 API 接口性能
验证与避坑要点
调完别急着上线，用 curl -i 检查关键指标：
- 确认响应头不含
Content-Length: 0或意外出现Transfer-Encoding: chunked（说明未被截断） - 下载过程中观察
nginx temp目录是否持续有新文件生成（高频小文件 = 落盘过碎） - 禁用
proxy_buffering后，若后端是 Java/Tomcat 等，注意其 keepalive 设置是否兼容，防止连接池耗尽
