WebSocket 代理

要将客户端和服务器之间的连接从 HTTP/1.1 转换为 WebSocket, 协议 switch 机制。

然而,有一个微妙之处: 由于 “Upgrade” 是一个逐跳 Headers,它不会从 Client 端传递到代理服务器。 通过正向代理,客户端可以使用该方法来规避此问题。 但是,这不适用于反向代理, 由于客户端不知道任何代理服务器, 并且需要在代理服务器上进行特殊处理。CONNECT

从 1.3.13 版本开始, nginx 实现特殊作模式 允许在 Client 端和 Proproxiesed 之间设置隧道 server(如果代理服务器返回了带有代码的响应) 101 (交换协议)、 客户端通过 “Upgrade” 请求协议切换 标头。

如上所述,包括 “Upgrade” 的逐跳报头 和 “Connection” 不会从客户端传递到代理 server,因此为了让代理服务器知道客户端的 为了将协议切换到 WebSocket,这些标头必须为 显式传递:

location /chat/ {
    proxy_pass http://backend;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
}

一个更复杂的例子 其中 “Connection” 标头字段的值 在对代理服务器的请求中,取决于是否存在 客户端请求标头中的 “Upgrade” 字段:

http {
    map $http_upgrade $connection_upgrade {
        default upgrade;
        ''      close;
    }

    server {
        ...

        location /chat/ {
            proxy_pass http://backend;
            proxy_http_version 1.1;
            proxy_set_header Upgrade $http_upgrade;
            proxy_set_header Connection $connection_upgrade;
        }
    }

默认情况下,连接将关闭 如果代理服务器在 60 秒内没有传输任何数据。 可以使用 proxy_read_timeout 指令增加此超时。 或者,可以配置代理服务器 定期发送 WebSocket ping 帧重置超时 并检查连接是否仍处于活动状态。