产品文档
Citrix Cloud™
查看 PDF

云连接器安装

August 31, 2026
投稿者: 
C C

您可以交互式地或使用命令行安装 Cloud Connector 软件。

安装以启动安装的用户权限进行。Cloud Connector 需要访问云才能执行以下操作：

  • 验证执行安装的用户
  • 验证安装程序的权限
  • 下载并配置 Cloud Connector 服务

安装前需要查看的信息

安装前请查看系统要求。

部署后指导

安装后，请保持所有 Cloud Connector 持续通电，以确保与 Citrix Cloud 始终保持连接。

升级

升级通常由 Citrix Cloud 自动管理。要手动升级，请先卸载旧的 Cloud Connector，然后再安装新版本。请勿使用较新版本升级以前安装的 Cloud Connector。请勿单独升级 Cloud Connector 的各个组件。

重命名计算机

安装后，请勿重命名托管 Cloud Connector 的计算机。如果以后需要更改服务器名称，请执行以下任务：

  1. 从资源位置中删除计算机：
    1. 从 Citrix Cloud 菜单中，选择 资源位置。
    2. 找到您要管理的资源位置，然后选择 Cloud Connectors 磁贴。
    3. 找到您要管理的计算机，然后单击省略号菜单。选择 删除连接器。
  2. 卸载 Cloud Connector 软件。
  3. 重命名计算机。
  4. 按照本文所述安装最新版本的 Cloud Connector 软件。

将计算机移动到其他域

安装后，请勿将托管 Cloud Connector 的计算机移动到其他域。如果以后需要将计算机加入其他域，请执行以下任务：

  1. 从资源位置中删除计算机。
  2. 卸载 Cloud Connector 软件。
  3. 将计算机从当前域中取消加入，然后将计算机重新加入新域。
  4. 按照本文所述安装最新版本的 Cloud Connector 软件。

克隆计算机的注意事项

每台托管 Cloud Connector 的计算机都必须具有唯一的 SID 和连接器 ID，以便 Citrix Cloud 能够与资源位置中的计算机可靠地通信。如果您打算在资源位置中的多台计算机上托管 Cloud Connector 并希望使用克隆计算机，请执行以下步骤：

  1. 根据您的环境要求准备计算机模板。
  2. 预置您打算用作 Cloud Connector 的计算机数量。
  3. 在每台计算机上安装 Cloud Connector，可以手动安装，也可以使用静默安装模式。

不支持在计算机模板（克隆之前）上安装 Cloud Connector。如果您克隆了已安装 Cloud Connector 的计算机，则 Cloud Connector 服务将无法运行，并且该计算机无法连接到 Citrix Cloud。

服务注意事项

本文中的安装步骤介绍了部署 Cloud Connector 的过程，无论它们用于何种服务。

部署适用于 Citrix DaaS 的 Cloud Connector 时，请验证连接器所在的 AD 域是否处于活动状态，并且在 Citrix Cloud 控制台中未显示为“未使用”。如果您在 Citrix DaaS 中设置计算机目录时指定了未使用的域，则可能会发生错误。有关详细信息，请参阅 Citrix DaaS 产品文档中的 在 Citrix Cloud 中添加资源类型或激活未使用的域。

有关其他服务的其他注意事项，请查阅该服务的文档。

默认资源位置

如果您的 Citrix Cloud 帐户中没有资源位置，并且您在域中安装 Cloud Connector，则 Citrix Cloud 创建的资源位置将成为默认资源位置。您的帐户中只能有一个默认资源位置。如果需要，您可以在 Citrix Cloud 中 创建其他资源位置，然后在其他域中安装 Cloud Connector 时选择所需的资源位置。

或者，您可以在域中安装 Cloud Connector 之前，先在控制台中创建所需的资源位置。Cloud Connector 安装程序会在安装过程中提示您选择所需的资源位置。

交互式安装

