WebSocket 代理
将客户端与服务器之间的连接从HTTP/1.1转换为WebSocket时,使用HTTP/1.1中可用的 协议切换 机制。
然而,有一个微妙之处:由于“升级”是一个 逐跳 头部,它不会从客户端传递到被代理的服务器。通过正向代理,客户端可以使用 CONNECT
方法来避免此问题。然而,这在反向代理中不起作用,因为客户端不知道任何代理服务器,并且代理服务器上需要特殊处理。
自版本1.3.13起,nginx实现了一种特殊的操作模式,允许在客户端和被代理服务器之间建立一个隧道,如果被代理服务器返回了一个带有代码101(切换协议)的响应,并且客户端通过请求的“升级”头部请求协议切换。
如上所述,包括“升级”和“连接”在内的逐跳头部不会从客户端传递到被代理的服务器,因此为了让被代理的服务器知道客户端要将协议切换到WebSocket的意图,这些头部必须被显式地传递:
location /chat/ { proxy_pass http://backend; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header 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帧以重置超时并检查连接是否仍然活动。