傳統 Session 存儲於伺服器 (記憶體/Redis/資料庫),擴展時面臨同步、單點故障、黏性 Session 等難題。客戶端 Session 將加密後的 Session 資料直接存於 Cookie,實現真正的無狀態水平擴展。本文基於 client-sessions 庫,詳細講解 Express 整合、資料讀寫、安全機制與即時登出 (Persona 風格) 實現。
const express = require('express');
const clientSessions = require('client-sessions');
const app = express();
// 中介軟體配置
app.use(clientSessions({
cookieName: 'session', // Cookie 名稱
secret: '0GBlJZ9EKBt2Zbi2flRPvztczCewBxXK', // 必須:強隨機長字串 (生產環境用環境變數)
duration: 24 * 60 * 60 * 1000, // 24 小時有效期
activeDuration: 1000 * 60 * 5, // 活躍延長 5 分鐘
httpOnly: true, // 防 XSS
secure: true, // 僅 HTTPS (生產環境必開)
ephemeral: false // true = 瀏覽器關閉即失效
}));
// 登入:寫入 Session
app.post('/login', function(req, res) {
// 驗證帳號密碼...
req.session.userId = 12345;
req.session.username = 'johndoe';
req.session.role = 'admin';
res.json({ success: true });
});
// 讀取 Session
app.get('/profile', function(req, res) {
if (!req.session.userId) return res.status(401).send('未登入');
res.json({ username: req.session.username, role: req.session.role });
});
// 登出:銷毀 Session
app.post('/logout', function(req, res) {
req.session.reset(); // 刪除 Cookie
res.json({ success: true });
});
問題:伺服器無法直接刪除客戶端 Cookie。用戶改密碼/被封禁/管理員強制登出時,舊 Session 仍有效直到過期。
sessionVersion 欄位 (預設 0)。req.session.sv = user.sessionVersion。user.sessionVersion++ 並儲存,所有舊 Session 瞬間失效。// 中介軟體:驗證 Session 版本
function validateSessionVersion(req, res, next) {
if (!req.session.userId) return next(); // 未登入略過
User.findById(req.session.userId, function(err, user) {
if (err) return res.status(500).send('DB error');
if (!user) {
req.session.reset();
return res.status(401).send('用戶不存在');
}
if (req.session.sv !== user.sessionVersion) {
req.session.reset();
return res.status(401).send('Session 已失效,請重新登入');
}
req.user = user; // 掛載用戶物件供下游使用
next();
});
}
app.use(validateSessionVersion); // 掛載在 session 中介軟體之後
// 強制登出端點 (管理員/修改密碼後調用)
app.post('/admin/force-logout/:userId', function(req, res) {
User.findByIdAndUpdate(req.params.userId, { $inc: { sessionVersion: 1 } }, function(err) {
if (err) return res.status(500).send('Failed');
res.json({ success: true });
});
});
Persona 使用 token 欄位而非版本號:
token,寫入用戶表與 Session。null 或重新生成。優點:Token 可攜帶額外資訊 (裝置 ID、登入地點);缺點:每請求額外查詢 (通常合併在用戶查詢中,開銷可忽略)。
secret 必須 32+ 字元高熵值字串,存於環境變數/密鑰管理系統,定期輪換 (舊密鑰保留驗證舊 Cookie 直到自然過期)。httpOnly: true 防 XSS、secure: true 僅 HTTPS、sameSite: 'lax' 防 CSRF。userId、sessionVersion/token、role 等授權所需最小集合;用戶資料、權限詳情每請求從資料庫/快取讀取。activeDuration 滑動延長,平衡安全與體驗。| 場景 | 推薦方案 |
|---|---|
| 無狀態微服務、Kubernetes 部署、極致水平擴展 | 客戶端 Session (client-sessions / iron-session) |
| 傳統單體應用、已有 Redis 集群、需 Session 列表/管理後台 | 伺服器端 Session (express-session + connect-redis) |
| 跨域/多子域 SSO、行動端 App、第三方整合 | JWT (JSON Web Token) + Refresh Token 機制 |
| 高安全性、頻繁權限變更、審計追蹤 | 伺服器端 Session + 即時失效機制 |
客戶端 Session 以「以空間換時間、以計算換儲存」的巧妙設計,完美契合雲原生無狀態架構。掌握其原理與即時登出模式,是構建可擴展、可運維 Node.js 服務的關鍵技能。