> 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/marketplace-vm-recipes.md).

# VergeOS 市场目录：VM 配方

## 概述

{% hint style="info" %}
**要点**

* VergeOS 市场目录提供一系列经过精选的预配置虚拟机方案。
* 方案可使用优化设置，实现虚拟机的快速自助部署。
* 每个方案都简化了常见操作系统和应用的部署流程。
* 用户可在部署过程中自定义 CPU、RAM、存储和网络等关键参数。
  {% endhint %}

VergeOS 市场目录为加速虚拟机部署提供了强大的方式。与其手动配置每台新虚拟机，不如直接使用市场中针对各种操作系统和应用提供的即用型方案。这些方案针对 VergeOS 环境进行了优化，可确保高效的资源利用和一致的配置。

本指南将向你介绍市场目录中可用的虚拟机方案，并说明在部署这些方案时可预期的常见配置选项。

## 访问市场目录

要从市场中访问并部署虚拟机方案：

1. 登录到你的 VergeOS 系统。
2. 导航到 **机器** 从左侧菜单中。
3. 点击 **新建虚拟机**.
4. 在左侧的“选择类型”部分，选择“市场”（或某个特定的市场目录，例如“操作系统（市场）”或“应用程序（市场）”）。

随后将显示可供选择的方案，并按其主要功能分类（例如：操作系统、应用程序、服务）。

## 常见方案配置选项

当你从市场方案部署虚拟机时，通常会看到一组问题，用于自定义新的虚拟机实例。这些问题旨在覆盖最常见的配置需求。

以下是你通常会需要配置的设置类别：

### 1. 虚拟机实例设置

这些选项控制虚拟机的核心硬件和身份信息：

* **核心（`YB_CPU_CORES`):** 分配给虚拟机的虚拟 CPU 核心数。
* **内存（`YB_RAM`):** 分配给虚拟机的虚拟 RAM 容量（例如，MB 或 GB）。
* **主机名（`YB_HOSTNAME`):** 虚拟机的网络主机名。
* **启用 UEFI（`SELECT_CREATE_UEFI`):** 一个布尔（是/否）选项，用于为虚拟机启用统一可扩展固件接口（UEFI）启动模式。
* **首次启动后禁用 Cloud-init（`YB_DISABLE_CLOUDINIT`):** 对于 Linux 虚拟机，这允许在初次运行后禁用 cloud-init 服务，防止后续启动时继续更改配置。选项通常包括 `true`, `false`，或 `purge`.
* **分离方案实例（`YB_DETACH_RECIPE`):** 一个隐藏选项，可能用于控制虚拟机是否仍与方案关联（以便将来更新），或者在创建后变成独立的虚拟机。

### 2. 网络设置

这些选项定义你的虚拟机将如何连接到网络并获取 IP 地址：

* **选择 IP 地址类型（`YB_IP_ADDR_TYPE`):** 在以下之间选择 `dhcp` （动态主机配置协议）以自动分配 IP，或者 `static` 进行手动配置。
* **外部网络所用网络（`YB_NIC_ETH0_EXTERNAL_GATEWAY`):** 虚拟机主网卡（eth0）将连接到的外部网络。
* **（eth0）的 IP 地址（`YB_NIC_ETH0_IP_ADDR`):** 如果 `static` 选择了 IP，此处输入虚拟机的具体 IP 地址。
* **子网掩码 CIDR（`YB_NIC_ETH0_CIDR`):** 静态 IP 地址的子网掩码（例如， `/24`).
* **默认网关（`YB_NIC_ETH0_GW`):** 虚拟机的默认网关。
* **名称服务器（`YB_NIC_ETH0_NS`):** 用逗号分隔的 DNS 服务器 IP 地址列表。

### 3. 存储设置

这些选项控制虚拟机主磁盘的大小：

* **操作系统磁盘大小（`YB_DRIVE_OS_SIZE`):** 操作系统虚拟磁盘的大小（例如，GB）。
* **操作系统磁盘层级（`SELECT_OS_TIER`):** 选择虚拟机 OS 磁盘的首选存储层级（例如，1 级适用于高性能，5 级适用于归档）。

### 4. 用户账户创建

方案通常包含在来宾操作系统中创建初始用户账户的选项：

* **用户名（`YB_USER`):** 初始管理员或普通用户账户的用户名。
* **密码（`YB_PASSWORD`):** 指定用户的密码。

### 5. 针对特定操作系统的自定义选项

某些方案包含针对其部署的特定操作系统量身定制的选项：

