> 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-ban-fu-wu/zoom-node/zoom-node-deployment-field-guide/zoom-node-hypervisor-specific-deployments.md).

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

在虚拟化环境中部署 Zoom Node 时，您必须使安装和配置步骤与所使用的特定 hypervisor 平台保持一致。每种 hypervisor（例如 VMware vSphere、Microsoft Hyper-V 或其他）都可能会带来与资源分配、存储访问和网络接口配置相关的独特要求。

本节为受支持的 hypervisor 提供详细指导，确保 Zoom Node 在您的虚拟基础设施中可靠且高效地运行。

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

以下部分介绍 VMWare vSphere 安装方法，该方法需要下载并部署 Zoom Node 的 OVA（Open Virtual Appliance）文件版本。

#### 下载 OVA 映像

要下载映像文件：

1. 登录 Zoom 管理员 web 门户。
2. 通过浏览到以下位置下载 Zoom Node OVA 映像文件 **Node Management > Modules > Node > 添加 Node**.\\

   <figure><img src="/files/b7abe76c035cba1eea65cfb800a137f8e8c77202" alt=""><figcaption></figcaption></figure>
3. 点击 **下载** 按钮。

#### 部署 OVA 映像

要部署映像文件：

1. 登录 VMware Web 界面。
2. 点击 **创建/注册虚拟机**.
3. 在 Sect creation type 菜单下，单击 **从 OVF 或 OVA 文件部署虚拟机**.\\

   <figure><img src="/files/d6155574d66a1826a175ae0a6f129277e84d9814" alt=""><figcaption></figcaption></figure>
4. 点击 **下一步**.
5. 为 Zoom Node VM 输入一个名称。
6. 单击蓝色对话框以打开文件浏览器，并选择您下载的 Zoom Node OVA 映像文件。
   1. （可选）将映像文件拖放到框中。

<figure><img src="/files/2a729e044bcd1d08f5739cf33db32923bbf8345a" alt=""><figcaption></figcaption></figure>

7. 点击 **下一步**.
8. 选择您将存储 Zoom Node 的存储卷，然后单击 **下一步**.
9. 选择服务器将驻留的网络。
   1. （可选）如有需要，您可以对 VM 进行精简置备。

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

<figure><img src="/files/a097fd1cb8503c99c5a4e4cfde341e1d93f3304e" alt=""><figcaption></figcaption></figure>

10. 点击 **下一步**.
11. 检查您的所选内容，然后单击 **完成** 以部署 VM。

完成 VM 部署可能需要几分钟。

启动后，VM 将具有与下图所示相似的设置和详细信息：

<figure><img src="/files/e0614db0d434efaf43bc1b84f52350e601de6051" alt=""><figcaption></figcaption></figure>

VM 部署已完成。

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

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

#### 下载 Zoom Node VHDX 存档

Zoom 存档包括 Zoom Node VHDX 磁盘映像和 VM 的配置元数据。

要下载该存档：

1. 登录 Zoom 管理员 web 门户。
2. 下载 **Zoom Node VHDX** 映像，通过浏览到 Zoom 管理员门户 **Node Management > Modules > Node > 添加 Node**.\\
3. 下载 Zoom Node VHDX 文件。
4. 将文件解压到本地文件夹中以供临时使用。

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

