安装 VDA

Last published : Nov 13, 2026
重要提示:
  • 如果您正在升级,并且当前版本安装了 Personal vDisk 或 AppDisks 软件,请参阅删除 PvD、AppDisks 和不受支持的主机。
  • Citrix® 分发的二进制文件现已签名。签名二进制文件表示它们已通过 Citrix 生成的证书或真实的第三方证书进行验证。
Windows 计算机有两种类型的 VDA:适用于多会话操作系统的 VDA 和适用于单会话操作系统的 VDA。(有关适用于 Linux 计算机的 VDA 的信息,请参阅 Linux Virtual Delivery Agent 文档。)
在开始安装之前,请查看准备安装 并完成所有准备任务。
在安装 VDA 之前,请先安装核心组件。您也可以在安装 VDA 之前创建站点。
本文介绍了安装 VDA 时的安装向导序列。提供了命令行等效项。有关详细信息,请参阅使用命令行安装。

步骤 1. 下载产品软件并启动向导

如果您使用的是完整产品安装程序:
  1. 如果您尚未下载产品 ISO:
    • 使用您的 Citrix 帐户凭据访问 Citrix Virtual Apps and Desktops™ 下载页面。下载产品 ISO 文件。
    • 解压缩文件。或者,刻录 ISO 文件的 DVD。
  2. 在要安装 VDA 的映像或计算机上使用本地管理员帐户。将 DVD 插入驱动器或装载 ISO 文件。如果安装程序未自动启动,请双击装载驱动器上的 AutoSelect 应用程序。
    安装向导启动。

步骤 2. 选择要安装的产品

单击要安装的产品旁边的开始:Citrix Virtual Apps 或 Citrix Virtual Desktops。(如果计算机已安装 Citrix Virtual Apps 或 Citrix Virtual Desktops 组件,则此页面不会出现。)
命令行选项:/xenapp 以安装 Citrix Virtual Apps。如果省略此选项,则安装 Citrix Virtual Desktops。

步骤 3. 选择 VDA

选择虚拟投递代理条目。安装程序知道它是在单会话还是多会话操作系统上运行,因此它只提供适当的 VDA 类型。
例如,当您在 Windows Server 2019 计算机上运行安装程序时,多会话操作系统 VDA 选项可用。不提供单会话操作系统 VDA 选项。
如果您尝试在不受此 Citrix Virtual Apps and Desktops™ 版本支持的操作系统上安装(或升级到)Windows VDA,将显示一条消息,引导您了解有关选项的信息。
如果您使用的是独立软件包:
  1. 使用您的 Citrix 帐户凭据访问 Citrix Virtual Apps and Desktops™ 下载页面。下载相应的软件包:
    • VDAServerSetup_2603.exe:多会话操作系统 VDA 版本
    • VDAWorkstationSetup_2603.exe:单会话操作系统 VDA 版本
    • VDAWorkstationCoreSetup_2603.exe:单会话操作系统核心服务 VDA 版本
    • VDASingleSessionCoreSetup_2603.exe:新的单会话操作系统核心服务 VDA 版本
  2. 右键单击软件包并选择 以管理员身份运行。
    安装向导启动。

步骤 4. 指定 VDA 的使用方式

在“环境”页面上,指定您计划如何使用 VDA,指示您是否将此计算机用作预配更多计算机的映像。
您选择的选项会影响自动安装哪些 Citrix Provisioning™ 工具(如果有),以及 VDA 安装程序的“附加组件”页面上的默认值。
安装 VDA 时,会自动安装多个 MSI(预配和其他)。防止其安装的唯一方法是在命令行安装中使用 /exclude 选项。
请选择以下选项之一:
  • 创建主 MCS 映像: 如果您计划使用 Machine Creation Services™ 预配 VM,请选择此选项以在 VM 映像上安装 VDA。此选项将安装 Machine Identity Service。这是默认选项。
    命令行选项:/mastermcsimage 或 /masterimage
重要提示:
安装介质或 ISO 映像必须在本地装载。不支持从网络驱动器装载 ISO 映像以安装软件。
  • 使用 Citrix Provisioning 或第三方预配工具创建主映像: 如果您计划使用 Citrix Provisioning 或第三方预配工具(例如 Microsoft System Center Configuration Manager)预配 VM,请选择此选项以在 VM 映像上安装 VDA。
    命令行选项:/masterpvsimage
  • (仅在多会话操作系统计算机上显示)启用与服务器的代理连接: 选择此选项可在物理或虚拟机上安装 VDA,该虚拟机将不作为映像用于预配其他计算机。
    命令行选项:/remotepc
  • (仅在单会话操作系统计算机上显示)启用远程电脑访问: 选择此选项可在物理计算机上安装 VDA,以用于远程电脑访问。
    命令行选项:/remotepc
