讲师中心 微信公众号

工具推荐

视频效率加速
立刻MV
立刻MV

低成本歌曲 MV、视频生成

Laper
Laper

剧本策划到成片协作

Seko
Seko

AI短剧一键生成成片

AniShort
AniShort

AI短剧协同制作平台

Nginx ip_hash 如何解决后端下线后会话丢失

落浩小哥_1888

落浩小哥_1888

发布时间:2026-11-19 21:24:04

|

284人浏览过

|

来源于php中文网

原创

nginx 的 ip_hash 通过哈希算法将客户端 ip 固定映射到特定后端服务器,当该后端下线时,nginx 默认会将请求重新分配给其他存活节点,导致会话丢失。要解决此问题,需结合 max_fails 和 fail_timeout 参数配置健康检查,并在 nginx 1.9.0+ 版本中启用 hash 指令的 consistent 选项(即一致性哈希),以减少后端变动时的哈希环扰动,从而降低会话迁移概率。

Nginx ip_hash 如何解决后端下线后会话丢失

如何配置 ip_hash 的健康检查与故障转移

在传统的 ip_hash 配置中,Nginx 依赖 upstream 块中的 server 指令属性来判断后端状态。当某个后端服务器被标记为不可用(例如因 max_fails 达到阈值)时,Nginx 会将来自该 IP 的请求转发到其他可用的后端服务器上。这种机制虽然保证了服务可用性,但直接导致了原属于该 IP 的会话数据在新后端上不存在,从而引发会话丢失。因此,首要步骤是调整 max_fails 和 fail_timeout 以平衡故障检测的灵敏度与误判率。

Nginx ip_hash 如何解决后端下线后会话丢失

http {
    upstream backend {
        # 使用 ip_hash 确保同一 IP 访问同一后端
        ip_hash;
        
        # 设置最大失败次数为 3,超时时间为 30 秒
        # 如果 30 秒内连续失败 3 次,则标记该 server 为 down
        server 192.168.1.101:8080 max_fails=3 fail_timeout=30s;
        server 192.168.1.102:8080 max_fails=3 fail_timeout=30s;
        server 192.168.1.103:8080 max_fails=3 fail_timeout=30s;
    }

    server {
        listen 80;
        location / {
            proxy_pass http://backend;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
        }
    }
}

上述配置中,max_fails=3 表示在 fail_timeout=30s 的时间窗口内,如果 Nginx 向某台后端服务器发起的请求有 3 次失败(如连接拒绝或超时),则该服务器将被暂时标记为不可用。此时,来自原本应路由到该服务器的 IP 的请求会被重新哈希到其他存活的后端。为了减少这种重定向带来的会话丢失,可以增大 fail_timeout 的值,或者使用更稳定的网络环境。此外,确保后端应用本身具备快速恢复能力也是关键。

Nginx Reverse Proxy
Nginx Reverse Proxy

配置 Nginx 反向代理,实现域名绑定。用户说“绑定域名”“配置 Nginx”“反向代理”时触发,将域名绑定到指定 IP:端口。

下载

如何使用一致性哈希减少会话迁移

从 Nginx 1.9.0 开始,ip_hash 的实现方式有所改进,支持基于一致性哈希算法。传统 ip_hash 使用简单的取模算法,当后端节点增减时,大量请求的路由目标会发生剧烈变化。而一致性哈希通过将后端节点和客户端 IP 映射到一个虚拟圆环上,当某个节点下线时,只有部分请求会迁移到相邻节点,从而显著减少了会话丢失的范围。要启用此功能,需在 upstream 块中使用 hash 指令并指定 consistent 关键字。

Nginx ip_hash 如何解决后端下线后会话丢失

http {
    upstream backend {
        # 使用 hash 指令替代 ip_hash,并启用 consistent 模式
        hash $remote_addr consistent;
        
        server 192.168.1.101:8080;
        server 192.168.1.102:8080;
        server 192.168.1.103:8080;
    }

    server {
        listen 80;
        location / {
            proxy_pass http://backend;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
        }
    }
}

在此配置中,hash $remote_addr consistent; 取代了 ip_hash;。它使用 $remote_addr 作为哈希键,并采用一致性哈希算法。当后端服务器 192.168.1.101 下线时,只有那些哈希值落在 192.168.1.101 和下一个存活节点之间的请求才会被重新路由。大部分请求仍会留在原来的节点上,从而最大限度地保留了会话状态。需要注意的是,一致性哈希要求所有后端节点在逻辑上保持对称,因此在添加或删除节点时,应尽量平滑操作,以避免大规模的哈希重分布。

后端下线后具体哪些会话会丢失

当后端服务器因故障或维护而下线时,Nginx 会根据当前的负载均衡策略重新分配请求。对于使用 ip_hash 的场景,原本路由到该下线下游节点的 IP 地址的请求会被转移到其他存活节点。这意味着,这些 IP 对应的会话数据(通常存储在内存或本地文件中)在新的后端节点上不存在,从而导致会话丢失。具体来说,丢失的会话仅限于那些哈希值指向已下线节点的客户端 IP。如果使用了一致性哈希,则只有哈希环上受影响的少量 IP 会经历会话迁移,其余 IP 的会话保持不变。

热门AI工具

更多
墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

豆包大模型

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

WorkBuddy

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

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

码上飞
码上飞 Hot

一款基于自然语言的AI应用开发平台,可根据用户描述自动生成应用程序,帮助个人和团队快速完成应用原型与开发。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

DeepSeek

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

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

3103

2023.08.11

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

7630

2024.03.19

后端的主要工作内容介绍
后端的主要工作内容介绍

后端是应用程序的服务端部分,负责核心任务,如数据库交互、业务逻辑处理和响应客户端请求。想了解更多后端的相关内容,可以阅读本专题下面的文章。

7246

2024.03.19

服务器是什么
服务器是什么

服务器是一种计算机硬件设备或软件程序,它具有强大的计算和存储能力,用请求、存储数据和提供服务。它在互联网中着关重要的作用,为用户提供各种服务和资源。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

457

2023.08.15

连接apple id服务器时出错
连接apple id服务器时出错

连接apple id服务器时出错的原因包括网络连接问题、服务器问题、Apple ID账户问题、设备问题、防火墙或安全软件问题、时间和日期设置问题、Apple服务器维护等。本专题为大家提供apple id相关的文章、下载、课程内容,供大家免费下载体验。

1020

2023.09.08

搭建互联网服务器
搭建互联网服务器

搭建互联网服务器需要:1、选择合适的硬件和操作系统,第一步是选择合适的硬件和操作系统;2、安装和配置操作系统,是搭建互联网服务器的关键步骤;3、安装和配置服务器软件,是搭建互联网服务器的下一步,常见的服务器软件包括Apache、Nginx、Tomcat等;4、配置防火墙和安全性,是搭建互联网服务器的重要步骤;5、域名解析和配置,是搭建互联网服务器的最后一步。

3732

2023.09.19

如何查看服务器状态
如何查看服务器状态

查看服务器状态的方法有使用命令行工具、图形界面工具、监控工具、日志文件和远程管理工具等。本专题为大家提供服务器状态相关的文章、下载、课程内容,供大家免费下载体验。

1216

2023.10.09

服务器域名转接慢怎么解决
服务器域名转接慢怎么解决

服务器域名转接慢的解决办法有DNS优化、服务器优化、CDN加速、前端优化和网络优化等。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

1089

2023.10.17

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

20

2026.11.17

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
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