Citrix Virtual Apps and Desktops

准备安装

March 18, 2026

投稿者:

Citrix Virtual Apps and Desktops™ 的部署从安装以下组件开始。此过程旨在为防火墙内的用户交付应用程序和桌面做好准备。

一个或多个 Delivery Controller
Citrix Director
Citrix StoreFront™
Citrix License Server
一个或多个 Citrix Virtual Delivery Agent (VDA)
可选组件和技术，例如 Universal Print Server、Federated Authentication Service 和 Self-Service Password Reset

对于防火墙外的用户，请安装并配置一个额外组件，例如 Citrix Gateway。有关介绍，请参阅将 Citrix Virtual Apps and Desktops 与 Citrix Gateway 集成。

注意：

请确保服务器操作系统和工作站操作系统满足以下 Microsoft 先决条件：

Microsoft 卷影复制和 Microsoft 软件卷影复制提供程序服务正在运行。有关详细信息，请参阅卷影复制服务。

MS-Defender 版本必须高于 4.18.2105.5。有关详细信息，请参阅Microsoft Defender 防病毒安全智能和产品更新。

如果您的部署包含 Windows Server 工作负载，请配置 Microsoft RDS 许可证服务器。

您可以使用产品 ISO 上的完整产品安装程序部署许多组件和技术。您可以使用独立的 VDA 安装程序安装 VDA。独立的 VDA 安装程序可在 Citrix 下载站点上获取。所有安装程序都提供图形界面和命令行界面。请参阅安装程序。

产品 ISO 包含用于在 Active Directory 中安装、升级或删除计算机 VDA 的示例脚本。您还可以使用这些脚本管理 Machine Creation Services (MCS) 和 Citrix Provisioning（以前称为 Provisioning Services）使用的映像。有关详细信息，请参阅使用脚本安装 VDA。

安装前要查看的信息

技术概述：熟悉产品及其组件。
安全性：规划部署环境时。
已知问题：此版本中可能遇到的问题。
数据库：了解系统数据库以及如何配置它们。在 Controller 安装期间，您可以安装 SQL Server Express 作为站点数据库。在安装核心组件后创建站点时，您可以配置大多数数据库信息。
远程电脑访问：如果您正在部署一个环境，使用户能够远程访问其办公室中的物理计算机。
连接和资源：如果您正在使用管理程序或其他服务来托管或预配用于应用程序和桌面的虚拟机。您可以在创建站点时（安装核心组件后）配置第一个连接。在此之前设置您的虚拟化环境。
Microsoft System Center Configuration Manager：如果您正在使用 ConfigMgr 管理对应用程序和桌面的访问，或者您正在将 Wake on LAN 功能与远程电脑访问结合使用。
公有云主机连接： 如果您拥有混合权利许可证，则可以创建到公有云的主机连接。有关混合权利许可证的信息，请参阅混合权利续订。有关公有云权利以及此更改原因的信息，请参阅 CTX270373。

组件安装位置

请查看系统要求以了解支持的平台、操作系统和版本。组件先决条件会自动安装，但另有说明的除外。有关 Citrix StoreFront 和 Citrix License Server 的支持平台和先决条件，请参阅其文档。

您可以将核心组件安装在同一台服务器上或不同的服务器上。

将所有核心组件安装在一台服务器上适用于评估、测试或小型生产部署。
为适应未来的扩展，请考虑将组件安装在不同的服务器上。例如，将 Studio 安装在与安装 Controller 的服务器不同的计算机上，可以远程管理站点。
对于大多数生产部署，建议将核心组件安装在单独的服务器上。

在其他服务器上安装其他组件之前，请先安装 Citrix License Server 和许可证。
要在 Server CoreOS（例如 Delivery Controller）上安装受支持的组件，您必须使用命令行。该操作系统类型不提供图形界面，因此请在其他位置安装 Studio 和其他工具，然后将它们指向 Controller 服务器。

您可以在同一台服务器上安装 Delivery Controller™ 和用于多会话操作系统的 VDA。启动安装程序并选择 Delivery Controller（以及您希望在该计算机上安装的任何其他核心组件）。然后再次启动安装程序并选择用于多会话操作系统的 Virtual Delivery Agent。

请确保每个操作系统都具有最新更新。

