WebSocket与K8s集成教程 Ingress配置WebSocket支持的方法【进阶】-js教程-PHP中文网

Ingress 本身不原生处理 WebSocket 协议，但 Nginx Ingress Controller 可通过注解透传 Upgrade 和 Connection 头并调大超时实现协议升级；缺一配置即导致握手返回 400/200 而非 101。

websocket与k8s集成教程 ingress配置websocket支持的方法【进阶】

直接说结论：Ingress 本身不原生处理 WebSocket 协议，但 Nginx Ingress Controller 可以通过注解和底层 Nginx 配置补全协议升级逻辑；配置错一个关键注解，WebSocket handshake 就会返回 400 或 200 而非 101，连接直接失败。

为什么 WebSocket 在 Ingress 下容易 400/200 握手失败

Nginx 默认把所有请求当 HTTP/1.0 处理，而 WebSocket 升级需要两个强制头部：Upgrade: websocket 和 Connection: Upgrade。Ingress Controller 不会自动注入它们——除非你显式声明。

常见错误现象包括：

浏览器报错 WebSocket connection to 'ws://...' failed: Error during WebSocket handshake: Unexpected response code: 200
wscat -c ws://... 返回 error: unexpected response code: 200
服务端日志显示连接被当作普通 HTTP 请求接收，未触发 onupgrade 逻辑

根本原因不是超时，而是协议升级被拦在了 Ingress 层。必须靠注解透传或重写 header。

nginx.ingress.kubernetes.io/configuration-snippet 必须加这俩 header

这是最通用、兼容性最强的写法，适用于所有 Nginx Ingress Controller 版本（v1.0+），且不依赖 controller 的内置 WebSocket 检测逻辑。

在 Ingress 的 annotations 中添加：

nginx.ingress.kubernetes.io/configuration-snippet: |
  proxy_set_header Upgrade $http_upgrade;
  proxy_set_header Connection "upgrade";

注意点：

$http_upgrade 是 Nginx 内置变量，会原样转发客户端发来的 Upgrade 头（值为 websocket）
"upgrade" 字符串必须小写、带英文双引号，Nginx 对大小写敏感
不能写成 proxy_set_header Connection $http_connection —— 客户端可能不带该头，会导致空值传递而失败
该 snippet 会插入到 server 块内的 location 区域，无需额外 rewrite 规则

超时注解不设等于默认 60 秒，长连接必断

WebSocket 是长连接，但 Nginx Ingress 默认的 proxy-read-timeout 和 proxy-send-timeout 都是 60 秒。只要两次数据收发间隔超过 60 秒，连接就被静默关闭。

WebSocket 8.18.2

WebSocket 8.18.2 是该协议规范的一个重要迭代版本，主要优化了连接稳定性与数据传输效率。它通过全双工通信机制，允许客户端与服务器在单一长连接上实时交换数据，大幅降低传统 HTTP 轮询的开销。该版本增强了心跳保活、自动重连及二进制帧传输能力，适用于即时通讯、在线游戏及金融行情推送等低延迟场景，为开发者提供更可靠的实时网络交互基础。

下载

必须显式设置为足够长的值（单位：秒）：

nginx.ingress.kubernetes.io/proxy-read-timeout: "3600" —— 控制 Ingress 等待后端发送下一段数据的最大空闲时间
nginx.ingress.kubernetes.io/proxy-send-timeout: "3600" —— 控制 Ingress 向后端发送数据时，两次写操作之间的最大空闲时间
这两个值不是“总连接时长”，而是“两次 IO 操作之间的容忍间隔”；设太短会断连，设太大对资源无实质压力
如果业务有心跳机制（如每 30 秒 ping/pong），建议设为心跳间隔的 3–5 倍，例如 "180"