> 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/permissions.md).

# 权限

用户和组权限提供了高度的细粒度控制，允许将访问配置到具体的对象实例。每个独立云都会创建和管理用户；创建的每个租户都是一个独立的 VergeOS 云，因此都有自己的一套用户、组和权限设置，用于控制租户内的访问。

## 权限级别

系统中使用以下权限级别：

* 列表
* 读取
* 创建
* 修改
* 删除

## 权限范围

* **云级别** - 权限适用于整个云 - 所有区域
* **对象类型** - 权限适用于该类型的所有对象（例如虚拟机、租户、用户、网络等）
* **单个对象** - 权限适用于特定对象实例，例如某台虚拟机、某个租户、某个用户等。

## 根级别“admin”账户

当创建 VergeOS 云时（在硬件上初始安装期间或创建新租户时，） **会自动创建一个根级别用户账户，并授予整个云的完全访问权限（list/read/create/modify/delete）。** 默认情况下，此用户名为“admin”；不过，在硬件安装期间可以按需命名该账户，或在安装后/创建租户后更改。这个特殊系统用户无法删除。

## 新用户默认权限

* **类型 = Normal/API：** 对所有内容具有 list/read 权限；对其自己的用户具有 list/read/modify 权限
* **类型 = VDI：** 对所有内容具有 list 权限；对其自己的用户具有 list/read/modify 权限。

创建用户后，可根据需要自定义该用户的权限。

## 实际生效权限

用户的实际生效权限是分配给该用户的所有权限的累加，包括直接分配的权限以及通过组成员身份获得的权限。权限可在对象类型级别授予，使用户对某一类的所有对象拥有权限，也可授予特定对象实例。权限在操作发起时进行验证；如果分配给用户（或用户所属组）的任何权限适用，则允许该操作。

### 示例 1

* 已为 JSmith 分配了该云的 list/read 权限。
* JSmith 是“machine-operators”组的成员；“machine-operators”组被分配了对虚拟机的完全权限（list/read/create/modify/delete）。
* JSmith 是“assistants”组的成员；“assistants”组仅被分配了对若干特定虚拟机的 list/read/modify 权限。
* JSmith 对所有虚拟机的实际生效权限：list/read/create/modify/delete。 ***由于权限是累加的，即使某个特定虚拟机实例上定义了更严格的权限，JSmith 仍会对所有虚拟机拥有 list/read/create/modify/delete 权限。***

### 示例 2

* 已为 RJohnson 分配了该云的 list/read 权限。
* RJohnson 是“tenant-admins”组的成员；“tenant-admins”组被分配了对租户的 list/read/modify 权限。
* 已为 RJohnson 分配了对特定“Zcorp”租户的 list/read/modify/delete 权限。
* RJohnson 对所有租户的实际生效权限：list/read/modify
* RJohnson 对“Zcorp”租户的实际生效权限：list/read/modify/delete。

## 为用户授予整个 VergeOS 云的完全权限

1. 在云仪表板中，选择 **系统**.
2. 单击 **权限**.
3. 单击 **添加用户**.
4. 从以下内容中选择所需用户 ***用户名*** 下拉菜单。
5. 勾选以下项目的复选框： ***列表***, ***读取***, ***创建***, ***修改***，并且 ***删除***.
6. 在 ***类型*** 下拉字段中，选择 **“您的云”（默认）**.
7. ***--所有部分--*** 将默认选中
8. 单击 **提交** 按钮。

## 查看用户权限

1. 在云仪表板中，单击 **系统**.
2. 单击 **用户**。这将显示所有用户的列表。
3. **双击所需用户** 列表中的该用户。将显示用户仪表板，其中会显示分配给该用户的所有权限。

{% hint style="success" %}
**请记住：用户也可以通过组成员身份获得权限；组成员关系也会显示在用户仪表板上。**
{% endhint %}

## 为用户/组授予某一类型所有对象的权限（例如机器、用户、租户等）

1. 在云仪表板中，单击 **系统**.
2. 单击 **权限**.
3. 单击 **添加用户** 或 **添加组**
4. 选择所需的 **用户/组** 在第一个下拉框中。
5. 勾选所需访问级别的复选框（***list/read/create/modify/delete***).
6. 在 ***类型*** 在下拉字段中，选择要应用此权限的对象类型。
7. 在 ***名称*** 下拉字段中，选择 ***--全部--***
8. 单击 **提交** 按钮。

## 为用户/组授予特定对象实例的权限（例如某台特定虚拟机）

1. 在云仪表板中，选择 **系统**.
2. 选择 **权限**.
3. 单击 **添加用户** 或 **添加组**.
   * 选择所需的 **用户/组** 在第一个下拉框中。
   * 勾选所需访问级别的复选框（***list/read/create/modify/delete***).
   * 在 ***类型*** 在下拉字段中，选择要应用此权限的对象类型。
   * 在 ***名称*** 在下拉字段中，选择特定对象（例如某台虚拟机的名称）
4. 单击 **提交** 按钮。

## 查看所有权限

这将显示为 VergeOS 系统定义的所有权限。

1. 导航到 **系统** > **权限**.
2. 将显示整个云的所有权限。提示：列表可排序或筛选，以聚焦特定权限。
3. 可从列表中选择权限进行编辑/删除。

## 查看特定部分的权限

可查看系统某一特定部分的权限；例如，从虚拟机仪表板查看所有虚拟机的权限；或者从某台特定虚拟机的仪表板查看该虚拟机的所有权限。

1. 在所需部分中，单击 **权限** 左侧菜单中的。该部分的权限列表将显示。  *类型* 字段将显示该权限适用的一般部分，而 *名称* 字段将指示它适用于该特定类型的所有对象，或显示其所适用的特定对象名称。
2. 可从列表中选择权限进行编辑或删除。


---

# 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/permissions.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.