要在 Hyper-V 环境中使用 QCOW2 (KVM) 磁盘映像，您可以使用 `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 VM 中。这支持自定义实验室环境、CI/CD 测试或具有一致系统配置的本地化开发。

#### 部署 Zoom Node Hyper-V VM

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

有两种方法可用于部署虚拟机。简单方法“选项 1”使用 PowerShell 命令，利用具有正确属性的 VMDK 创建新的 Zoom Node VM。选项 2 使用 Hyper-V Manager GUI 来部署 VM。

请参阅 [Zoom Node 基础设施先决条件](/technical-library/zh/gao-ji-qi-ye-ban-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    = 加入-Path $RootPath $VMName
$TargetVhdx  = 加入-Path $VMFolder "$VMName.vhdx"

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

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

# --- 创建第 2 代 VM（尚无磁盘）---
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 + 从磁盘启动 ---
# 为 Linux（Ubuntu）启用安全启动，使用 Microsoft UEFI CA
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 '访客 服务 接口' -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 虚拟机的指定存储位置，并手动配置 VM 设置。

**将 VMDK 复制到 Hyper-V VM 存储**

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

   <figure><img src="/files/8c3353a660822568933b62f9dcc3a107c6fe34b7" alt=""><figcaption></figcaption></figure>
2. 为你正在部署的 Zoom Node 创建一个唯一的文件夹，并在该目录中创建一个名为 **虚拟硬盘**.

   <figure><img src="/files/8f539194b6e3b60fb06df44c3a5ce07cdde679f1" alt=""><figcaption></figcaption></figure>
3. 将你从 Zoom 下载的 VHDX 映像文件复制到 Virtual Hard Disks 目录中。
4. 登录到 Microsoft Hyper-V Manager 控制台来管理这些 VMs。

**定义 VM**

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

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

<figure><img src="/files/706c1f76688587479f3929c8516f7d77c3b89ae3" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/9c671028ec5042d8c995ecfe45f4275d7693efd6" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/840e7cba3d1249e4cae91af43922b9fc3b69ef82" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/18fe7b92f766109a41b86aa2de6eededb4661bc9" alt=""><figcaption></figcaption></figure>

8. 完成 **配置网络** 步骤：
   1. 点击 **连接：** 展开下拉列表并选择一个虚拟交换机，将 VM 连接到您的网络。这将取决于您的 Hyper-V 网络环境。

<figure><img src="/files/516aa277ab048b2d7efd5c3f90bdab7b296191da" alt=""><figcaption></figcaption></figure>

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

**连接 VHDX 磁盘映像**

下一步，在新建虚拟机向导中，您将完成 **连接虚拟硬盘** 步骤。要连接映像：

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

<figure><img src="/files/88bc3bd8287b0dd840ec513fa734e7d893bc0ac0" alt=""><figcaption></figcaption></figure>

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

   <figure><img src="/files/cee87980675c9de9aea8dd72a0c098ebb1938c73" alt=""><figcaption></figcaption></figure>
3. 在文件选择窗口中，单击 **打开**.
4. 点击 **下一步**.
5. 检查您的设置并单击 **完成** 以使用已附加的 VHDX 磁盘创建 VM。\\

   <figure><img src="/files/0bb6698b455aa0246f25a3c54727c205ebc65faf" alt=""><figcaption></figcaption></figure>

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

**配置其他 VM 设置**

要配置其他设置：

1. 右键单击已部署的 VM 并选择 **设置...**.\\

   <figure><img src="/files/29e813e149aa78355114a6f963315571113801b6" alt=""><figcaption></figcaption></figure>
2. 在 **硬件** 在屏幕左侧的类别中，单击 **安全**.
3. 在屏幕右侧并在……下方 **安全** 标题下，点击 **模板：** 下拉列表。
4. 选择 **Microsoft UEFI 证书颁发机构** 选项。\\

   <figure><img src="/files/b64042b77142b83d7c478a65dcfd051f9bf53c4b" alt=""><figcaption></figcaption></figure>
5. 点击 **应用**.
6. 在 **硬件** 在屏幕左侧的类别中，单击 **处理器**.
7. 在屏幕右侧并在……下方 **处理器** 标题下，将 **虚拟处理器数量：** 框设置为 `8` （虚拟处理器）。\\

   <figure><img src="/files/809feb210247bb11c52a3ff7d40c6c4e0122d7f2" alt=""><figcaption></figcaption></figure>

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

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

**启动虚拟机**

要启动 VM：

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

   <figure><img src="/files/76452b3e7124df39e0b4501702d813ba8cd1c24b" alt=""><figcaption></figcaption></figure>

正常工作的 VM 启动顺序将显示 Linux 启动屏幕。下一步，Zoom Node 文本界面将加载。

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

<img src="/files/805fd9fdc07fc789a788f6ed856b48b0f8bb9c9b" alt="unknown" data-size="original">
{% endhint %}

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

以下部分介绍基于内核的虚拟机（KVM）安装方法，该方法允许通过 Proxmox VE 或 KVM 虚拟机管理器（Virt-manager）进行 Zoom Node 安装。

#### KVM Proxmox 虚拟环境（VE）

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

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

**定义 Zoom Node 虚拟机**

要定义该虚拟机：

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

{% hint style="info" %}
Machine 和 BIOS 设置必须按所述方式进行设置，否则虚拟机将无法成功启动。
{% endhint %}

8. 点击 **下一步**.
9. 在 **磁盘** 页面上，选择虚拟机将从中运行的存储卷。
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 > Modules > Nodes > 添加节点**.
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 主网页界面，并选择刚刚部署的虚拟机。
10. 右键单击所选虚拟机，并选择 **克隆** 它。
11. 通过为克隆命名并单击以下内容，将该克隆转换为模板 **克隆**.
12. 克隆完成后，右键单击该克隆并选择 **转换为模板**.
    1. 你现在拥有一个可部署的模板。
13. 选择原始虚拟机并单击以打开 **控制台**.
14. 通过单击以下内容启动虚拟机 **立即启动** 按钮。

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

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

虚拟机管理器（也称为 virt-manager）是一个流行的基于应用程序的 QEMU/KVM 虚拟机管理器。

此部署示例使用 Ubuntu 22.04 LTS 上的 Virtual Machine Manager。不过，它可以运行在许多 Linux 发行版上。

QEMU/KVM 的默认部署会使用 hypervisor NAT 和私有 IP 地址池来部署由 KVM 管理的虚拟机。这是 **不** Zoom Node 支持的架构。

{% hint style="info" %}
尽管可以在 hypervisor NAT 后部署和运行 Zoom Node，但网络上的客户端将无法正常通信。为确保客户端正常通信，请将 Zoom Node 部署在与客户端 IP 地址范围一致的桥接接口上。
{% endhint %}

要使用 virt-manager 方法安装：

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

{% hint style="info" %}
你可以调整这些值，但调整可能会影响 Zoom Node 的容量和性能。如果你只在 Zoom Node 上运行单个模块，则可以将 RAM 设置调整为 6GB、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. 点击 **开始安装** 以部署虚拟机。

虚拟机将启动并开始引导。原始虚拟机启动后，我们就知道我们创建的模板已正式可用。

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

Zoom Node 可以在 Nutanix AHV 上作为虚拟机（VM）运行。Zoom Node 部署到数据中心以运行 Zoom 混合服务，也称为服务模块，例如会议混合、录制混合、聊天混合和电话本地生存能力。

本节介绍将 Zoom Node 操作系统虚拟机安装到 Nutanix AHV 6.8.1 至 7.0.1 版本。

#### 通用虚拟机监控程序和虚拟机要求

此 [Zoom Node 基础设施先决条件](/technical-library/zh/gao-ji-qi-ye-ban-fu-wu/zoom-node/zoom-node-deployment-field-guide/zoom-node-infrastructure-prerequisites.md)页面提供部署所需的硬件和软件先决条件。

#### Zoom Node 部署

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

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

要下载映像文件：

1. 登录到 [Zoom 管理员网页门户](https://zoom.us/).
2. 下载 **Zoom Node QCOW2** 镜像，从 Zoom 管理员门户中选择 **Node Management > Modules > Node > 添加 Node**.\\

   <figure><img src="/files/94ea178b6da9f826eca2dabd106e6c8ba3ce6200" 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="/files/2afd3521f20c52907e7ff77710abd937b7673f1d" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="/files/f63259b6a15e6a0ab9b5a5bfff5387f6ce789124" alt=""><figcaption></figcaption></figure>

4. 在屏幕左侧，单击 **镜像配置**。磁盘镜像上传对话框会出现。

<figure><img src="/files/8df007af2fcd7c3de3ebdb4d7f6c9a7e9502750a" alt="" width="563"><figcaption></figcaption></figure>

5. 单击“+ 上传镜像”按钮。

<figure><img src="/files/9206fa8e35e1201808e12c7f99fe95f98dd34282" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="/files/9217a745696849ff369076ec82e602cedd991c33" alt=""><figcaption></figcaption></figure>

上传进度将显示在蓝色功能区中。

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

上传完成后，镜像更新过程将运行。点击功能区菜单中闪烁的作业状态图标以查看进度。

<figure><img src="/files/3158e7b0b18dcd7ef73262d54a806e6454e50758" alt=""><figcaption></figcaption></figure>

导入过程可能需要几分钟才能完成。完成后，镜像会显示在列表中，处于一个 **有效** 状态：

<figure><img src="/files/84f910944013460194f8d3c646b7e05d48bf1399" alt=""><figcaption></figcaption></figure>

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

**创建 Zoom Node 虚拟机**

接下来，你将创建虚拟机。要创建 VM：

1. 点击 **设置** 下拉并选择 **VM**.

   <figure><img src="/files/3f6ef1071bce76aed2eb188665c51e37e5dda326" alt="" width="375"><figcaption></figcaption></figure>
2. 从 VM 屏幕中，点击 **+ 创建 VM** 在屏幕右侧。

   <figure><img src="/files/52e5458c4c8ef1e38e20bdb3944e992254d65f36" alt=""><figcaption></figcaption></figure>
3. 输入一个 **名称**, **描述** （可选），然后选择合适的 **时区**.
4. 在 **计算详情**，输入你的计算规格。\\

   <figure><img src="/files/df758bcedcb1fb3e6b7e196e1deb2fbe7a317a7a" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="warning" %}
如上所示，Zoom Node 在生产部署中需要 8 个 vCPU 核心。设置 vCPU 设置时，Zoom 建议与物理服务器的插槽数量保持一致。以下设置说明满足标准部署要求：

* 设置 **vCPU（数量）** 字段，使其与运行 Nutanix AHV 的服务器中的插槽数量匹配。对于典型的双插槽服务器，你会将该值设置为 **2**.
* 设置 **每个 vCPU 的核心数** 到 **4**，相当于 **8 vCPU**.
* 设置 **内存** （RAM）为 **16** GB。
* 在 **启动配置**，选择 **UEFI**.
  {% endhint %}

{% hint style="danger" %}
除非选择 UEFI，否则 Zoom Node 将无法启动。
{% endhint %}

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

   <figure><img src="/files/a916619b3b4e41490bb9c49fd0d37058afeb2a9f" alt="" width="525"><figcaption></figcaption></figure>
6. 向下滚动到 **磁盘** 部分。\\

   <figure><img src="/files/78a9243fa71adf33e778154cce63dfc3c29c5d28" alt="" width="563"><figcaption></figcaption></figure>
7. 点击 **+ 添加新磁盘** 以创建供 Zoom Node 运行的磁盘。\\

   <figure><img src="/files/ad74a1451a7986b2cafe5a487ee74ba727fa0b7c" alt="" width="375"><figcaption></figcaption></figure>
8. 在 **类型** 下拉菜单，选择 **磁盘**.
9. 在 **操作** 下拉菜单，选择 **从镜像服务克隆**.\\

   <figure><img src="/files/fde114eb2203b15b0a6f4e875bc9bc0bd2fabee7" alt="" width="563"><figcaption></figcaption></figure>
10. 在 **镜像** 下拉菜单，选择你之前导入 Zoom Node 磁盘时创建的镜像名称。
11. 点击 **添加**.
12. 向下滚动到 **网络适配器（NIC）** 部分。\\

    <figure><img src="/files/3973450cc08b3b13db8522af0095b7fc2ba0c44e" alt="" width="563"><figcaption></figcaption></figure>
13. 点击 + 添加新 NIC。\\

    <figure><img src="/files/71b8653362f18e53472332fdfbaa0a31e92e6bfb" alt="" width="563"><figcaption></figcaption></figure>
14. 在 **子网名称** 下拉，选择具有直接 IP 访问的选项。

{% hint style="info" %}
提醒一下，不支持 hypervisor NAT。
{% endhint %}

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

    <figure><img src="/files/544124195e99e2959c3b11dcea2d4ae1acf80f23" alt="" width="375"><figcaption></figcaption></figure>
17. 点击 **保存** 以创建该 VM。

**启动新的 Zoom Node VM。**

新的节点将出现在 VM 列表中。您可以选择表格视图，以便更轻松地查看 VM 列表。

<figure><img src="/files/ac4264088db731acb041f25e549bbdd14ab97e94" alt=""><figcaption></figcaption></figure>

右键单击您创建的新 VM，并选择 **开启电源**.

<figure><img src="/files/fa03a48dd733c2a84a43cd9a7f15e1f3cc65cd7b" alt=""><figcaption></figcaption></figure>

几秒钟后，VM 将开始启动。

再次右键单击 VM 并选择 **启动控制台** 与虚拟机交互。

{% 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 基础设施先决条件](/technical-library/zh/gao-ji-qi-ye-ban-fu-wu/zoom-node/zoom-node-deployment-field-guide/zoom-node-infrastructure-prerequisites.md)页面提供部署所需的硬件和软件先决条件。

#### 下载 OVA 镜像

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

<figure><img src="/files/842017f6fd789e1f66e9bc7f6126fbab84d70d75" alt=""><figcaption></figcaption></figure>

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

      <figure><img src="/files/bfdb1581ddf200ffcddf4bc682b7016d4083e667" 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="/files/b77591d74c4a2804124ba6f9667dbdc1e9a14950" 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" %}
此代码用于标识您对 `node3.4.vmdk` 映像的导入，目前该映像存储在一个 S3 存储桶中，版本为 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="/files/c110033aec8ac0f85d815d9e059bcdcbffc9f9be" 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="/files/b98e42a12cf4fbbc37487b36b409d8b953819e69" alt=""><figcaption></figcaption></figure>
    4. 请注意，任务当前状态为“downloading/converting”，表示任务仍在处理该文件。字段 `进度：<##>，` 显示完成百分比。上面的示例显示了 `19` 为完成 19%。
    5. 查看 `状态：` 用于验证任务完成的字段：\\

       <figure><img src="/files/1a5bac5babd05dac4cdadbca91e539b6b9ce0c7b" alt=""><figcaption></figcaption></figure>

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

