OpenPortal认证计费系统-用户手册 · 黑白名单管理

适用系统：OpenPortalServer V6 后台 — 黑白名单管理

手册说明：本文所有截图取自系统实际界面并按页面原样展示（未做任何遮挡），实际参数以生产环境为准。

一、模块概述

「黑白名单」决定谁能免认证直接上网、谁被拒绝上网、谁只能在指定时段上网。三类名单的区别：

白名单与黑名单都按「所属分组」隔离：A 组的管理员只能看到并维护 A 组的名单，跨组数据互不可见。

二、手机号白名单

2.1 列表

查询条件

操作按钮

列表字段：编号、名称、手机号、所属分组、管理员、说明、在线数、相关操作（修改、删除）。

「在线数」显示该手机号当前有几台设备在线。数字异常大时说明被多人共用，建议核查。

2.2 添加 / 修改

操作步骤

1. 点「添加」。
2. 选择所属部门，填写名称与手机号。
3. 保存后回到列表，确认新条目出现且分组正确。
4. 用该手机号实际走一次认证验证是否真的免认证。

修改与添加是同一个界面，区别是修改时手机号等原有内容已经填好。

2.3 批量导入

1. 点「模板下载」，得到 Excel 模板。
2. 按模板列填写（不要改动表头，不要增删列）。
3. 回到本页，选择填写好的文件。
4. 点「提交」等待导入结果。

注意事项

• 一次导入数量较多时耗时会变长，请等待页面返回结果再离开。
• 导入前先导出一次现有名单，避免重复导入造成重复条目。
• 模板中的必填列留空会导致该行被跳过。

2.4 手机号在线详情

查看某个手机号当前正在使用的设备：分组、姓名、来源、IP、MAC、时长。

• 「手机号在线详情」与「在线详情 API」两个入口展示的内容一致，前者供后台查看，后者供外部系统调用。
• 用户反馈「我的手机号明明在白名单里却上不了网」时，先看这里是否有在线记录：没有记录说明没走到白名单放行，应检查号码是否填错、分组是否匹配。

三、手机号白名单审批

用户在前台自助提交手机号申请后，需要管理员审核才会进入白名单。

3.1 审批列表

查询条件：名称、手机号、说明、分类、状态（未审批 / 通过 / 拒绝 / 全部，默认未审批）。

操作按钮：刷新、删除勾选、全部删除。

列表字段：编号、名称、手机号、所属分组、申请时间、状态、审批时间、管理员、来源、备注、相关操作。

行内操作

3.2 审批页面

操作步骤

1. 在审批列表按「状态 = 未审批」筛选。
2. 逐条查看申请内容，必要时与申请人核对。
3. 点「审批」，选择「通过」或「拒绝」，点「保存」。
4. 通过后到「手机号白名单列表」确认该号码已出现。

审批 = 放行上网。对来源不明的申请应先拒绝或暂缓，避免被滥用。

四、Mac 地址白名单

4.1 列表

查询条件：名称、Mac 地址、说明、分类、在线（全部 / 离线 / 在线）。

操作按钮：添加、导入、导出、刷新、删除勾选、全部删除。

列表字段：编号、名称、Mac 地址、所属分组、管理员、说明、状态、相关操作。

与手机号白名单相比，Mac 白名单多一列「状态」，用于标识该条目当前是否生效。终端设备的 MAC 是硬件地址，适合给固定的设备（打印机、摄像头、机顶盒）做免认证。

4.2 添加 / 修改

注意事项

• MAC 地址填错（少一位、分隔符不一致）会导致放行失败。
• 手机等移动设备的 MAC 可能随机变化，不建议大量加入白名单。
• 批量导入与手机号白名单流程一致，在列表点「导入」下载模板。

4.3 Mac 白名单审批

列表字段与操作方式与「手机号审批」一致：编号、名称、Mac 地址、所属分组、申请时间、状态、审批时间、管理员、来源、备注、相关操作。

审批页面字段：Mac 地址、申请时间、名称、所属部门、备注、审批（通过 / 拒绝）。

五、IP 地址白名单

5.1 列表

查询条件：名称、开始 IP、结束 IP、说明、分类。

操作按钮：添加、导入、导出、刷新、删除勾选、全部删除。

列表字段：编号、名称、开始 IP、结束 IP、所属分组、管理员、说明、相关操作。

IP 白名单以地址段为单位，适合整层楼、整间机房或整个网段免认证的场景。

5.2 添加 / 修改

注意事项

• 开始 IP 必须小于或等于结束 IP，否则该条不生效。
• 添加整段前先确认该段确实是可信网络，IP 白名单等于完全放行，填错会把未认证用户暴露出去。
• 终端 IP 由 DHCP 分配时会变化，白名单可能失效；此类场景建议改用 MAC 白名单。

5.3 IP 白名单审批

列表与审批页的字段、操作方式与前述两种审批一致，审批页字段为：开始 IP、结束 IP、申请时间、名称、所属部门、备注、审批。

六、MAC 黑名单

6.1 列表

黑名单的字段很少：只需要一个 MAC 地址，加入后该设备将无法通过认证上网。

6.2 添加 / 修改

使用要点

• 封禁前先确认 MAC 无误，封错会导致正常用户完全无法上网，且很难自行发现原因。
• 该终端若已在线，封禁后可能仍保持在线直到下一次认证。
• 解封即删除该条记录，删除后终端可重新认证。

6.3 批量导入

点「模板下载」得到模板 → 填写 MAC 与备注 → 选择文件 → 提交。

导入前务必核对模板中的 MAC 格式，格式不符的行会被跳过且不会提示。

七、时间限制

7.1 列表

时间限制的作用是在指定时间段内不允许某个用户组上网，例如「学生宿舍每天 23:00–06:00 断网」。

7.2 添加 / 修改

操作步骤

1. 点「添加」。
2. 填写名称与时段：跨零点的时段（如 23:00 到 06:00）按提示填写即可。
3. 选择星期、日期、月份，确定规则的适用范围。
4. 选择用户组——这是规则真正作用的对象，选错等于无效。
5. 填写排序，保存。
6. 到点后用该组的测试账号验证是否被断网。

注意事项

• 时段的时、分两栏都是必填，且必须落在提示的数值范围内。
• 同一用户组配置多条规则时，按「排序」先后判断。
• 规则只影响新认证或下一轮检测，不会立刻切断已在线用户。

八、Mac 非法接入记录

当终端尝试用被限制的 MAC 接入时，系统会记录下来供追溯。

查询条件：MAC、IP、协议、BASIP、NASIP、开始时间、结束时间。

操作按钮：删除勾选、删除全部、按搜索结果导出、刷新、查询、数据设置、确定（分页跳转）。

列表字段：序号、MAC 地址、IP 地址、协议、BAS 地址、NAS 地址、最后记录时间、时内次数、操作。

用途：排查「某台设备始终连不上」时，先查这里——如果出现在非法接入记录中，说明该 MAC 已在黑名单或被 MAC 限制策略拦下。

九、手机号绑定记录

记录手机号与设备 MAC 的绑定关系。

查询条件：手机号码、MAC 地址、姓名。

操作按钮：删除勾选、删除全部、刷新、查询、数据设置、确定（分页跳转）。

列表字段：编号、手机号码、MAC 地址、姓名、操作。

用途

• 短信认证、手机号白名单会把手机号与设备绑定；绑定后换设备可能无法直接认证。
• 用户反馈「换手机后要重新认证」「同一个号只能在一台设备上用」时，到这里查看并删除旧绑定即可。
• 删除绑定记录后，用户下次认证会重新建立绑定。

十、常见问题