独立服务器部署负载均衡,如何处理跨节点会话保持?
首次把两台独立服务器放到负载均衡后,最容易漏掉的不是请求分发,而是登录状态:用户在节点 A 登录,下一次请求落到节点 B,如果会话只保存在 A 的本地文件中,B 就无法识别该用户。上线时应优先把会话存入两台应用节点都能访问的共享存储,再由负载均衡器分发请求;按客户端 IP 固定节点可以暂时减少跨节点访问,却不能解决节点故障后的会话丢失。
下面以一台 Nginx 入口、两台运行同一 PHP 应用的独立服务器和一个已有的 Redis 会话服务为例,完成首次部署。操作重点是先让应用共享会话,再开放双节点入口,最后用登录请求和节点切换验证。其他应用语言也遵循同一判断标准,但应使用其框架提供的会话存储配置,不能照搬 PHP 配置项。

围绕双节点应用与统一入口的部署,A5idc数据提供中国香港、美国、日本等地区的物理服务器,涵盖不同的CPU、内存、SSD或NVMe存储及带宽线路选择,可为Nginx入口、应用节点和自建会话存储提供按角色配置的硬件资源。面向不同地区的访问需求,其多地区服务器资源也为规划业务入口与应用部署位置提供了选择。
准备条件:先确认会话在哪里
示例环境中的地址仅用于说明,执行前须替换为实际内网地址、域名和证书路径。
| 角色 | 示例地址 | 上线前应确认 |
|---|---|---|
| Nginx 入口 | 10.20.0.10 | 能访问两个应用节点的 8080 端口;已有匹配业务域名的有效证书 |
| 应用节点 A、B | 10.20.0.11:8080、10.20.0.12:8080 | 运行相同版本的应用;各自直接访问 /health 返回正常结果 |
| Redis 会话服务 | 10.20.0.30:6379 | 两个应用节点均可连接;已配置访问控制、容量与故障处理方案 |
| 业务域名 | app.example.com | 测试时能解析到入口,或使用 curl --resolve 指定入口地址 |
本文的 PHP 命令以 Ubuntu 24.04、PHP 8.3 FPM 为例,且假定这两台机器的 PHP-FPM 实例专供该应用使用。若同一 FPM 实例还承载其他站点,不能把会话配置写入全局 conf.d:那会改变其他站点的会话存储;应改在该应用专属 FPM 池或框架配置中设置。应用若已自行接管会话,也应修改框架配置,而不是期望 php.ini 覆盖它。
实施前记录当前入口配置、PHP 会话配置及服务状态,并备份即将修改的文件。切换现有业务的会话存储可能使旧的本地文件会话无法在新存储中读取,应安排维护窗口,提前确定是否允许存量用户重新登录。Redis 只应允许应用节点和必要的管理端访问,不应把服务端口直接暴露给公网;会话服务本身若不可用,共享会话方案也会受影响。
先在入口机器核验两个后端,而不是安装完 Nginx 才发现其中一台应用不可用:
curl -fsS -o /dev/null -w 'A: %{http_code}\n' http://10.20.0.11:8080/health
curl -fsS -o /dev/null -w 'B: %{http_code}\n' http://10.20.0.12:8080/health
预期两次均显示 200。/health 应由应用提供,并至少反映进程是否可接收请求;它返回 200 不等于 Redis 会话读写正常,后者还要通过登录和跨节点访问验证。如果接口名称或成功状态码不同,以应用实际约定为准,先不要把异常节点加入入口。
第一步:让两个应用节点使用同一会话存储
PHP 默认可以把会话写到本地文件。对这种部署,只更换 Nginx 的分发算法,不能让节点 B 读到节点 A 的会话。这里使用 PhpRedis 会话处理器,将两台应用的会话指向同一个 Redis 服务,并为该应用设置独立的键前缀。
在两台应用节点分别确认 PHP-FPM 版本和 Redis 扩展;安装命令只适用于上述 Ubuntu/PHP 版本,版本不同时先核验实际包名与配置目录:
php -v
systemctl status php8.3-fpm --no-pager
php-fpm8.3 -m | grep -i redis
如果 FPM 模块列表没有 redis,先在对应节点安装扩展,再重新核验:
sudo apt update
sudo apt install php8.3-redis
php-fpm8.3 -m | grep -i redis
安装可能触发相关服务重载,应在维护窗口执行。改动前备份现有 FPM 配置;若目标文件已存在,也先备份该文件,不要直接覆盖。对于专用 FPM 实例,在两台节点分别编辑 /etc/php/8.3/fpm/conf.d/99-site-session.ini,内容保持一致:
session.save_handler = redis
session.save_path = "tcp://10.20.0.30:6379?auth[]=session-app&auth[]=REPLACE_WITH_SECRET&timeout=2.5&read_timeout=2.5&prefix=siteA:"
session.gc_maxlifetime = 1800
session.cookie_secure = 1
session.cookie_httponly = 1
这里的 session-app 是预先创建的 Redis 访问身份,REPLACE_WITH_SECRET 必须替换为实际凭据;示例值不能直接上线。凭据保存在受限配置文件中,不要提交到代码仓库或贴入工单。若凭据含有 URL 特殊字符,先按所用 PhpRedis 版本核验参数编码方式。1800 的单位是秒,表示示例会话有效期设置为 30 分钟;它需要与应用自身的登录过期策略一致。cookie_secure = 1 以用户通过 HTTPS 访问为前提。PhpRedis 支持在 session.save_path 中设置认证、连接及读取超时等参数。(packagist.org)
确认配置文件仅授权必要的管理员读取,再在每台节点执行语法检查和重载:
sudo chmod 600 /etc/php/8.3/fpm/conf.d/99-site-session.ini
sudo php-fpm8.3 -t
sudo systemctl reload php8.3-fpm
systemctl is-active php8.3-fpm
预期语法检查成功,服务状态为 active。这只能证明 FPM 接受配置,不能单凭命令确认应用真的使用了 Redis:框架可能覆盖 PHP 原生会话处理器。下一步必须结合应用登录行为验证。
第二步:配置双节点 Nginx 入口
在入口机器确认 Nginx 的 conf.d/*.conf 位于 http 配置块内,并备份现有入口配置。如果 Nginx 尚未安装,可在入口机器执行 sudo apt install nginx;安装后核查默认站点及现有监听端口,避免与正在运行的服务冲突。以下文件示例为 /etc/nginx/conf.d/session-lb.conf,仅在确认该文件未承载原有业务、证书文件已经就位后写入。
log_format session_lb
'$remote_addr "$request" status=$status '
'upstream=$upstream_addr upstream_status=$upstream_status '
'request_time=$request_time';
upstream app_nodes {
server 10.20.0.11:8080 max_fails=2 fail_timeout=10s;
server 10.20.0.12:8080 max_fails=2 fail_timeout=10s;
}
server {
listen 80;
server_name app.example.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
server_name app.example.com;
ssl_certificate /etc/ssl/site/fullchain.pem;
ssl_certificate_key /etc/ssl/site/privkey.pem;
access_log /var/log/nginx/session-lb.access.log session_lb;
location / {
proxy_pass http://app_nodes;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $remote_addr;
proxy_set_header X-Forwarded-Proto https;
proxy_connect_timeout 2s;
proxy_read_timeout 30s;
proxy_next_upstream error timeout http_502 http_503 http_504;
}
}
这份配置采用默认的轮询分发:会话已共享时,请求落到 A 或 B 都应能读取同一登录状态。日志记录实际后端地址和状态码,但不记录 Cookie 值。示例假定客户端直接到达这台 Nginx;若前面还有 CDN 或其他入口,应先划定可信来源并正确配置真实客户端地址,不能无条件相信请求自带的转发头。max_fails、fail_timeout 属于请求失败后的被动判断,不应把它误认为 Nginx 会主动轮询 /health。
proxy_next_upstream 可在所列失败条件下尝试其他后端,但不要把它当成业务写入请求的“自动重试保证”:请求体发送状态和操作是否可重复执行都影响结果。支付、下单等操作还需由应用自身处理幂等性。(nginx.org)
替换域名、地址和证书路径后,先检查再启用:
sudo nginx -t
sudo systemctl reload nginx
systemctl is-active nginx
如果此前 Nginx 未运行,应在确认端口及默认站点行为后启动,而不是对未运行的服务执行重载。预期 nginx -t 报告配置检查成功,服务为 active;若检查失败,不要重载,先按报错行检查证书路径、分号、配置块位置及是否与现有监听冲突。
第三步:按“请求到达—登录保持—节点切换”验证
先检查 HTTPS 入口和证书。将以下变量换成真实值;--resolve 只让本次 curl 请求连向指定入口,不会修改正式 DNS:
DOMAIN=app.example.com
GATEWAY=10.20.0.10
curl -fsS -o /dev/null -w 'HTTP %{http_code}\n' \
--resolve "$DOMAIN:443:$GATEWAY" \
"https://$DOMAIN/health"
预期获得应用约定的健康状态,且没有证书校验错误。这里不使用 -k 跳过校验:证书域名或信任链有问题,应在放量前修正。若响应是 502,先检查 Nginx 到两台节点的网络与应用监听;若证书校验失败,则检查域名、证书链和证书有效性,不要从会话配置开始排查。
接着从入口连续发起请求,观察两台节点是否都接到流量:
for i in 1 2 3 4 5 6; do
curl -fsS -o /dev/null \
--resolve "$DOMAIN:443:$GATEWAY" \
"https://$DOMAIN/health"
done
sudo tail -n 20 /var/log/nginx/session-lb.access.log
预期日志中的 upstream= 能看到 10.20.0.11:8080 和 10.20.0.12:8080。健康请求分散,只证明入口在分流,还不能证明登录会话跨节点可用。
最后使用测试账号,通过指向该入口的域名完成一次真实登录,再连续访问应用的已登录页面或“当前用户”接口。保持同一个浏览器会话,核对入口日志:当这些已登录请求分别落到 A、B 时,两边均应识别同一账号,不应一会儿成功、一会儿跳回登录页。若应用要求 CSRF 令牌、购物车状态或表单暂存,也选一个有代表性的流程测试;只检查登录页是否打开,覆盖不了这些会话内容。

在预发布环境或维护窗口,还应做一次受控摘除:备份 Nginx 配置,把当前承载测试会话的节点在 upstream 中临时标记为 down,通过 nginx -t 后重载,再访问同一已登录页面。预期请求转到另一节点且登录仍有效。测试结束立即恢复原配置、再次检查并重载,确认两台节点重新接收请求。不要通过直接停掉生产应用进程来代替这一步;摘除操作会影响所有被路由到该节点的流量。
异常处理:先辨认失败发生在哪一层
| 现象 | 优先检查 | 不同结果意味着什么 |
|---|---|---|
| HTTPS 无法访问或证书报错 | 域名解析、入口监听、证书域名与文件路径 | 请求尚未进入正常应用链路,先修入口 |
入口返回 502、504 | 日志中的 upstream、后端端口与应用日志 | 无法连接、连接超时或后端响应异常;暂不归因于会话 |
| 只有落到另一节点时掉线 | 两节点实际启用的会话驱动、Redis 地址、前缀及凭据 | 常见于一台仍写本地文件,或两台使用不同存储配置 |
| 两个节点都突然无法登录 | Redis 连通性、认证、容量及应用错误日志 | 共享存储可能不可用;Nginx 分流正常也无法补救 |
| 登录后立刻再次跳转登录页 | 浏览器是否保存并回传 Cookie,域名、HTTPS、Cookie 属性及应用会话过期策略 | Cookie 未回传时,先修客户端与入口设置;已回传再查服务端读取 |
| 偶发会话字段回退 | 同一会话的并发写入、应用更新逻辑及会话锁策略 | 共享存储解决“能否读到”,不自动解决并发覆盖 |
排查日志时,不要把完整会话 ID、认证 Cookie 或 Redis 凭据写进公开日志和工单。如果应用使用框架自带会话组件,以应用运行时的实际配置和错误日志为准;php.ini 中写着 redis,不代表框架一定采用它。
本地会话暂时无法迁移时
如果应用短期内只能使用节点本地会话,可把 Nginx 的 upstream 块临时改为以下形式,其他代理配置保持不变:

upstream app_nodes {
ip_hash;
server 10.20.0.11:8080 max_fails=2 fail_timeout=10s;
server 10.20.0.12:8080 max_fails=2 fail_timeout=10s;
}
ip_hash 按客户端地址选择后端,同一地址通常会继续落到同一节点;但节点不可用时,请求会改投其他节点,而本地会话不会随之转移。多人共用出口地址时,还可能集中到同一后端。因此,这只能作为明确接受“故障时部分用户重新登录”后的过渡方案,不是本文跨节点会话验收的替代品。不要在开源版 Nginx 配置中照抄商业版的 sticky cookie 指令。
上线验收与回滚检查项
- 入口验收: 域名与证书校验通过;两台应用节点均可从入口访问;日志能显示实际后端地址和异常状态码。
- 会话验收: 同一测试账号的已登录请求分别落到 A、B 后仍保持登录;受控摘除其中一台后,另一台仍能读取会话。
- 依赖验收: 两台应用均使用预期的会话驱动、Redis 地址及键前缀;Redis 仅向授权节点开放,并已明确其故障处理方式。
- 配置回滚: 如果入口配置导致故障,先恢复备份的 Nginx 配置,执行
nginx -t,通过后重载,再检查原有入口和业务请求。 - 会话回滚: 如果必须恢复旧的本地文件会话配置,先把流量收回单节点或使用已评估风险的临时固定路由,再恢复应用配置并验证登录。不要删除新的 Redis 会话数据,也不要假定切回本地文件后,新建立的会话仍可读取。
完成这些检查,才算验证了“请求可以跨节点分发”与“会话可以跨节点继续使用”这两件不同的事。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/8745.html