1. 登录 AWS 控制台 EC2 仪表板。\\

   <figure><img src="/files/3b31ae2b5387ddc795035d54192ef6b26595e1c0" alt=""><figcaption></figcaption></figure>
2. 在屏幕左侧的 **Elastic Block Store** 下拉菜单，单击 **快照**.\\

   <figure><img src="/files/8cf1a166215622693dfaafe14bc9634346c0cc24" alt=""><figcaption></figcaption></figure>
3. 点击 **快照 ID 链接** 查看其详细信息。\\

   <figure><img src="/files/6d0503f7d249427080e4d6871d046adbaf28fb20" alt=""><figcaption></figcaption></figure>
4. 点击 **操作** 屏幕右上角的下拉按钮并选择 **从快照创建映像**.
5. 此 **映像设置** 窗口会出现。
6. 输入一个 **映像名称** 作为 AMI 的名称。
   1. 示例： **Zoom Node 3.4 AMI**.
7. （可选）输入描述。\\

   <figure><img src="/files/64bbbe52419cc9dc1ca13b70ade2ded019b82622" alt=""><figcaption></figcaption></figure>
8. 向下滚动窗口以查看其他设置。
9. 确认您在下方看到了分配的 189 GB 磁盘卷 **大小 (GiB)**.\\

   <figure><img src="/files/7b506a0955e168a6f042a84e7c44de807c5835c2" alt=""><figcaption></figcaption></figure>
