> 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/automate-protect-and-extend/zh/zi-dong-hua/recipes-organization.md).

# 配方组织

本页介绍仓库和目录，它们是用于组织租户和 VM 配方的容器。还包括共享配方的说明。

## 仓库

### 什么是仓库？

仓库是配方的站点集合。仓库可以包含多个配方目录。

```mermaid
graph TD
    A["仓库"] --> B("目录 1")
    A --> C("目录 2")
    A --> D("目录 3")
    B --> E("VM 配方")
    B --> F("VM 配方")
    C --> G("租户配方")
    C --> H("租户配方")
    D --> I("VM 配方")
    D --> J("租户配方")
    D --> K("VM 配方")
```

* **本地仓库**：目录/配方在本地系统上创建和维护。
* **远程仓库**：在另一台 VergeOS 系统上创建和维护的配方目录会被检索到本地系统使用。通过远程仓库共享可避免在多个位置管理相同的配方。

### 自动安装的仓库

***"Marketplace"***\
主机级系统预装了 ***Marketplace***，这是一个由 VergeOS 提供的特殊远程仓库，包含各种可直接使用的 Linux 和 Windows VM 配方。默认情况下，Marketplace 中的配方目录被设置为 scope="global"，这也允许系统的所有租户使用它们。

***"本地"***\
默认情况下，您的新 VergeOS 系统会有一个名为 ***"本地"*** 的空本地仓库，可用于创建新的目录/配方。

## 目录

### 什么是目录？

目录允许您在仓库内将相关配方分组。例如，一个目录可能包含各种 Windows VM 配方，而另一个目录包含所有基于 Linux 的 VM 配方。管理员可以根据组织需要，以最合适的方式使用目录进行组织。目录可以配置为私有，也可以与您的租户或其他外部 VergeOS 系统共享。

### 创建新目录

1. 导航到 **仓库** > **列表** 从顶部菜单中， **双击该仓库** 所在位置。它需要是本地仓库；远程仓库由远程系统维护。（默认的 *"本地"* 在每个新 VergeOS 系统/租户中创建的仓库通常会被使用。）
2. 点击 **目录** 在左侧菜单中，然后点击 **新建**.
3. 提供一个具有描述性的 **名称** 用于该目录。可选地，还可以在描述字段中添加其他管理信息。
4. 选择一个 **发布范围** 来定义该目录的可访问性：
   * **私有** - 仅对这个特定的 VergeOS 云可用。
   * **无** - 已禁用，任何地方都不可用
   * **租户** - 对该特定云及其自己的租户可用
   * **全局** - 对该特定系统及其租户和外部 VergeOS 系统可用（需要用户凭据）

## 共享配方

### 与您的租户共享目录

1. 将目录的 **发布范围 =** ***‘租户’*** （或 ‘全局’，这也将允许使用正确凭据访问外部系统）。
2. **切换到租户的 UI** 完成剩余步骤。
3. 导航到 ***服务提供商*** 仓库并点击 **刷新**.
4. **双击所需目录** 以查看其中包含的配方。
5. 点击 **VM 配方** -或- **租户配方** 以查看相应列表。
6. **选择所需的配方。**
7. 点击 **下载/更新** 在左侧菜单中，将其下载到租户环境中。当配方显示状态为 *在线* 时，即可使用。

{% hint style="info" %}
**当源端的配方更新时，租户 UI 会显示一条消息，表明有可下载的更新。**
{% endhint %}

### 将目录共享到远程系统

**授予目录访问权限（共享端）**

1. 创建一个 **新用户，类型为：API** 供远程系统/租户用于身份验证。请记下用户名和密码。
2. 导航到 **目录仪表板** （仓库 > 目录 > 双击目标目录）。
3. 点击 **权限** 在左侧菜单中。
4. 点击 **添加用户** 在左侧菜单中。
5. 为新权限设置以下字段：
   * **授权对象**：上面创建的 API 用户
   * **权限：** 列表和读取
   * **类型：** 目录
   * **名称：** 正在共享的目录名称
6. 点击 **提交** 以保存新权限。

**连接到远程目录（接收端）：**

1. 导航到 **仓库** > **+ 新建仓库**.
2. 完成 **字段** 用于新仓库：
   * **名称**：一个有助于区分此仓库的描述性名称。
   * **描述**：（可选）在此输入的附加信息可有助于未来的管理。
   * **类型**：远程
   * **URL**：托管系统的 IP 或 DNS 条目，例如 `https://VergeOS.example.com`
   * **用户/密码**：使用在主机系统上创建的 API 用户凭据（见上文）。
   * **允许不安全证书**：提供此选项是为了适应同一私有网络中的自签名证书；使用没有安全 SSL 的公共 URL 可能存在风险，不推荐。
   * **最大最快层级**：允许您指定用于配方磁盘的最佳层级（例如，配方在远程系统上有一个位于第 2 层的磁盘，如果此设置设为第 4 层，下载时该磁盘会移动到第 4 层）。
3. 点击 **提交** 以保存新仓库。
4. 创建后，转到 **仓库仪表板** 并点击 **刷新** 以重新加载其中的目录。配方可以下载到本地，然后在创建新的 VM/租户时使用。

{% hint style="info" %}
**当远程系统创建连接到您系统的仓库时，他们将能够访问该 API 用户拥有权限的任何目录。**
{% endhint %}

{% hint style="info" %}
**当源端的配方更新时，远程系统的 UI 会显示一条消息，表明有可下载的更新。**
{% endhint %}


---

# 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/automate-protect-and-extend/zh/zi-dong-hua/recipes-organization.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.