nginx代理websocket需配置三行核心指令并调优超时参数：proxy_http_version 1.1；proxy_set_header upgrade $http_upgrade；proxy_set_header connection "upgrade"；同时设置proxy_read_timeout、proxy_send_timeout为86400并关闭缓冲与gzip。

Linux 下 Nginx 代理 WebSocket，关键不在“能不能连”，而在“连得稳、升得对、不断开”。很多配置看似跑通了，一上生产就掉线、握手 400、wss 报错，根源往往就藏在几行被忽略的指令里。下面直接给可落地的模板和真正卡人的细节。

必须写的三行核心配置

WebSocket 握手依赖 HTTP/1.1 的 Upgrade 机制，Nginx 默认不传关键头，必须显式声明：

• proxy_http_version 1.1; —— 强制使用 HTTP/1.1（HTTP/1.0 不支持 Upgrade）
• proxy_set_header Upgrade $http_upgrade; —— 动态转发客户端的 Upgrade 头（值通常是 websocket）
• proxy_set_header Connection "upgrade"; —— 注意是小写 upgrade，不是 Upgrade 或 keep-alive

长连接不掉线的关键参数

握手成功后，WebSocket 是长连接，Nginx 默认 60 秒无数据就断连，必须延长：

Zynq Linux Hardware Debug

Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。

下载

• proxy_read_timeout 86400; —— 建议设为 24 小时（86400 秒），或按业务最长空闲时间调整
• proxy_send_timeout 86400; —— 同步设置，避免服务端发数据慢被掐断
• proxy_buffering off; —— 关闭缓冲，防止 Nginx 缓存 WebSocket 帧导致延迟或粘包

wss 配置要同时兼顾 TLS 和代理

wss 不是新协议，只是 ws + SSL。Nginx 需同时处理证书和升级逻辑：

• SSL 部分用标准 ssl_certificate 和 ssl_certificate_key 配置
• location 块内仍需完整复用上述三行升级头 + 超时配置
• 确保 listen 443 ssl http2; 中启用了 http2（非必需但推荐，兼容性更好）
• 不要在 wss 的 location 里加 proxy_redirect，它不适用于 WebSocket

容易踩的四个隐形坑

这些错误不会让配置加载失败，但会让连接在特定条件下突然中断：

• Host 头被覆盖：后端依赖 Host 判断租户或路由时，要加 proxy_set_header Host $host;（不是 $http_host）
• Origin 校验失败：某些后端严格校验 Origin 头，App 或 WebView 可能不带 Origin，可临时加 proxy_set_header Origin ""; （慎用，仅调试）
• 超时值未继承到 upstream：如果用了 upstream 块，proxy_read_timeout 必须写在 location 内，不能只写在 upstream 里
• gzip 干扰帧格式：WebSocket 数据帧不是文本，开启 gzip 可能破坏二进制帧，务必确认 gzip off; 或至少排除 WebSocket 路径