Linux 怎么使用 ip_hash 策略实现会话保持功能-linux运维-PHP中文网

ip_hash;可启用基于客户端ip的会话保持，但仅适用于内网/ip稳定环境，需配合real_ip配置、禁用buffering、延长超时等调优，且不支持权重与动态扩缩容。

linux 怎么使用 ip_hash 策略实现会话保持功能

直接在 upstream 块里加 ip_hash; 就能启用基于客户端 IP 的会话保持，但光写这一行远远不够——它只在特定条件下有效，用错反而导致会话丢失、负载不均或 CDN 下完全失效。

ip_hash 的核心机制和适用前提

它对客户端 IPv4 地址取前三个字节（如 192.168.1.x 视为同一 IP）、IPv6 取完整地址做哈希，再对当前后端节点数取模，固定路由到某台服务器。这意味着：

必须是内网环境或客户端 IP 稳定（如企业办公网、固定出口 NAT）
后端服务得自己存 Session（比如 Tomcat 内存 Session、Spring Boot 默认 Session）
不能有频繁扩缩容——增减一台 server，所有 IP 的哈希映射都会偏移，大量用户会话“漂移”
不适用于公网移动用户、多层代理或 CDN 接入场景

基础配置写法与位置要求

ip_hash; 必须放在 upstream 块的最前面，且不能和其它 hash 指令（如 hash $cookie_session）共存，也不能和 weight、backup、max_fails 等参数混用——这些配置一旦开启 ip_hash 就会被忽略。

正确示例：

Alpine Linux

获取最新发布版本；聚合最新版本架构

下载

upstream app_backend {
    ip_hash;
    server 10.0.2.10:8080;
    server 10.0.2.11:8080;
    server 10.0.2.12:8080;
}

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