单击下一步。
此页面不显示:
  • 如果您正在升级 VDA
  • 如果您使用的是 VDAWorkstationCoreSetup_xxxx.exe、VDASingleSessionCoreSetup_xxxx.exe、VDAServerSetup_xxxx.exe 或 VDAWorkstationSetup_xxxx.exe 安装程序

步骤 5. 选择要安装的组件和安装位置

注意:
从版本 2603 开始,以前在“可选软件”页面上列出的组件已移至“组件”页面。
在组件页面上:
  • 位置: 默认情况下,VDA 安装在 C:\Program Files\Citrix 中。此默认设置适用于大多数部署。如果您指定不同的位置,则该位置必须具有网络服务的 execute 权限。
  • 组件: 默认情况下,会话录制代理和 Citrix Virtual Desktop Assistant 与 VDA 一起安装。如果您使用的是 VDAWorkstationCoreSetup.exe 安装程序或 VDASingleSessionCoreSetup.exe 安装程序,则只会安装 VDA,并且不会显示其他组件。
单击下一步。
命令行选项:/installdir "C:\Program Files\VDA" /components "VDA","CSA","PLUGINS" 用于将 Virtual Delivery Agent、Citrix Workspace Environment Management™ 代理、Citrix deviceTRUST、Citrix uberAgent、Citrix Secure Access Client 和 Citrix Workspace 应用程序安装到指定目录中。
注意:
在以下情况下,您可以在 VDA 安装、升级或卸载期间选择安装、升级或卸载 Citrix Workspace 应用程序和其他组件:
  • 在 VDA 安装和升级到 2603 期间,您可以选择包含或排除组件和 CWA 插件。
    • 默认情况下,Citrix Workspace 应用程序 (CWA)、Citrix Secure Access Client (CSA)、**Citrix 用户个性化层 (UPL)(仅适用于 WS VDA)**和 **Citrix Elastic App Layering (CEAL)(仅适用于 TS VDA)**未选择安装,如果需要,您可以在安装期间选择它们。 会话录制代理 (SRAGENT) 和 **Citrix Virtual Desktop Assistant (ASSISTANTAPP)(现在在 TS VDA 和 WS VDA 上均可用)**默认选择安装,如果需要,您可以在安装期间取消选择它们。
    • Citrix Device Trust、Citrix uberAgent 和 Citrix Workspace Environment Management™ 代理现已与 VDA 集成并始终安装。为防止其安装,管理员必须使用受支持的 /exclude 命令行选项。uberAgent 也默认安装,从 VDA 2511 开始,以及在 2603 中,它无法通过 GUI 或命令行 (CLI) 从安装中排除。
    • 默认情况下,Citrix Workspace Environment Management™ 代理在基本部署中运行,这是一种功能有限的单机模式,不连接到 WEM 基础结构。要通过将代理连接到 Citrix Cloud 中的 WEM 服务或本地部署来启用完整的 WEM 功能,请通过组策略配置设置。有关详细信息,请参阅这篇 WEM 文章。
    • Citrix 用户个性化层: 安装用户个性化层的 MSI。有关详细信息,请参阅用户个性化层。
    • 命令行更改
      /components VDA,CSA:此命令将安装 VDA 和 CSA(已选择),以及 Citrix Device Trust、Citrix uberAgent 和 Citrix Workspace Environment Management agent(默认集成)。
      /components VDA:此命令将安装 VDA,以及 Citrix Device Trust、Citrix uberAgent 和 Citrix Workspace Environment Management agent,因为这些组件现已集成到 VDA 本身中。如果您将 Citrix Device Trust、Citrix uberAgent 和 Citrix Workspace Environment Management agent 指定为与 /components 选项一起使用的参数,则 VDA 元安装程序会记录一条通知,指示从 /components 选项中删除了这些参数。随后,VDA 元安装程序将继续安装或升级 VDA。
      /components:此命令是无效命令,它必须始终包含 VDA。可以根据需要添加其他组件进行安装。
      将 /exclude 命令用于默认集成组件:/exclude 选项始终优先。它可用于阻止安装默认集成组件。示例:/exclude "Citrix Device Trust","Citrix Universal Print Client"。此命令将安装包含 Citrix Workspace Environment Management agent 的 VDA,但不安装 Citrix Device Trust 和 Citrix Universal Print Client。
  • 在 VDA 升级期间,如果 VDA 中尚未安装 Citrix Workspace app、Citrix Secure Access Client 和 Citrix 用户个性化层(仅适用于 WS VDA)、Session Recording Agent、Citrix Virtual Desktop Assistant 和 Elastic App Layering(仅适用于 TS VDA),则可以选择安装它们。
  • 在 VDA 升级期间,如果已安装用户个性化层或 Elastic App Layering,则会将其选为“必需”,并升级该组件。
  • 在 VDA 升级期间,如果 Citrix Workspace app 和其他已安装插件的版本可以升级,则会显示升级它们的选项。
  • 在 VDA 卸载期间,您可以选择是否卸载 Citrix Workspace app (CWA) 和任何其他已安装的组件。默认情况下,除 CWA 之外的所有组件都会自动卸载。CWA 的处理方式不同,除非明确选择,否则不会将其删除。

