签入版本

2026-10-25 17:24:27 +08:00
parent 48911cc08f
commit fdbeae092a
1010 changed files with 30682 additions and 95274 deletions
@@ -0,0 +1,34 @@
+# 6.17 在线用户
+
+:::tip 概述
+在线用户页展示当前活跃的 JWT 会话（缓存登记，不落库），支持查看明细与强制下线。多端登录并存，每个会话独立管理。
+:::
+
+## 功能清单
+
+| 接口 | 说明 |
+|---|---|
+| Page | 分页查询在线会话（按租户隔离） |
+| Detail | 会话明细 |
+| ForceLogout | 按会话（jti）强制下线 |
+| ForceLogoutUser | 按用户强制下线（其全部会话） |
+
+## 数据来源
+
+在线登记在缓存：`online:jti:set`（有序集合，score=访问令牌过期时间）+ `online:info:{jti}`（明细 JSON：用户、IP、UA、登录时间、令牌过期）。登录时 MarkOnline、登出/强退时 MarkOffline。
+
+## 强制下线语义
+
+拉黑该会话的**访问令牌与刷新令牌**（防登出后凭刷新令牌复活）+ 移除在线登记。只影响目标会话，用户其他端不受影响（ForceLogoutUser 则清全部）。
+
+## 过期清理
+
+集合按 score（过期时间）可范围清理——令牌过期后在线记录随查询自然过滤/清理，无需专门任务。
+
+## 管理界面
+
+`monitor/online`：会话列表 + 强制下线按钮（需相应权限码）。
+
+## 相关
+
+- [5.1 用户认证（JWT）](/zh/core/jwt.html)