安装准备工作

June 2, 2026

投稿者:

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

一个或多个交付控制器
思杰导向器
思杰店面™
Citrix 许可证服务器
一个或多个 Citrix 虚拟投递代理 (VDA)
可选的组件和相关技术，例如通用打印服务器、联合身份验证服务以及自助密码重置功能

对于防火墙外的用户，请安装并配置一个额外的组件，例如 Citrix 网关。有关介绍，请参阅将 Citrix 虚拟应用和桌面与 Citrix 网关集成。

注意：

确保在服务器操作系统和工作站操作系统上满足以下 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。

在安装之前需要审阅的信息

技术概述：熟悉产品及其组件。
(/zh-cn/citrix-virtual-apps-desktops/2503/secure.html)：规划部署环境时。
(/zh-cn/citrix-virtual-apps-desktops/2503/whats-new/known-issues.html)：此版本中可能遇到的问题。
(/zh-cn/citrix-virtual-apps-desktops/2503/technical-overview/databases.html)：了解系统数据库以及如何配置它们。在 Controller 安装期间，您可以安装 SQL Server Express 作为站点数据库。在安装核心组件后，创建站点时配置大多数数据库信息。
(/zh-cn/citrix-virtual-apps-desktops/2503/install-configure/remote-pc-access.html)：如果您正在部署一个环境，使用户能够远程访问其办公室中的物理计算机。
(/zh-cn/citrix-virtual-apps-desktops/2503/manage-deployment/connections.html)：如果您正在使用虚拟机管理程序或其他服务来托管或预配应用程序和桌面的虚拟机。您可以在创建站点时（安装核心组件后）配置第一个连接。在此之前设置您的虚拟化环境。
(/zh-cn/citrix-virtual-apps-desktops/2503/install-configure/install-prepare/configmgr.html)：如果您正在使用 ConfigMgr 管理对应用程序和桌面的访问，或者如果您正在将局域网唤醒功能与远程电脑访问结合使用。
公共云主机连接： 如果您拥有混合权利许可证，则可以创建到公共云的主机连接。有关混合权利许可证的信息，请参阅 Hybrid Rights Renewals。有关公共云权利以及此更改原因的信息，请参阅 CTX270373。

组件的安装位置

查看 (/zh-cn/citrix-virtual-apps-desktops/2503/system-requirements.html) 以了解支持的平台、操作系统和版本。除非另有说明，否则组件先决条件将自动安装。有关 Citrix StoreFront 和 Citrix License Server 的支持平台和先决条件，请参阅其文档。

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

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

在其他服务器上安装其他组件之前，请先安装 Citrix 许可证服务器和许可证。
要在 Server CoreOS（例如 Delivery Controller）上安装受支持的组件，您必须(/zh-cn/citrix-virtual-apps-desktops/2503/install-configure/install-command.html)。该操作系统类型不提供图形界面，因此请在其他位置安装 Studio 和其他工具，然后将它们指向 Controller 服务器。

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

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

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

对于 XenServer，即使虚拟机已注册，其电源状态也可能显示为未知。要解决此问题，请编辑注册表项 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，则会显示一条消息，引导您阅读一篇介绍相关选项的文章。

权限和活动目录必备条件

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

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

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

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

用于安装 Citrix 许可证服务器的 Windows 用户帐户会自动配置为委派管理完全管理员。

有关更多信息，请参阅：

安全最佳实践
委派管理
微软关于活动目录配置的说明文档

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

在安装任何组件期间

从完整产品介质安装或升级 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™ 应用程序可用，但在安装 VDA 时默认不安装。您或您的用户可以从 Citrix 网站下载、安装（和升级）适用于 Windows 的 Citrix Workspace 应用程序以及其他 Citrix Workspace 应用程序。或者，您可以从 StoreFront 服务器提供这些 Citrix Workspace 应用程序。请参阅 StoreFront 文档。
必须启用 Microsoft Print Spooler 服务。如果该服务被禁用，您将无法成功安装 VDA。
大多数受支持的 Windows 版本都预装了 Microsoft Media Foundation。如果计算机没有 Media Foundation（例如 N 版本），则多个多媒体功能将不会安装且无法工作。
- Windows 媒体重定向
- HTML5 视频重定向
- HDX™ RealTime 网络摄像头重定向
您可以确认此限制，或者在安装 Media Foundation 后结束 VDA 安装并稍后重新启动。在图形界面中，此选择会显示在消息中。在命令行中，您可以使用 /no_mediafoundation_ack 选项来确认此限制。
安装 VDA 时，会自动创建一个名为 Direct Access Users 的新本地用户组。在单会话操作系统 VDA 上，此组仅适用于 RDP 连接。在多会话操作系统 VDA 上，此组适用于 ICA® 和 RDP 连接。
VDA 必须具有有效的控制器地址才能进行通信。否则，无法建立会话。您可以在安装 VDA 时或之后指定控制器地址。请记住，此操作必须完成。有关详细信息，请参阅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 命令），请在摘要页面上选中如果更新失败则启用自动恢复复选框。

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

安装程序

完整产品安装程序

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

安装、升级或删除核心组件：交付控制器、Studio、Director 和许可证服务器。
安装或升级 StoreFront 服务。
安装或升级用于单会话或多会话操作系统的 Windows VDA。
在您的打印服务器上安装 Universal Print Server 的 UpsServer 组件。
安装联合身份验证服务。
安装会话录制。
安装工作区环境管理。

注意：

工作区环境管理™ 代理安装程序未本地化。它仅提供英文版本。

要从多会话操作系统为单个用户（例如，用于 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 应用程序。
配置文件管理。从安装中排除 Citrix Profile Management 会影响 Citrix Director 的显示。有关详细信息，请参阅安装 VDA。
计算机身份服务。
Citrix 可支持性工具。
适用于 Windows 的 Citrix 文件应用程序。
适用于 Outlook 的思杰文件。

VDAWorkstationCoreSetup.exe 安装程序不安装或不包含适用于 Windows 的 Citrix Workspace 应用程序。

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

在图形界面中：在“环境”页面上选择 Remote PC Access 选项。
在命令行界面中：指定 /remotepc 选项。
在命令行界面中：指定 /components vda 以及 /exclude 选项，该选项列出了所有有效的附加组件名称。

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

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

Citrix 安装返回代码

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

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

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

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

为 Windows 服务器工作负载配置微软 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 工作负载。