步骤 6. 安装附加组件

VDA 安装程序中的附加组件页面
“其他组件”页面包含用于启用或禁用随 VDA 安装其他功能和技术的复选框。在命令行安装中,您可以使用 /exclude 或 /includeadditional 选项明确省略或包含一个或多个可用组件:
  • /includeadditional "组件"\[,"组件"\] ...
  • /排除 "组件"\[,"组件"\] ...
下表指示此页面上项目的默认设置。默认设置取决于您在环境页面上选择的选项。
附加组件页面 环境页面:“带有 MCS 的主映像”或“带有 Citrix Provisioning 的主映像”已选择 环境页面:“启用与服务器的代理连接”(适用于多会话操作系统)或“远程电脑访问”(适用于单会话操作系统)已选择
应用程序包交付组件 未选择 未选择
Citrix VDA 升级代理 未选择 未选择
Citrix 备份和还原 未选择 未选择
Citrix MCS I/O 驱动程序 未选择 未选择
Citrix 会合 V2 未选择 未选择
如果出现以下情况,此页面将不显示:
  • 您正在使用 VDAWorkstationCoreSetup.exe 安装程序或 VDASingleSessionCoreSetup.exe。此外,附加组件的命令行选项不适用于该安装程序。
  • 您正在升级 VDA 并且所有附加组件均已安装。如果某些附加组件已安装,则此页面仅列出未安装的组件。
选中或清除以下复选框。(这些组件在安装程序中可能以不同的顺序显示。)
  • **应用程序包交付组件:**如果您使用 Microsoft App-V 包中的应用程序,请安装此组件。有关详细信息,请参阅部署和交付 App-V 应用程序。
    命令行选项:/includeadditional "App Packages Delivery Component" 启用组件安装,/exclude "App Packages Delivery Component" 阻止组件安装。
  • Citrix 配置文件管理: 此组件管理用户配置文件中的用户个性化设置。有关详细信息,请参阅配置文件管理。
    在安装中排除 Citrix Profile Management 会影响使用 Citrix Director 对 VDA 进行监视和故障排除。在“用户详细信息”和“端点”页面上,“个性化”面板和“登录持续时间”面板将失败。在“控制板”和“趋势”页面上,“平均登录持续时间”面板仅显示已安装 Profile Management 的计算机的数据。
    即使您正在使用第三方用户配置文件管理解决方案,Citrix 仍建议您安装并运行 Citrix Profile Management Service。不需要启用 Citrix Profile Management Service。
    命令行选项:/includeadditional "Citrix Profile Management" 启用组件安装,/exclude "Citrix Profile Management" 阻止组件安装。
  • Citrix Profile Management WMI 插件: 此插件在 WMI(Windows Management Instrumentation)对象中提供 Profile Management 运行时信息(例如,配置文件提供程序、配置文件类型、大小和磁盘使用情况)。WMI 对象向 Director 提供会话信息。
    命令行选项:/includeadditional "Citrix Profile Management WMI Plug-in" 启用组件安装,/exclude "Citrix Profile Management WMI Plug-in" 阻止组件安装。
