# 登录会话

> 查看已登录设备、强制下线，并设置网页、桌面和移动端的会话上限与空闲时长。

Source: https://yile2020.github.io/fastapi-react-admin/features/login-sessions/

每次登录都会创建一个服务端会话。本页介绍怎么查看已登录的设备、让指定会话下线，以及调整多久不操作就退出。

## 查看并结束一个会话

**入口：**「系统监控 → 在线用户」（`/monitor/online`）。只有**超级管理员**能查询会话和强制下线；给普通角色授予菜单，不会同时获得这些接口的权限。

1. 按用户、登录端、IP、浏览器和登录时间找到目标会话。
2. 核对最后活跃时间、实时连接状态和剩余有效期，确认是要处理的设备。
3. 对目标会话执行「强制下线」。

**看到什么算成功：** 有实时连接的页面立即回到登录页并显示原因；没有实时连接时，下次请求会收到带原因的 401。同一浏览器中，一个标签页退出后，其他标签页也会退出。

<details>
<summary>查看在线用户截图</summary>

</details>

## 设置时长与设备上限

每次登录在服务端建一个会话，会话 ID 从登录到退出不变。登录时客户端说明自己是哪一端，三端各用一套规则：

<div className="doc-table-scroll" role="region" aria-label="会话规则对照" tabIndex={0}>

| 规则 | 网页端 | 桌面端 | 移动端 |
|---|---|---|---|
| 空闲超时 | 120 分钟 | 120 分钟 | 30 天 |
| 最长登录（从登录那一刻算，一直在用也不延长） | 7 天 | 7 天 | 90 天 |
| 同一账号在这一端的会话上限 | 不限 | 不限 | 1 |
| 超过上限时 | 挤掉最久没活跃的 | 挤掉最久没活跃的 | 挤掉最久没活跃的 |

</div>

都在参数配置「会话策略」里改；超限时也可以选「拒绝新登录」。要「单设备登录」，把上限填 1。改了只影响**之后的**登录，已经登录的人按登录那一刻的规则走完。

## 被踢下线时，本人看到什么？

会话结束时服务端记下原因，被踢的人下一次请求拿到的 401 里就带着它，页面直接回到登录页并显示：

| 原因 | 登录页上的提示 |
|---|---|
| 管理员强制下线 | 你已被管理员强制下线，请重新登录 |
| 超过会话上限被挤掉 / 在同一个浏览器里重新登录 | 账号已在其他设备登录，本设备已下线 |
| 空闲超时 | 长时间未操作，已自动退出，请重新登录 |
| 到了最长登录时间 | 登录已过期，请重新登录 |
| 改了密码 / 被重置密码 | 密码已修改，请重新登录 |
| 账号被停用或删除 | 账号已被停用，请联系管理员 |
| refresh token 被重复使用 | 检测到登录凭据被重复使用，已强制下线；如果不是你本人操作，请尽快修改密码 |

## 空闲时间和令牌怎么计算

<details>
<summary>查看活跃上报与令牌续期规则</summary>

**空闲按「人有没有在操作」算，不按请求算。** 在线用户页每 10 秒轮询一次，监控页、导出进度也在后台发请求 —— 按请求算的话，人走开了、浏览器开着，会话永远不会过期，而那正是空闲超时要防的场景。所以浏览器每个请求都带上「距上次键盘 / 鼠标 / 触屏操作过了几秒」，服务端据此推算最后活跃时间；在页面上有操作（滚动、打字）却一直没发请求的人，前端每 5 分钟补一次心跳。

access token 30 分钟过期，靠 refresh token 续；refresh token 每用一次就换一枚新的。上一枚在 30 秒内再出示（多个标签页同时刷新、弱网重试）会拿到同一组新令牌；超过 30 秒再出示，判定凭据可能被盗，**整个会话立即作废**。

</details>

会话原子操作使用单实例 Redis 的 Lua 脚本，尚未在 Redis Cluster 上实测。

## 在演示站里试试

[在线演示](https://fra.wubunan.com/sign-in)（`admin` / `123456`）：用两个浏览器（或一个普通窗口 + 一个无痕窗口）各登录一次，到「系统监控 → 在线用户」能看到两条会话，各自的登录端、浏览器、最后活跃时间都在。把**你自己的另一条**强制下线，那个窗口会当场回到登录页并显示原因。演示站所有人共用 `admin`，别踢别人的会话；演示站有没有配 `MFA_SECRET_KEY` 也不保证，二次验证建议在本地试。

## 继续阅读

- [登录安全配置](https://yile2020.github.io/fastapi-react-admin/reference/security-config/)：会话参数键名与默认值。
- [登录与安全](https://yile2020.github.io/fastapi-react-admin/features/login-security/)：密码和二次验证的设置。
