nginx 的 ip_hash 算法本身不支持动态后端节点,因为哈希表是静态的。要实现兼容,必须使用 nginx plus 提供的 hash 指令配合 consistent 参数,或者在开源版中通过 lua 模块(如 openresty)实现一致性哈希逻辑。

开源 Nginx 如何实现动态节点的一致性哈希?
在开源 Nginx 中,标准的 ip_hash 无法处理后端节点的增删。最可行的方案是使用 njs (Nginx JavaScript) 模块或 lua-nginx-module 来手动计算哈希并选择后端。这里以 njs 为例,它允许我们在 proxy_pass 之前动态决定目标地址。

// njs script: hash.js
function select_backend(r) {
var ip = r.headersIn["X-Real-IP"] || r.remote_addr;
// 简单的 MurmurHash3 实现或调用外部库
var hash = murmurhash3(ip);
var backends = ["backend1", "backend2", "backend3"]; // 实际应从 upstream 获取
var index = hash % backends.length;
r.internalRedirect("/@" + backends[index]);
}
r.return(200, "ok");
}
上述代码展示了如何在请求进入时根据 IP 计算索引。需要注意的是,开源版没有原生的 consistent 哈希支持,因此需要自行维护后端列表和哈希环。如果后端节点变化,客户端的映射可能会发生较大偏移,除非实现了完整的一致性哈希算法。
Nginx Plus 原生支持动态节点的配置方法?
Nginx Plus 提供了原生的 hash 指令,支持 consistent 模式,这是解决动态节点兼容性问题的标准答案。配置时,不再使用 ip_hash,而是使用 hash $remote_addr consistent;。

upstream backend {
server backend1.example.com;
server backend2.example.com;
server backend3.example.com;
hash $remote_addr consistent;
}
这种配置下,当添加或删除后端节点时,只有少数客户端的请求会被重新分配到其他节点,从而保持会话的稳定性。这是 Nginx Plus 区别于开源版的核心功能之一,专门用于解决负载均衡中的动态伸缩问题。
当后端节点数量发生变化时,现有会话会丢失吗?
在使用 hash $remote_addr consistent;配置后,节点数量的变化会导致部分会话迁移,但不会导致所有会话立即丢失。一致性哈希算法确保只有受影响的哈希槽对应的客户端需要重定向。例如,增加一个节点只会影响约 1/N 的流量,其中 N 是新节点数。对于开源版的自定义实现,若未实现完整的一致性哈希,则可能面临更高的会话丢失率。


















