OpenPortal认证计费系统-用户手册 · Portal 在线记录日志
适用系统：OpenPortalServer V6 后台 — Portal 在线记录日志
手册说明：本文所有截图取自系统实际界面并按页面原样展示（未做任何遮挡），实际参数以生产环境为准。
一、模块概述
本模块把与「谁在上网」相关的数据集中在一起，按用途可分为三类：
| 类别 | 功能 | 页面地址 | 说明 |
|---|---|---|---|
| 统计 | 历史在线统计 | /historyonline/list.action | 按小时记录在线人数，用于趋势分析 |
| 在线 | 在线列表 | /portalOnline/list.action | 当前通过 Portal 上网的用户，可强制下线 |
| 在线 | wifidog 设备对接列表 | /wifidogAP/list.action | 已对接的 wifidog AP 状态 |
| 在线 | wifidog 用户在线列表 | /wifidogOnline/list.action | 通过 wifidog 上网的用户，可强制下线 |
| 历史 | 上网记录列表 | /portallinkrecordall/list.action | 全部上下线明细 |
| 历史 | 日志列表 | /portallogrecord/list.action | 认证过程日志（成功/失败原因） |
排查用户投诉时的推荐顺序：日志列表（看认证为什么失败）→ 在线列表（看当前是否在线）→ 上网记录列表（看历史上下线时间）。
二、历史在线统计
2.1 查询与操作
| 条件 / 按钮 | 说明 |
|---|---|
| 年 / 月 / 日 / 星期 / 时 | 按时间维度筛选，留空表示不限 |
| 刷新 | 重新加载列表 |
| 删除勾选 | 删除勾选记录 |
| 全部删除 | 删除全部统计记录，不可恢复 |
2.2 列表字段
| 列 | 说明 |
|---|---|
| 序号 | 排序号 |
| 在线数 | 该时间点的在线人数 |
| 年 / 月 / 日 / 星期 / 时 | 该记录对应的时间维度 |
| 记录日期 | 完整时间戳 |
| 操作 | 该行的删除入口 |
2.3 使用说明
- 系统按小时生成在线人数快照，图中「在线数」是该小时的在线人数。
- 需要看曲线趋势请到「数据分析 → 历史在线统计」。
- 该表只记录不参与计费，清理历史数据不影响用户上网。
三、在线列表
查看当前通过 Portal 认证在线的用户。
3.1 查询条件
| 条件 | 说明 |
|---|---|
| 帐号模糊 | 下拉切换是否对账号做模糊匹配 |
| 用户名 | 按登录账号筛选 |
| IP | 用户地址 |
| MAC | 用户设备物理地址 |
| BASNAME | 接入设备名称 |
| SSID | 无线信号名称 |
| APMac / APIP / APName | 无线接入点信息 |
| 认证方式 | 下拉筛选 |
| 无感知 | 是否无感知认证（下拉） |
| 客户端 | 终端类型（下拉） |
| 终端厂商 | 按厂商筛选，支持部分匹配（如填「华为」） |
| 终端型号 | 按型号筛选，支持部分匹配（如填「P40」） |
| 主机名 | 终端主机名 |
| 上线开始 / 上线结束 | 上线时间范围 |
3.2 操作按钮
| 按钮 | 作用 | 注意事项 |
|---|---|---|
| 查询 / 刷新 | 检索 / 重新加载 | — |
| 下线勾选 | 让勾选的用户立刻下线 | 会中断用户上网 |
| 全部下线 | 让当前条件下列表的用户全部下线 | 影响面大，先在测试账号上确认 |
| 用户解锁 | 解除账号的登录锁定状态 | 用于用户多次登录失败被锁定的场景 |
| 清空在线 | 清空平台侧的在线记录 | 只清记录，不通知设备 |
| 数据设置 | 选择表格显示哪些列 | 只影响显示 |
3.3 列表字段
序号、连接地址、MAC 地址、登录名、上线时间、在线时长、下行流量、上行流量、使用流量、BASNAME、SSID、APMac、APIP、AP名称、认证方式、无感知、客户端、终端型号、主机名、操作。
「终端型号」取自终端档案。终端第一次接入本系统后才会建档，刚上线的一瞬间可能显示为空，稍后刷新即可。
四、上网记录列表
保存全部 Portal 上下线明细，是核对“某人某时是否在线”的权威依据。
4.1 查询条件
帐号模糊、用户名称、IP、BASIP、MAC、BASNAME、SSID、APMac、APIP、APName、认证方式、无感知、客户端、终端厂商、终端型号、主机名、上线开始、上线结束。
4.2 操作按钮
| 按钮 | 作用 | 注意事项 |
|---|---|---|
| 查询 / 刷新 | 检索 / 重新加载 | — |
| 删除勾选 | 删除勾选记录 | 需先勾选 |
| 删除全部 | 删除当前条件下全部记录 | 不可恢复 |
| 按搜索结果导出 | 导出当前条件下的记录 | 对账时使用 |
| 导出记录 | 导出所选记录 | 需先勾选 |
| 数据设置 | 选择显示列 | — |
4.3 列表字段
| 列 | 说明 |
|---|---|
| 序号 | 记录序号 |
| IP 地址 / BAS 地址 | 用户地址与设备地址 |
| MAC 地址 | 终端物理地址 |
| 登录名 | 上网账号 |
| 上线时间 / 下线时间 | 本次上网起止时间 |
| 在线时长 | 本次上网的持续时长 |
| 下行流量 / 上行流量 / 使用流量 | 本次上网流量 |
| BASNAME、SSID、APMac、APIP、AP名称 | 接入位置信息 |
| 认证方式 | 本次的认证方式 |
| 无感知 | 是否为无感知认证 |
| 客户端 | 终端类型 |
| 终端型号 | 终端厂商 + 型号（如「华为 P40」）；未识别到则为空 |
| 主机名 | 终端主机名 |
| 原因 | 下线原因（如「主动下线」「在线同步」） |
| 操作 | 该行可用操作 |
「终端厂商 / 终端型号」由系统根据终端上网时上报的信息自动识别累积。只对识别上线之后产生的记录有值，改造前的老记录会一直显示为空，属正常现象。
五、日志列表
记录认证过程中的每一步，是排查认证失败的首选入口。
5.1 查询与操作
| 条件 / 按钮 | 说明 |
|---|---|
| 编号 | 按日志编号筛选 |
| 日志内容 | 按关键字筛选，例如填账号、IP 或 MAC |
| 查询 / 刷新 | 检索 / 重新加载 |
| 删除勾选 / 删除全部 | 删除记录，删除全部不可恢复 |
| 数据设置 | 选择显示列 |
5.2 列表字段
序号、时间、内容、操作。
「内容」一列包含设备地址、MAC、账号、动作与结果，例如：
HOST:"*" mac: 11:22:33::: 用户: aaa授权 上线时间: 2026-10-29-01-46-55 在线时长: 1分钟,在线同步!
5.3 典型排查方法
| 用户反映 | 日志中关注的关键词 |
|---|---|
| 认证失败 | MAC、账号，看是否出现“失败”“不允许认证” |
| 上不了网但显示已认证 | 看是否有“登录成功”但没有后续“在线同步” |
| 莫名掉线 | 检索账号，看是否有“主动下线”“超时”等记录 |
六、wifidog 设备对接列表
展示已对接的 wifidog AP 及其运行状态，用于判断 AP 是否在线、是否正常上报。
6.1 查询与操作
| 条件 / 按钮 | 说明 |
|---|---|
| AP ID | 按设备编号筛选 |
| AP IP | 按设备地址筛选 |
| 批量删除 | 删除勾选的 AP 记录 |
| 全部删除 | 清空全部 AP 记录，不可恢复 |
| 刷新 | 重新加载 |
6.2 列表字段
| 列 | 说明 |
|---|---|
| 序号 | 排序号 |
| AP ID | 设备编号 |
| AP IP | 设备地址 |
| 开机时长 | 设备已开机的时间 |
| 系统内存 | 设备内存占用 |
| 系统加载 | 设备负载 |
| 工作时长 | 本次工作持续时间 |
| 心跳检测时间 | 最后一次上报心跳的时间，超过预期时间未更新说明 AP 离线 |
| 操作 | 该行可用操作 |
该页数据由 AP 主动上报。AP 掉电或断网后不会立即从列表消失，需按「心跳检测时间」判断是否真正在线。
七、wifidog 用户在线列表
通过 wifidog 方式上网的用户列表。
7.1 查询与操作
| 条件 / 按钮 | 说明 |
|---|---|
| 登录名 | 按账号筛选 |
| 连接 IP | 按用户地址筛选 |
| AP ID | 按接入设备筛选 |
| 批量下线 | 让勾选的用户下线 |
| 全部下线 | 让列表内全部用户下线，影响面大 |
| 刷新 | 重新加载 |
7.2 列表字段
序号、连接 IP、MAC、登录名、上线时间、在线时长、AP ID、incoming（下行字节数）、outgoing（上行字节数）、操作。
八、常见问题
| 现象 | 原因与处理 |
|---|---|
| 用户说上不了网，但在线列表能看到 | 用「上网记录列表」核对最近一次上线时间；若时间很早，可能是设备侧会话已断，点「下线勾选」让用户重连 |
| 认证失败但日志里没有记录 | 认证请求可能没有到达本机（设备配置或网络问题），检查 Portal 端口与设备配置 |
| 在线人数曲线为 0 | 确认是否有用户实际在线；若在线列表有人而曲线为 0，检查定时任务是否正常运行 |
| wifidog AP 显示在线但用户连不上 | 看「心跳检测时间」是否为旧时间，以及该 AP 下的用户是否还在线 |
| 上网记录里某条流量为 0 | 设备未上报流量，或该次连接时间过短 |
| 导出为空 | 先点「查询」确认有结果，再导出 |