产品文档
Citrix DaaS™
查看 PDF

安装 VDA

May 4, 2026
投稿者: 
C C

简介

本文首先介绍了 Windows VDA 和可用的 VDA 安装程序。文章的其余部分描述了 VDA 安装向导中的步骤。提供了命令行等效项。有关详细信息，请参阅使用命令行安装 VDA。

有关 Linux VDA 的信息，请参阅Linux Virtual Delivery Agent。

  • 观看 VDA 简介。

VDA 简介视频

  • 安装注意事项

    • Citrix DaaS 文章介绍了 VDA 是什么以及它们的作用。以下是更多信息。

  • 分析数据收集： 安装或升级组件时会自动收集分析数据。默认情况下，安装完成后，这些数据会自动上传到 Citrix。此外，当您安装组件时，您会自动加入 Citrix 客户体验改善计划 (CEIP)，该计划会上传匿名数据。此外，在安装或升级期间，您还可以选择加入 Call Home。

    如果 VDA 安装失败，MSI 分析器会解析失败的 MSI 日志，显示确切的错误代码。如果这是一个已知问题，分析器会建议一篇 CTX 文章。分析器还会收集有关失败错误代码的匿名数据。此数据包含在 CEIP 收集的其他数据中。如果您退出 CEIP，则收集的 MSI 分析器数据将不再发送到 Citrix。

    • 有关这些计划的信息，请参阅 Citrix Insight Services。

    • Citrix Workspace™ app： 安装 VDA 时，默认情况下不安装适用于 Windows 的 Citrix Workspace app。您可以从 Citrix 网站下载并安装或升级适用于 Windows 的 Citrix Workspace app 和其他 Citrix Workspace app。或者，您可以从 Workspace 或 StoreFront™ 服务器提供这些 Citrix Workspace app。

    • 打印后台处理程序服务： 必须启用 Microsoft 打印后台处理程序服务。如果该服务被禁用，则无法成功安装 VDA。

    • Microsoft Media Foundation： 大多数受支持的 Windows 版本都已安装 Media Foundation。如果安装 VDA 的计算机没有 Microsoft Media Foundation（例如 N 版本），则不会安装某些多媒体功能，并且这些功能将无法工作。

    • Flash 重定向
    • Windows Media 重定向
    • HTML5 视频重定向

    • HDX™ RealTime 网络摄像头重定向

    • 您可以确认此限制，或者结束 VDA 安装并在安装 Media Foundation 后重新启动。在图形界面中，此选择会显示在消息中。在命令行中，您可以使用 /no_mediafoundation_ack 选项来确认此限制。

    • 本地用户组： 安装 VDA 时，会自动创建一个名为 Direct Access Users 的新本地用户组。对于单会话操作系统 VDA，此组仅适用于 RDP 连接。对于多会话操作系统 VDA，此组适用于 ICA® 和 RDP 连接。

    • Cloud Connector 地址要求： VDA 必须至少有一个有效的 Cloud Connector 地址（在同一资源位置）才能进行通信。否则，无法建立会话。您在安装 VDA 时指定 Cloud Connector 地址。有关指定 VDA 可以注册的 Cloud Connector 地址的其他方法的信息，请参阅 VDA 注册。

    • 操作系统注意事项：
    • 查看系统要求以了解支持的平台、操作系统和版本。
    • 确保每个操作系统都保持最新的更新。
    • 确保 VDA 具有同步的系统时钟。保护计算机之间通信的 Kerberos 基础结构需要同步。
    • 有关 Windows 10 计算机的优化指南，请参阅 CTX216252。
    • 如果您尝试在不受该 VDA 版本支持的操作系统上安装（或升级到）Windows VDA，则会显示一条消息，描述您的选项。有关详细信息，请参阅系统要求和早期操作系统。

  • 已安装的 MSI： 安装 VDA 时会自动安装多个 MSI。您可以在图形界面的附加组件页面上或使用 CLI 中的 /exclude 选项阻止安装某些 MSI。对于其他 MSI，阻止其安装的唯一方法是使用 /exclude CLI 选项。

  • 已加入域： 在安装 VDA 软件之前，请确保计算机已加入域。

  • VDA 安装期间的重新启动

    • VDA 安装结束时需要重新启动。默认情况下，此重新启动会自动发生。

