Nginx代理WebSocket音视频流需透传Upgrade/Connection头、禁用缓冲、延长超时至3600秒、开启tcp_nodelay与keepalive_timeout、并配置限连及后端会话保持。

要让 Nginx 正确代理 WebSocket 并稳定承载音视频流的长连接,关键不是“打开 WebSocket”,而是确保连接不被中断、头部不被篡改、缓冲不堆积、超时不误判。音频视频流对时序敏感、数据量大、持续时间长,普通 HTTP 代理配置极易导致断连、卡顿或服务端收包异常。
必须设置的 Upgrade 和 Connection 头部
WebSocket 握手依赖两个特定 HTTP 头:Upgrade 和 Connection。Nginx 默认会过滤或重写它们,必须显式透传:
- proxy_http_version 1.1:强制使用 HTTP/1.1(WebSocket 升级机制仅在该版本有效)
- proxy_set_header Upgrade $http_upgrade:将客户端原始 Upgrade 头(通常是 "websocket")原样转发
- proxy_set_header Connection "upgrade":注意必须是字面量 "upgrade"(小写、带引号),不能写成 $http_connection —— 后者可能为空或被设为 "keep-alive"
延长超时与禁用缓冲,适配音视频流特性
默认 timeout 值(如 proxy_read_timeout=60s)对持续数分钟的语音识别或视频推流远远不够;而 proxy_buffering 开启会导致 Nginx 缓存整块音频帧再转发,破坏实时性:
- proxy_read_timeout 3600:设为 1 小时(或按业务最大会话时长设定),防止空闲期被静默断连
- proxy_send_timeout 3600:同样延长,避免大音频包分片发送时触发超时
- proxy_buffering off:彻底关闭响应缓冲,保证 PCM/WAV 数据帧逐包直通后端
- proxy_buffer_size 128k:若需保留最小缓冲(如处理小控制帧),建议不小于单次音频 chunk(如 20ms PCM @ 16kHz = ~640B,留余量设 128k 更稳妥)
防止连接被中间设备劫持或复位
运营商 NAT、防火墙、负载均衡器常因“长时间无数据”主动踢掉空闲 TCP 连接。需配合心跳与 TCP 层保活:
- tcp_nodelay on:禁用 Nagle 算法,避免小音频包(如 VAD 触发帧)延迟合并
- keepalive_timeout 3600:提升 TCP 层 keepalive 探测间隔,与 proxy_read_timeout 对齐
- 客户端应主动发送 ping 帧(如每 30s 一次),服务端及时 pong 回应 —— Nginx 不处理 ping/pong,但能透传,确保链路活跃
可选:限制并发连接与资源占用
音视频流对内存和 socket 数量消耗显著,建议在 location 或 upstream 块中增加防护:
- limit_conn addr 100:按客户端 IP 限流,防止单 IP 恶意建大量流连接
- proxy_max_temp_file_size 0:禁用临时文件缓存,避免大视频流写磁盘拖慢吞吐
- 若后端是集群,upstream 中启用 least_conn 或 ip_hash,保障同一会话始终打到同一节点(尤其涉及状态化语音识别时)