请确保所有计算机都具有同步的系统时钟。保护计算机之间通信的 Kerberos 基础结构需要同步。

对于 XenServers，即使虚拟机显示为已注册，其电源状态也可能显示为未知。要解决此问题，请编辑注册表项 HostTime 值以禁用与主机的时钟同步：

HKEY_LOCAL_MACHINE\Software\Citrix\XenTools\HostTime="Local"

HKEY_LOCAL_MACHINE\Software\Wow6432Node\Citrix\XenTools\HostTime="Local"

提示：

默认值为 HostTime="UTC"。将此值更改为 UTC 以外的值，例如 Local。此更改可有效禁用与主机的时钟同步。

有关 Windows 10 单会话计算机的优化指导，请参阅 CTX216252。

不应安装组件的位置：

请勿在 Active Directory 域控制器上安装任何组件。
不支持在 SQL Server 群集安装、SQL Server 镜像安装中的节点上或在运行 Hyper-V 的服务器上安装 Controller。

如果您尝试在当前产品版本不支持的 Windows 操作系统上安装或升级 VDA，则会显示一条消息，引导您阅读一篇介绍选项的文章。

权限和 Active Directory 要求

您必须是域用户，并且是安装组件的计算机上的本地管理员。

要使用独立的 VDA 安装程序，您必须具有提升的管理权限或使用以管理员身份运行。

在开始安装之前，请配置您的 Active Directory 域。

系统要求列出了支持的 Active Directory 功能级别。已加入 Active Directory包含更多信息。
您必须至少有一个运行 Active Directory 域服务的域控制器。
请勿在域控制器上安装任何 Citrix Virtual Apps™ and Desktops 组件。
在 Studio 中指定组织单位名称时，请勿使用正斜杠 (/)。

用于安装 Citrix License Server 的 Windows 用户帐户会自动配置为委派管理完全管理员。

有关详细信息：

安全最佳实践
委派管理
有关 Active Directory 配置的 Microsoft 文档

安装指导、注意事项和最佳实践

安装任何组件期间

从完整产品介质安装或升级 Delivery Controller、Studio、License Server 或 Director 时，如果 Citrix 安装程序检测到计算机上存在以前的 Windows 安装挂起的重新启动，则安装程序将停止并显示退出/返回代码 9。系统会提示您重新启动计算机。

这不是 Citrix 强制重新启动。这是由于计算机上早期安装的其他组件造成的。如果发生这种情况，请重新启动计算机，然后再次启动 Citrix 安装程序。

使用命令行界面时，您可以通过在命令中包含 /no_pending_reboot_check 选项来阻止检查挂起的重新启动。
通常，如果组件具有先决条件，则安装程序会在它们不存在时部署它们。某些先决条件可能需要重新启动计算机。
在安装之前、期间和之后创建对象时，请为每个对象指定唯一的名称。例如，为网络、组、目录和资源提供唯一的名称。
如果组件安装不成功，安装将停止并显示错误消息。已成功安装的组件将保留。您无需重新安装它们。
安装（或升级）组件时，会自动收集 Citrix Analytics。默认情况下，安装完成后，这些数据会自动上传到 Citrix。此外，当您安装组件时，您会自动注册 Citrix 客户体验改善计划 (CEIP)，该计划会上传匿名数据。

在安装过程中，您还可以选择参与其他 Citrix 技术，这些技术会收集诊断信息以进行维护和故障排除。有关这些计划的信息，请参阅 Citrix Insight Services。
安装 (或升级) Studio 时，会自动收集 (并随后上传) Google Analytics 数据。安装 Studio 后，您可以使用注册表项 HKLM\Software\Citrix\DesktopStudio\GAEnabled 更改此设置。值为 1 可启用收集和上传，值为 0 可禁用收集和上传。
如果 VDA 安装失败，MSI 分析器会解析失败的 MSI 日志，显示确切的错误代码。如果这是一个已知问题，分析器会建议一篇 CTX 文章。分析器还会收集有关失败错误代码的匿名数据。此数据包含在 CEIP 收集的其他数据中。如果您终止 CEIP 注册，则收集的 MSI 分析器数据将不再发送给 Citrix。

VDA 安装期间

