大文件下载优化关键在于nginx流式透传而非加大缓冲：需关闭proxy_buffering off，仅保留proxy_buffer_size 16k；延长proxy_read_timeout和send_timeout至3600秒；启用http/1.1长连接；静态文件启用sendfile on等零拷贝；临时路径设于ssd并确保空间充足。
大文件下载优化的关键不在“加大缓冲”，而在于让数据流畅通无阻地从后端（比如 Python 应用）直通客户端。Nginx 作为反向代理时，若配置不当，反而会成为瓶颈——比如等完整接收 2GB 文件才发第一个字节，或频繁写临时磁盘导致卡顿。
关闭 proxy_buffering 实现流式透传
Python 后端（如 Flask、FastAPI、Django）通常以流式响应（StreamingResponse 或 yield）输出大文件。此时 Nginx 必须关闭缓冲，否则会强行收全再发：
- proxy_buffering off; —— 强制边收边传，消除首字节延迟
- 该设置下
proxy_buffers、proxy_busy_buffers_size等参数自动失效，无需调大 - 仅保留 proxy_buffer_size 16k; 确保响应头（含
Content-Length、Content-Disposition等）能完整容纳
适配 Python 流式响应的超时与连接控制
Python 生成大文件可能较慢（如动态打包、数据库导出），且客户端网络不稳定。需延长关键超时并复用连接：
- proxy_read_timeout 3600; —— 允许后端最多花 1 小时生成响应体
- proxy_send_timeout 3600; —— 容忍客户端慢速接收（如移动网络）
- proxy_http_version 1.1; + proxy_set_header Connection ''; —— 启用 HTTP/1.1 长连接，避免反复建连开销
- 确认 Python 响应头含
Transfer-Encoding: chunked或明确Content-Length，避免 Nginx 因无法判断长度而退化为缓存模式
启用零拷贝加速静态文件直出（可选）
若部分大文件是静态资源（如预生成的 ZIP、ISO），不经过 Python，而是由 Nginx 直接提供，应启用内核级传输：
- sendfile on;
- tcp_nopush on; —— 合并响应头与首个数据块，减少 TCP 包数
-
tcp_nodelay off; —— 配合
tcp_nopush，避免 Nagle 算法拆散大块数据 - 搭配
location /static/ { alias /data/assets/; }使用，无需 Python 参与
规避临时磁盘 I/O 拖累
即使关闭 proxy_buffering，某些场景（如响应头过大、SSL 握手后首次写入）仍可能触发临时文件。需预防性配置：
- proxy_temp_path /mnt/ssd/nginx-temp 1 2; —— 将临时路径设在高速 SSD 分区，避免系统盘拥塞
- 确保该路径有足够空间和 inode，尤其当并发下载多路流时
- 不设置
proxy_max_temp_file_size（默认 1024m），因流式模式下本不该写大临时文件；若观察到频繁open() write()日志，说明某环节仍在尝试缓存，需回查是否误启了proxy_buffering或后端返回了异常头
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