注意:
从 2507 LTSR 开始,Citrix Profile Management 和 Citrix Profile Management WMI 插件现在是 VDA 的一部分,并针对主映像/MCS/PVS 用例自动安装。对于远程 PC 用例,这些组件默认不安装。在所有情况下,已安装的组件都会自动升级。命令行行为与以前的版本保持不变。
  • VDA 升级代理: 仅适用于 Citrix DaaS(以前称为 Citrix Virtual Apps and Desktops 服务)部署。使 VDA 能够参与VDA 升级功能。您可以使用该功能从管理控制台立即或在计划时间升级目录的 VDA。如果未安装此代理,您可以通过在计算机上运行 VDA 安装程序来升级 VDA。
    命令行选项:/includeadditional "Citrix VDA Upgrade Agent" 启用组件安装,/exclude "Citrix VDA Upgrade Agent" 阻止组件安装。
  • 用于存储优化的 MCSIO 写入缓存: 安装 Citrix MCS I/O 驱动程序。有关详细信息,请参阅管理程序共享的存储 和配置临时数据缓存。
    命令行选项:/includeadditional "Citrix MCS IODriver" 启用组件安装,/exclude "Citrix MCS IODriver" 阻止组件安装。
  • 代理配置: 如果您计划在您的环境中使用 Rendezvous 协议与 Gateway Service、VDA Upgrade Service 等,并且您的网络中存在用于出站连接的非透明代理,请在此处指定代理。仅支持 HTTP 代理。
    如果安装此组件,请在“Rendezvous 代理配置”页面上指定代理地址或 PAC 文件路径。有关功能详细信息,请参阅Rendezvous 协议。
    命令行选项:/includeadditional "Citrix Rendezvous V2" 启用组件安装,/exclude "Citrix Rendezvous V2" 阻止组件安装。
  • Citrix 备份和还原: 如果 VDA 安装或升级失败,此组件可以将计算机恢复到安装或升级之前完成的备份。
    确保满足 准备安装 中提到的 Microsoft 先决条件。
    命令行选项:/includeadditional "Citrix Backup and Restore" 启用组件安装,/exclude "Citrix Backup and Restore" 阻止组件安装。
    注意:
    从版本 2603 开始,Citrix 备份和还原组件仅适用于工作站 VDA。如果启用了 MCS 存储优化,则桌面操作系统的备份或还原可能会失败。要解决此问题,请在元安装程序中禁用 MCS 存储优化选项。

步骤 7. Delivery Controller™ 地址

VDA 安装程序中的 Delivery Controller 页面
在“Delivery Controller”页面上,选择输入已安装 Controller 地址的方式。Citrix 建议您在安装 VDA 时指定地址(手动执行)。VDA 必须拥有此信息才能向 Controller 注册。如果 VDA 无法注册,用户将无法访问该 VDA 上的应用程序和桌面。
  • 手动执行:(默认)输入已安装 Controller 的 FQDN,然后单击“添加”。如果您安装了更多 Controller,请添加其地址。
  • 稍后执行(高级): 如果选择此选项,向导会要求您在继续之前确认是否要执行此操作。要稍后指定地址,您可以重新运行安装程序或使用 Citrix 组策略。向导还会在“摘要”页面上提醒您。
  • 从 Active Directory 中选择位置: 仅当计算机已加入域且用户是域用户时有效。
  • 使用 WebSocket 令牌: 创建 WebSocket VDA。WebSocketToken 用于所需的令牌。
  • 让 Machine Creation Services 自动执行: 仅在使用 MCS 预配计算机时有效。
单击“下一步”。如果选择了“稍后执行(高级)”,系统会提示您确认稍后指定 Controller 地址。
其他注意事项:
  • 地址不能包含非字母数字字符。
  • 如果您在 VDA 安装期间和组策略中指定地址,则策略设置将覆盖安装期间提供的设置。
  • 成功的 VDA 注册要求用于与 Controller 通信的防火墙端口处于打开状态。此操作在向导的“防火墙”页面上默认启用。
  • 指定 Controller 位置(在 VDA 安装期间或之后)后,您可以使用自动更新功能在添加或删除 Controller 时更新 VDA。有关 VDA 如何发现 Controller 并向其注册的详细信息,请参阅VDA 注册。
命令行选项:/controllers

步骤 8. 代理配置

VDA 安装程序中的 Rendezvous 代理配置页面
“代理配置”页面仅在您在“附加组件”页面上启用了“代理配置”复选框时才会显示。
  1. 选择您将通过代理地址还是 PAC 文件路径指定代理源。
  2. 指定代理地址或 PAC 文件路径。
    • 代理地址格式:http://<url-or-ip>:<port>
    • PAC 文件格式:http://<url-or-ip>:<port>/<path>/<filename>.pac
代理端口的防火墙必须打开,连接测试才能成功。如果无法连接到代理,您可以选择是否继续 VDA 安装。
命令行选项:/proxyconfig

步骤 9. 启用或禁用功能

