> For the complete documentation index, see [llms.txt](https://library.zoom.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://library.zoom.com/technical-library/zh/gao-ji-qi-ye-fu-wu/zoom-node/zoom-node-deployment-field-guide/zoom-node-hypervisor-specific-deployments.md).

# Zoom Node 特定虚拟机监控程序部署

使用本节在各种虚拟机监控程序平台上部署 Zoom Node

在虚拟化环境中部署 Zoom Node 时，必须根据所用的特定虚拟机监控程序平台调整安装和配置步骤。每种虚拟机监控程序（例如 VMware vSphere、Microsoft Hyper-V 等）都可能对资源分配、存储访问和网络接口配置提出独特要求。

本部分针对受支持的虚拟机监控程序提供详细指导，确保 Zoom Node 在您的虚拟基础架构中可靠、高效地运行。

### <mark style="color:蓝色;">VMware vSphere 部署</mark>

以下部分介绍 VMware vSphere 安装方法，该方法需要下载并部署 Zoom Node 的 OVA（开放虚拟设备）文件版本。

#### 下载 OVA 映像

下载映像文件的步骤：

1. 登录 Zoom 管理员 Web 门户。
2. 浏览至以下位置，下载 Zoom Node OVA 映像文件： **节点管理 > 模块 > 节点 > 添加节点**.\\

   <figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-904a6441a8b23f2c4870f0730dbd8068abed1636%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>
3. 单击 **下载** 按钮。

#### 部署 OVA 映像

部署映像文件的步骤：

1. 登录 VMware Web 界面。
2. 单击 **创建/注册虚拟机**.
3. 在“选择创建类型”菜单下，单击 **从 OVF 或 OVA 文件部署虚拟机**.\\

   <figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-f950f3774cdb44e52af8e6ea1a9192d0b36ed439%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>
4. 点击 **下一步**.
5. 输入 Zoom Node 虚拟机的名称。
6. 单击蓝色对话框以打开文件浏览器，然后选择已下载的 Zoom Node OVA 映像文件。
   1. （可选）将映像文件拖放到框中。

<figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-8c01dba69c53e657d909fa87ba2733a6d4c11e75%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

7. 点击 **下一步**.
8. 选择用于存储 Zoom Node 的存储卷，然后单击 **下一步**.
9. 选择服务器所在的网络。
   1. （可选）如果需要，可对虚拟机进行精简置备。

{% hint style="info" %}
“精简置备”允许虚拟机磁盘仅在写入数据时使用物理存储，而不是预先预留整个磁盘空间。此方法可以节省空间，但如果总体使用量增长速度超过可用容量，您可能会面临存储空间不足的风险。
{% endhint %}

<figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-290f8dc92612b93d0b03cee035ef6567c27f45f3%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

10. 点击 **下一步**.
11. 检查所做的选择，然后单击 **完成** 以部署虚拟机。

完成虚拟机部署可能需要几分钟。

虚拟机启动后，其设置和详细信息将与下图所示类似：

<figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-5323e44d982cdf4a86d20cfc4200cbbbd54c5a31%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

虚拟机部署已完成。

### <mark style="color:蓝色;">Microsoft Hyper-V 部署</mark>

以下部分介绍 Microsoft Hyper-V 安装方法，该方法需要下载并部署 Zoom Node 的 VHDX 文件版本。

#### 下载 Zoom Node VHDX 存档

Zoom 存档包含 Zoom Node VHDX 磁盘映像和虚拟机配置元数据。

下载存档的步骤：

1. 登录 Zoom 管理员 Web 门户。
2. 从 Zoom **Zoom Node VHDX** 管理员门户中浏览至以下位置，下载映像： **节点管理 > 模块 > 节点 > 添加节点**.\\
3. 下载 Zoom Node VHDX 文件。
4. 将文件解压到本地文件夹中以供临时使用。

### <mark style="color:蓝色;">（可选）使用</mark> <mark style="color:蓝色;">`qemu-img`</mark> <mark style="color:蓝色;">在 Windows 上从 QCOW2 (KVM) 磁盘映像创建 VHDX 映像</mark>

若要在 Hyper-V 环境中使用 QCOW2 (KVM) 磁盘映像，可以将其转换为 VHDX 格式，方法是使用 `qemu-img` 在 PowerShell 中。

**步骤 1：下载并安装 `qemu-img` （适用于 Windows）**

1. 访问 Cloudbase 官方存储库：\
   <https://cloudbase.it/qemu-img-windows/>
2. 下载适用于 Windows 的 `qemu-img`.
3. 将内容解压到一个已知目录，例如： `C:\Users\管理员\Downloads\qemu-img`.

**步骤 2：使用 PowerShell 将 QCOW2 转换为 VHDX 格式**

打开 PowerShell 并运行以下命令来转换镜像：

{% code overflow="wrap" %}

```powershell
.\qemu-img.exe convert `
  -f qcow2 `
  -O vhdx `
  -p `
  .\ubuntu22-zoomcommon-build-dev-20250312012853-2.qcow2 `
  .\ubuntu22-zoomcommon-build-dev-20250312012853.vhdx
```

{% endcode %}

您应该会看到类似以下的进度输出：

```
(100.00/100%)
```

{% hint style="info" %}

* `-f qcow2` 指定输入格式
* `-O vhdx` 指定与 Hyper-V 兼容的输出格式
* `-p` 在转换过程中显示进度条
* 根据你的环境调整文件路径
  {% endhint %}

**实施背景和实际成果**

转换为 VHDX 后，你可以将自定义构建的 Linux 映像（例如预装了 Zoom 代理或服务的 Ubuntu）导入 Hyper-V 虚拟机。这有助于搭建自定义实验室环境、进行 CI/CD 测试，或在一致的系统配置下开展本地化开发。

#### 部署 Zoom Node Hyper-V 虚拟机

Hyper-V 支持通过两种主要方式部署 VM：第一种是使用 Hyper-V 管理器中的 GUI，第二种是使用 PowerShell 脚本。PowerShell 是自动化部署多个 Node 的最简单方法。

可通过两种方式部署虚拟机。简单方式（选项 1）使用 PowerShell 命令，根据正确的属性，使用 VMDK 创建新的 Zoom Node VM。选项 2 则使用 Hyper-V 管理器 GUI 部署 VM。

请参阅 [Zoom Node 基础架构先决条件](https://library.zoom.com/technical-library/zh/gao-ji-qi-ye-fu-wu/zoom-node/zoom-node-deployment-field-guide/zoom-node-infrastructure-prerequisites.md#supported-hypervisors) 先决条件页面，了解更多信息。

{% hint style="info" %}
对于某些模块系列（ZPLS、ZRH、CRC Hybrid），可能需要调整 Zoom Node VM 的大小。请参阅特定模块的文档，了解正确的属性。
{% endhint %}

#### 选项 1（推荐）：通过 PowerShell 部署 Zoom Node VM

{% hint style="info" %}
截至 2025 年，Microsoft PowerShell v5.1 是 Hyper-V 管理插件支持的版本。PowerShell 7 可能也能使用，但某些 Hyper-V 专用命令无法正常运行。
{% endhint %}

找到 Hyper-V 虚拟机的存储位置。本示例中，Hyper-V 服务器将 VM 存储在 `D:\!-HyperVMs`.

以下 PowerShell 命令用于创建 VM、附加 VHDX 映像，并使用正确的属性自定义 VM。

{% code overflow="wrap" %}

```powershell
# ===========================
# Zoom Node VM：Hyper-V 设置
# ===========================

# 编辑这四个值
$VMName      = "ZN-PROD-01"
$RootPath    = "D:\!-HyperVMs"  # 将用于存放 VM 文件夹的目录
$SourceVhdx  = "D:\Downloads\ubuntu22-zoomcommon-build-20250502110711.vhdx"
$SwitchName  = "vSwitch-Production"

# 派生路径
$VMFolder    = Join-Path $RootPath $VMName
$TargetVhdx  = Join-Path $VMFolder "$VMName.vhdx"

# --- 为虚拟机创建文件夹并复制 VHDX（完整的独立克隆）---
New-Item -ItemType Directory -Path $VMFolder -Force | Out-Null

Copy-Item -LiteralPath $SourceVhdx -Destination $TargetVhdx -Force

# --- 创建第 2 代虚拟机（暂不创建磁盘）---
New-VM `
  -Name $VMName `
  -Generation 2 `
  -MemoryStartupBytes 16GB `
  -Path $VMFolder `
  -NoVHD | Out-Null

# --- CPU：8 个 vCPU ---
Set-VMProcessor -VMName $VMName -Count 8

# --- 内存：固定 16 GB（禁用动态内存）---
Set-VMMemory -VMName $VMName -DynamicMemoryEnabled:$false -StartupBytes 16GB

# --- 挂载克隆的磁盘 ---
添加-VMHardDiskDrive -VMName $VMName -Path $TargetVhdx

# --- 安全启动 + Microsoft UEFI CA + 从磁盘启动 ---
# 使用 Microsoft UEFI CA 为 Linux（Ubuntu）启用安全启动
Set-VMFirmware -VMName $VMName -EnableSecureBoot On -SecureBootTemplate "MicrosoftUEFICertificateAuthority"

# 获取系统磁盘对象，并将其设为第一启动设备
$sysDisk = Get-VMHardDiskDrive -VMName $VMName | Where-Object { $_.Path -eq $TargetVhdx }
Set-VMFirmware -VMName $VMName -BootOrder $sysDisk

# --- 网络：连接到 vSwitch（可选的 VLAN 行已注释）---
Connect-VMNetworkAdapter -VMName $VMName -SwitchName $SwitchName
# Set-VMNetworkAdapterVlan -VMName $VMName -访问 -VlanId 123

# --- 管理行为与检查点 ---
Set-VM -Name $VMName -AutomaticStartAction StartIfRunning -AutomaticStopAction ShutDown
Set-VM -Name $VMName -CheckpointType Production -AutomaticCheckpointsEnabled:$false

# --- 集成服务：启用访客服务接口 ---
$gsi = Get-VMIntegrationService -VMName $VMName -Name '访客 Service Interface' -ErrorAction SilentlyContinue
if ($gsi -and -not $gsi.Enabled) {
  启用-VMIntegrationService -VMName $VMName -Name '访客服务接口'
}

# --- 启动虚拟机（可选）---
Start-VM -Name $VMName

```

{% endcode %}

#### 选项 2：部署 VHDX 并手动创建虚拟机

选项 2 是通过部署 VHDX 文件手动创建虚拟机。此方法需要将磁盘映像从解压后的 Zoom Node 存档中传输到 Hyper-V 虚拟机的指定存储位置，并手动配置虚拟机设置。

**将 VMDK 复制到 Hyper-V 虚拟机存储**

1. 找到 Hyper-V 虚拟机的存储位置。（在此示例中，Hyper-V 服务器将虚拟机存储在 `D:\HyperVMs`.)

   <figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-f985a064f1e189b6ee41ff68a908fab368d1e018%2Funknown?alt=media" alt=""><figcaption></figcaption></figure>
