Skip to content

角色 ​

Utopia Server Panel 采用基于角色的三级权限模型。每个面板账号都会归属一个角色,未登录的访客则统一使用内置的访客角色进行权限判定。

Roles

权限等级 ​

系统中的每一项功能模块权限都支持以下三个等级:

等级数值等级名称含义
0禁止 deny无法访问对应接口与页面,侧边栏也会隐藏对应入口
1只读 readonly可以查看页面与实时数据,但无法执行写入、修改或控制操作
2完全控制 full拥有该模块的完整查看与操作权限

权限模块列表 ​

目前系统内置以下 9 个权限键:

权限键对应模块只读权限范围完全控制权限范围
dashboard看板查看实时状态、TPS、MSPT 与系统资源与只读一致
terminal控制台实时查看服务端输出日志与历史命令向服务端发送并执行控制台指令
logs监控日志查询历史性能记录、玩家上下线事件与启停记录与只读一致
map小地图浏览已启用且允许只读可见的地图图层与标记创建或删除个人路径点,并可使用传送等高级能力
profiler性能分析查看当前最耗时的区块与维度热点统计在游戏内执行传送至热点位置操作
mods_config模组与服务器配置浏览已安装模组列表,只读查看配置与 server.properties编辑保存配置文件、修改 server.properties 并触发服务器重启
whitelist_apply白名单申请访问公开白名单申请页面并查询状态提交白名单申请
whitelist_manage白名单管理查看白名单申请队列与现有服务器白名单列表审核申请、手动添加或移除白名单成员
admin系统管理查看用户、角色、系统设置与数据库概览新增或编辑用户与角色、修改系统设置、清理地图缓存等

内置系统角色 ​

初始化完成后,数据库会自动预置三个系统角色:

角色 ID标识名称说明默认权限特征
1admin超级管理员不可修改且不可删除,全部权限固定为 2
2guest访客控制未登录用户能看到的内容,默认 dashboard、map 为 1,whitelist_apply 为 2,其余为 0
3user普通成员新注册账号的默认角色,默认 dashboard、logs、map 为 1,whitelist_apply 为 2,其余为 0

管理员可以根据服务器运营需要创建自定义角色,例如仅拥有 whitelist_manage 和 terminal 权限的服管角色。当存在用户正在使用某个自定义角色时,系统会阻止直接删除该角色,需先将对应用户调整至其他角色后再删除。

联动设置 ​

  • 在 系统设置 -> 面板设置 -> 注册与绑定 中,可以指定新注册用户默认分配的角色 ID,即修改 defaultRegisterRoleId。
  • 在 系统设置 -> 游戏内联动设置 -> 白名单 中开启或关闭「允许访客申请白名单」时,系统会自动同步调整 guest 角色的 whitelist_apply 权限等级。
  • 小地图的细粒度图层可见性可以在 系统设置 -> 面板功能 -> 小地图 中单独指定需要 map 的只读等级还是完全控制等级,详见 小地图。