Nginx反向代理大文件时，若响应超proxy_max_temp_file_size，会写临时文件导致I/O飙升；应通过日志、iostat和访问日志确认问题，再按需关闭缓冲、调大限制或改用sendfile零拷贝。
当 Nginx 作为反向代理转发大文件（如视频、安装包、备份归档）时，若响应体超过 proxy_max_temp_file_size 限制，Nginx 会将后端返回的数据先写入临时文件再发给客户端。这个过程会显著放大磁盘 I/O 压力，尤其在高并发下载场景下，容易引发 I/O 瓶颈、延迟飙升甚至 502 错误。
确认是否真由 proxy_max_temp_file_size 触发
不是所有大文件传输慢都源于该参数。需先验证：
- 检查 Nginx error 日志，搜索
upstream sent too big response或client intended to send too large body类报错 - 对比
proxy_buffering on和off下的磁盘 I/O 使用率（用iostat -x 1观察 %util 和 await）——开启 buffering 且触发 temp file 写入时，await明显升高 - 查看
/var/log/nginx/access.log中大响应（如bytes_sent > 10M）的请求耗时是否集中在后半段，这是临时文件落盘的典型表现
调高或禁用临时文件限制
该参数默认为 1G，但实际生效依赖于 proxy_buffering 和缓冲区配置。调整需同步考虑内存与磁盘平衡：
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
- 若后端能稳定流式输出（如支持
Transfer-Encoding: chunked），可直接关闭缓冲：proxy_buffering off;—— 此时 Nginx 不缓存响应，也不生成临时文件，I/O 压力转移到网络带宽和后端吞吐 - 若必须启用缓冲（例如需要添加响应头、做 gzip 压缩），则增大限制：
proxy_max_temp_file_size 2g;，同时扩大缓冲区：proxy_buffers 16 4k;和proxy_busy_buffers_size 8k; - 注意：增大该值不会自动提升性能，只是推迟落盘时机；真正缓解 I/O 要靠减少落盘频次或改用更快存储（如 SSD 缓存层）
绕过磁盘，改用内存缓冲或流式透传
对确定的大文件服务（如 /downloads/ 路径），推荐更彻底的优化路径：
- 为该 location 单独关闭缓冲：
location /downloads/ { proxy_buffering off; ... } - 配合
sendfile on;和tcp_nopush on;，让内核直接零拷贝发送文件（前提是后端是本地静态文件或已启用 sendfile 支持） - 若后端是应用服务器（如 Python/Node.js），确保它本身支持分块传输并设置合适的
Content-Length或Transfer-Encoding，避免 Nginx 因无法预判长度而强制落盘
监控与兜底策略
即使调优后，仍需防范突发流量压垮 I/O：
- 用
nginx-module-vts或 Prometheus + nginx-exporter 监控nginx_upstream_response_time和nginx_proxy_temp_files指标，发现 temp file 数量突增及时告警 - 在磁盘满前设置保护：在
proxy_temp_path所在分区挂载时加noatime,nodiratime减少元数据写入；或用 tmpfs 挂载小容量高速缓存（如mount -t tmpfs -o size=2g tmpfs /var/lib/nginx/proxy_temp） - 对非关键大文件，可结合
limit_rate限速，把长连接 I/O 压力摊平，避免瞬时峰值