适用于 Windows 的 Citrix Workspace™ app 可用，但在安装 VDA 时默认不安装。您或您的用户可以从 Citrix 网站下载、安装（和升级）适用于 Windows 的 Citrix Workspace app 以及其他 Citrix Workspace app。或者，您可以从您的 StoreFront 服务器提供这些 Citrix Workspace app。请参阅 StoreFront 文档。
必须启用 Microsoft Print Spooler Service。如果此服务被禁用，您将无法成功安装 VDA。
大多数受支持的 Windows 版本都已安装 Microsoft Media Foundation。如果计算机没有 Media Foundation（例如 N 版本），则某些多媒体功能将不会安装且无法工作。
- Windows Media Redirection
- HTML5 Video Redirection
- HDX™ RealTime Webcam Redirection
您可以确认此限制，或者在安装 Media Foundation 后结束 VDA 安装并稍后重新启动。在图形界面中，此选择会显示在消息中。在命令行中，您可以使用 /no_mediafoundation_ack 选项来确认此限制。
安装 VDA 时，会自动创建一个名为 Direct Access Users 的新本地用户组。在单会话操作系统 VDA 上，此组仅适用于 RDP 连接。在多会话操作系统 VDA 上，此组适用于 ICA® 和 RDP 连接。
VDA 必须具有有效的 Controller 地址才能进行通信。否则，无法建立会话。您可以在安装 VDA 时或之后指定 Controller 地址。请记住，必须完成此操作。有关详细信息，请参阅 VDA 注册。

VDA 安装后和安装期间的重新启动

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

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

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

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

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

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

升级 VDA 版本时，升级期间会发生重新启动。这是无法避免的。

安装或升级失败时恢复

注意：

此功能适用于单会话和多会话 VDA。

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

如果多会话 VDA 安装或升级失败，并且启用了“失败时恢复”功能，则计算机将恢复到安装或升级开始之前执行的备份。

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

当启用此功能启动多会话 VDA 安装或升级时，安装程序会在实际安装或升级开始之前创建一个服务器备份。如果 VDA 安装或升级失败，计算机将恢复到备份状态。%temp%/Citrix 文件夹包含部署日志和有关恢复的其他信息。创建服务器备份所需的时间取决于所需备份的大小以及服务器可用的资源量。备份存储在 C:\WindowsImageBackup\servername 中。

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

如果您计划启用此功能，请确保未通过 GPO 设置（Computer Configuration > Administrative Templates > System > System Restore）禁用系统还原。

注意：

此 GPO 设置不适用于恢复多会话 VDA。

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

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

如果安装/升级成功完成，则不会使用还原点/备份，但会保留。
使用命令行运行带 /enablerestore 或 /enablerestorecleanup 选项的 VDA 安装程序。
- 如果您使用 /enablerestorecleanup 选项，并且安装/升级成功完成，则还原点/服务器备份会自动删除。
- 如果您使用 /enablerestore 选项，并且安装/升级成功完成，则不会使用还原点，但会保留。

安装程序

完整产品安装程序

使用 ISO 中提供的完整产品安装程序，您可以：

安装、升级或删除核心组件：Delivery Controller、Studio、Director 和 License Server。
安装或升级 StoreFront。
安装或升级适用于单会话或多会话操作系统的 Windows VDA。
在您的打印服务器上安装 Universal Print Server UpsServer 组件。
安装 Federated Authentication Service。
安装 Session Recording。
安装 Workspace Environment Management。

注意：

Workspace Environment Management™ Agent 安装程序未本地化。它仅提供英文版本。

要从多会话操作系统为单个用户（例如，用于 Web 开发）交付桌面，请使用完整产品安装程序的命令行界面。有关详细信息，请参阅 Server VDI。

独立 VDA 安装程序

独立 VDA 安装程序可在 Citrix 下载页面上获取。（它们不随产品安装介质提供。）独立 VDA 安装程序比完整产品 ISO 小得多。它们更易于适应以下部署：

使用本地暂存或复制的电子软件分发 (ESD) 包
具有物理计算机
具有远程办公室

默认情况下，自解压独立 VDA 中的文件会提取到 Temp 文件夹。提取到 Temp 文件夹时，计算机上所需的磁盘空间比使用完整产品安装程序时更多。但是，提取到 Temp 文件夹的文件在安装完成后会自动删除。或者，您可以使用带绝对路径的 /extract 命令。

有四种独立的 VDA 安装程序可供下载。

