代理大文件中断主因是超时、缓冲和连接参数未合理配置；需调大proxy_connect_timeout、proxy_send_timeout、proxy_read_timeout，按流式或缓冲模式调整缓冲区，并协同优化客户端长连接与日志定位。
代理大文件时出现中断，多数情况不是 proxy_pass 本身出错，而是配套的超时、缓冲和连接控制参数未合理设置。Nginx 默认配置偏向小请求，直接转发大文件（如下载包、视频、日志归档）容易触发超时断连或内存溢出。
关键超时参数必须显式调大
Nginx 与后端建立连接后，若响应生成慢或传输慢，会因超时主动断开。需在 location 或 upstream 块中调整：
-
proxy_connect_timeout：与后端建立 TCP 连接的最长等待时间，建议设为
60s或更高（尤其后端启动慢或负载高时） -
proxy_send_timeout：Nginx 向后端发送请求体的超时，上传大文件时需增大（如
300s） -
proxy_read_timeout：Nginx 等待后端响应头/响应体的超时，下载大文件时这是最关键的项，通常设为
600s或更久
缓冲区与流式传输要匹配场景
默认开启缓冲（proxy_buffering on），Nginx 先收全响应再发给客户端——对大文件会吃光内存或触发 proxy_max_temp_file_size 限制而中断。应对方式分两类：
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
- 若后端能持续流式输出（如 Go/Python 的 chunked 响应），建议关闭缓冲：
proxy_buffering off，并配proxy_buffer_size 128k和proxy_buffers 4 256k控制单次读写粒度 - 若必须缓冲（如需修改响应头），则增大缓冲空间：
proxy_buffer_size 128k、proxy_buffers 8 4m、proxy_busy_buffers_size 8m，同时确保磁盘临时目录有足够空间且proxy_max_temp_file_size足够（如2g）
客户端侧也要协同控制
仅调后端参数不够，客户端（浏览器或 curl）可能因自身超时或 Nginx 返回的 Connection: close 提前断连：
- 用
proxy_http_version 1.1强制启用长连接，避免 HTTP/1.0 的默认短连接行为 - 加
proxy_set_header Connection ''清除上游传来的 Connection 头，防止误关连接 - 必要时配合
send_timeout（客户端空闲超时）和client_header_timeout统一延长
额外建议：加日志定位真实断点
中断发生时，仅看 502/504 不足以判断是哪一环失败。开启详细日志：
- 在
http或location块中加proxy_bind $server_addr（可选，便于抓包追踪源 IP） - 启用
error_log /var/log/nginx/proxy_error.log debug;（调试时用，生产慎开） - 检查 access log 中的
$upstream_response_time和$upstream_status字段，确认是后端未响应，还是 Nginx 主动切断