2. 为要部署的 Zoom Node 创建一个唯一的文件夹，并在该目录中创建一个名为 **虚拟硬盘**.

   <figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-c7ba7bbd77bb5fd0f6c36b88514178dd2a11d3d8%2Funknown?alt=media" alt=""><figcaption></figcaption></figure>
3. 将从 Zoom 下载的 VHDX 映像文件复制到 Virtual Hard Disks 目录。
4. 登录 Microsoft Hyper-V Manager 控制台以管理虚拟机。

**定义虚拟机**

在 Hyper-V Manager 中，单击 **新建** 并选择 **虚拟机** （位于右侧窗格中）。这将启动 **新建虚拟机向导**.

1. 完成 **指定名称和位置** 步骤：
   1. 为虚拟机输入名称。
   2. （可选）选择存储位置。通常会将 VM 配置文件与 VM 虚拟磁盘存储在同一文件夹中。
   3. 勾选“将虚拟机存储在其他位置”复选框，然后点击 **浏览**.

<figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-e2da648950db55e12e7652da1b8fcf208d0aa68c%2Funknown?alt=media" alt=""><figcaption></figcaption></figure>

2. 浏览到之前创建的 VM 存储文件夹。

<figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-2f33b703f1adf5b4cd3e50927dbfdced04cb30cf%2Funknown?alt=media" alt=""><figcaption></figcaption></figure>