多会话操作系统虚拟投递代理 (VDAServerSetup.exe)：

安装用于多会话操作系统的 VDA。它支持完整产品安装程序提供的所有多会话操作系统 VDA 选项。

单会话操作系统虚拟投递代理 (VDAWorkstationSetup.exe)：

安装用于单会话操作系统的 VDA。它支持完整产品安装程序提供的所有单会话操作系统 VDA 选项。

单会话操作系统核心服务虚拟投递代理 (VDAWorkstationCoreSetup.exe)：

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

此安装程序不安装或不包含用于以下目的的组件：

App-V。
Profile Management。从安装中排除 Citrix Profile Management 会影响 Citrix Director 显示。有关详细信息，请参阅安装 VDA。
计算机身份服务。
Citrix MCS IODriver
Citrix 备份和还原
deviceTRUST
uberAgent
WEM

VDAWorkstationCoreSetup.exe 安装程序不安装或不包含以下组件：适用于 Windows 的 Citrix Workspace 应用程序 (CWA)、Citrix Secure Access Client (CSA)、Citrix 用户个性化层 (UPL)、会话录制代理 (SRAGENT) 和 Citrix Assistant App (ASSISTANTAPP)。

使用 VDAWorkstationCoreSetup.exe 等同于使用完整产品安装程序或 VDAWorkstationSetup 安装程序安装单会话操作系统 VDA，并执行以下任一操作：

在图形界面中：在“环境”页面上选择“远程电脑访问”选项。
在命令行界面中：指定 /remotepc 选项。
在命令行界面中：指定 /components vda 以及列出所有有效附加组件名称的 /exclude 选项。

您可以通过运行完整产品安装程序稍后安装省略的组件/功能。该操作使您能够安装所有缺失的组件。

VDAWorkstationCoreSetup.exe 安装程序会自动安装 Browser Content Redirection MSI。此自动安装适用于 VDA 2003 及更高版本支持的版本。

单会话核心服务虚拟投递代理 (VDASingleSessionCoreSetup.exe)：

适用于 Windows 365 Cloud PC 和远程电脑部署的新型轻量级单会话 VDA 元安装程序。此安装程序基于现有的 VDAWorkstationCoreSetup.exe 安装程序构建，提供必要的 VDA 组件以及 Profile Management、deviceTRUST、uberAgent、WEM、备份和还原以及 VDA 升级代理。备份和还原功能可以使用命令行选项 /enablerestore 或 /enablerestorecleanup 启用。

它显著减小了程序包大小，并提高了基于云的工作负载的安装可靠性。此安装程序专为现代远程电脑场景设计，为在 Windows 365 和远程电脑上部署 Citrix 工作负载提供了简化且高性能的选项。

使用单会话 VDA 安装程序的最佳实践

对于单会话操作系统，有四种不同的安装程序可用。完整产品 VDA 安装程序和 VDAWorkstationSetup.exe 安装程序提供所有组件的安装，而 VDAWorkstationCoreSetup.exe 和 VDASingleSessionCoreSetup.exe 安装程序不包含某些默认组件和附加组件。

为保持环境稳定性、一致的性能和持续的可支持性，Citrix 建议在 Citrix VDA 的整个生命周期（包括安装、升级和卸载）中，使用一致的安装程序类型。混合使用安装程序类型可能会带来某些风险。

混合安装程序类型带来的风险：

场景 1：如果最初使用 VDAWorkstationCoreSetup.exe 或 VDASingleSessionCoreSetup.exe 安装程序安装单会话 VDA，然后使用完整产品 VDA 安装程序或 VDAWorkstationSetup.exe 安装程序进行升级，则除非明确排除，否则以前排除的组件可能会在升级期间安装。

场景 2：如果最初使用完整产品 VDA 安装程序或 VDAWorkstationSetup.exe 安装单会话 VDA，然后使用 VDAWorkstationCoreSetup.exe 或 VDASingleSessionCoreSetup.exe 进行升级，则核心服务 VDA 安装程序未安装的任何组件都将从升级中排除。这些组件既不会在升级过程中升级，也不会在卸载过程中删除。