您可以使用图形安装程序界面下载并安装 Cloud Connector。在此之前，您必须在 Citrix Cloud 管理控制台中创建一个或多个资源位置，以便在其上部署 Cloud Connector。有关资源位置的详细信息，请参阅 资源位置。

下载 Citrix Cloud Connector™ 软件

  1. 以 Windows 管理员身份登录到您打算安装 Citrix Cloud Connector 的计算机。

  2. 访问 https://citrix.cloud.com 并登录到您的管理员帐户。

  3. 在 Citrix Cloud 控制台中，从主菜单导航到“资源位置”。

  4. 如果您还没有资源位置，请单击加号图标 (+) 或选择“添加资源位置”。有关详细信息，请参阅创建资源位置。

  5. 找到您要管理的资源位置，然后选择“+ Cloud Connectors”。

    没有连接器的新资源位置

  6. 在打开的窗口中选择“下载”。将 cwcconnector.exe 文件保存到连接器计算机上的本地文件位置。

    添加 Cloud Connector 窗口

安装 Citrix Cloud Connector 软件

先决条件

  1. 右键单击 cwcconnector.exe 安装程序文件，然后选择“以管理员身份运行”。安装程序会执行初始连接检查，以确保您在安装 Cloud Connector 之前可以连接到 Citrix Cloud。

  2. 单击“管理”以更新代理服务器。

安装云连接器

注意：

由于 Microsoft WinHTTP 的限制，仅支持一个代理服务器。有关详细信息，请参阅WinHTTP 中的自动代理问题

  1. 单击“高级连接检查”以运行详细检查，确保计算机满足连接器安装的基本连接要求。

    高级连接检查

初始升级和测试

  1. 更新 代理服务器 并检查 高级连接检查 后，单击 安装云连接器。

  2. 在 Sign-in 页面上，单击 Sign in and Install。

    云连接器登录

  3. Citrix Cloud Connectivity Test 窗口出现，并显示初始升级和测试的状态以及事件日志。

    正在进行的初始测试

  4. 单击 View logs 以打开包含所有连接检查调试日志的目录 (C:\ProgramData\Citrix\WorkspaceCloud\InstallLogs)。

  5. 初始升级和测试完成后，您将看到 Citrix Cloud Connectivity Test 为 Successful，如以下图像所示。连接检查结果在首次升级后显示在事件日志框中。

    初始测试完成

激活未使用的域

如果您正在为 Citrix DaaS™ 创建资源位置并部署 Cloud Connector，请验证您与 Citrix DaaS 一起使用的 AD 域是否处于活动状态且未被视为未使用。如果在 Citrix DaaS 中设置计算机目录时指定了未使用的域，则可能会发生错误。

有关详细信息，请参阅 Citrix DaaS 产品文档中的 在 Citrix Cloud 中添加资源类型或激活未使用的域。

创建其他资源位置

  1. 在 Citrix Cloud 管理控制台中，单击菜单按钮并选择 Resource Locations。
  2. 单击 + Resource Location 并输入一个有意义的名称。
  3. 单击“保存”。Citrix Cloud 会显示新资源位置的磁贴。
  4. 单击“Cloud Connectors”，然后单击“下载”以获取 Cloud Connector 软件。
  5. 在每台准备好的计算机上，使用安装向导或命令行安装安装 Cloud Connector 软件。Citrix Cloud 会提示您选择要与 Cloud Connector 关联的资源位置。

使用多个客户和现有资源位置进行安装

如果您是多个客户帐户的管理员，Citrix Cloud 会提示您选择要与 Cloud Connector 关联的客户帐户。

如果您的客户帐户已有多个资源位置，Citrix Cloud 会提示您选择要与 Cloud Connector 关联的资源位置。

命令行安装

支持静默或自动化安装。但是，连接器安装程序会定期更新，因此建议每次安装都下载最新的安装程序。从 Citrix Cloud 控制台的“资源位置”页面下载新的 Cloud Connector 安装程序。

要求