3. 选择该文件夹。
4. 点击 **下一步**.
5. 完成 **指定代数** 步骤：
   1. 选择 **第 2 代** 单选按钮
   2. 点击 **下一步**

<figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-0e8f445aa803cfaaa8ee2760304d646868ab8a65%2Funknown?alt=media" alt=""><figcaption></figcaption></figure>

7. 完成 **分配内存** 步骤：
   1. 在 **启动内存：** 文本框中，输入 `16384` （MB）
   2. （可选）勾选“对此虚拟机使用动态内存”，以减少分配的 RAM
   3. 点击 **下一步**

<figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-a9b854dfdd94190288130e4c7bfe182bf6787b7b%2Funknown?alt=media" alt=""><figcaption></figcaption></figure>

8. 完成 **配置网络** 步骤：
   1. 点击 **连接：** 下拉菜单，然后选择一个虚拟交换机，将 VM 连接到网络。具体选项取决于你的 Hyper-V 网络环境。

<figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-8a82acfa91de1ef007f2091507a99da7ba85372f%2Funknown?alt=media" alt=""><figcaption></figcaption></figure>

9. 点击 **下一步**.

**连接 VHDX 磁盘映像**

接下来，在“新建虚拟机向导”中完成 **连接虚拟硬盘** 步骤。连接映像的方法：

1. 选择 **使用现有虚拟硬盘** 单选按钮。

<figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-2710d15507ef48173d8e02255f31d1eceab0eefc%2Funknown?alt=media" alt=""><figcaption></figcaption></figure>

2. 点击 **浏览** 并找到之前创建的 VM 文件夹。\\

   <figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-925dffe7be359c06c2b1318af88152d4b3f5a30e%2Funknown?alt=media" alt=""><figcaption></figcaption></figure>
3. 在文件选择窗口中，点击 **打开**.
4. 点击 **下一步**.
5. 检查设置，然后点击 **完成** 以创建附加了 VHDX 磁盘的 VM。\\

   <figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-39754679d1152d8c66f2c20b82399d30837c7d08%2Funknown?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
暂时不要启动 VM。
{% endhint %}

**配置其他 VM 设置**

配置其他设置的方法：

1. 右键点击已部署的 VM，然后选择 **设置...**.\\

   <figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-4327767f591fcbc02ab6f4ee599112ce96f7ed85%2Funknown?alt=media" alt=""><figcaption></figcaption></figure>
2. 在 **硬件** 屏幕左侧的类别下，单击 **安全**.
3. 在屏幕右侧的 **安全** 标题下，单击 **模板：** 下拉列表。
4. 选择 **Microsoft UEFI 证书颁发机构** 选项。\\

   <figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-24bac2604171e6578a11403dcf9bfa7a86f802ab%2Funknown?alt=media" alt=""><figcaption></figcaption></figure>
5. 单击 **应用**.
6. 在 **硬件** 屏幕左侧的类别下，单击 **处理器**.
7. 在屏幕右侧的 **处理器** 标题下，将 **虚拟处理器数量：** 框设置为 `8` （虚拟处理器）。\\

   <figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-1364c2938421760484435e0e17a1813800d25c71%2Funknown?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
