OpenPortal认证计费系统-用户手册 · 系统管理

适用系统：OpenPortalServer V6 后台 — 系统管理

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

一、模块概述

系统管理是后台的「地基」：谁可以登录、能看哪些菜单、系统按什么规则运行、如何备份升级，都在这里配置。

推荐的初始化顺序

1. 分类管理（建立部门结构）→ 2. 角色管理（建立角色）→ 3. 为角色分配权限 → 4. 系统用户（建账号并指定分类与角色）→ 5. 系统全局设置 → 6. 定时任务与邮件 FTP → 7. 需要接收「充值成功」等业务通知时，在系统全局设置页底部配置「系统通知渠道设置」（见 4.7）。

二、组织、角色与权限

2.1 分类管理

用于给操作员分部门，方便按组织管理账号。

添加 / 修改分类

分类可以多级嵌套。建立二级分类前先建好上级分类。

2.2 角色管理

添加 / 修改角色

填写「角色名称」与「详细说明」后保存。名称建议体现职责，例如「只读运维」「财务对账」。

2.3 角色权限配置

这是控制「某个角色能看到哪些菜单」的核心页面。

• 页面按业务模块（数据分析、系统管理、Portal 管理、Radius 管理、接入账户管理、充值管理、财务管理、黑白名单管理、页面门店广告管理、Portal 在线记录日志、通知管理、AD 域-LDAP 管理、消息管理、扩展功能、定制功能、SNMP 网管）分块列出全部功能。
• 每项显示「功能名称 + 访问地址」，勾选即授权。
• 顶部「全选/反选」可一次勾选或取消整页。
• 底部「保存」提交，「取消」放弃修改。

操作步骤

1. 在角色列表点目标角色的「权限配置」。
2. 按职责勾选需要的功能；只读岗位建议只勾选「列表」「查询」类节点。
3. 点「保存」。
4. 让该角色的用户重新登录，权限才会生效。

注意事项

• 取消父节点的勾选时，其下的子功能通常也应一并取消，否则用户仍可能通过地址直接访问。
• 分配权限前先确认该用户的分类是否正确，分类与角色共同决定用户能看到的数据范围。
• 「保存」后若菜单没变化，先退出重新登录再验证。

2.4 权限管理

以「权限名称 / 访问地址 / 相关操作」的树形结构展示全部后台功能节点，可新增节点、调整顺序（上移/下移/移动）。

注意事项

• 这里的每个节点都对应左侧菜单中的一项，随意增删会导致菜单缺失或地址无法访问。
• 新增节点需同时确认访问地址与上级节点正确，否则前端不会显示。
• 调整顺序只影响菜单排列，不影响功能本身。

三、系统用户管理

3.1 系统用户列表

3.2 添加 / 修改用户

操作步骤

1. 在用户列表点「添加」。
2. 选择分类与角色（角色决定权限，务必先建好角色）。
3. 填写登录名与密码。
4. 填写姓名等基本信息。
5. 保存后通知使用人登录。

3.3 修改自己的信息

每个操作员都可以自助修改：登录名、密码、姓名、性别、电话号码、电子邮件、详细信息。

该页只能改自己的资料与密码；想调整权限需联系管理员在「角色权限配置」中处理。

安全建议

• 首次登录后立即修改默认密码。
• 密码不要与登录名相同，也不要多人共用同一账号。
• 人员离职后及时删除或停用账号。

四、系统全局设置

影响整个平台的运行参数。页面提示「本页面为系统全局设置页面！」，所有带 * 的项目都必须填写。

4.1 网络与端口

三个端口一旦修改，设备端的对接端口必须同步修改，否则认证会全部失败。改完需要重启服务。

4.2 阈值与提醒

4.3 计费与套餐

4.4 账号与认证

4.5 日志与记录

记录开关直接影响排障能力：关掉后出问题将无从追溯，生产环境建议开启上网记录与系统日志。

4.6 模板统计

修改步骤与注意

1. 逐项确认要改的参数，带【重启后生效】的项目改完必须重启服务。
2. 点「保存」。
3. 改端口、改公网地址属于高风险操作，务必在维护窗口进行，并提前通知使用方。
4. 修改后用一个真实终端完整走一次认证，确认页面能打开、认证能成功。

4.7 系统通知渠道设置

本页最下方的「系统通知渠道设置」按钮会打开一个独立弹层，用来回答三个问题：哪些业务动作要通知、通过哪些渠道通知、通知给谁。目前接入的业务是充值。

一个业务模块一块配置：页面按业务模块分块（当前只有「用户充值」一块），每个模块的渠道开关、机器人地址、标题前缀与接收人各自独立保存，互不影响；日后新增其它业务模块时，这里会自动多出一块。

