nginx 中 ip_hash 是最常用且原生支持的客户端 ip 绑定后端方案，对 ipv4 前 3 段或 ipv6 全地址哈希，要求 upstream 不配置 weight，不支持一致性哈希，上游有代理时需用 set_real_ip_from 等指令还原真实 ip。
在 Nginx 中，可以通过 IP 哈希（ip_hash） 实现将同一客户端 IP 的请求始终转发到同一个后端服务器，达到“绑定”效果。这是最常用、原生支持且无需额外模块的方式。
使用 ip_hash 实现固定后端绑定
ip_hash 是 upstream 指令中的内置负载均衡方法，它对客户端 IP（IPv4 取前 3 段，IPv6 取整个地址）做哈希运算，并根据结果固定分配到某台后端。只要后端列表不变，同一 IP 总会落到同一台机器。
- 只支持 IPv4 和 IPv6，自动忽略端口和协议信息
- 要求 upstream 中不能配置
weight（权重），否则会报错 - 如果某台后端 down 掉，Nginx 会临时将其剔除，此时原属该节点的 IP 流量会重哈希到其他存活节点；当它恢复后，IP 分配可能变化（非完全一致性哈希）
示例配置：
upstream backend {
ip_hash;
server 192.168.1.10:8080;
server 192.168.1.11:8080;
server 192.168.1.12:8080;
}
<p>server {
location / {
proxy_pass <a href="https://www.php.cn/link/65b5b8d1f89bf53a5713bc3afdd83e9e">https://www.php.cn/link/65b5b8d1f89bf53a5713bc3afdd83e9e</a>;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}</p>注意真实客户端 IP 的获取
如果 Nginx 前面还有 CDN、LB 或反向代理（如云 WAF、SLB），$remote_addr 就是上游代理的 IP，不是真实用户 IP，会导致 ip_hash 失效或误绑。
- 需配合
set_real_ip_from+real_ip_header指令还原真实 IP - 常见做法：信任上游代理网段，从
X-Forwarded-For或X-Real-IP头中提取最左侧/可信段的 IP
示例（假设上游代理网段为 10.0.0.0/8）：
set_real_ip_from 10.0.0.0/8;
real_ip_header X-Forwarded-For;
real_ip_recursive on; # 启用递归解析，取最后一个非信任 IP
<p>upstream backend {
ip_hash;
server 192.168.1.10:8080;
server 192.168.1.11:8080;
}</p>替代方案：一致性哈希（hash 指令）
若需要更强的稳定性（例如增减后端时尽量减少 IP 重分布），可用 hash 指令配合 consistent 参数（Nginx Plus 或开源版 1.19+ 支持）：
-
hash $remote_addr consistent;提供 Ketama 一致性哈希，节点变动影响更小 - 支持
weight，也支持变量（如$http_x_forwarded_for），灵活性更高 - 注意：开源 Nginx 1.19 之前不支持
consistent，需确认版本
示例：
upstream backend {
hash $remote_addr consistent;
server 192.168.1.10:8080 weight=2;
server 192.168.1.11:8080;
}验证与调试建议
上线前建议验证 IP 绑定是否生效：
- 用不同公网 IP（如手机热点、朋友网络）访问，检查响应头中后端标识（如自定义
X-Upstream）是否稳定 - 查看 Nginx access log，添加
$upstream_addr变量观察实际转发目标 - 模拟后端宕机再恢复，观察同一 IP 是否发生跳变（ip_hash 下会跳变，consistent hash 下跳变更少）
