# 在线用户

<!-- BookStack import page: id=mon-online chapter=系统监控 -->

## 功能定位

在线用户列出当前仍持有有效会话的账号、客户端、设备类型、所属部门、登录地址、浏览器、操作系统和登录时间。管理员可据此确认异常会话、排查重复登录或执行强制退出。

![在线用户](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-lvoypupn.png)

*图 9-1　在线会话筛选、列表和安全强退入口*

## 适用角色

超级管理员、系统管理员和安全运维人员。普通业务用户只能在个人中心查看自己的在线设备。

## 页面入口

系统监控 → 在线用户（`/monitor/online`）。

## 前置条件

- 已使用具备 `monitor:online:list` 权限的账号登录。
- 执行强制退出还需要 `monitor:online:forceLogout` 权限。
- 浏览器与服务端时间已校准，便于判断会话是否异常。

## 页面结构

| 区域 | 说明 |
|---|---|
| 筛选条件 | 登录地址、用户名称；支持回车和“搜索” |
| 在线用户列表 | 会话编号、登录名称、客户端、设备类型、部门、主机、地点、系统、浏览器、登录时间 |
| 操作 | 强制退出当前会话 |
| 分页 | 显示总数、每页条数，可切换页码或每页数量 |

## 操作步骤

1. 进入“系统监控 → 在线用户”。
2. 输入登录地址或用户名称，点击“搜索”。空条件则返回当前授权范围内的在线会话。
3. 核对客户端、设备类型、登录地点、浏览器和时间，判断是否为本人或受信设备。
4. 对离职账号、遗失设备或明显异常会话，点击行尾“强退”按钮。
5. 在确认框中再次核对账号和会话，确认后使该会话失效。
6. 强退后用“操作日志”和“登录日志”复核事件；不要把它当作封禁账号的替代手段。
7. 若风险来自账号泄露，应同时停用账号、重置密码并检查角色授权。

## 输入与输出

- 输入：用户名称、登录地址、当前会话筛选条件。
- 输出：会话列表、在线设备信息和强制退出结果。
- 强退只终止目标令牌对应的会话，不删除账号，也不改变角色权限。

## 宏澜家电示例

安全管理员发现一个已离职区域经理的账号在非工作时间从陌生地点登录。先筛选该账号，核对设备与浏览器后强制退出；随后在用户管理中停用账号、重置密码，并由审计人员复核该账号近期访问的报表和数据导出记录。

## 安全与隐私

- 截图和工单中不得公开完整会话编号、主机地址或账号信息。
- 帮助中心展示的截图已对会话、账号、客户端和主机信息脱敏。
- 只有经过授权的安全人员可以查看和处理全体在线会话。
- 强退生产用户前应评估是否正在执行报表导出、数据配置或调度操作。

## 客户应用演示：强制退出异常在线会话

**业务情境：** 安全告警显示一个未知设备登录了管理员账号。

### 第一步：进入“系统监控 → 在线用户”

![第1步重点操作：进入“系统监控 → 在线用户”](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-xfyzeu3f.jpeg)

*步骤图 55-01　第1步：进入“系统监控 → 在线用户”。红框标出进入系统监控 → 在线用户。*

进入“系统监控 → 在线用户”，按账号或地址搜索。

### 第二步：核对会话的登录时间、浏览器、地址和最后活动时间

![第2步重点操作：核对会话的登录时间、浏览器、地址和最后活动时间](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-pkmjjh7d.jpeg)

*步骤图 55-02　第2步：核对会话的登录时间、浏览器、地址和最后活动时间。红框标出核对会话的登录时间、浏览器、地址和最后活动时间。*

核对会话的登录时间、浏览器、地址和最后活动时间。

### 第三步：与账号所有者确认是否为本人操作

![第3步重点操作：与账号所有者确认是否为本人操作](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-jrhibmbw.jpeg)

*步骤图 55-03　第3步：与账号所有者确认是否为本人操作。红框标出与账号所有者确认是否为本人操作。*

与账号所有者确认是否为本人操作。

### 第四步：确认异常后点击“强退”

![第4步重点操作：确认异常后点击“强退”](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-xfjxbonf.jpeg)

*步骤图 55-04　第4步：确认异常后点击“强退”。红框标出确认异常后点击强退。*

确认异常后点击“强退”，并通知用户立即修改密码。

### 第五步：复查登录日志和操作日志

![第5步重点操作：复查登录日志和操作日志](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-pzu5o3ji.jpeg)

*步骤图 55-05　第5步：复查登录日志和操作日志。红框标出复查登录日志和操作日志。*

复查登录日志和操作日志，确认没有异常数据操作。

## 最终结果与效果

异常会话被终止，后续登录使用新凭据；安全事件有完整处理记录。

> **操作提示：** 强退前务必确认，避免误断正在进行的重要导出或建模操作。

## 常见问题

**列表为空。** 可能当前没有其他有效会话，或筛选条件过窄；先清空筛选后重试。

**强退后用户仍能访问。** 用户可能已在另一设备重新登录，或浏览器仍显示缓存页面。检查最新在线会话并要求用户重新认证。

**看不到强退按钮。** 当前账号缺少 `monitor:online:forceLogout` 权限，应通过角色授权，不要共享管理员账号。

## 开发人员参考

- 页面：`ui/src/views/monitor/online/index.vue`
- 接口：`GET /monitor/online/list`、`DELETE /monitor/online/{tokenId}`
- 权限：`monitor:online:list`、`monitor:online:forceLogout`
- 会话数据来自 Redis/Token 会话存储；服务端应校验令牌归属、租户和当前操作者权限。
- 返回浏览器或工单前，对 `tokenId`、`clientKey`、`ipaddr` 和地点字段做脱敏。