MSM Wiki

主题

用户管理 ​

MSM 支持多用户管理和基于角色的访问控制（RBAC），让你可以安全地与团队成员共享管理平台。

Pro 多用户管理功能需要 Pro 授权。

角色与权限 ​

MSM 定义了三种用户角色，权限递增：

角色说明权限范围
查看者 (Viewer)只读访问查看仪表盘、日志、服务状态
运维员 (Operator)操作权限查看者权限 + 启停服务、更新配置、管理设备
管理员 (Admin)完全控制运维员权限 + 用户管理、系统设置、授权管理

权限对照表 ​

功能查看者运维员管理员
查看仪表盘✅✅✅
查看服务状态✅✅✅
查看日志✅✅✅
启停服务❌✅✅
编辑配置❌✅✅
管理设备❌✅✅
管理规则❌✅✅
用户管理❌❌✅
系统设置❌❌✅
授权管理❌❌✅
API Token 管理❌❌✅

用户列表 ​

进入 侧边栏 → 用户管理 页面，可以看到所有用户列表：

  • 用户名 — 登录账号
  • 角色 — 用户角色（管理员/运维员/查看者）
  • 状态 — 是否启用（活跃/禁用）
  • 创建时间 — 账号创建时间
  • 最后登录 — 最近一次登录时间

创建用户 ​

  1. 点击页面右上角的 新建用户 按钮
  2. 填写用户信息：
    • 用户名 — 登录账号（唯一）
    • 密码 — 登录密码（建议 8 位以上）
    • 角色 — 选择用户角色
  3. 点击 确认 完成创建

最佳实践

  • 为每个使用者分配独立账号，便于审计追踪
  • 遵循最小权限原则，仅授予必要的角色
  • 只查看不操作的成员分配「查看者」角色即可

编辑用户 ​

在用户列表中点击对应用户的操作按钮：

  • 编辑 — 修改用户名、角色等信息
  • 重置密码 — 为用户重置登录密码
  • 启用/禁用 — 切换用户的活跃状态
  • 删除 — 移除用户（不可恢复）

注意

  • 不能删除自己的账号
  • 不能修改自己的角色
  • 至少保留一个管理员账号

个人设置 ​

每个用户都可以管理自己的个人信息：

修改密码 ​

  1. 点击右上角头像
  2. 进入个人设置
  3. 输入当前密码和新密码
  4. 确认修改

修改个人信息 ​

  • 修改显示名称
  • 更新个人偏好设置

API Token 管理 ​

管理员可以创建 API Token，用于第三方系统对接或自动化脚本：

  1. 进入 侧边栏 → 授权管理
  2. 点击 创建 Token
  3. 设置 Token 名称和权限范围
  4. 复制生成的 Token（仅显示一次）

安全提示

API Token 等同于登录凭证，请妥善保管：

  • 不要在公开代码仓库中提交 Token
  • 定期轮换 Token
  • 不再使用的 Token 应及时删除

Token 使用示例 ​

bash
# 使用 Token 调用 API
curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  http://your-server:7777/api/v1/services

# 查看服务状态
curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  http://your-server:7777/api/v1/daemon/status

安全建议 ​

  1. 强密码策略 — 使用包含大小写字母、数字和特殊字符的密码
  2. 最小权限 — 遵循最小权限原则分配角色
  3. 定期审计 — 定期检查用户列表，移除不再需要的账号
  4. Token 管理 — 及时清理过期或废弃的 API Token
  5. 密码重置 — 忘记管理员密码时，可在服务器上执行 msm reset-password

下一步 ​