# 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)