> 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/zu-hu/create-tenants.md).

# 创建租户

## 租户创建方法

VergeOS 提供多种创建新租户的方法：

* 使用 [**租户向导**](#tenant-wizard)
* [**克隆**](#tenant-cloning) 一个现有租户
* 使用 [**租户配方**](#tenants-from-recipes)

## 租户向导

该 *租户向导* 通过多个输入表单逐步创建新的自定义租户。

### 使用租户向导创建新租户

1. 单击 **租户** 从顶部菜单。
2. 选择 **+ 新租户**.
3. 在左上角，选择 *从向导*.
4. 单击 **下一步**。 ***租户设置***** 表单将显示。**
5. 输入一个 ***名称*** 用于该租户。
6. ***URL*** 只是一个辅助字段，用于从 **连接到 UI** 菜单链接访问服务提供商 VergeOS 用户界面中的租户 UI。该字段可以留空，因为当第一个外部 IP 分配给该租户时，它会自动填充。
7. 输入一个 ***管理员用户密码*** 以及再次在 ***确认管理员用户密码*** 字段中（必填）。这将设置自动创建的租户“admin”根用户的密码。
8. **可选地**， **要求更改密码** 可选择该选项，以在租户管理员首次登录时强制更改密码。
9. **可选地**，可 **描述** 可以输入以记录有关该租户的更多信息。
10. 默认情况下， **显示系统快照** 选项（复选框）处于选中状态。选中后，租户可以浏览父级的系统快照，并从提供商的快照时间点“自助”下载自己的租户快照。
11. 配置 **主题访问权限**:
    * ***不能创建新主题，对所有主机主题具有只读访问权限***
    * ***不能创建新主题，对指定的主机主题具有只读访问权限***
    * ***可创建新主题，无法访问主机主题***
    * ***可创建新主题，对主机主题具有只读访问权限***
12. **可选地**， **自定义帮助 URL** 可用于为租户提供替代帮助内容的位置。租户用户在 VergeOS UI 中点击帮助链接时会被引导到此 URL。
13. **OIDC 应用程序** 可用于为租户定义授权源。选择列表将包含在父级上定义的 OIDC 应用程序。当 *--无--* 被选中时，将使用本地租户用户数据库进行身份验证。
14. 单击 **提交** （页面底部）继续。继续进行 ***新租户节点***** 表单**.

### 新租户节点表单

此处定义的设置将应用于使用向导创建的单个租户节点。如有需要，可在向导完成后创建额外的租户节点。

{% hint style="success" %}
[**KB 文章： *****租户节点规划指南***](/knowledge-base/zh/tenants/tenant-node-planning-guide.md) **逐步介绍决定应使用多少个租户节点以及分配给这些租户节点的 RAM/核心数时所涉及的考量。**
{% endhint %}

1. 选择 ***核心数*** 以及 ***RAM*** 要预配到租户节点。
2. **可选地**，可 ***集群*** 可被选择用于运行该租户，或者可保留为 --Default --（由 *系统 > 设置 > 租户节点默认集群*)
3. **可选地**，可 **故障转移集群** 如果主选集群不可用，可选择其来运行该租户。或者也可保留为 *--默认--* （由 *系统 > 设置 > 租户节点默认故障转移集群*)
4. 定义一个 **首选节点** 是 **通常不建议用于租户节点的**。这是租户节点的高级设置；配置不正确可能会对内置冗余产生不利影响。如需进一步帮助，请咨询 VergeOS 支持。
5. **可选地**，可 **描述** 可输入以记录此初始租户节点的更多信息。
6. 从列表中选择所需的 ***断电时*** 设置：
   * ***上次状态*** - 仅当租户在断电时处于开启状态时，才会在恢复供电后再次开启。
   * ***保持关闭*** - 当恢复供电时，租户不会开启（无论断电时其状态如何）。
   * ***开机*** - 当恢复供电时，租户将开启（无论断电时其状态如何）。
7. 单击 **提交** 按钮（页面底部）继续。继续进行 ***新租户存储***** 表单**.

### 新租户存储表单

1. 选择要使用的 **层级** 用于租户存储，来自 **层级** 下拉菜单。
2. 选择要为该租户配置的存储容量。
3. 单击 **提交** 按钮继续。继续进行 **UI 管理** 表单。

### UI 管理表单

1. 您也可以选择性地为该租户分配一个外部 IP。创建后也可以再为租户分配外部 IP。默认情况下，分配给租户的第一个外部 IP 会被配置为租户的 UI 地址。
2. 从 **分配外部 IP**\* 下拉菜单中选择。（此列表将包含父级中定义的所有未分配虚拟 IP）。
3. 如果所需 IP 尚未在父系统中配置为虚拟 IP，点击 ***创建新的外部 IP*** 来创建该地址：
   * **网络** — 从下拉列表中选择合适的网络。
   * **类型** - **虚拟 IP**
   * **IP 地址** — 输入公网（外部）IP 地址，或留空以自动创建该网络中下一个可用 IP。
   * **主机名和描述字段** — 可以留空。
   * **所有者** （下拉菜单）— 新租户的名称。

{% hint style="success" %}
**请记住，外部 IP 是指 VergeOS 系统外部的 IP；它可能是也可能不是公共互联网地址。例如，外部 IP 可以是您外部 LAN/WAN 上的私有地址，例如：10.10.10.100**
{% endhint %}

4. 单击 **提交** 完成。您应该会看到一条消息，说明租户已成功创建，并显示新的租户仪表板。
5. 如果租户使用代理，则可以 **创建新的 FQDN** 为该租户

* 参见 [**使用代理创建新租户**](/knowledge-base/zh/tenants/configuring-proxy.md#creating-a-new-tenant-with-proxy) 有关通过代理创建新租户并为其分配 FQDN 的说明。

{% hint style="success" %}
**应用规则**

如果已为租户分配外部 IP，则需要将规则应用到所选外部网络。点击租户仪表板上橙色高亮的消息“需要应用规则”以应用必要的规则。
{% endhint %}

**启动新租户：**\
创建租户后，UI 将进入租户仪表板页面。从该仪表板页面，可以通过点击 ***开机*** 左侧菜单中的。

## 租户克隆

克隆租户将创建现有租户的副本。这对于测试、开发、恢复以及其他需要租户副本的场景非常有用。

{% hint style="warning" %}
**克隆注意事项**

创建克隆时，请注意避免在同一网络上运行的重复 IP 地址、MAC 地址、应用实例等产生冲突。
{% endhint %}

### 从克隆创建新租户

1. 单击 **租户** 在顶部菜单中。
2. 选择 **+ 新租户**.
3. 在左上角，选择 *克隆现有* 选项。
4. 所有虚拟机都将列在右侧的 ***可用选择*** 区域中。 **选择所需的虚拟机。** 单击 **下一步** （页面底部）。 ***名称***** 输入表单显示**.
5. 该 ***名称*** 租户克隆的内容可以按需更改。（名称默认将为 *源虚拟机名称* +“克隆”，例如：克隆名为“Tenant2”的租户时，名称默认将为“Tenant2 克隆”。）
6. 可选地， ***作为新租户克隆*** 可选择此选项，以创建新的租户实例，而不附带历史统计、日志以及带过期的快照。当不需要这些项目时，推荐使用该选项。
7. 单击 **提交** （页面底部）。租户已创建，并显示新的租户仪表板。

**启动新租户：**\
从租户仪表板页面，可通过点击 ***开机*** 左侧菜单中的。

## 来自配方的租户

租户配方允许使用基础租户模板和问题来自动创建租户，从而自定义每个新的租户实例。

该 [租户配方页面](/automate-protect-and-extend/zh/zi-dong-hua/tenant-recipes.md) 提供有关创建和使用租户配方的信息。


---

# 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/zu-hu/create-tenants.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.