Citrix Workspace 应用程序（Windows版）安装与卸载完全指南

# Citrix Workspace 应用程序（Windows版）安装与卸载完全指南

## 引言

Citrix Workspace 应用程序是连接 Citrix 虚拟桌面和应用环境的核心客户端软件。本指南提供面向 Windows 操作系统的 Citrix Workspace 应用程序安装、配置和卸载的完整说明，涵盖交互式向导安装、命令行静默部署、应用保护增强安装流程，以及卸载和故障排除等关键环节。通过本指南，IT 管理员和终端用户可以全面掌握该应用程序的部署与管理方法。

## 获取与安装准备

Citrix Workspace 应用程序可通过 Citrix 官方下载页面或者公司内部提供的下载渠道获取安装包。在开始安装之前，必须确认系统满足“系统要求”一节中所列明的全部硬件和软件前置条件。

升级到新版 Citrix Workspace 应用程序时，推荐使用 `CitrixWorkspaceApp.exe /CleanInstall` 命令执行干净的安装流程。如果需要进行版本降级，Citrix 官方建议先彻底卸载现有版本，然后安装目标版本，以避免因版本冲突导致系统异常。

## 安装权限与安装类型

Citrix Workspace 应用程序支持管理员和普通用户两种身份进行安装，但安装后的效果存在显著差异。管理员权限仅在需要使用特定高级功能时才是必需的，包括：

- 透传认证（Passthrough Authentication）
- 单点登录（Single Sign-On）
- 应用保护（App Protection）
- Microsoft Teams VDI 插件

下表列出了管理员和用户安装的关键差异：

| 安装类型 | 安装文件夹路径 | 安装范围 |
|---------|-------------|---------|
| 管理员 | 64 位系统：`C:\Program Files\Citrix\ICA Client`；32 位系统：`C:\Program Files (x86)\Citrix\ICA Client` | 系统级安装 |
| 用户 | `%USERPROFILE%\AppData\Local\Citrix\ICA Client` | 用户级安装 |

值得特别注意的是，管理员可以覆盖用户已安装的 Citrix Workspace 应用程序实例，并正常完成新安装流程，这为系统管理员提供了灵活的部署选项。

## 清理安装命令（/CleanInstall）

`/CleanInstall` 命令是执行干净安装的重要工具，它能够清理先前卸载操作可能遗留的残余文件和注册表值，确保新版本安装的纯净性。标准用法如下：

```
CitrixWorkspaceApp.exe /CleanInstall
```

需要注意的是，`forceinstall` 命令与 `cleaninstall` 命令存在本质区别。`forceinstall` 适用于不支持的版本升级或安装过程出现故障的场景，而 `cleaninstall` 则无论执行安装还是升级操作，都会在必要操作之前主动执行完整的系统清理过程，确保系统的干净状态。

## 启用 App Protection 的增强安装过程

在早期版本中，当 App Protection 功能被启用时，`/CleanInstall` 命令不被支持，用户不得不手动卸载应用、重启机器，再重新尝试安装。自版本 2503 起，此问题得到了有效解决：当 App Protection 已启用且执行 `/CleanInstall` 命令时，Citrix Workspace 应用程序会自动执行卸载，并根据用户选择重启计算机，重启过程中自动重新安装应用程序。

此过程将显示安装成功的界面提示，用户点击“重启”后，系统重启期间会自动完成重装。如果用户点击“取消”，应用程序将在下一次重启时安装。此时，在系统中搜索会找不到 Citrix Workspace 应用程序，这是预期行为。对于静默安装场景，App 仅会在用户下一次重启之后才变为可用。如果用户在重启前重新尝试安装，系统会再次显示重启提示。

## 交互式安装向导

用户可以通过手动运行 `CitrixWorkspaceApp.exe` 安装包来启动交互式安装向导。整个流程如下：

安装程序首先对系统进行前置条件检查，并自动安装缺失的必要组件，例如 `.NET Desktop Runtime` 等运行时环境。前置条件就绪后，将显示「Citrix Workspace 安装程序欢迎」界面。用户点击“继续”后进入 Citrix 许可协议页面，阅读并同意相关条款后，系统将自动推进安装直至成功完成。

当以管理员权限安装时，“附加组件”页面提供以下选项供用户选择：

- 安装后启动 App Protection
- 启用单点登录
- 安装 Microsoft Teams VDI 插件（自版本 2508 起默认选中，用户可取消选择）
- 安装 Zoom VDI 插件（自版本 2511 起默认选中，用户可取消选择）
- 安装 Cisco WebEx VDI 插件

## Microsoft Store 安装方式

用户还可以通过 Microsoft Store 完成安装，具体步骤包括：打开 Microsoft Store，搜索“Citrix Workspace”，点击“获取”按钮即可自动完成安装。此方式虽然便捷，但存在一个重要限制：Microsoft Teams VDI 插件、Zoom 插件管理以及其他第三方插件及其管理组件将不支持在此安装方式下使用，因此企业用户建议采用正式安装包进行部署。

## 命令行安装选项

命令行安装为 IT 管理员提供了批量部署和自动化配置的灵活性。安装命令的基本格式如下：

```
CitrixWorkspaceApp.exe [命令] [属性]
```

所有安装参数可归纳为六大类：公共参数、更新参数、存储配置参数、安装参数、HDX 功能参数以及设置与用户界面参数。

### 公共参数

- `?` 或 `help`：列出全部安装命令和属性。
- `/silent`：禁用安装过程中的对话框和提示，实现静默安装。
- `/forceinstall`：清理现有配置或卸载旧版本后强制安装，适用于不支持版本升级或安装失败的场景。该命令是 `rcu` 的替代方案，后者自版本 1909 起已弃用。

### 自动更新参数

**检测可用更新**：`AutoUpdateCheck` 命令提供三种值：
- `auto`（默认）：有可用更新时自动通知。
- `manual`：不主动通知，需手动检查更新。
- `disabled`：完全禁用自动更新。

该参数是配置其他更新参数（如 `AutoUpdateStream`、`DeferUpdateCount`、`AURolloutPriority`）时所必需的基础设置。

**选择更新版本**：`AutoUpdateStream` 命令支持以下值：
- `LTSR`：仅自动更新长期服务版本的累积更新。
- `Current`：自动更新至最新版本。

**延迟更新通知**：`DeferUpdateCount` 用于控制更新通知的延迟次数，默认值为 `-1`，表示可无限次延迟通知；值为 `0` 时仅对每个可用更新通知一次；指定正整数 `n` 则允许延迟通知 `n` 次。需要说明的是，自版本 2207 起该参数已不适用。

**设置发布优先级**：`AURolloutPriority` 允许用户在 Citrix 的发布窗口内自主选择接收更新的时间节点，包括 `Auto`（默认）、`Fast`（窗口初期）、`Medium`（窗口中期）和 `Slow`（窗口末期）四档。

### 存储配置参数

**配置 Store**：`ALLOWADDSTORE` 命令控制 Store 的添加或删除权限：
- `S`（默认）：仅允许操作 HTTPS 安全 Store。
- `A`：允许同时操作 HTTPS 和 HTTP Store；不适用于用户级安装。
- `N`：禁止用户自行添加或删除 Store。

**本地保存凭据**：`ALLOWSAVEPWD` 控制 Store 密码的本地存储策略：
- `S`（默认）：仅允许保存 HTTPS 安全 Store 的密码。
- `N`：完全禁止保存密码。
- `A`：允许保存 HTTPS 和 HTTP Store 的密码。

**命令行配置 Store 实例**：指定 StoreFront Store 使用以下格式：
```
CitrixWorkspaceApp.exe /silent STORE0="AppStore;https://testserver.net/Citrix/MyStore/discovery;on;HR App Store"
```
指定 Citrix Gateway Store 则使用以下格式：
```
CitrixWorkspaceApp.exe STORE0=HRStore;https://ag.mycompany.com#Storename;On;Store
```
多个 Store 可以在此格式基础上使用 `STORE0`、`STORE1` 等参数实现批量配置。需要特别强调的是，若要成功实现透传认证，Store URL 中必须包含 `discovery` 关键字。Store URL 的参数依次为：Store 显示名称、Store 地址、启用状态（On/Off）和 Store 描述文字。

### 安装参数

**启动 App Protection**：`startAppProtection` 命令用于启动应用保护组件，防止键盘记录和屏幕捕获类恶意软件的侵害。该命令是旧命令 `includeAppProtection` 的替代，后者自版本 2212 起已弃用。

**排除 Citrix Enterprise Browser**：通过 `ADDLOCAL` 参数排除浏览器组件：
```
CitrixWorkspaceapp.exe ADDLOCAL=ReceiverInside,ICA_Client,BCR_Client,USB,DesktopViewer,AM,SSON,SelfService,WebHelper
```
该排除操作仅适用于全新安装或从不包含浏览器组件的旧版本进行升级的场景。自版本 2511 起，Citrix Enterprise Browser 已停止随应用分发，用户可按需从 Citrix 下载页面单独安装。

**排除 EPA 客户端自动安装**：使用 `CitrixWorkspaceApp.exe InstallEPAClient=N` 可以阻止 EPA（终端防护代理）客户端的自动安装。

**自定义安装目录**：`INSTALLDIR` 参数允许指定自定义安装路径，默认位置为 `C:\Program Files\Citrix`。自定义路径时必须确保目标文件夹具备适当的访问权限和安全性保护。

**选择安装组件**：`ADDLOCAL` 参数支持按需安装特定组件，下表列出了重要组件及其功能说明：

| ADDLOCAL 键 | 组件名称 | 说明 |
|------------|---------|------|
| ReceiverInside | Receiver 自助服务插件 | 提供 Workspace SDK 服务 |
| ICA_Client | HDX 引擎 | 处理 ICA 文件与会话启动 |
| BCR_Client | BCR 客户端 | 处理浏览器内容重定向 |
| USB | USB 客户端 | 处理 USB 重定向 |
| DesktopViewer | Desktop Viewer 客户端 | 虚拟桌面 UI 框架 |
| AM | AuthManager | 用户认证管理 |
| SSON | SSON | 单点登录组件 |
| SELFSERVICE | 自助服务 | Citrix Workspace 原生启动插件 |
| WebHelper | Web Helper | 连接浏览器与原生应用 |
| CitrixEnterpriseBrowser | 浏览器 | 安全打开 Web/SaaS 应用 |

默认情况下，不指定 `ADDLOCAL` 参数会安装全部支持组件。使用此参数时，需要注意两个技术细节：第一，升级安装不会识别已存在组件的排除指令，如需在升级时移除组件，必须先完整卸载再重装；第二，单独省略 `DesktopViewer` 参数可能导致“连接中心”的“设备”和“设置”窗口无响应，建议同时包含此参数以避免潜在问题。

**第三方插件管理**：Citrix Workspace 应用程序支持 Microsoft Teams、Zoom 和 Cisco WebEx 三个第三方 VDI 插件。这些插件不从 Citrix 服务器直接分发，而是从各第三方 CDN 获取。在安装和更新时，必须确保终端能够访问对应的 CDN 网络资源。插件安装失败不会影响 Citrix Workspace 应用程序主体安装，失败组件可在后续重新运行安装程序时予以修复。

各插件管理策略如下：Microsoft Teams 插件默认安装（可通过 `/InstallMSTeamsPlugin=N` 禁止），Zoom 插件默认安装（可通过 `Installzoomplugin=N` 禁止），WebEx 插件默认不安装（通过 `ADDONS=WebexVDIPlugin` 显式启用）。需要留意的是，在卸载 Citrix Workspace 应用程序时，第三方插件不会被自动卸载。Citrix 推荐启用自动更新机制以便及时获取第三方插件的最新版本。

**Citrix Casting 安装**：`IncludeCitrixCasting` 命令用于在安装中包含 Citrix Casting 功能，但自 LTSR 2402 起此功能已不可用，用户需回退至旧版本才能使用该特性。

**UberAgent 与 Session Recording 参数**：`/InstallUberAgent` 用于安装监控诊断插件，提供深度用户行为和应用性能洞察；`/InstallSRAgent` 用于安装会话记录代理，扩展端点监控能力。两个组件均仅支持命令行安装方式。若需保留现有组件版本而不执行升级，可使用 `./SkipUberAgentUpgrade` 或 `/SkipSRAgentUpgrade` 参数搭配使用。

### HDX 功能参数

- `ALLOW_BIDIRCONTENTREDIRECTION`：启用或禁用客户端与主机间的双向内容重定向，默认值为 `0`（禁用），设置为 `1` 时启用。
- `FORCE_LAA`：指示是否安装客户端本地应用访问组件，默认值为 `0`（不安装），设置为 `1` 时安装，且需要管理员权限安装才能正常运作。
- `ALLOW_CLIENTHOSTEDAPPSURL`：控制用户设备上的 URL 重定向功能，默认值为 `0`（禁用），设置为 `1` 时启用。
- `LEGACYFTAICONS`：控制订阅应用程序关联文档或文件的图标显示方式，默认值 `False` 表示显示操作系统生成的通用图标叠加；设置为 `True` 时则不显示此类文件图标。

### 设置与用户界面参数

