安装准备工作

May 31, 2026

投稿者:

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

一个或多个交付控制器
思杰导向器
思杰店面™
思杰许可证服务器
一个或多个 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。

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

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

组件的安装位置

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

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

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

在其他服务器上安装其他组件之前，请先安装 Citrix 许可证服务器和许可证。
要在 Server CoreOS（例如 Delivery Controller）上安装受支持的组件，您必须使用命令行(/zh-cn/citrix-virtual-apps-desktops/2507-ltsr/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 域服务的域控制器。
请勿在域控制器上安装任何 Citrix 虚拟应用和桌面组件。
在 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 版本），则多个多媒体功能将不会安装且无法正常工作。
- 视窗媒体重定向
- HTML5 视频重定向
- HDX™ RealTime 网络摄像头重定向
您可以确认此限制，或者在安装 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 命令），请在“摘要”页面上选中“如果更新失败，则启用自动恢复”复选框。

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

安装程序

完整产品安装程序

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

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

注意：

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

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

独立 VDA 安装程序

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

使用已暂存或本地复制的电子软件分发 (ESD) 软件包
准备好物理机
拥有远程办公室

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

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

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

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

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

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

Single-session OS Core Services Virtual Delivery Agent (VDAWorkstationCoreSetup.exe):

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

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

App-V 应用程序虚拟化。
配置文件管理。将 Citrix Profile Management 从安装中排除会影响 Citrix Director 显示。有关详细信息，请参阅安装 VDA。
计算机身份服务。
思杰 MCS IO驱动程序
Citrix 备份和还原
设备信任
优博艾真特
WEM

VDAWorkstationCoreSetup.exe 安装程序不安装或不包含以下组件：适用于 Windows 的 Citrix Workspace 应用程序 (CWA)、Citrix 安全访问客户端 (CSA) 和 Citrix 用户个性化层 (UPL)。

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

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

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

VDAWorkstationCoreSetup.exe 安装程序会自动安装浏览器内容重定向 MSI。此自动安装适用于 VDA 2003 及更高版本支持的版本。

Single-session Core Services Virtual Delivery Agent (VDASingleSessionCoreSetup.exe):

从 2507 CU1 版本开始，推出了一款新的轻量级单会话 VDA 元安装程序，适用于 Windows 365 Cloud PC 和 Remote PC 部署。此安装程序基于现有的 VDAWorkstationCoreSetup.exe 安装程序构建，提供了基本的 VDA 组件以及配置文件管理、deviceTRUST、uberAgent、WEM、备份和还原以及 VDA 升级代理。备份和还原功能可以通过命令行选项 /enablerestore 或 /enablerestorecleanup 启用。

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

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

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

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

混合安装程序类型相关的风险：

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

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

Scenario 3: If a single-session VDA is initially installed using the VDAWorkstationCoreSetup.exe installer, and subsequently upgraded with VDASingleSessionCoreSetup.exe, you’ll experience the new features. If you upgrade with VDAWorkstationCoreSetup.exe next time, the newly added components by VDASingleSessionCoreSetup.exe will neither be upgraded in the upgrade process nor removed during uninstallation.

处理混合安装程序类型的指导：

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

在安装程序类型被无意中混用的情况下，导致安装了额外的组件，或者某些组件脱离了管理范围，并且需要将环境恢复到之前的状态时，请按照以下步骤进行操作：

对于场景 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 = 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 工作负载。