场景 3：如果最初使用 VDAWorkstationCoreSetup.exe 安装程序安装单会话 VDA，然后使用 VDASingleSessionCoreSetup.exe 进行升级，您将体验到新功能。如果下次使用 VDAWorkstationCoreSetup.exe 进行升级，则 VDASingleSessionCoreSetup.exe 新增的组件既不会在升级过程中升级，也不会在卸载过程中删除。

解决混合安装程序类型的指导：

如果必须混合使用安装程序类型，则务必确保在升级过程中包含相同的组件。

如果安装程序类型被无意中混合，导致安装了额外的组件或某些组件脱离管理，并且需要恢复以前的环境，请按以下步骤操作：

对于场景 1：从 Windows 的“卸载或更改程序”功能中卸载 VDA，然后使用您最初使用的安装程序（VDAWorkstationCoreSetup.exe 或 VDASingleSessionCoreSetup.exe）重新安装 VDA。
对于场景 2：使用完整产品 VDA 安装程序或 VDAWorkstationSetup.exe 安装程序升级缺失的组件。
对于场景 3：如果您打算继续利用新功能，请使用 VDASingleSessionCoreSetup.exe 安装程序升级缺失的组件。或者，如果您在通过 VDASingleSessionCoreSetup.exe 升级后不希望使用新功能，请首先从 Windows 的“卸载或更改程序”功能中卸载 VDA，然后使用 VDAWorkstationCoreSetup.exe 重新安装 VDA。

Citrix 安装返回代码

安装日志包含组件安装结果，其为 Citrix 返回代码，而非 Microsoft 值。

0 = 成功
1 = 失败
2 = 部分成功
3 = 部分成功且需要重新启动
4 = 失败且需要重新启动
5 = 用户已取消
6 = 命令行参数错误
7 = 找到更新版本
8 = 成功且需要重新启动
9 = 文件锁定重新启动
10 = 已中止
11 = 介质失败
12 = 许可证失败
13 = 预检查失败
14 = 已中止待处理的重新启动检查
15 = 预检查通过 - 在使用新的 /precheckonly 命令行选项后，预检查通过时返回此值。
16 = 预检查失败 - 在使用新的 /precheckonly 命令行选项后，预检查失败时返回此值。
17 = 可选软件失败 - 当新的可选软件组件之一安装失败且已选择“如果任何其他选定组件失败，则继续 VDA 安装或升级”时返回此值。

例如，当使用 Microsoft System Center Configuration Manager 等工具时，如果安装日志包含返回代码 3，则脚本化 VDA 安装可能会显示为失败。当 VDA 安装程序正在等待您必须启动的重新启动（例如，在服务器上安装 RDS 角色先决条件之后）时，可能会发生这种情况。仅当所有先决条件和选定组件都已安装，并且计算机在安装后重新启动时，VDA 安装才被视为成功。

或者，您可以将安装包装在 CMD 脚本中（这些脚本返回 Microsoft 退出代码），或者更改 Configuration Manager 程序包中的成功代码。

为 Windows Server 工作负载配置 Microsoft RDS 许可证服务器

在交付 Windows Server 工作负载（例如 Windows 2016）时，本产品会访问 Windows Server 远程会话功能。这通常需要远程桌面服务客户端访问许可证 (RDS CAL)。VDA 必须能够联系 RDS 许可证服务器以请求 RDS CAL。安装并激活许可证服务器。有关详细信息，请参阅 Microsoft 文档激活远程桌面服务许可证服务器。对于概念验证环境，您可以使用 Microsoft 提供的宽限期。

使用此方法，您可以让此服务应用许可证服务器设置。您可以在映像上的 RDS 控制台中配置许可证服务器和每用户模式。您还可以使用 Microsoft 组策略设置配置许可证服务器。有关详细信息，请参阅 Microsoft 文档使用客户端访问许可证 (CAL) 许可您的 RDS 部署。

要使用组策略设置配置 RDS 许可证服务器：

在可用计算机上安装远程桌面服务许可证服务器。该计算机必须始终可用。Citrix 产品工作负载必须能够访问此许可证服务器。
使用 Microsoft 组策略指定许可证服务器地址和每用户许可证模式。有关详细信息，请参阅 Microsoft 文档指定 RD 会话主机服务器的远程桌面授权模式。

Windows 10 工作负载需要适当的 Windows 10 许可证激活。我们建议您遵循 Microsoft 文档来激活 Windows 10 工作负载。