讲师中心 微信公众号

工具推荐

视频效率加速
updream

一键生成高质量推广成片

Laper
Laper

剧本策划到成片协作

AniShort
AniShort

AI短剧协同制作平台

Seko
Seko

AI短剧一键生成成片

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

浅丽小哥_5328

浅丽小哥_5328

发布时间:2026-11-20 15:27:05

|

641人浏览过

|

来源于php中文网

原创

在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不变,连接就会保持在同一后端。

Websocket Hub Patterns
Websocket Hub Patterns

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

下载

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

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

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`参数来控制对故障服务器的重试策略,但这些参数主要影响新连接的分配,对已建立的长连接影响有限。

热门AI工具

更多
UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

SoundView
SoundView Hot

SoundView是一款面向跨境电商的视频翻译、配音和本地化 AI 创作平台。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

相关专题

更多
nginx 重启
nginx 重启

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

423

2023.07.27

nginx 配置详解
nginx 配置详解

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

4387

2023.08.04

nginx配置详解
nginx配置详解

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

7365

2023.08.04

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

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

601

2024.02.23

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

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

1516

2024.07.09

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

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

4018

2024.08.07

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

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

122

2026.01.13

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

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

617

2026.01.13

Nginx CVE-2026-123007排查与防护指南
Nginx CVE-2026-123007排查与防护指南

Nginx HTTP/2漏洞该怎么修复?本专题围绕CVE-2026-123007,介绍安全版本升级、模块兼容检查和配置恢复方法,以及日志排查、权限设置等后续加固操作,方便你按实际部署情况查找对应教程。

0

2026.11.20

热门下载

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

精品课程

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

共0课时 | 0人学习

nginx手册
nginx手册

共0课时 | 0人学习

进程与SOCKET
进程与SOCKET

共6课时 | 0.5万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn