Nginx 模块配置中怎么配置 Upstream 模块的 hash 散列算法-Nginx-PHP中文网

nginx upstream支持普通hash和hash consistent两种哈希，但ip_hash不支持权重；推荐使用hash $variable consistent配合weight实现可加权、高粘性的持久化绑定，且需置于upstream块内server之前。

nginx 模块配置中怎么配置 upstream 模块的 hash 散列算法

直接说结论：Nginx 的 upstream 模块支持两种 hash 类型——普通哈希（hash）和一致性哈希（hash ... consistent），但不支持在 ip_hash 指令下加权重；真正可配置、可加权、可持久化的哈希方案，是用 hash 指令配合变量（如 $remote_addr 或 $cookie_xxx），并启用 consistent 参数。

用 hash + consistent 实现带权重的稳定绑定

这是最常用也最推荐的方式，既能保留 weight，又能保证客户端长期落在同一台后端上：

必须写在 upstream 块内，且要放在所有 server 行之前
语法格式为：hash $variable consistent;，其中 $variable 可以是任意 Nginx 内置变量或自定义变量
consistent 是关键参数，它启用一致性哈希算法，节点增减时影响范围小，粘性更稳定
每个 server 行可正常配置 weight、max_fails、fail_timeout 等参数

示例配置：

upstream app_backend {
  hash $remote_addr consistent;
  server 10.0.1.10:8080 weight=4;
  server 10.0.1.11:8080 weight=2;
  server 10.0.1.12:8080 weight=1;
}

按 Cookie 或登录态做哈希更可靠

如果业务真正依赖用户会话（比如登录态、购物车），仅靠 IP 不够稳定（NAT、代理、移动网络频繁换 IP），建议优先用 Cookie 值哈希：

Nginx

在宝塔面板中轻松管理Nginx高性能Web服务器。提供可视化配置反向代理、负载均衡、SSL证书及HTTP缓存功能，一键优化高并发性能，助您高效搭建稳定、快速的网站运行环境。

下载

使用 $cookie_jsessionid、$cookie_session_id 或自定义 cookie 名（如 $cookie_user_token）
要求后端稳定生成该 Cookie，且客户端每次请求都携带（浏览器默认行为）
若 Cookie 缺失，Nginx 默认 fallback 到轮询；可叠加双哈希策略增强容错

双哈希兜底写法：

upstream app_backend {
  hash $cookie_session_id consistent;
  hash $remote_addr consistent;
  server 10.0.1.10:8080 weight=3;
  server 10.0.1.11:8080 weight=1;
}