这是 Zoom Node 运行四 (4) 个模块所需的默认值。有关运行较少模块时调整 VM 大小的更多信息，请参阅 [Zoom Node 基础架构先决条件](https://library.zoom.com/technical-library/zh/gao-ji-qi-ye-fu-wu/zoom-node/zoom-node-deployment-field-guide/zoom-node-infrastructure-prerequisites.md#deployment-sizing-and-capacity-planning-matrix) 页面。
{% endhint %}

8. 单击 **确定** 以接受更改。

**启动虚拟机**

若要启动 VM：

1. 在 Hyper-V 管理器中选择新创建的 VM。
2. 在屏幕右侧的 **操作** 窗格中，单击 **启动**.
3. 单击 **连接** 以打开 VM 控制台窗口。\\

   <figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-2cf51b9a938b92f92ca3983741ee5e45bfbe8387%2Funknown?alt=media" alt=""><figcaption></figcaption></figure>

正常运行的 VM 启动过程会显示 Linux 启动画面。接下来将加载 Zoom Node 文本界面。

{% hint style="info" %}
如果尝试启动时看到 UEFI 错误消息，可能是因为您没有将安全启动方法设置为“UEFI 证书颁发机构”。

<img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-0b290fa647f6639fedd39a37d3f2fe277ce9a13b%2Funknown?alt=media" alt="unknown" data-size="original">
{% endhint %}

### <mark style="color:蓝色;">KVM 部署</mark>

以下部分介绍基于内核的虚拟机 (KVM) 安装方法，该方法支持通过 Proxmox VE 或 KVM 虚拟机管理器 (Virt-manager) 安装 Zoom Node。

#### KVM Proxmox 虚拟环境 (VE)

与部署 ISO 映像相比，使用 qcow2 映像在 Proxmox VE 上部署 Zoom Node 需要额外步骤。以下步骤将创建一台新的、已配置好的 VM，以便将 Zoom Node qcow2 映像附加到该 VM。

{% hint style="info" %}
QEMU/KVM 的默认部署会使用 hypervisor NAT 和由 KVM 管理的私有 IP 地址池来部署 VM。这不是 Zoom Node 支持的架构。虽然可以在 hypervisor NAT 后部署并运行 Zoom Node，但网络上的客户端将无法与其正常通信。Zoom Node 必须部署在桥接接口上，使其获得的 IP 地址位于客户端可与之通信的 IP 地址范围内。
{% endhint %}

**定义 Zoom Node 虚拟机**

若要定义 VM：

1. 登录 Proxmox 管理应用程序界面。
2. 单击 **创建 VM** 按钮。此 VM 将成为 Zoom Node 模板 VM。
3. 为 VM 命名，并 **保存 VM ID**.
   1. 此信息将在后续步骤中使用。
4. 单击 **下一步** 以继续。
5. 选择 **不要使用任何介质** 在操作系统设置页面上。
6. 点击 **下一步**.
7. 在 `q35` 选项下，选择 **计算机** 设置。
   1. 对于 **BIOS** 类型，请选择 **OVMF (UEFI)** 并选择用于存储 EFI 设置的卷。此处设置为与存储 VM 本身所用的同一个 VM 卷。

{% hint style="info" %}
必须按照说明设置计算机和 BIOS 设置，否则 VM 将无法成功启动。
{% endhint %}

8. 点击 **下一步**.
9. 在 **磁盘** 页面上，选择 VM 将从中运行的存储卷。
10. 将 **磁盘大小 (GiB)** 设置为 `200`.
11. 选择 **直写** 作为缓存设置。
12. 点击 **下一步**.
13. 将 **核心数** 设置为 `8`.
14. 点击 **下一步**.
15. 将 **内存 (GiB)** 设置为 `16384`.
16. 点击 **下一步**.
17. 根据部署选择正确的网络设置，通常为带有 VLAN 标签的网桥接口。
18. 点击 **下一步**.
19. 在 **确认** 页面上，确保未选中 **创建后启动** 复选框。
20. 再次检查设置，重点确认 `q35` 是计算机类型，且 `omvf` 是 BIOS 类型。
21. 单击 **完成** ，但请先确认设置正确。
22. 以 [Zoom 管理员门户](https://zoom.us/) 管理员身份登录，网址为 <https://zoom.us>.

**准备 Zoom Node QCOW2 映像**

准备映像：

1. 在 Zoom 管理员门户中转到 **Zoom Node > 模块 > 节点 > 添加节点**.
2. 下载当前版本的 **Zoom Node qcow2 映像文件**.
3. 将文件复制到 Proxmox 可访问的目录（例如 NFS 卷）。
   1. （可选）将其复制到 Proxmox 服务器上存储虚拟机的卷中。
4. 请注意，已创建 `111` 目录和空磁盘映像。
5. 记下此文件夹中磁盘映像的名称
   1. 例如： `vm-111-disk-0.qcow2`.
6. 删除磁盘映像文件。
7. 将 **Zoom Node qcow2** 文件复制到此目录中。
8. 将此文件重命名为之前记下的磁盘映像原始名称（即 `vm-111-disk-0.qcow2`).
9. 返回 Proxmox 主 Web 界面，选择刚刚部署的虚拟机。
10. 右键单击所选虚拟机，然后选择 **克隆** 。
11. 为克隆虚拟机命名并单击 **克隆**.
12. 。克隆完成后，右键单击克隆虚拟机并选择 **转换为模板**.
    1. 现在已有一个可部署的模板。
13. 选择原始虚拟机，然后单击打开 **控制台**.
14. 单击 **立即启动** 按钮启动虚拟机。

确认虚拟机启动并显示 Zoom Node 本地文本用户界面，以验证该模板可用于将来的部署。

#### KVM 虚拟机管理器（Virt-manager）

虚拟机管理器（也称为 virt-manager）是一款广受欢迎的 QEMU/KVM 虚拟机管理应用程序。

此部署示例使用 Ubuntu 22.04 LTS 上的虚拟机管理器。不过，它也可以在许多 Linux 发行版上运行。

默认部署的 QEMU/KVM 使用虚拟机监控程序 NAT 和由 KVM 管理的私有 IP 地址池来部署虚拟机。Zoom Node **不** 支持此架构。

{% hint style="info" %}
虽然可以在虚拟机监控程序 NAT 后部署和运行 Zoom Node，但网络上的客户端将无法正常通信。为确保客户端正常通信，请将 Zoom Node 部署在与客户端 IP 地址范围匹配的桥接接口上。
{% endhint %}

使用 virt-manager 方法安装：

1. 登录 [Zoom 管理员门户](https://zoom.us/) 以管理员身份。
2. 下载当前版本的 **Zoom Node qcow2 映像文件** 在 Zoom Node 管理员门户中选择 **Zoom Node > 模块 > 节点 > 添加节点**.
3. 将文件重命名为所需的 VM 或磁盘名称。
   1. 示例： `ZN-SJC01-NODE01.qcow2`.
4. 将文件移至 Virtual Manager 可访问的卷。
5. 在 Virtual Manager 中创建新的 VM。
6. 点击 **导入现有磁盘映像**.
7. 选择存储已重命名 qcow2 映像的卷。
8. 点击 **选择卷** 按钮。
   1. （可选）如果 virt-manager 中尚未添加正确的目录，可以点击 **浏览本地** 以添加该目录。
9. （可选）如果未自动检测到操作系统，请将其设置为 **Ubuntu 22.04 LTS**.
10. 将 RAM 配置更改为 `16384 MB` （16 GB），并将 CPU 配置设置为 `8 CPUs`.
    1. 这些设置可让 Zoom Node 运行四 (4) 个模块。

{% hint style="info" %}
您可以调整这些值，但调整可能会影响 Zoom Node 的容量和性能。如果 Zoom Node 仅运行一个模块，可将 RAM 设置调整为 6 GB、CPU 设置调整为 3，这是绝对最低配置。
{% endhint %}

11. 输入节点名称。
12. **点击“安装前自定义配置”**.

{% hint style="danger" %}
如果不执行此配置，节点将无法启动。还必须修改其他设置。
{% endhint %}

13. 确保网络设备设置为 **桥接以太网** 而不是 NAT。

{% hint style="info" %}
在 KVM 上将 Zoom Node 部署在 NAT 后方会阻止客户端与其通信。
{% endhint %}

14. 打开 **VM 详细信息** 窗格后，更改 **芯片组** 为 **Q35**.
15. 将 **固件** 更改为 **UEFI**.

{% hint style="warning" %}
如果未设置 UEFI，Zoom Node 将无法启动。
{% endhint %}

16. 单击 **应用**.
17. 点击 **开始安装** （位于功能区菜单顶部）以部署 VM。

VM 将启动并开始引导。原始 VM 启动后，我们就能确认创建的模板已正式可用。

### <mark style="color:蓝色;">Nutanix AHV 部署</mark>

Zoom Node 可以作为虚拟机（VM）在 Nutanix AHV 上运行。Zoom Node 部署在数据中心，用于运行 Zoom 混合服务（也称为服务模块），例如 Meetings Hybrid、Recording Hybrid、聊天 Hybrid 和 Phone Local Survivability。

本节介绍如何在 Nutanix AHV 6.8.1 至 7.0.1 版本上安装 Zoom Node 操作系统虚拟机。

#### Hypervisor 和虚拟机的一般要求

请参阅 [Zoom Node 基础架构先决条件](https://library.zoom.com/technical-library/zh/gao-ji-qi-ye-fu-wu/zoom-node/zoom-node-deployment-field-guide/zoom-node-infrastructure-prerequisites.md)页面，了解部署所需的硬件和软件先决条件。

#### 部署 Zoom Node

部署 Zoom Node 需要下载镜像、将镜像导入 AHV 并创建虚拟机。

**下载 Zoom Node 镜像文件**

下载映像文件的步骤：

1. 登录 [Zoom 管理员 Web 门户](https://zoom.us/).
2. 下载  **Zoom Node QCOW2**  镜像，请在 Zoom 管理员门户中选择  **节点管理 > 模块 > 节点 > 添加节点**。\\

   <figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-b16ce1aa1e16b7838854e789a00d1331169b99c0%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>
3. 下载  **QCOW2 镜像** ，请点击“ **下载** ”按钮。

{% hint style="info" %}
AHV 可以导入 QCOW2 或 .ova/VMDK 镜像。两种格式都可以使用，但 Zoom 建议使用 QCOW2 镜像。该格式可以直接上传，无需先解压 .ova 文件来提取 VMDK。
{% endhint %}

**将 Zoom Node 镜像导入 AHV**

1. 通过访问以下地址登录 Nutanix AHV 控制台： `https://<cluster hostname>:9440`.
2. 点击 **主页** 下拉菜单，然后选择 **设置** 列表中的相应选项。

<figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-60d20e5cc62dcec3c6cf90c3fc0fe4b69182ed2d%2Funknown.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

3. 查看 **设置** 页面。

<figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-6519b8ce1e2870b301d70f461943558f97954a56%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

4. 在屏幕左侧，点击 **映像配置**。此时会显示磁盘映像上传对话框。

<figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-ded1a16c1aadc4864393e52b269df8463eea03d0%2Funknown.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

5. 点击 + 上传映像按钮。

<figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-af1444caa47a2318eb5d1a7a2cba9d001b0c3703%2Funknown.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

6. 在“创建映像”对话框的文本字段中输入所需信息。
   1. 注释是可选字段。
   2. 点击 **映像类型** 展开下拉菜单并选择 **DISK**.
   3. 单击 **存储容器** 展开下拉菜单并选择适合您环境的选项。
7. 单击 **上传文件** 单选按钮，然后单击 **浏览...**.
8. 选择之前下载的 QCOW2 映像。
9. 点击 **保存** 以开始上传映像。

<figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-53b770f1c8aacc343ed894a9b41408085b45ca2a%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

上传进度将显示在蓝色横幅中。

{% hint style="danger" %}
请保持当前浏览器窗口或选项卡处于打开状态，以确保上传完成。上传过程中，请勿尝试导航到 AHV 界面的其他位置。
{% endhint %}

上传完成后，映像更新流程将开始。点击横幅菜单中闪烁的作业状态图标以查看进度。

<figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-7e6de74df5f314185ef393de99627f84f5180246%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

导入过程可能需要几分钟才能完成。完成后，映像将以 **有效** 状态显示在列表中：

<figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-859d94c55a31e99c0c77b6ef016ea7ee5470c081%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
导入后，Zoom Node 磁盘映像约为 200GB。
{% endhint %}

**创建 Zoom Node 虚拟机**

接下来，您将创建虚拟机。创建 VM 的步骤如下：

1. 点击 **设置** 下拉菜单，然后选择 **VM**.

   <figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-474951338298637cc45c8a4ffaab1e8e452b5abd%2Funknown.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>
2. 在 VM 屏幕中，点击 **+ Create VM** 屏幕右侧的该选项。

   <figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-b01cec67254e40cc465e27007d52faa3435cd613%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>
3. 输入 **名称**, **描述** （可选），然后选择合适的 **时区**.
4. 在 **计算详细信息**下，输入计算规格。\\

   <figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-815de752de241325f60ffecd7c350a721bf0ce2f%2Funknown.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="warning" %}
如上所示，生产环境部署的 Zoom Node 需要 8 个 vCPU 核心。Zoom 建议设置 vCPU 时，使套接字数量与物理服务器相匹配。以下设置说明满足标准部署要求：

* 将 **vCPU(s)** 字段设置为运行 Nutanix AHV 的服务器的套接字数量。对于典型的双套接字服务器，请将此值设置为 **2**.
* 将 **Number Of Cores Per vCPU** 设置为 **4**，计算结果为 **8 个 vCPU**.
* 将 **内存** (RAM) 设置为 **16** GB。
* 在 **启动配置**下，选择 **UEFI**.
  {% endhint %}

{% hint style="danger" %}
如果未选择 UEFI，Zoom Node 将无法启动。
{% endhint %}

5. 此时会出现警告对话框。点击 **确定** 以确认。\\

   <figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-8650c6bcb97e8e59e698dbb2279e91dda03446d7%2Funknown.png?alt=media" alt="" width="525"><figcaption></figcaption></figure>
6. 向下滚动到 **磁盘** 部分。\\

   <figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-754c969e06ac2d54827d1c9b9c61dd659efb4dff%2Funknown.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>
7. 单击 **+ 添加新磁盘** ，以创建供 Zoom Node 运行的磁盘。\\

   <figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-7ce64b4af20709c24fde059fbb4a906eef92849c%2Funknown.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>
8. 在 **类型** 下拉菜单中，选择 **DISK**.
9. 在 **操作** 下拉菜单中，选择 **从映像服务克隆**.\\

   <figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-a52a02d5c64aed117aa2b9da1a0c2b47f62b53fd%2Funknown.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>
10. 在 **映像** 下拉菜单中，选择你之前导入 Zoom Node 磁盘时创建的映像名称。
11. 点击 **添加**.
12. 向下滚动到 **网络适配器 (NIC)** 部分。\\

    <figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-27cf7978d38bd953e64108d19ecf97bafe2075d1%2Funknown.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>
13. 点击 + 添加新 NIC。\\

    <figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-93faedc48201020bdd3546579a26dfa6fcaa5c04%2Funknown.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>
14. 在 **子网名称** 下拉菜单中，选择具有直接 IP 访问权限的选项。

{% hint style="info" %}
提醒：不支持虚拟机管理程序 NAT。
{% endhint %}

15. 在 **网络连接状态**，选择 **已连接**.
16. 点击 **添加**.\\

    <figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-088ab7e3569d1e244786d3be266617903047da7b%2Funknown.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>
17. 单击 **保存** 以创建虚拟机。

**启动新的 Zoom Node 虚拟机**

新的 Node 将显示在虚拟机列表中。你可以选择“表格”视图，以便更轻松地查看虚拟机列表。

<figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-9d41bee9bd5784fafc6d387da902fac351a5624b%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

右键单击新建的虚拟机，然后选择 **开机**.

<figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-58323e423085b1790e0891004ef300f862ca0099%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

几秒钟后，虚拟机将开始启动。

再次右键单击该虚拟机，然后选择 **启动控制台** 与虚拟机交互。

{% hint style="info" %}
将打开一个弹出窗口。如果您没有看到该窗口，可能需要在浏览器设置中允许 AHV 弹出窗口。
{% endhint %}

启动后，Zoom Node 在 Nutanix AHV 上的部署即告完成。

#### 管理 Zoom Node

如需详细了解如何管理已激活的 Zoom Nodes，请参阅 Zoom 支持文章 [管理 Zoom Node 服务器和模块](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063730).

### <mark style="color:蓝色;">AWS EC2 部署</mark>

{% hint style="info" %}
Zoom Node AMI 尚未在 Zoom App Marketplace 中提供。目前，需要手动创建 AMI。此过程只需针对 AWS 账户执行一次。

如果您的账户已创建 Zoom Node AMI，且您只是想部署新的 Zoom Node 实例，则可以跳过本节。
{% endhint %}

#### 前提条件

请参阅 [Zoom Node 基础架构先决条件](https://library.zoom.com/technical-library/zh/gao-ji-qi-ye-fu-wu/zoom-node/zoom-node-deployment-field-guide/zoom-node-infrastructure-prerequisites.md)页面，了解部署所需的硬件和软件先决条件。

#### 下载 OVA 镜像

1. 通过访问以下位置，从 Zoom 管理员门户下载最新的 Zoom Node OVA 镜像： **管理员门户 > Zoom Node > 模块 > 节点 > 添加节点**.

<figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-1c3ae8bd61b6e5d88e39cfc6f638b1af2c517bd8%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

2. 下载 VMWare OVA 镜像并记下文件名。文件约 5GB，下载可能需要一些时间。
3. 将 OVA 文件解压到工作目录。（在 Windows 上，使用 PowerShell 以便使用 tar 命令。）
   1. 输入： `tar xvf <Zoom Node>.ova`
   2. 输出类似于以下内容：\\

      <figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-4626811be8f9ea5d7761020fa34d32a232135a6a%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>
   3. 记下 .vmdk 文件的名称。在此示例中，文件名为： `ubuntu22-zoomcommon-build-go-20240418014859-disk-0.vmdk`.
4. 将 .vmdk 文件上传到 S3 存储桶。可以使用 AWS Web 界面，或者最好使用 AWS CLI，以确保 .vmdk 文件名保持一致。
   1. 输入以下命令，将文件复制到 AWS S3： `aws s3 cp ubuntu22-zoomcommon-build-go-20240418014859-disk-0.vmdk s3:///node3.4.vmdk`.
   2. 根据互联网连接速度，上传可能需要几分钟到数小时。文件大小约为 5 GB。\\

      <figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-6621bf2c934afafa36779b8049bf49d786193d0b%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
上述命令会将文件在 S3 中重命名为更易于识别的 `node3.4.vmdk` 名称，便于导入时使用。

例如，如果 S3 存储桶名为 `vhd-import-bucket` 命令如下： `aws s3 cp ubuntu22-zoomcommon-build-go-20240418014859-disk-0.vmdk s3://vhd-import-bucket/node3.4.vmdk`.
{% endhint %}

5. 准备一个 JSON 文件，其中包含以下信息，用于描述要导入的磁盘镜像：

```json
 {
    "Description": "Zoom Node 3.4 VMDK",
    "Format": "vmdk",
    "UserBucket": {
        "S3Bucket": "vhd-import-bucket",
        "S3Key": "node3.4.vmdk"
    }
  }
```

{% hint style="info" %}
此代码将当前存储在 S3 存储桶中的 `node3.4.vmdk` 镜像标识为 Zoom Node 3.4 版。
{% endhint %}

6. 将 Zoom Node .vmdk 镜像导入为 **快照**.

{% hint style="warning" %}
必须将磁盘导入为快照， **而不是** 镜像。
{% endhint %}

7. 输入以下命令： `aws ec2 import-snapshot --disk-container file://.json`.
8. （可选）如果 JSON 文件名为 `node.json`，请输入以下命令： `aws ec2 import-snapshot --disk-container file://node.json`.
9. 查看 `StatusMessage:` 字段，在导入开始时确认状态为“pending”。\\

   <figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-41eb385ae7229d8ddb24651f1794082953012eab%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
导入可能需要 20 分钟或更长时间才能完成。
{% endhint %}

10. 查看 CLI 输出中的 `ImportTaskId` 值。
    1. 在上面的示例中， `ImportTaskId` 是 `import-snap-f8d845596565b0c3t`。此值会定期检查作业的状态。
    2. 输入以下命令： `aws ec2 describe-import-snapshot-tasks --import-task-ids <ImportTaskId>` 其中 `ImportTaskId` 是上一步确定的唯一值。
    3. 应显示以下输出，其中已填入你的 `ImportTaskId` 值：\\

       <figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-ddbb134ad032b38f0148e0efd07463573d9738e7%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>
    4. 请注意，作业的当前状态为“downloading/converting”（正在下载/转换），表示作业仍在处理文件。字段 `Progress: <##>,` 显示完成百分比。上面的示例中，该值表示已完成 `19` 19%。
    5. 查看 `Status:` 字段以确认作业已完成：\\

       <figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-d5e95a0013f54e293cd0e836243ee9fe6510e0de%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

#### 将快照转换为 Amazon Machine Image (AMI)

1. 登录 AWS Console EC2 仪表板。\\

   <figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-495ff50c27be4f5880910750271cba41bc1d4e01%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>
2. 在屏幕左侧的 **Elastic Block Store** 下拉菜单中，点击 **快照**。\\

   <figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-10efb7067c30bf4667e4a42764232ab1a24611d6%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>
3. 点击 **快照 ID 链接** 以查看其详细信息。\\

   <figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-1cd5fc7510c2faed257ac0faee99c2f10211926c%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>
4. 点击屏幕右上角的 **操作** 下拉按钮，然后选择 **从快照创建映像**.
5. 此时会显示 **映像设置** 窗口。
6. 输入 AMI 的 **映像名称** 。
   1. 示例： **Zoom Node 3.4 AMI**.
7. （可选）输入说明。\\

   <figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-0d4e5efcbe70b6e80866211fc130458d8da572ba%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>
8. 向下滚动窗口以查看其他设置。
9. 确认在 **大小 (GiB)**&#x4E0B;方看到已分配的 189 GB 磁盘卷。\\

   <figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-f1ec30743a66afc398b20d0036d7dfde8e3f555e%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>
10. 在 **启动模式** 下拉菜单中，选择 **UEFI**.

#### 在 AWS EC2 上部署 Zoom Node 实例

1. 登录 AWS Console EC2 仪表板。\\

   <figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-495ff50c27be4f5880910750271cba41bc1d4e01%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>
2. 在屏幕左侧的 **实例** 下拉菜单中，点击 **实例**.
3. 使用 Zoom Node AMI 创建新实例。
4. 输入实例名称。

<figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-1f6ae0259884d8f846423e001edb3ffcd4e83d8b%2Funknown.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

5. 在 **应用程序和操作系统映像 (Amazon 机器映像)** 部分中，点击 **我的 AMI** 选项卡。
6. 搜索刚刚创建并命名的 Zoom Node AMI。\\

   <figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-e77a5de3de0e83b321d92c53d296cca1ced58d72%2Funknown.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>
7. 点击创建的 AMI，以设置各种参数。
8. 在 **实例类型** 部分中，点击 **实例类型** 下拉列表并选择 **t3.medium**.

<figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-729f12d883c854eba7892ea9520ea410af2c8c9c%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
对于生产部署，Zoom Node 需要 8 vCPU 和 16 GB RAM。相比之下，实验环境可以使用 2 vCPU 和 4 GB RAM 运行，建议使用 t3.medium 实例。如果系统上运行 Zoom Meetings Hybrid，则可能需要 t3.large 实例，才能支持会议中超过几位用户。
{% endhint %}

9. 在 **密钥对（登录）** 部分中，点击 **密钥对名称** 下拉列表并选择 **不使用密钥对继续（不推荐）**.

   1. 必须省略密钥对，因为 Zoom Node 未启用 SSH 控制台访问。

   <figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-d9d734bbd4466ab52f9d6bbdbdbf7b4ce00ee3c7%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>
10. 在“网络设置”下，配置以下选项：
    1. 在 **VPC - 必需**下，选择一个允许 Zoom Workplace 应用程序直接通过 L3 路由访问的 VPC。
    2. 在 **子网**下，选择此 VM 将运行的子网。\\

       <figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-728f03485275d3561c751fc29f3fc2cb10c8957e%2Funknown.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>
    3. **Zoom Node 需要与 Zoom 云进行外拨通信**。您必须提供一个公共 IP 地址。
    4. 从 **启用** 字段中选择 **自动分配公共 IP** 。
    5. 创建一个 **安全群组** ，允许 Zoom Workplace 应用程序通过所需端口进行拨入访问。
    6. 请参阅 Zoom 支持文章中记录的防火墙规则： [Zoom Node 管理服务器防火墙规则](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0066766)。\\

       <figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-ddf67e307bfefd85af13d78c20eb19dea8fc2404%2Funknown.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
Zoom Node 不需要互联网拨入访问，除非启用了来自外部来源的直接媒体访问（这是会议连接器的可选部署方式，或用于为 Zoom Meetings Hybrid - 私有会议提供外部用户访问）。
{% endhint %}

11. 点击 **高级详细信息**.
12. 点击 **元数据版本** 下拉列表并选择 **仅限 V2（需要令牌）**.\\

    <figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-3c12526cdf11ff191120e67a81fc3de8e228b283%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
必须将元数据版本设置为 V2，否则部署将失败。
{% endhint %}

#### （可选）预配置 Zoom Node

Zoom Node 操作系统设置（例如网络设置、主机名、本地密码和 16 位注册代码）可通过 AWS EC2 中的 **用户数据 -&#x20;*****可选*** 部分自动配置。

Zoom Node 启动时，会从 AWS EC2（IDMSv2 服务器）获取这些预配置的信息，并自动配置该 Node，如下图所示：

<figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-dd88be2e2972858f488b0e2439fce2221fd6b920%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

使用以下代码创建新的用户数据文件：

```yaml
#custom-config
hostname: zn-ec2
密码: ZoomNodepassword1234
注册_code: ABCD1234DEFG5678
network:
  ethernets:
    ens:
      addresses:
        - 10.15.1.150/24
        - 10.15.1.151/24
        - 10.15.1.152/24
      gateway: 10.15.1.1
      名称服务器：
        addresses:
          - 1.1.1.1
```

将用户数据文件上传到 AWS EC2 后，点击 **启动实例**.

<figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-f005bdc6849b51089c2f4d9c852a8f17422acf88%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

#### 查看已部署的实例

<div align="center"><figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-81efccb2aef64fd6ddbd71c74d717468f4fd4059%2Funknown.png?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>

点击 **实例 ID 链接** （如上图所示，i-06e4592fd2d91ef3f），找到分配给该节点的 **内部 IP 地址** 。

<figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-ee0d8b76974b80de46560b8415771b3297b5ccd8%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

节点启动并运行本地 Web 图形界面需要几分钟。

在实例启动后的前 10 分钟内，打开浏览器并输入 **专用 IPv4 地址** 列表中的地址（`10.10.130.223` 如上图所示）。

例如： `https://<10.10.130.223>:8443`.

接受出现的无效证书警告。随后会显示 Zoom Node 本地管理员门户，并提示你输入密码。

<figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-055d15acc93f4e797065fe134ebf7d535f156851%2Funknown.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

点击 **设置密码** 链接以配置管理员密码。

用户名始终为 `zoom-setup`.

{% hint style="info" %}
“设置密码”链接仅在虚拟机启动后的前 10 分钟内可见。如果看不到该链接，请重启虚拟机，以便再次显示此选项。
{% endhint %}

部署现已完成，您可以按照以下位置开始的说明继续进行配置： [Zoom Node 部署后配置和管理](https://library.zoom.com/technical-library/zh/gao-ji-qi-ye-fu-wu/zoom-node/zoom-node-deployment-field-guide/zoom-node-post-deployment-configuration-and-management.md#network-configuration)步骤 [Zoom Node 部署后配置和管理](https://library.zoom.com/technical-library/zh/gao-ji-qi-ye-fu-wu/zoom-node/zoom-node-deployment-field-guide/zoom-node-post-deployment-configuration-and-management.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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://library.zoom.com/technical-library/zh/gao-ji-qi-ye-fu-wu/zoom-node/zoom-node-deployment-field-guide/zoom-node-hypervisor-specific-deployments.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