10. 在 **启动模式** 下拉菜单，选择 **UEFI**.

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

1. 登录 AWS 控制台 EC2 仪表板。\\

   <figure><img src="/files/3b31ae2b5387ddc795035d54192ef6b26595e1c0" alt=""><figcaption></figcaption></figure>
2. 在屏幕左侧，在 **实例** 下拉菜单，单击 **实例**.
3. 使用 Zoom Node AMI 创建一个新实例。
4. 为该实例输入一个名称。

<figure><img src="/files/c5d70b26aea8d77499b5d987290fab06621c1e61" alt="" width="563"><figcaption></figcaption></figure>

5. 在 **应用程序和操作系统映像（Amazon Machine Image）** 部分，单击 **我的 AMI** 选项卡。
6. 搜索您刚刚创建并命名的 Zoom Node AMI。\\

   <figure><img src="/files/096cdc4cdf2fc197b963d983689d5d5a49334986" alt="" width="563"><figcaption></figcaption></figure>
7. 单击您创建的 AMI 以设置各种参数。
8. 在 **实例类型** 部分，单击 **实例类型** 下拉列表并选择 **t3.medium**.

<figure><img src="/files/e1873c37dc4e0664befbce164e562121bf9f3a21" alt=""><figcaption></figcaption></figure>

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

