qinglong/MULTI_USER_GUIDE.md

多用户管理功能说明 (Multi-User Management Guide)

功能概述 (Overview)

青龙面板现已支持多用户管理和数据隔离功能。管理员可以创建多个用户账号，每个用户只能看到和操作自己的数据。

Qinglong now supports multi-user management with data isolation. Administrators can create multiple user accounts, and each user can only see and operate their own data.

用户角色 (User Roles)

管理员 (Admin)

• 可以访问所有用户的数据
• 可以创建、编辑、删除用户
• 可以管理系统设置
• Can access all users' data
• Can create, edit, and delete users
• Can manage system settings

普通用户 (Regular User)

• 只能访问自己创建的数据
• 可以管理自己的定时任务、环境变量、订阅和依赖
• 无法访问其他用户的数据
• Can only access their own data
• Can manage their own cron jobs, environment variables, subscriptions, and dependencies
• Cannot access other users' data

API 使用 (API Usage)

用户管理接口 (User Management Endpoints)

所有用户管理接口需要管理员权限。 All user management endpoints require admin privileges.

获取用户列表 (Get User List)

GET /api/user-management?searchValue=keyword

创建用户 (Create User)

POST /api/user-management
{
  "username": "user1",
  "password": "password123",
  "role": 1,  // 0: admin, 1: user
  "status": 0  // 0: active, 1: disabled
}

更新用户 (Update User)

PUT /api/user-management
{
  "id": 1,
  "username": "user1",
  "password": "newpassword",
  "role": 1,
  "status": 0
}

删除用户 (Delete Users)

DELETE /api/user-management
[1, 2, 3]  // User IDs to delete

数据隔离 (Data Isolation)

定时任务 (Cron Jobs)

• 每个用户创建的定时任务会自动关联到该用户
• 用户只能查看、编辑、运行、删除自己的定时任务
• 管理员可以查看所有用户的定时任务

环境变量 (Environment Variables)

• 每个用户的环境变量相互隔离
• 用户只能查看和修改自己的环境变量
• 管理员可以查看所有环境变量

订阅和依赖 (Subscriptions and Dependencies)

• 用户数据完全隔离
• Only accessible by the owning user and admins

密码安全 (Password Security)

• 所有密码使用 bcrypt 加密存储
• 密码长度最少为 6 位
• 建议使用强密码
• All passwords are hashed with bcrypt
• Minimum password length is 6 characters
• Strong passwords are recommended

向后兼容 (Backward Compatibility)

• 原有的单用户系统管理员账号继续有效
• 已存在的数据可以被所有用户访问（遗留数据）
• 新创建的数据会自动关联到创建者
• The original system admin account remains valid
• Existing data is accessible by all users (legacy data)
• Newly created data is automatically associated with the creator

注意事项 (Notes)

1. 首次使用：首次使用多用户功能时，建议先创建一个管理员账号作为备份

2. 密码管理：请妥善保管用户密码，忘记密码需要管理员重置

3. 数据迁移：如需将现有数据分配给特定用户，请联系管理员手动更新数据库

4. 权限控制：删除用户不会删除该用户的数据，数据会变为遗留数据

5. First Use: When first using multi-user functionality, it's recommended to create an admin account as a backup

6. Password Management: Please keep user passwords safe; forgotten passwords need admin reset

7. Data Migration: To assign existing data to specific users, contact admin for manual database update

8. Permission Control: Deleting a user doesn't delete their data; the data becomes legacy data