Haproxy会话保持:基于Cookie优化

说明

  • 在仅使用 balance source 时,HAProxy 会基于客户端源 IP 做哈希,能保证同一台机器(相同出口 IP)的多个请求大概率落到同一后端,但不能区分同一机器的不同浏览器或不同浏览器的不同会话。
  • 使用基于 cookie 的会话保持,可以在浏览器级别实现"会话粘性":同一浏览器(同一 Cookie)会话会被路由到同一后端,而不同浏览器可被路由到不同后端。

示意图(已保留原图):

外链图片转存中...(img-eGUb2nyi-1769333492187)

配置示例(在 haproxy.cfg 中):

haproxy 复制代码
listen webcluster
    bind        *:80
    balance     roundrobin
    hash-type   consistent

    # 在响应中插入名为 WEBCOOKIE 的 cookie(由 HAProxy 插入)
    # insert : 当后端未设置 cookie 时由 HAProxy 插入
    # nocache : 指示浏览器不要缓存带有此 cookie 的页面
    # indirect : 客户端的 cookie 不会覆盖 server 的 cookie(更安全)
    cookie WEBCOOKIE insert nocache indirect

    # 每个 server 指定其 cookie 名称(用于标识该 server)
    server haha 192.168.0.10:80 cookie web1 check inter 3s fall 3 rise 5 weight 2
    server hehe 192.168.0.20:80 cookie web2 check inter 3s fall 3 rise 5 weight 1

说明各项含义

  • cookie insert:当后端响应中没有该 cookie 时,HAProxy 会插入名为 <name> 的 cookie。
  • server ... cookie :给每个后端指定一个 cookie 值(如 web1、web2),HAProxy 会把该值写入客户端 cookie,用于后续请求路由。
  • nocache:提示浏览器或中间缓存不要缓存带有该 cookie 的响应。
  • indirect:禁止客户端通过设置 cookie 来直接影响后端选择(更安全);有 rewrite、indirect 等其它选项,可根据需求选用。
  • hash-type consistent:如果配合 hash 类算法,建议使用一致性哈希以减小节点变更时抖动;这里对 cookie 保持不是必须项,但保留可提升稳定性。

测试方法(浏览器)

  • 打开两个不同浏览器(例如 Firefox、Edge),访问 haproxy 的前端 URL:
    • 你会看到每个浏览器被固定到某个后端(因浏览器分别保存各自的 cookie)。
  • 在同一浏览器中打开新标签��或刷新,应保持在同一后端(相同 cookie)。

示例截图(保留原实验截图):

  • Firefox(示例)

    外链图片转存中...(img-Gy1q4eVU-1769333492188)

  • Edge(示例)

    外链图片转存中...(img-hJjMfDBE-1769333492188)

其它注意事项与扩展

  • 后端应用本身若也设置了相同名称的 cookie(例如会话 cookie),需注意命名冲突或选择 cookie <name> prefix|rewrite 等策略进行配合。
  • 若需要更严格的安全(HTTPS、Secure、HttpOnly��,可在后端或通过 HAProxy 设置相关响应头/cookie 属性(例如通过 http-response set-cookie 或在后端直接设置)。
  • 若想在 HAProxy 层面把已有后端 cookie 用作路由依据(而非 HAProxy 插入),可以使用 cookie 的 preserve/rewrite 等选项或使用 stick 表(stick-table + stick on cookie)来实现更复杂的粘性策略。
  • 对于需要跨子域或设置路径的情况,请注意 cookie 的 Domain / Path 属性(通常由后端或 response header 指定)。

常见故障排查

  • 浏览器不保存 cookie:检查请求与响应头(Set-Cookie)、是否有 SameSite/Domain/Path/secure 限制、是否在 HTTP(非 HTTPS)下被浏览器策略阻止。
  • 插入 cookie 无效:确认 haproxy 配置中的 cookie 行语法正确,且配置已重载:systemctl restart haproxy 或 haproxy -f /etc/haproxy/haproxy.cfg -c 校验。
  • 多级代理或缓存:如果请求经过代理或缓存,可能会影响 cookie 的传递,应排查中间路径上的行为。

示例验证命令(命令行)

  • 使用 curl 查看 Set-Cookie:
    curl -I http:///
  • 使用 curl 带 cookie 请求:
    curl -b "WEBCOOKIE=web1" http:///

结束语

  • 本方法适合对"同一浏览器会话"实现粘性路由,使用简单直观;若需要跨设备或更复杂的会话管理,可考虑结合 stick-table、session 存储或应用端会话同步。
相关推荐
无忧.芙桃7 小时前
Linux系统编程(四):用户与权限管理
linux·运维·服务器
谙弆悕博士9 小时前
多智能体架构详解:层级树状架构(分级主从型)
运维·架构·大模型·agent·多智能体·langgraph·层级树状
HMS工业网络12 小时前
工业远程访问的五项安全部署原则
运维·服务器·安全
吴建旭 智宅焕13 小时前
智能家居全国交付中执行端能力评估与分级调度架构设计:从注册数量到交付确定性的系统实现
运维·智能家居·devops
IT大白鼠15 小时前
eBPF 观测入门:用 bpftrace 给服务器装上“内核摄像头“
运维·服务器·ebpf
分布式存储与RustFS15 小时前
Zeppelin 笔记本重启就丢:三个环境变量把 .zpln 存进 RustFS 桶
运维·云原生·开源·对象存储·分布式存储·s3·性能基准
好用斋16 小时前
内网测速 LibreSpeed:网页版 Docker 测速服务
运维·docker·容器
江华森17 小时前
从零开始:智能运维概念与Linux环境准备完全指南
linux·运维
橙橙子23018 小时前
Linux----libevent
linux·运维·服务器
如夏倾城19 小时前
五大远程桌面协议:RDP、SSH、VNC/RFB、Citrix ICA/HDX 与 VMware Blast Extreme
运维·windows·网络协议·安全·自动化·ssh·远程工作