为了最大程度地减少 VDA 安装期间所需的其他重新启动次数：

-  在开始 VDA 安装之前，请确保已安装受支持的 Microsoft .NET Framework 版本。
  • 对于 Windows 多会话操作系统计算机，请在安装 VDA 之前安装并启用 RDS 角色服务。

如果您在安装 VDA 之前未安装这些必备组件：

  • 如果您使用图形界面或不带 /noreboot 选项的命令行界面，则计算机将在安装必备组件后自动重新启动。
  • 如果您使用带 /noreboot 选项的命令行界面，则必须手动启动重新启动。

每次重新启动后，VDA 安装都会继续。如果您是从命令行安装，则可以使用 /noresume 选项阻止自动恢复。

将 VDA 升级到版本 7.17 或更高受支持的版本时，升级期间会发生重新启动。此重新启动无法避免。

安装或升级失败时恢复

注意：

此功能仅适用于单会话 VDA。

如果单会话 VDA 安装或升级失败，并且启用了“失败时恢复”功能，则计算机将恢复到安装或升级开始之前设置的还原点。

当启用此功能后开始单会话 VDA 安装或升级时，安装程序会在实际安装或升级开始之前创建一个系统还原点。如果 VDA 安装或升级失败，计算机将恢复到还原点状态。%temp%/Citrix 文件夹包含部署日志和有关恢复的其他信息。

默认情况下，此功能处于禁用状态。

如果您计划启用此功能，请确保未通过 GPO 设置（计算机配置 > 管理模板 > 系统 > 系统还原）禁用系统还原。

  • 要在安装或升级单会话 VDA 时启用此功能：

  • 使用 VDA 安装程序的图形界面（例如使用 Autostart 或不带任何恢复或静默选项的 XenDesktopVDASetup.exe 命令）时，请在摘要页面上选中如果更新失败，则启用自动恢复复选框。

  • 如果安装/升级成功完成，则不会使用还原点，但会保留该还原点。

  • 使用 /enablerestore 或 /enablerestorecleanup 选项运行 VDA 安装程序。

    • 如果您使用 /enablerestorecleanup 选项，并且安装/升级成功完成，则还原点会自动删除。

    • 如果您使用 /enablerestore 选项，并且安装/升级成功完成，则还原点不会被使用，但会保留。

VDA 安装程序

VDA 安装程序可直接从 Citrix Cloud™ 控制台下载。

默认情况下，自解压安装程序中的文件会提取到 Temp 文件夹。提取到 Temp 文件夹的文件在安装完成后会自动删除。或者，您可以使用 /extract 命令并指定绝对路径。

有三个独立的 VDA 安装程序可供下载。

VDAServerSetup.exe 安装多会话操作系统 VDA。

VDAWorkstationSetup.exe 安装单会话操作系统 VDA。

VDAWorkstationCoreSetup.exe 安装针对远程 PC 访问部署或核心 VDI 安装进行了优化的单会话操作系统 VDA。远程 PC 访问使用物理机。核心 VDI 安装是未用作映像的虚拟机。此安装程序仅部署 VDA 连接所需的核心服务。因此，它仅支持 VDAWorkstationSetup 安装程序有效选项的子集。

有关详细信息，请参阅安装 VDA 以了解您的相应版本。

故障排除

在交付组的 Studio 显示中，详细信息窗格上的“已安装的 VDA 版本”条目可能不是计算机上安装的版本。计算机的 Windows“程序和功能”显示会显示实际的 VDA 版本。

Citrix Optimizer

Citrix Optimizer 是一款适用于 Windows 操作系统的工具，可帮助 Citrix 管理员通过移除和优化各种组件来优化 VDA。

安装 VDA 并完成最终重新启动后，下载并安装 Citrix Optimizer。请参阅 CTX224676。该 CTX 文章包含下载包，以及有关安装和使用 Citrix Optimizer 的说明。

自定义 VDA

-  稍后，要自定义（更改信息）已安装的 VDA：