VDA 安装程序中的功能页面
在“功能”页面上,使用复选框启用或禁用您要使用的功能。
  • 使用 Windows 远程协助: 启用此功能后,Windows 远程协助将与 Director 的用户影子功能一起使用。Windows 远程协助会在防火墙中打开动态端口。(默认 = 禁用)
    命令行选项:/enable_remote_assistance
  • 使用实时音频传输进行音频传输: 如果您的网络中广泛使用 IP 语音,请启用此功能。此功能可降低延迟并提高音频在有损网络上的弹性。它允许使用 RTP over UDP 传输音频数据。(默认 = 禁用)
    命令行选项:/enable_real_time_transport
  • 使用屏幕共享: 启用后,屏幕共享使用的端口将在 Windows 防火墙中打开。(默认 = 禁用)
    命令行选项:/enable_ss_ports
  • 此 VDA 是否安装在云中的 VM 上: 此设置有助于 Citrix 正确识别本地和服务 (Citrix Cloud™) VDA 部署的资源位置,以用于遥测目的。此功能对客户侧利用率没有影响。如果您的部署使用 Citrix DaaS,请启用此设置(默认 = 禁用)。
    命令行选项:/xendesktopcloud
  • 安全默认设置: 此选项将各种功能的默认设置从启用更改为禁用,以实现更安全的开箱即用配置。相关功能包括:客户端驱动器重定向、特殊文件夹重定向、拖放、客户端 TWAIN 设备重定向、客户端 USB 即插即用设备重定向、客户端打印机重定向、客户端剪贴板重定向和客户端麦克风重定向。
命令行选项:/ENABLE_SECURE_DEFAULTS
单击下一步。

步骤 10. 防火墙端口

在防火墙页面上,默认情况下,如果 Windows 防火墙服务正在运行,即使未启用防火墙,端口也会自动打开。此默认设置适用于大多数部署。有关端口信息,请参阅网络端口。
单击下一步。
命令行选项:/enable_hdx_ports

步骤 11. 查看必备条件并确认安装

摘要页面列出了将要安装的内容。使用返回按钮可返回到之前的向导页面并更改选择。
准备就绪后,单击安装。
如果先决条件尚未安装或启用,计算机可能会重启一次或多次。请参阅准备安装。
注意:
此时,您还可以单击“摘要”页面上的“生成自定义脚本”按钮,根据您当前的安装选择创建命令行脚本。此脚本可以重复用于以无人参与模式安装或升级 VDA。

步骤 12. 诊断

VDA 安装程序中的诊断页面
在诊断页面上,选择是否参与 Citrix Call Home。如果您选择参与(默认),请单击连接。出现提示时,输入您的 Citrix 帐户凭据。
凭据验证后(或者如果您选择不参与),单击下一步。
使用完整产品安装程序时,如果您在诊断页面上单击连接而未首先选择收集诊断信息,则在关闭连接到 Citrix Insight Services 对话框后,下一步按钮将禁用。您无法移动到下一页。要重新启用下一步按钮,请选择并立即取消选择收集诊断信息。
有关详细信息,请参阅Call Home。

步骤 13. 完成此安装

VDA 安装程序中的完成安装页面
完成页面包含所有已成功安装和初始化的先决条件和组件的绿色复选标记。
单击完成。默认情况下,计算机将自动重启。尽管您可以禁用此自动重启,但在计算机重启之前无法使用 VDA。

后续步骤

根据需要,重复上述过程在其他计算机或映像上安装 VDA。
安装所有 VDA 后,启动 Studio。如果您尚未创建站点,Studio 会自动引导您完成该任务。完成该任务后,Studio 会引导您创建计算机目录,然后创建交付组。请参阅:

Citrix 优化器

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”。然后右键单击并选择“更改”。
  2. 选择自定义 Virtual Delivery Agent 设置。安装程序启动后,您可以更改:
    • Controller 地址
    • 用于向 Controller 注册的 TCP/IP 端口(默认值 = 80)
    • 是否自动打开 Windows 防火墙端口

故障排除

  • 有关 Citrix 如何报告组件安装结果的信息,请参阅Citrix 安装返回代码。
  • 在交付组的 Studio 显示中,详细信息窗格中的已安装 VDA 版本条目可能不是计算机上安装的版本。计算机的 Windows 程序和功能显示屏会显示实际的 VDA 版本。
  • VDA 安装后,必须先向 Delivery Controller 注册,然后才能向用户交付应用程序或桌面。
    要了解 VDA 注册方法以及如何排查注册问题,请参阅VDA 注册。

已知限制

当您使用 Citrix Workspace app for Windows 1912 或更早版本时,会话会在一段时间后断开。此问题已在较新的 LTSR 和 CR 版本的 Citrix Workspace 应用程序中修复。 有关支持的版本信息,请参阅适用于 Windows 的 Citrix Workspace 应用程序/适用于 Windows 的 Citrix Receiver 长期服务版本。