要将命令行安装与 Citrix Cloud 结合使用，您需要提供以下信息：

  • 您正在为其安装 Cloud Connector 的 Citrix Cloud 帐户的客户 ID。此 ID 显示在“身份和访问管理”中的“API 访问”选项卡顶部。
  • 您要用于安装 Cloud Connector 的安全主体 ID 和密钥。要获取这些值，您必须首先创建一个安全主体。安全主体必须以“完全访问”权限创建。有关创建服务主体的更多信息，请参阅创建服务主体。获取安全主体的 ID 和密钥后，即可继续进行 Cloud Connector 安装。
  • 您要与 Cloud Connector 关联的资源位置的资源位置 ID。要检索此值，请在“资源位置”页面上资源位置名称下方选择“ID”按钮。如果您不提供此值，Citrix Cloud 将使用默认资源位置的 ID。

支持的参数

为确保安全主体 ID 和密钥的安全性，必须向安装程序提供 JSON 配置文件。安装完成后必须删除此文件。配置文件的支持值包括：

  • customerName 必填。Citrix Cloud 控制台（在“身份和访问管理”中）的“API 访问”页面上显示的客户 ID。
  • clientId 必填。管理员可以在“API 访问”页面上创建的安全主体 ID。
  • clientSecret 必填。创建安全主体后可以下载的安全主体密钥。位于“API 访问”页面上。
  • resourceLocationId 建议。现有资源位置的唯一标识符。在 Citrix Cloud 控制台的“资源位置”页面上选择“ID”按钮以检索资源位置 ID。如果未指定任何值，Citrix Cloud 将使用帐户中第一个资源位置的 ID。
  • acceptTermsOfService 必填。必须设置为 true。

示例配置文件 

{
"customerName": "CustomerID",
"clientId": "SecurePrincipalID",
"clientSecret": "ClientSecret",
"resourceLocationId": "ResourceLocationId",
"acceptTermsOfService": "true"
}
<!--NeedCopy-->

示例命令

以下命令使用 JSON 配置文件静默安装 Cloud Connector 软件：

CWCConnector.exe /q /ParametersFilePath:c:\cwcconnector_install_params.json
<!--NeedCopy-->

使用 /q 指定静默安装。

使用 Start /Wait CWCConnector.exe /ParametersFilePath:value 检查故障情况下的潜在错误代码。安装完成后，您可以使用运行 echo %ErrorLevel% 的标准机制。

HTTPS 配置

为了允许 StoreFront™ 和 NetScaler Gateway 设备安全地连接到 Cloud Connector 并加密所有数据，强烈建议您启用 HTTPS。这需要 SSL 证书。

  • 证书必须包含用于访问连接器的 FQDN 作为公用名或主题备用名称。如果您在连接器前面部署了负载均衡器，则使用负载均衡器的 FQDN。
  • 证书可以由企业 CA 或公共 CA 签名。
  • 连接到 Cloud Connector 的任何 StoreFront 和网关服务器都必须信任该证书。

要启用 HTTPS：

  1. 打开 证书 MMC 管理单元。

  2. 在个人证书存储中创建或导入合适的证书。有关管理证书的更多信息，请参阅 管理证书。

  3. 打开证书，转到“详细信息”选项卡，记下“指纹”，忽略所有空格。

    证书详细信息屏幕截图

  4. 确定要将证书绑定到哪个 IP 地址。通常，您可以使用 0.0.0.0 的 IP 地址应用于所有 IPv4 地址。如果启用了 IPv6，则使用 [::] 应用于所有 IPv6 地址。如果您只想将更改应用于特定的网络适配器，请记下该网络适配器的 IP 地址。

  5. 在提升的命令提示符下运行

    netsh http add sslcert ipport=<IP address>:<Port number> certhash=<Certificate Hash Number> appid={Any GUID}