- `STARTMENUDIR`：指定开始菜单快捷方式目录，支持相对路径，如 `STARTMENUDIR=Workspace`。
- `DESKTOPDIR`：指定桌面快捷方式目录，使用时须将 `PutShortcutsOnDesktop` 设为 `True`。
- `SELFSERVICEMODE`：控制自助服务用户界面访问权限，`True` 允许访问，`False` 禁止。
- `ENABLEPRELAUNCH`：控制会话预启动功能，`True` 启用，`False` 禁用。
- `DisableSetting`：控制“高级设置”面板中快捷方式和重连选项的可见性：`0` 显示全部，`1` 仅显示重连选项，`2` 仅显示快捷方式选项，`3` 两者均隐藏。
- `EnableCEIP`：控制客户体验改善计划参与状态，默认 `True` 表示参与，`False` 则拒绝参与。
- `EnableTracing`：控制常时追踪功能，默认 `True` 启用，`False` 禁用。
- `CLIENT_NAME`：指定服务器侧识别用户设备所使用的名称，默认值为 `%COMPUTERNAME%`。
- `ENABLE_DYNAMIC_CLIENT_NAME`：允许客户端名称与计算机名称保持同步变更，默认值为 `Yes`；设置为 `No` 时必须指定 `CLIENT_NAME` 属性的有效值。

### 认证参数

- `/includeSSON`：要求以管理员权限安装，在安装中包含单点登录组件。自版本 2503 起，系统默认在休止模式下安装 SSON，可通过组策略（用户认证 > 本地用户名和密码 > 启用透传认证）在安装后激活。SSON 设置生效前需要重启系统。该参数仅支持全新安装，不适用于升级场景。
- `ENABLE_SSON`：在使用 `/includeSSON` 安装的前提下，启用或禁用单点登录功能，默认值为 `Yes`，设置 `No` 则关闭。

## 卸载与故障排除

**通过 Windows 卸载**：可通过“控制面板”中的“程序和功能”正常卸载 Citrix Workspace 应用程序。

**通过命令行卸载**：使用以下命令进行卸载或静默卸载：
```
CitrixWorkspaceApp.exe /uninstall
CitrixWorkspaceApp.exe /silent /uninstall
```
需要留意，卸载操作不会清除与组策略（GPO）相关的注册表键值，这些键值在卸载后依然保留，管理员需要根据实际情况通过 `gpedit` 手动更新或删除残留条目。

**安装日志**：安装日志是排查部署问题的重要依据。默认情况下，日志存放位置根据安装类型而异：管理员安装的日志位于 `C:\Program Files (x86)\Citrix\Logs`（64 位系统）或 `C:\Program Files\Citrix\ICA Client`（32 位系统），用户安装的日志则存放于 `%USERPROFILE%\AppData\Local\Citrix\Logs`。自版本 2311.1 起，日志命名由 `TrolleyExpress` 调整为 `CWAInstaller-<日期时间戳>` 格式，例如 `CTXWorkspaceInstallLogs-20231225-093441`。

**重置应用程序**：使用以下命令可以将 Citrix Workspace 应用程序恢复到默认状态：
```
"C:\Program Files (x86)\Citrix\ICA Client\SelfServicePlugin\CleanUp.exe" -cleanUser
```
如需静默重置，可添加 `/silent` 参数。重置操作会清除全部已配置的账户与 Store、缓存文件、已保存密码、用户注册表设置以及 Citrix Gateway 注册表配置，但不会卸载应用程序本体，也不影响 ICA 锁定设置和组策略管理模板配置。

**错误代码查询**：安装过程中遇到错误时，可参考以下两个微软官方资源进行排查：安装类错误查找 `MsiExec.exe 和 InstMsi.exe 错误消息`，系统类错误则查询 `系统错误代码` 文档。

## 总结与最佳实践

Citrix Workspace 应用程序的部署涉及多种安装方式和大量可配置参数，合理运用这些工具和选项可以极大地提升部署效率和用户体验。建议企业 IT 管理员：

1. **采用命令行部署**：利用命令行参数实现批量静默安装，结合 `STORE0` 等参数自动配置 Store，实现用户零干预部署。
2. **统一更新策略**：合理配置 `AutoUpdateCheck`、`AutoUpdateStream` 和 `AURolloutPriority` 等参数，确保客户端安全补丁和应用更新及时到位。
3. **按需选择组件**：根据企业实际安全要求和业务场景，利用 `ADDLOCAL` 和第三方插件管理参数精细控制安装内容，避免不必要的资源占用。
4. **规划好升级路径**：升级新版本时优先使用 `/CleanInstall` 命令，降级前务必完整卸载旧版本。涉及 App Protection 时，注意重启过程的时序安排并及时通知最终用户。
5. **定期审视日志与监控**：利用安装日志和 UberAgent 监控插件，持续跟踪部署质量和用户使用体验，及时发现并解决潜在问题。

通过科学规划和标准化操作流程，企业可以最大限度发挥 Citrix Workspace 应用程序在数字化工作空间中的核心价值，为终端用户提供安全、稳定且高效的远程访问体验。