在 nginx 中配置 ip_hash 配合 proxy_pass,需要在 upstream 块中声明 ip_hash 指令,并在 location 块中将请求代理至该上游组。这样做会根据客户端 ip 地址的哈希值将请求固定分发到特定的后端服务器,从而实现会话保持。配置时需确保后端服务无状态或支持共享 session,且注意 ipv6 地址的处理方式。

如何定义 upstream 并启用 ip_hash
要在 Nginx 中使用 ip_hash,必须在 upstream 块内部添加 ip_hash 指令。该指令会计算客户端 IP 地址的哈希值,并将来自同一 IP 的请求始终转发到同一个后端服务器。如果某个后端服务器被标记为不可用(down),Nginx 会自动将其从哈希计算中移除,以确保服务不中断。配置示例如下:

http {
upstream backend_pool {
ip_hash;
server 192.168.1.10:8080;
server 192.168.1.11:8080;
server 192.168.1.12:8080 down;
}
server {
listen 80;
location / {
proxy_pass http://backend_pool;
}
}
}
在上述配置中,server 192.168.1.12:8080 down; 表示该节点暂时不参与负载均衡。当客户端发起请求时,Nginx 会根据其 IP 地址计算哈希值,并映射到剩余的两个活跃服务器之一。这种机制确保了同一客户端的多次请求会被路由到相同的后端实例,从而维持会话状态。
如何处理 IPv6 地址的哈希一致性
对于使用 IPv6 地址的客户端,默认的 ip_hash 实现可能会因为 IP 地址过长而导致哈希分布不均。为了解决这个问题,Nginx 提供了 ipv6 参数选项,允许指定只使用 IPv6 地址的前缀部分进行哈希计算。这有助于提高哈希值的均匀分布,避免某些后端服务器负载过高。配置方法如下:

upstream backend_pool_ipv6 {
ip_hash ipv6;
server [2001:db8::1]:8080;
server [2001:db8::2]:8080;
}
通过添加 ipv6 参数,Nginx 会使用 IPv6 地址的前 96 位进行哈希计算。这种处理方式与 IPv4 的默认行为类似,即使用整个 IP 地址进行哈希。在实际应用中,应根据客户端的网络环境选择合适的哈希策略。如果主要用户群体使用 IPv4,则无需特别配置;如果 IPv6 用户较多,建议启用 ipv6 参数以优化负载均衡效果。
ip_hash 在后端服务器宕机时的行为表现
当使用 ip_hash 时,如果某个后端服务器宕机或被手动标记为 down,Nginx 会将该服务器从哈希表中移除。这意味着原本分配给该服务器的客户端请求将被重新哈希到其他可用的后端服务器。这种行为可能导致会话丢失,因为客户端的新请求可能被路由到不同的后端实例。因此,在使用 ip_hash 时,应确保后端服务具有高可用性,或结合其他会话保持机制(如 Redis 共享 Session)来减少会话丢失的风险。











