Nginx WebSocket代理支持二进制传输

Nginx 默认支持 WebSocket 二进制帧代理，但需配置 proxy_http_version 1.1、透传 Upgrade 和 Connection 头、关闭 proxy_buffering、调大 proxy_read_timeout/proxy_send_timeout，否则易导致连接中断、数据截断或协议降级。

Nginx 默认支持 WebSocket 代理，但对二进制帧（Binary Frame）的传输需满足特定配置条件，否则可能出现连接中断、数据截断或协议降级为文本帧等问题。

WebSocket 协议升级必须完整透传

Nginx 要正确代理 WebSocket，需显式处理 Upgrade 和 Connection 头部，确保客户端发起的协议升级请求不被过滤或改写：

• 必须设置 proxy_http_version 1.1 —— WebSocket 基于 HTTP/1.1 的 Upgrade 机制
• 必须传递 Upgrade $http_upgrade 和 Connection "upgrade"，且不能被其他指令覆盖（如 proxy_set_header Connection "" 会破坏升级）
• 若上游服务使用自定义 WebSocket 实现（如基于 Netty 或 ws 库），需确认其接受并响应标准 Upgrade 流程

二进制帧本身无需额外配置，但依赖 TCP 层完整性

Nginx 对 WebSocket 数据帧（包括文本帧和二进制帧）不做解析或修改，只要连接保持长连接、未触发超时或缓冲限制，二进制数据即可透明转发：

• 二进制帧（opcode = 2）与文本帧（opcode = 1）在 Nginx 视角下无区别，均作为原始字节流转发
• 关键限制来自 proxy_buffering off 和 proxy_buffer_size 设置：若开启缓冲且二进制包超过缓冲区大小，可能引发分块粘包或截断
• 建议显式关闭代理缓冲：proxy_buffering off，避免 Nginx 尝试缓存整个消息体

超时与连接稳定性直接影响大二进制流传输

长连接空闲或大文件分片上传过程中，Nginx 默认超时参数极易导致连接意外关闭：

• proxy_read_timeout 和 proxy_send_timeout 应设为较大值（如 3600），否则接收/发送间隔稍长即断连
• proxy_timeout（非标准指令，勿误用）不存在；真正生效的是 proxy_read_timeout（等待上游响应数据的时间）
• 若前端使用浏览器 WebSocket API 发送 ArrayBuffer，需确保分片逻辑与服务端匹配，Nginx 不参与分片控制，仅保证帧顺序和完整性

验证二进制支持是否生效的方法

不依赖日志，直接通过行为判断：

• 用浏览器控制台执行 ws.send(new Uint8Array([0x01, 0x02, 0xFF]))，观察服务端是否收到原样字节数组
• 抓包检查 WebSocket Frame：Wireshark 过滤 websocket，确认 Frame Type 显示 BINARY 且 Payload 与发送一致
• 若服务端返回 400 Bad Request 或连接立即关闭，大概率是 Upgrade 头未透传；若数据错乱或长度不符，优先检查缓冲与超时设置