确保二进制流完整性需关闭 proxy_buffering、透传原始响应头与状态码、调大 proxy_read_timeout 等超时参数，避免缓冲截断、头重写或连接中断。
在 Nginx 中使用 proxy_pass 转发二进制流文件（如视频、音频、大附件、PDF 等）时，确保完整性关键在于避免 Nginx 缓冲、截断、修改响应体，以及正确透传原始响应头和状态码。默认配置下 Nginx 可能因缓冲、超时或头处理导致流中断、校验失败或下载不完整。
禁用响应体缓冲与分块传输干扰
Nginx 默认会对后端响应启用缓冲（proxy_buffering on），这对流式内容极不友好——它会等待整个响应结束才开始发送客户端，破坏流式体验，还可能因内存不足截断大文件。
- 显式关闭响应缓冲：
proxy_buffering off; - 禁用自动分块编码（避免 Nginx 重写
Transfer-Encoding）：proxy_buffering off;已隐含该行为，但需额外确认不插入chunked；若后端已用Transfer-Encoding: chunked，Nginx 默认透传，无需干预 - 关闭响应头重写：添加
proxy_http_version 1.1;并确保未启用proxy_set_header Transfer-Encoding "";等覆盖操作
保持原始响应头与状态码透传
完整性依赖于客户端能准确获取原始 Content-Length、Content-Type、ETag、Last-Modified 等头字段。Nginx 若缓存或改写这些头，会导致校验失败（如 HTTP Range 请求异常、MD5/SHA256 校验不匹配）。
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
- 透传所有响应头（除少数安全头）：
proxy_pass_request_headers on;（默认即为 on，但建议显式声明） - 禁止 Nginx 自动计算并覆盖
Content-Length：proxy_buffering off;可避免此问题；若必须开启缓冲，则需配合proxy_cache_bypass和严格缓存策略，但不推荐用于流 - 不修改状态码：
proxy_intercept_errors off;（默认），防止 4xx/5xx 被 Nginx 错误页覆盖
调优超时与连接参数防中断
二进制流通常耗时长、数据量大，若超时过短，Nginx 会在传输中途关闭连接，造成“Connection reset”或“Incomplete read”。
- 延长代理超时：
proxy_read_timeout 300;（根据最大预期传输时间调整，如 30 分钟可设为1800） - 延长连接建立超时：
proxy_connect_timeout 60; - 延长请求发送超时（对大上传流也重要）：
proxy_send_timeout 300; - 启用长连接复用：
proxy_http_version 1.1;+proxy_set_header Connection '';（清除客户端传来的Connection: close，允许 keepalive）
验证完整性与调试建议
部署后务必验证端到端完整性，不能仅看是否“能下载”。重点检查：
- 对比源服务与 Nginx 代理后响应的
Content-Length和实际字节数（curl -sI查头，curl -s | wc -c查体） - 测试 Range 请求（如
curl -H "Range: bytes=0-1023" http://proxy/file.bin），确认返回206 Partial Content且Content-Range正确 - 抓包（tcpdump 或 Wireshark）观察 TCP 流是否平滑、无 RST、FIN 过早出现
- 开启 Nginx debug 日志（
error_log /path/to/debug.log debug;）关注upstream sent response header和upstream sent body行，确认无截断警告
不复杂但容易忽略。核心就三点：关缓冲、透原头、调长超时。只要后端本身返回正确流，Nginx 做好“透明管道”，完整性自然得到保障。