首次使用必须手动开启：所有渠道出厂都是关闭状态，升级到本版本也不会自动开始发通知，需要运营人员主动勾选并保存。

短信沿用「Portal 管理 → 短信认证设置」里启用中的网关；管理员邮箱、手机号为空时自动跳过。三个群机器人渠道只发到机器人所在的群，不受「指定接收人」影响（机器人无法指定个人）。

会触发通知的充值场景

通知正文包含账户、套餐、金额、次数、支付方式、订单号、交易号、操作员、时间与来源 IP，不涉及的内容自动省略（例如没有支付平台流水的充值不显示「交易号」）。在线支付由支付平台发起，来源 IP 显示为 0.0.0.0。通知只发给后台管理员，不会发给充值用户本人；只在业务成功时发送，失败或异常不通知，也不影响充值本身。

操作步骤

1. 打开「系统全局设置」，拉到页面最下方，点「系统通知渠道设置」。
2. 在「用户充值」块勾选「启用本模块通知」。
3. 按需勾选通知渠道；勾了群机器人就填写对应地址（钉钉、飞书按需填密钥）。
4. 需要限定收件人时在「指定接收人」里勾选管理员；不勾表示通知全部后台管理员。
5. 先点「测试发送」，到群里确认收到后再点「保存」。
6. 点「关闭」回到系统全局设置页。

注意事项

• 通知是「尽力而为」，不能当收款凭证：发送高峰、队列满或网络异常时消息可能延迟甚至丢失，对账一律以「充值管理」「财务管理」的记录为准。
• 三家群机器人共用同一条发送通道，约每 3 秒发一条；充值高峰期消息会排队，与 SNMP 告警通知也共用这条通道。
• 企业微信单条正文有长度上限，过长会被截断；充值通知正文较短，一般不受影响。
• 保存后立即生效，不需要重启服务；改完建议再充一笔小额验证一次。
• 目前没有「发送记录」页面，是否发出只能到群里核对，或到「系统日志列表」查看。
• 「测试发送」发的是固定测试文案，与真实业务正文不同；能收到只说明地址与密钥正确。

五、系统维护

页面顶部显示当前系统版本，下方按功能分组排列操作图标。

5.1 常用维护操作

5.2 计划任务

5.3 重启

修改端口、公网地址、线程配置等参数后，需要「重启服务」才生效。

5.4 数据备份

建议

• 定期做「无日志」备份，重大变更前做「全额」备份。
• FTP 上传需先在「邮件 FTP 设置」中配好 FTP 参数。
• 备份文件请另存一份到其他机器，避免与服务器一起损坏。

5.5 数据库恢复

选择备份文件后点「恢复」。

恢复会用备份覆盖当前数据，当前数据将丢失。执行前务必先做一次最新备份，并确认选中的文件正确。

5.6 在线升级与本地升级

注意事项

• 升级前必须备份数据库与程序目录。
• 升级包必须与当前版本匹配，不要跨大版本跳跃升级。
• 升级过程中不要关闭服务或断电。

六、定时任务与外部服务

6.1 定时任务设置

典型用途是「每天凌晨自动备份数据库并上传 FTP」。CRON 表达式写错会导致任务不执行或频繁执行，修改后在日志中确认一次执行结果。

6.2 邮件 FTP 设置

页面提供「发送」与「上传」两个测试按钮：先测试通过再保存，可避免备份上传失败却无人发现。

6.3 FastDFS 接口设置

未部署 FastDFS 时保持「不启用」，否则上传类功能（图片、认证页、升级包）会失败。

七、系统日志

记录后台操作行为，用于追溯「谁在什么时候改了什么」。

使用建议

• 出现配置被改、数据丢失等问题时，先按时间范围筛选，看当时是哪个账号操作的。
• 日志删除后不可恢复，排查期间不要执行「删除全部」。

八、授权管理

展示当前的授权情况：

更新授权

1. 点击「标识文件下载」，导出当前标识文件。
2. 将标识文件发给供应商换取授权文件。
3. 在「授权文件上传」中选择授权文件，点「提交」。
4. 部分场景需要同时上传「证书文件」，同样选择文件后点「提交」。

授权到期前提前处理，避免到期当天用户无法认证。授权容量接近上限时会出现新用户无法上线，可用「服务器状态监控」与在线列表确认。

九、服务器状态监控

按模块展示服务器资源使用情况，用于判断是否需要扩容。

使用建议

• 页面右上「返回」回到上一页。
• 磁盘写满会导致日志、备份、上传全部失败，需把「已用百分比」作为常规巡检项。
• 「运行时长」可用于确认服务是否被意外重启。

十、常见问题