Nginx WebSocket 代理如何配置负载均衡会话保持

浅丽小哥_5328

浅丽小哥_5328

2026-11-20

641人浏览

原创

在nginx中实现websocket负载均衡的会话保持,核心在于利用http协议的`upgrade`机制将连接从http升级至websocket,并配合`ip_hash`或`sticky`模块确保同一客户端的请求始终路由到后端同一个节点。具体做法是在`upstream`块中配置`ip_hash`指令以基于源ip进行哈希分发,同时在`server`块中正确设置`proxy_pass`、`proxy_http_version`为1.1以及关键的`upgrade`和`connection`头部透传。这样做可以确保websocket长连接在建立后不会因负载均衡器的随机转发而中断,同时通过ip哈希保证后续请求的一致性。

Nginx WebSocket 代理如何配置负载均衡会话保持

如何配置Upstream以实现基于IP的会话保持

要实现基于IP的会话保持,需要在Nginx配置文件的`http`上下文中定义一个`upstream`块,并在其中使用`ip_hash`指令。该指令会根据客户端的源IP地址计算哈希值,从而将来自同一IP的所有请求固定发送到同一个后端服务器。这对于WebSocket这种需要维持长连接状态的协议至关重要,因为如果连接被分散到不同的后端节点,之前的状态信息将无法访问。此外,为了支持WebSocket,必须显式地定义变量来传递`Upgrade`和`Connection`头部,否则Nginx默认行为可能会丢弃这些头部导致升级失败。

Nginx WebSocket 代理如何配置负载均衡会话保持

upstream websocket_backend {
    ip_hash;
    server 192.168.1.10:8080;
    server 192.168.1.11:8080;
    server 192.168.1.12:8080;
}