* **Windows ISO（`WINDOWS_ISO`):** 对于 Windows 方案，这允许为 Windows 安装选择特定的 ISO 镜像（例如， `windows-2025-evaluation-os-disk.iso`).
* **Windows 许可证密钥（`WINDOWS_LICENSE_KEY`):** 用于输入 Windows 许可证密钥以激活的可选字段。
* **启用 RDP（`ENABLE_RDP`):** 一个布尔（是/否）选项，用于为 Windows 虚拟机启用远程桌面协议。
* **从内部访问 UI（`YB_ACCESS_UI_FROM_INTERNAL`):** 对于某些基于 Windows 的 VergeOS 实例，此选项控制来自内部网络对其 UI 的访问。
* **VirtIO 下载名称（`VIRTIO_DL_NAME`):** 对于 Windows，这指的是用于向来宾操作系统注入驱动程序的 VirtIO 驱动 ISO。

### 6. 幕后自动化（`S数据库` 类型问题）

许多方案包含高级自动化步骤，可能会与 VergeOS 数据库或其他服务交互。这些问题通常会带有一个 `S数据库` 类型，并通常由方案发布者预先配置。示例如下：

* **创建 OS 磁盘（`CREATE_OS_DRIVE`):** 自动创建 OS 虚拟磁盘。
* **下载 Windows ISO（`YB_DOWNLOAD_WINDOWS_ISO`):** 从指定 URL 开始下载 Windows ISO。
* **下载 VirtIO（`YB_DOWNLOAD_VIRTIO`):** 开始下载 VirtIO 驱动 ISO。
* **创建 VirtIO CD-ROM（`YB_CREATE_VIRTIO_CD_DL`):** 创建一个虚拟 CD-ROM 驱动器，并挂载下载的 VirtIO ISO，以便自动安装驱动程序。
* **获取集群 CPU（`GET_CLUSTER_CPU`):** 查询集群可用的 CPU 信息。
* **更改集群 CPU（`CHANGE_CLUSTER_CPU`):** 以程序方式修改集群 CPU 设置。
* **编辑机器类型（`EDIT_MACHINE_TYPE`):** 在创建后调整虚拟机的机器类型。

这些 `S数据库` 操作突显了 VergeOS 方案的强大能力，它们不仅能部署虚拟机，还能在配置过程中执行复杂的自动化任务。

## 市场目录中的可用方案

市场目录会持续更新新的方案。以下是常见可用方案列表，按其主要用途分类：

### 操作系统

这些方案提供预配置的虚拟机，包含多种 Linux 和 Windows 操作系统。它们通常带有默认设置，可使用上述选项进行自定义。

* **AlmaLinux 8 和 9（最新）：** 面向企业环境的 AlmaLinux 最小化安装。
* **CentOS 7（最新）：** 一个稳定且广泛使用的 Linux 发行版。
* **CentOS Stream 8：** 一个滚动发布型 Linux 发行版。
* **Debian 10（Buster）、11（Bullseye）：** 稳定且受欢迎的基于 Debian 的发行版。
* **Fedora 35、36、37、38：** 面向开发和测试的前沿 Fedora 版本。
* **Rocky Linux 8 和 9（最新）：** 与 RHEL 二进制兼容的企业级 Linux 发行版。
* **Ubuntu Server 18.04（Bionic Beaver）、20.04（Focal Fossa）、22.04（Jammy Jellyfish）、24.04（Noble Numbat）：** Ubuntu Server 的长期支持（LTS）版本，非常适合生产工作负载。
* **Windows 2025 - 评估版：** 面向即将发布的 Windows Server 的评估镜像。
* **Windows 2022 - 评估版：** Windows Server 2022 的评估镜像。
* **Windows 2019 Server 评估版：** Windows Server 2019 的评估镜像。
* **Amazon Linux 2 LTS：** 经过 Amazon 优化的 Linux 发行版。

### 应用程序

这些方案通常基于底层操作系统构建，并包含针对特定使用场景预装的应用程序。

* **LAMP 技术栈：** 由 Linux、Apache、MySQL、PHP 组成的 Web 服务器技术栈。
* **Docker：** 预装的容器化平台。
* **Grafana：** 用于监控和可观测性的流行开源平台。
* **OpenVPN-AS：** 用于 VPN 方案的 OpenVPN Access Server。
* **Kubernetes K3S：** 一个轻量级的 Kubernetes 发行版。

### 服务

这些方案提供专用服务或实用虚拟机，用于管理你的 VergeOS 环境。

* **租户应急工具箱：** 一个常用于租户环境中故障排查或恢复的实用虚拟机。

## 使用方案

选定一个方案并点击“下一步”后，系统将引导你进入“问题”表单，你可以在其中输入所需配置。填写完所有必填字段后，点击“提交”即可开始虚拟机创建流程。方案自动化随后会根据你的选择为你部署新的虚拟机。

## 使用市场方案的优势

* **速度：** 在几分钟内部署新虚拟机，而不是几小时。
* **一致性：** 确保所有部署都遵循预定义的最佳实践。
* **简洁性：** 降低手动设置虚拟机的复杂度。
* **自助服务：** 让用户通过受控选项自行配置所需资源。
* **自动化：** 利用强大的 VergeOS 方案引擎执行高级配置任务。

***


---

# 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/marketplace-vm-recipes.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.