关闭 proxy_buffering 后，nginx 会立即将上游响应头发送给客户端，并逐块转发数据流。要实现实时流式传输，需设置 proxy_buffering off;、proxy_cache off; 以及 x-accel-buffering no;（若使用后端缓冲），并确保上游服务支持分块编码（chunked transfer encoding）或流式输出。
Nginx 中 proxy_buffering 关闭后怎么实现实时流式传输
关闭 proxy_buffering 后，Nginx 不再缓存上游响应体，而是直接透传。关键配置包括 proxy_buffering off;、proxy_cache off;，并禁用后端缓冲如 X-Accel-Buffering: no;。同时上游应启用 Transfer-Encoding: chunked 以支持流式发送。此配置适用于 SSE、WebSocket 或大文件实时推送场景。
server {
listen 80;
server_name example.com;
location /stream {
proxy_pass http://upstream_backend;
proxy_buffering off;
proxy_cache off;
proxy_set_header X-Accel-Buffering no;
proxy_http_version 1.1;
proxy_set_header Connection "";
}
}
预期结果：客户端在连接建立后立即收到响应头，后续数据按上游发送节奏实时到达，无 Nginx 侧缓冲延迟。
如何验证 proxy_buffering 关闭后的流式行为
可通过 curl 请求带 -N 参数禁用缓冲，观察数据是否逐块到达。配合 wireshark 或 tcpdump 可抓包确认 TCP 分段与 Nginx 转发行为。也可在后端模拟慢速输出，验证 Nginx 是否保持连接不断开且无缓冲堆积。
# 测试命令
curl -N http://example.com/stream
# 后端模拟脚本（Python）
import time
from http.server import BaseHTTPRequestHandler, HTTPServer
class StreamHandler(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header('Content-Type', 'text/event-stream')
self.send_header('Transfer-Encoding', 'chunked')
self.end_headers()
for i in range(5):
self.wfile.write(f'data: {i}\n\n'.encode())
self.wfile.flush()
time.sleep(1)
if __name__ == '__main__':
server = HTTPServer(('localhost', 8080), StreamHandler)
server.serve_forever()
预期结果：curl 每 1 秒接收一条 data 消息，无等待全部完成才输出的现象，证明流式传输生效。
基于 upstream 返回 chunked 编码的具体问题
当上游服务返回 Transfer-Encoding: chunked 时，Nginx 在 proxy_buffering off; 下能正确透传分块数据。若上游未启用 chunked 但 Content-Length 已知，Nginx 仍会逐块转发，但可能因 TCP 窗口或内核缓冲产生微小延迟。建议上游显式声明 chunked 以优化流式表现。
