Nginx WebSocket代理怎么配置 Upgrade 和 Connection 头-Nginx-PHP中文网

nginx代理websocket需正确透传upgrade和connection头：设proxy_set_header upgrade $http_upgrade;与proxy_set_header connection "upgrade";，并配置proxy_http_version 1.1;于location块内。

nginx websocket代理怎么配置 upgrade 和 connection 头

要让 Nginx 正确代理 WebSocket，关键就是把客户端发起的协议升级请求完整、准确地透传给后端服务。Upgrade 和 Connection 这两个头是 WebSocket 握手成功的硬性前提，缺一不可，且写法有明确规范。

必须显式设置 Upgrade 头

客户端在发起 WebSocket 连接时，会带上 Upgrade: websocket 请求头。Nginx 默认不转发这个头，必须手动配置：

正确写法：proxy_set_header Upgrade $http_upgrade;
使用 $http_upgrade 变量能原样保留客户端原始值（比如 websocket、h2c 或空），兼容多种升级场景
不能写成 proxy_set_header Upgrade websocket; —— 硬编码会破坏非标准协议（如 STOMP）或客户端未带 Upgrade 头时的行为

Connection 头必须设为固定字符串 "upgrade"

这个头不是简单透传，而是告诉 Nginx：“请执行协议切换”，所以它必须是明确指令：

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

最稳妥写法：proxy_set_header Connection "upgrade";
不要用 $http_connection —— 它常含多个值（如 "Upgrade, keep-alive"），Nginx 清理后只剩 keep-alive，后端收不到升级信号
如果已定义 map $http_upgrade $connection_upgrade { default upgrade; '' close; }，也可写 proxy_set_header Connection $connection_upgrade;，更严谨处理空 Upgrade 场景