> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/run-the-platform/zh/xi-tong-guan-li/users-groups.md).

# 用户和组

如何在 VergeOS 中创建和管理用户和组，包括用户类型、密码策略、双因素身份验证、SSH 密钥、物理访问和组成员资格。

## 用户

应为每个将使用该系统的个人创建一个单独的用户账户。

{% hint style="success" %}
**授权来源**

使用授权来源时，可以选择自动从该来源创建用户。
{% endhint %}

### 用户类型

* **普通** - 用于完整 UI 访问
* **API** - 仅用于服务账户；例如运行脚本、同步等。
* **VDI** - 仅用于 VDI 用户仪表板

## 组

组是用户的集合。组也可以包含其他组。通过使用组，权限和订阅的管理通常可以得到简化。

## 创建新用户

1. 导航到 **系统** > **用户**.
2. 选择 **新建**.
3. 选择一个 ***授权来源*** （如适用）（如果系统未配置第三方授权来源，则不会显示此字段）。默认选择“--None--”会创建一个直接通过 VergeOS 进行身份验证的用户。

{% hint style="info" %}
如果授权来源已配置为自动创建用户，请不要在此处创建该用户。
{% endhint %}

4. 输入一个 ***用户名***；这将作为该用户的登录名。用户名在此云中必须唯一（注意：每个租户都是一个单独的 VergeOS Cloud）。
5. 选择合适的用户 ***类型***:
   * **普通** - 将登录完整 UI 的用户
   * **API** - 用于服务账户，例如用于站点同步的账户
   * **VDI** - 仅登录 VDI 仪表板的用户
6. 输入一个 ***密码*** 用于该用户。密码必须符合此 VergeOS 云定义的密码复杂度设置；要求列在字段下方。复杂度设置在 系统 -> 设置 -> 密码复杂度要求 中定义。
7. 重新输入密码于 ***确认密码*** 字段中。
8. 可选地， ***要求更改密码*** 选项可启用，以便在用户首次登录时提示其创建自己的密码。
9. 可选地， ***显示名称*** 可为该用户指定。用户登录 UI 时，显示名称会显示在屏幕右上角。
10. 启用后， ***双因素认证*** 登录 VergeOS 系统时，除了用户名/密码外，还需要使用安全代码（通过用户电子邮件接收）。
11. ***电子邮件地址*** 用于发送分配给该用户的订阅报告和警报，以及在适用时用于双因素认证。
12. 该 ***物理访问*** 选项可被勾选，以允许用户直接控制台访问节点。

{% hint style="warning" %}
**注意：** 启用 *物理访问* 选项后，账户可通过物理访问（例如 crashcart、ipmi 远程控制）和 SSH 通过命令行登录。 **这只应授予被信任负责低级别 VergeOS 服务器管理的用户。**
{% endhint %}

* **SSH 密钥** 可以添加，以为 SSH 提供基于密钥的身份验证；可以定义多个密钥，允许用户从不同计算机通过 SSH 密钥进行身份验证。注意：SSH 密钥是可选的；已授予物理访问的用户在没有关联 SSH 密钥的情况下，也可以使用用户名/密码登录 SSH 会话。

  **添加新的 SSH 密钥条目：**

  * 将出现一个初始空白行，可在其中输入 SSH 密钥。
  * 如有需要，可以通过点击加号 \[ ] 按钮添加更多密钥，这将插入一个新的空白行，可在其中输入 SSH 密钥。

    **要选择和取消选择用于移动/编辑/删除的密钥：**
  * 所选条目将在左侧复选框中显示勾选。
  * 选择是一个切换操作：单击未选中的条目可选中；单击已选中的条目可取消选中。
  * 可以选择多个密钥用于删除或移动。

    **要编辑现有密钥条目：**
  * 单击以选择要编辑的密钥。
  * 单击编辑 \[ ] 按钮。
  * 所选密钥将显示出来并可被修改。编辑完成后，再次单击编辑 \[ ] 按钮以保存更改。

    **要删除现有密钥条目：**
  * 单击以选择要删除的密钥。
  * 单击删除 \[ ] 按钮。

13. 单击 **提交** 以保存新用户。

### 组成员关系

用户创建后会分配组成员关系。要将新用户添加到一个或多个组：

1. 选择 **修改成员关系** 在左侧菜单中。
2. 单击以选择每个目标组。
3. 单击 **提交** 在完成所有组选择后。

{% hint style="success" %}
用户也可以使用下面的 **添加成员** 说明添加到单个组。
{% endhint %}

## 创建新组

1. 从 **系统仪表板**，选择 **组** 从左侧边栏。
2. 选择 **新建** 在左侧菜单中。
3. 输入一个 ***名称*** 用于该组（必填）。
4. 可选地， ***描述*** 可为该组指定。
5. 可选地， ***电子邮件地址*** 可指定一个电子邮件地址，以接收分配给该组的订阅警报和报告。
6. 单击 **提交** 以保存新组。

## 向组中添加成员（用户和/或组）

1. 从 **系统仪表板**，选择 **组** 从左侧边栏。
2. **双击所需的组** 在列表中显示组仪表板。
3. 单击 **成员**.
4. 单击 **添加用户** 或 **添加组** 在左侧菜单中。
5. 从显示的列表中选择用户/组。提示：按住 Shift 或 Ctrl 键可选择多个组。
6. 单击 **添加到组** 以应用更改。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verge.io/run-the-platform/zh/xi-tong-guan-li/users-groups.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.