<!--NeedCopy-->

    您可以将任何有效的 GUID 用于 AppId。其目的是记录哪个应用程序添加了绑定。但是，该绑定适用于使用该端口的所有应用程序。

    例如：

    C:\> netsh http add sslcert ipport=0.0.0.0:443 certhash=BC96F958848639FD101A793B87915D5F2829B0B6 appid={6DE9BEFD-F4CB-4D63-8681-E88012D6F5F1}

SSL Certificate successfully added
<!--NeedCopy-->

  6. 要禁用 HTTP，请在注册表中转到 HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\DesktopServer 并创建名称为 XMLServicesEnableNonSSL 且值为 0 的 DWORD。

后续步骤

  1. 设置 Citrix Cloud Connector 更新计划。有关 Citrix Cloud Connector 更新和管理更新计划的信息，请访问 连接器更新。
  2. 如果您正在使用 StoreFront，请配置 StoreFront，使其可以使用连接器访问 DaaS 以枚举和启动资源。如果这是新 DaaS 部署中的第一个连接器，请创建新的资源订阅源。如果这是附加连接器，则建议为了提高弹性，将所有 Cloud Connector 添加到现有 DaaS 资源订阅源的服务器列表中。有关详细信息，请参阅 管理商店中提供的资源。
  3. 如果您正在将 StoreFront 与 NetScaler Gateway 结合使用，则可以使用连接器访问 Citrix Cloud Secure Ticket Authority (STA)。有关详细信息，请参阅 配置 Citrix Gateway。
  4. 如果这是特定 Active Directory 域上的第一个连接器，则可以将该域连接到 Citrix Cloud。有关详细信息，请参阅 将您的 Active Directory 连接到 Citrix Cloud。

排查安装问题

本节详细介绍了诊断和修复安装过程中可能遇到的一些问题的方法。有关排查安装问题的更多指导，请参阅Citrix Cloud Connector 故障排除指南。

安装日志

您可以通过首先查阅可用的日志文件来排查安装过程中遇到的问题。

安装过程中发生的事件可在 Windows 事件查看器中查看。您还可以查看 Cloud Connector 安装日志，这些日志位于 %LOCALAPPDATA%\Temp\CitrixLogs\CloudServicesSetup。 安装后，日志也会添加到 %ProgramData%\Citrix\WorkspaceCloud\InstallLogs。

退出代码

根据安装过程的成功或失败，可能会返回以下退出代码：

  • 1603 - 发生意外错误
  • 2 - 先决条件检查失败
  • 0 - 安装成功完成

安装错误

如果您通过双击安装程序来安装 Citrix Cloud Connector 软件，则可能会收到以下错误消息：

Can't reach this page..

即使您以管理员身份登录计算机来安装 Citrix Cloud Connector，也可能发生此错误。为避免此错误，请右键单击安装程序并选择“以管理员身份运行”，以管理员身份运行 Citrix Cloud Connector 软件。

连接失败

为确保 Cloud Connector 可以与 Citrix Cloud 通信，请确认以下 Citrix 服务处于 已启动 状态：

  • Citrix Cloud AD 提供程序
  • Citrix Cloud 代理日志记录器
  • Citrix Cloud 代理系统
  • Citrix Cloud 代理看门狗
  • Citrix Cloud 凭据提供程序
  • Citrix 配置同步器服务
  • Citrix 高可用性服务
  • 思杰 NetScaler® 云网关
  • Citrix 远程代理提供程序
  • Citrix 远程 HCL 服务器
  • Citrix 会话管理器代理

有关这些服务的更多信息，请参阅已安装的服务。

Cloud Connector 高级连接检查工具可以帮助验证 Cloud Connector 是否可以访问 Citrix Cloud 及其相关服务。

有关详细信息，请参阅Cloud Connector 高级连接检查工具。

有关如何解决连接检查失败的更多信息，请参阅 CTX224133: 云连接器连接检查失败。

云连接器安装
August 31, 2026
投稿者: 
C C
August 31, 2026
投稿者: 
C C

在本文中

站点反馈 | Your privacy choices footer link您的隐私选择 | 隐私和法律条款 | Cookie 首选项 | 同意设置 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.