-  1.  在 Windows 的“删除或更改程序”功能中，选择 **Citrix Virtual Delivery Agent** 或 **Citrix Remote PC Access/VDI Core Services VDA**。然后右键单击并选择**更改**。

  1. 选择 Customize Virtual Delivery Agent Settings。

    • 安装程序启动后，更改任何可用设置。

自定义用于与 Cloud Connector 通信的端口

-  您可以根据特定的安全要求，自定义 VDA 用于与 Cloud Connector 通信的端口。如果您的安全团队不允许打开默认端口（端口 80）或者默认端口已被占用，此功能会很有用。

注意： > 更改默认端口号时，仅支持 1024–65535 范围内的值。

要自定义端口，请完成以下步骤：

  1. 在 Citrix Cloud Connector 上添加 VDA 端口号
  2. 使用 Rendezvous V1 时的其他 Citrix Cloud Connector™ 配置
  3. 在 VDA 上添加 VDA 端口号

在 Citrix Cloud Connector 上添加 VDA 端口号

转到 Citrix Cloud Connector 并运行以下两个 PowerShell 命令：

-  [[CODE_BLOCK_0]]
  • [[CODE_BLOCK_1]]

示例：

  • [[CODE_BLOCK_2]]
  • [[CODE_BLOCK_3]]

自定义端口时，请考虑以下事项：

  • 您必须在这两个命令中使用相同的端口号。
  • 您必须在所有 Cloud Connector 上运行这两个命令。
  • 为了成功与 Cloud Connector 通信，请确保所有 VDA 都使用相同的端口号。
  • 您配置的端口在连接器更新后仍然保留。

使用 Rendezvous V1 时的其他 Citrix Cloud Connector 配置

在每个 Citrix Cloud Connector 上设置以下注册表项：

HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\XaXdCloudProxyPersist

名称：WorkerPortNumber 类型：REG_DWORD 值：<port number>

在 VDA 上添加 VDA 端口号

使用默认设置安装 VDA 并按如下方式进行配置。如果 VDA 已安装，请继续执行以下步骤。

  1. 在 VDA 上，打开 XenDesktopVdaSetup.exe，该文件位于 C:\Program Files\Citrix\XenDesktopVdaSetup\XenDesktopVdaSetup.exe。

  2. 在协议和端口页面上，添加自定义端口号。

    协议和端口页面

  3. 在 Delivery Controller™ 页面上，输入 Controller 的 FQDN。

    Delivery Controller 页面

  4. 单击下一步以完成向导，从而完成配置。

端口号随后会成功重新配置。

注意：

测试 Controller 连接时，您可能会看到以下错误消息：在 < 您输入的 Controller 地址 > 上找不到正在运行的 Controller 实例。如果地址正确，您可以忽略该消息。

故障排除

要检查自定义端口是否已正确配置，请转到 Cloud Connector 并执行以下故障排除步骤：

  1. 验证以下两个注册表项是否存在。

    HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\XaXdCloudProxyPersist Name: CustomVDAPortNumber Type: REG_DWORD Data: 18000

    HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\XaXdCloudProxyPersist Name: CustomVDAPortNumberHA Type: REG_DWORD Data: 18000

  2. 运行以下命令以创建 .txt 文件。

    • netsh http show urlacl > <filepath>.txt

    示例：

    • netsh http show urlacl > c:\reservations.txt

  3. 打开 .txt 文件并检查以下四个 URL，以验证是否使用了正确的端口。

    • http://+:18000/Citrix/CdsController/IRegistrar/
    • http://+:18000/Citrix/CdsController/ITicketing/
    • http://+:18000/Citrix/CdsController/IDynamicDataSink/
    • http://+:18000/Citrix/CdsController/INotifyBroker/

  4. 验证是否已创建以下两个防火墙规则并且所需端口已打开。

    • Citrix XaXdProxy
    • Citrix Broker Service (TCP-In)

其他信息

  • 安装 VDA 后，您可以使用 Cloud Health check 检查站点的运行状况和可用性及其组件。

后续步骤

创建计算机目录。

要查看整个配置过程，请参阅 规划和构建部署。

安装 VDA
May 4, 2026
投稿者: 
C C
May 4, 2026
投稿者: 
C C

在本文中

站点反馈 | Your privacy choices footer link您的隐私选择 | 隐私和法律条款 | Cookie 首选项 | 同意设置 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.