Node.js主备切换时会话安全需后端Redis统一存储session+Apache透传Cookie并配置健康检查与优雅重启。禁用MemoryStore，所有实例连同一Redis；Apache开启ProxyPreserveHost、stickysession=connect.sid，禁用Cookie重写；Node.js设httpOnly/secure/SameSite，监听SIGTERM优雅退出。
Apache 中 Node.js 部署在主备切换时保障客户端会话安全，关键不是靠 Apache 单独“记住”用户，而是构建一套可延续、可验证、不依赖单点内存的会话机制。Node.js 本身无状态，Apache 只是反向代理层，真正的会话安全必须由后端（Node.js）设计 + Apache 协同控制流量来实现。
会话安全的核心前提：避免会话绑定单节点内存
Node.js 默认用 express-session 配 MemoryStore 时，会话数据存在进程内存里。一旦主节点下线、请求切到备节点，session 就丢了——这不是 Apache 的问题，而是后端架构缺陷。所以第一步必须：
- ✅ 禁用
MemoryStore - ✅ 改用外部统一存储（如 Redis）托管 session 数据
- ✅ 所有 Node.js 实例（主/备）连接同一个 Redis 实例或集群
- ✅ session ID 通过 Cookie 透传，且 Apache 不修改、不缓存该 Cookie
这样，无论请求落到哪个 Node.js 实例，都能查到同一份会话数据。
Apache 需配合做的三件事
Apache 不生成 session，但能影响 session 是否被正确传递和延续：
诊断并恢复通过 SSH 隧道连接的 OpenClaw 节点。用于解决配对必需错误、隧道冲突、远程端点错误以及 SSH 目标配置错误等问题。
-
开启并透传会话 Cookie
确保ProxyPass和ProxyPassReverse配置中启用ProxyPreserveHost On，并确认后端返回的Set-Cookie头（含JSESSIONID或自定义名如connect.sid）未被 Apache 拦截或覆盖。
若使用stickysession，需与 Node.js 的 session cookie 名一致：ProxySet stickysession=connect.sid|Connect-SID
禁用对会话 Cookie 的重写或路径劫持
不要配置Header edit Set-Cookie "(^.*$)" "$1; Path=/"这类强制修改 Path 的规则，除非你明确知道所有 Node.js 路由都部署在同一路径层级下。否则可能造成 Cookie 不发送，导致反复登录。-
主备切换时不中断活跃会话连接
切换过程 Apache 必须做到：- 健康检查及时发现主节点失联（如
/health返回非 200） -
retry=60给足后端优雅停机时间（Node.js 收到 SIGTERM 后应继续处理完已有请求再退出） - 新请求不再打向已标记
down的节点，但已建立的长连接（如 WebSocket、Keep-Alive 请求）仍可完成
- 健康检查及时发现主节点失联（如
示例健康探测配置（确保 Node.js 提供
/health接口）：BalancerMember http://192.168.1.10:3000 route=node1 \ loadfactor=5 \ hcmethod=GET hcuri="/health" hcpasses=2 hcfails=2 timeout=3 retry=60 BalancerMember http://192.168.1.11:3000 route=node2 \ loadfactor=5 \ hcmethod=GET hcuri="/health" hcpasses=2 hcfails=2 timeout=3 retry=60 ProxySet lbmethod=byrequests ProxySet stickysession=connect.sid|Connect-SID
Node.js 端必须配合的关键动作
Apache 做得再好，如果 Node.js 不配合，会话依然不安全：
- 使用
connect-redis或express-session+redis-store，设置合理maxAge（如 30 分钟），避免长期驻留 - Session ID Cookie 设置
httpOnly: true, secure: true, sameSite: 'lax'（生产环境启 HTTPS） - 关闭
resave: true和saveUninitialized: false，减少无效写入 - 在进程退出前监听
SIGTERM，停止接受新连接，并等待现有请求（含 session 写入）完成后再退出
// 示例：优雅关闭
process.on('SIGTERM', () => {
server.close(() => {
redisClient.quit(); // 确保 session store 断开
process.exit(0);
});
});不复杂但容易忽略