server {
    listen 80;
    server_name example.com;

    location /ws/ {
        proxy_pass http://websocket_backend;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

上述配置中,`ip_hash`确保了会话保持。`proxy_http_version 1.1`是必须的,因为WebSocket升级依赖于HTTP/1.1的特性。`proxy_set_header Upgrade $http_upgrade`和`proxy_set_header Connection "upgrade"`负责将客户端发起的升级请求传递给后端。当客户端发送带有`Upgrade: websocket`头部的请求时,Nginx会将其转发给选定的后端服务器,后端确认后返回101 Switching Protocols,随后TCP连接转为WebSocket协议。此配置适用于大多数场景,只要客户端IP不变,连接就会保持在同一后端。

如何处理非标准端口或反向代理下的Header透传

当WebSocket服务运行在非标准端口或通过多层反向代理时,正确透传Header是保持连接稳定性的关键。除了基本的`Upgrade`和`Connection`头部外,还需要确保`Host`、`X-Real-IP`等头部被正确传递,以便后端应用能识别真实的客户端信息。在某些复杂网络拓扑中,可能需要自定义Header名称或使用正则表达式匹配特定的路径。此外,如果后端服务器对Header大小写敏感,需确保Nginx配置的Header格式符合后端要求。对于使用Cookie进行会话保持的场景,虽然`ip_hash`是基于IP的,但也可以结合`sticky`模块(如Nginx Plus或第三方模块)基于Cookie ID进行更精细的控制,但这通常用于更复杂的微服务架构。

Websocket Hub Patterns
Websocket Hub Patterns

可水平扩展的 WebSocket 中心模式,支持懒加载 Redis 订阅、连接注册表和优雅关闭。适用于构建可跨多实例扩展的实时 WebSocket 服务器。

下载

Nginx WebSocket 代理如何配置负载均衡会话保持

# 假设后端运行在8081端口,且需要透传自定义Header
upstream ws_custom_backend {
    ip_hash;
    server 192.168.1.20:8081;
    server 192.168.1.21:8081;
}

server {
    listen 443 ssl;
    server_name secure.example.com;

    # SSL配置省略...

    location /api/ws {
        proxy_pass http://ws_custom_backend;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        # 透传自定义Header,例如前端生成的Token
        proxy_set_header X-Custom-Token $http_x_custom_token;
        
        # 设置超时时间,防止长连接被意外断开
        proxy_read_timeout 86400s;
        proxy_send_timeout 86400s;
    }
}

在这个例子中,我们展示了如何在SSL终止点配置WebSocket代理。`proxy_read_timeout`和`proxy_send_timeout`设置为86400秒(一天),这是为了防止Nginx在长时间无数据传输时主动断开WebSocket连接,因为WebSocket设计上是长连接的。如果后端应用有心跳机制,这个值可以根据实际情况调整。`X-Custom-Token`的透传示例说明了如何扩展Header处理以满足特定业务需求。确保所有相关Header都被正确设置,可以避免后端应用因缺少必要信息而拒绝连接或产生错误。

当后端服务器宕机时Nginx的行为与故障转移

在配置了`ip_hash`的负载均衡环境中,如果某个后端服务器宕机,Nginx会自动将该IP的后续请求转移到其他可用的后端服务器。然而,对于已经建立的WebSocket连接,如果其所在的后端服务器突然宕机,现有的连接将会中断,客户端需要重新连接。Nginx本身不会自动重连已断开的WebSocket连接,这需要客户端应用层实现重连逻辑。此外,Nginx的健康检查机制(如果是Nginx Plus或使用了第三方模块)可以标记宕机的服务器为不可用,从而避免新的连接请求被发送到该服务器。对于开源版Nginx,可以通过配置`max_fails`和`fail_timeout`参数来控制对故障服务器的重试策略,但这些参数主要影响新连接的分配,对已建立的长连接影响有限。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

nginx websocket

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
nginx 重启
nginx 重启

nginx重启对于网站的运维来说是非常重要的,根据不同的需求,可以选择简单重启、平滑重启或定时重启等方式。本专题为大家提供nginx重启的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.27

423

5

nginx 配置详解
nginx 配置详解

Nginx的配置是指设置和调整Nginx服务器的行为和功能的过程。通过配置文件,可以定义虚拟主机、HTTP请求处理、反向代理、缓存和负载均衡等功能。Nginx的配置语法简洁而强大,允许管理员根据自己的需要进行灵活的调整。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

4387

6

nginx配置详解
nginx配置详解

NGINX与其他服务类似,因为它具有以特定格式编写的基于文本的配置文件。本专题为大家提供nginx配置相关的文章,大家可以免费学习。

2023.08.04

7365

6

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

601

5

nginx报404怎么解决
nginx报404怎么解决

当访问 nginx 网页服务器时遇到 404 错误,表明服务器无法找到请求资源,可以通过以下步骤解决:1. 检查文件是否存在且路径正确;2. 检查文件权限并更改为 644 或 755;3. 检查 nginx 配置,确保根目录设置正确、没有冲突配置等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.07.09

1516

5

Nginx报404错误解决方法
Nginx报404错误解决方法

解决方法:只需要加上这段配置:try_files $uri $uri/ /index.html;即可。想了解更多Nginx的相关内容,可以阅读本专题下面的文章。

2024.08.07

4018

3

nginx部署php项目教程汇总
nginx部署php项目教程汇总

本专题整合了nginx部署php项目教程汇总,阅读专题下面的文章了解更多详细内容。

2026.01.13

122

12

nginx配置文件详细教程
nginx配置文件详细教程

本专题整合了nginx配置文件相关教程详细汇总,阅读专题下面的文章了解更多详细内容。

2026.01.13

617

23

Nginx跨平台安装实操指南:Windows、macOS与Linux环境快速搭建
Nginx跨平台安装实操指南:Windows、macOS与Linux环境快速搭建

本指南详解Nginx在Windows、macOS及Linux系统的安装全流程。涵盖官方包解压、Homebrew一键部署、APT/YUM源配置及Docker容器化方案。无论新手或开发者,均可快速搭建运行环境,掌握跨平台核心指令,为后续配置与调优奠定坚实基础。

2026.03.16

179

12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpEnv手册
phpEnv手册

共0课时 | 0人学习

nginx手册
nginx手册

共0课时 | 0人学习

进程与SOCKET
进程与SOCKET

共6课时 | 0.5万人学习