9. 在 **密钥对（登录）** 部分，单击 **密钥对名称** 下拉列表并选择 **在没有密钥对的情况下继续（不推荐）**.

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

   <figure><img src="/files/0161884323f08e4e6b41ff8a2163b2a74112107a" alt=""><figcaption></figcaption></figure>
10. 在网络设置下，配置以下选项：
    1. 在 **VPC - 必需**，选择一个允许您的 Zoom Workplace 应用直接进行 L3 路由访问的 VPC。
    2. 在 **子网**，选择该 VM 将运行所在的子网。\\

       <figure><img src="/files/6ea6647758b103da62ddde3dc43a7f2007e54492" 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="/files/4189e21133fa0a7516838d394963c9a1cf2a566b" alt="" width="563"><figcaption></figcaption></figure>

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

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

    <figure><img src="/files/6f2cb54d557248c524055b59822388629b4165d0" alt=""><figcaption></figcaption></figure>

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

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

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

当 Zoom Node 启动时，它将从 AWS EC2（IDMSv2 服务器）提取此预配置的信息，并按下图所示自动配置该 Node：

<figure><img src="/files/8750ab817046f49cfca1f4af22a0e301a65482a8" alt=""><figcaption></figcaption></figure>

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

```yaml
#自定义配置
主机名: zn-ec2
密码: ZoomNodepassword1234
注册代码: ABCD1234DEFG5678
网络:
  以太网:
    ens:
      地址:
        - 10.15.1.150/24
        - 10.15.1.151/24
        - 10.15.1.152/24
      网关: 10.15.1.1
      名称服务器:
        地址:
          - 1.1.1.1
```

将用户数据文件上传到 AWS EC2 后，单击以下项以部署实例 **启动实例**.

<figure><img src="/files/caec26b87ac2d477914913fe7bc07305ee01892f" alt=""><figcaption></figcaption></figure>

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

<div align="center"><figure><img src="/files/32540a122c8e44ae29a33d27366628e2819b849c" alt="" width="563"><figcaption></figcaption></figure></div>

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

<figure><img src="/files/d4a965909093bda66f287c0761ff24450c54714f" alt=""><figcaption></figcaption></figure>

Node 需要几分钟时间来启动并启动本地 Web GUI。

在实例启动后的前 10 分钟内，打开网络浏览器并输入 **私有 IPv4 地址** 列出的（`10.10.130.223` 在上图中）。

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

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

<figure><img src="/files/e4e3da263e1a0fccecb4dafe6af21992bd55dc63" alt="" width="563"><figcaption></figcaption></figure>

点击 **设置密码** 用于配置管理员密码的链接。

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

{% hint style="info" %}
“设置密码”链接仅在 VM 启动后的前 10 分钟内可见。如果它不可见，请重启 VM 以使该选项再次可用。
{% endhint %}

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