账户管理用于创建用户、设置角色和状态、调整订阅或余额,并执行安全操作。登录方式、注册、邮箱验证和身份源在「登录认证」页面配置。
使用入口#
进入管理端后选择「账户」。工具栏提供搜索、「角色」「状态」筛选,周期计费下还有「订阅」筛选,以及排序、「导入」和「新增」。
搜索支持用户名、昵称、邮箱和 Public ID。
| 列 | 含义 |
|---|---|
| ID | 用户 ID。 |
| 信息 | 头像、昵称和用户名。 |
| 角色 | 用户角色,可在表格中直接修改。 |
| 状态 | 账户状态,可在表格中直接修改。 |
| 订阅 | 周期计费下显示的方案或等级。 |
| 余额 | 非自用计费下显示的计费账户余额。 |
| 2FA | 是否开启两步验证。 |
| 时区 | 账户时区。 |
| 最近活跃 | 最近活动时间。 |
排序方式包括 ID 从新到旧、ID 从旧到新、最近登录、最近更新和昵称 A-Z。
新增用户#
- 点击「新增」。
- 填写「用户名」「昵称」「密码」和「邮箱」。
- 周期计费下选择「订阅方案」;非 Free 方案还要选择「到期时间」。
- 点击「新增」。
| 字段 | 规则 |
|---|---|
| 用户名 | 3–16 位,小写字母、数字、_ 或 -,不能是保留名,不能包含 @。 |
| 昵称 | 可选,3–16 位。 |
| 密码 | 至少 8 位且不能为纯数字,最多 128 位。 |
| 订阅方案 | 周期计费下必填;非 Free 方案必须指定到期时间。 |
编辑用户#
点击行末的设置按钮打开「管理用户」。面板分为基础资料、权限与区域、计费信息、安全信息和系统信息。
| 区域 | 可编辑项 |
|---|---|
| 基础资料 | 昵称、邮箱、手机号、偏好;用户名只读。 |
| 权限与区域 | 状态、角色、时区、语言;修改状态时会出现「原因」。 |
| 计费信息 | 周期计费下的订阅方案和到期时间;非自用计费下的账号余额;计费状态只读。 |
| 安全信息 | 两步验证状态和恢复码数量、最近登录、最近活跃。 |
| 系统信息 | Public ID、注册时间、更新时间。 |
点击「保存」提交修改。余额调整会以「管理员在用户管理中设置余额」作为记录说明。
修改角色和状态#
角色和状态可以在表格中直接修改,也可以在用户面板中修改。
| 角色 | 说明 |
|---|---|
user | 普通账户。 |
admin | 可以进入管理端。 |
superadmin | 完整权限,包含内容审核;只有超级管理员能管理超级管理员账户。 |
| 状态 | 含义 |
|---|---|
| 待激活 | 账户已创建但尚未激活。 |
| 正常 | 可以正常登录。 |
| 已锁定 | 登录被阻止,通常由多次失败触发。 |
| 已暂停 | 被管理员临时阻止。 |
| 已停用 | 账户已禁用。 |
在面板中修改状态时填写原因,便于后续审计说明变更。
执行安全操作#
打开用户面板底部的「更多操作」。
| 操作 | 作用 |
|---|---|
| 重置密码 | 设置新密码,用户下次登录时需要重置密码。 |
| 重置 2FA | 清除两步验证配置并吊销活跃会话,用户需要重新绑定。 |
| 吊销会话 | 让该用户在所有设备上退出登录。 |
| 删除 | 永久删除用户记录及主要用户域数据。 |
重置 2FA 和吊销会话都需要确认。删除是永久操作,无法恢复。
批量操作#
用复选框选中用户后,可以批量应用「角色」「状态」「时区」「余额」,或点击「删除」。每个批量操作都会弹出确认框并显示已选人数。
- 只有非自用计费下才能批量设置余额,且余额必须是非负数。
- 已经是目标角色、状态、时区或余额的用户会被跳过。
- 部分失败时,失败的用户会保持选中,方便重试。
导入 OpenWebUI 用户#
- 点击「导入」,再选择「OpenWebUI」。
- 填写「DB 连接地址」,例如
postgres://...或/data/openwebui.db。 - 设置「积分转换比例」。
- 点击「预览」执行一次试运行,再点击「导入」。
去重按 email 进行,已存在用户不会修改或覆盖。预览会显示扫描、可导入、已存在邮箱、源库重复邮箱、无效邮箱和无效行数量。
常见问题#
| 现象 | 检查 |
|---|---|
| 用户列表加载失败 | 刷新页面;若登录状态失效,请重新登录。 |
| 创建用户失败 | 检查用户名长度、昵称长度和密码规则。 |
| 非 Free 订阅必须指定到期时间。 | 为所选方案设置到期日期。 |
| 角色或状态更新失败 | 确认你有权限管理目标账户。 |
| 无法选中超级管理员行 | 只有超级管理员能管理超级管理员账户。 |
| OpenWebUI 导入失败 | 检查连接地址,并确认源数据库可访问。 |