VDA 与 Delivery Controller™ 之间的 WebSocket 通信

Last published : Nov 13, 2026
本文介绍如何设置 WebSocket 连接，用于 VDA 与 Delivery Controller 之间的通信。
Related information
安全

概述

WebSocket 协议通过 Citrix Brokering Protocol 运行，并促进 Delivery Controller 与 VDA 之间的稳定通信。 使用 WebSocket 协议进行通信具有以下优势：
  • VDA 到 Delivery Controller 的通信仅需要 TLS 端口 443。
  • 在 VDA 与 Delivery Controller 之间提供无缝可靠的通信通道。

工作原理

以下部分介绍 Delivery Controller 与 VDA 之间 WebSocket 连接的工作流：
  1. Citrix Virtual Apps and Desktops™ 管理员通过使用 Machine Creation Service (MCS) 预配 VDA 来启动此过程。
  2. 在 MCS 预配过程中，MCS 为每个 VDA 生成公钥-私钥对，并将公钥注册到 Delivery Controller 上的 FMA 信任服务。MCS 将公钥-私钥对作为文件保存在 VDA 上的身份磁盘下。
  3. 当 VDA 计算机启动时，安装在 VDA 计算机上的 MCS 代理从身份磁盘读取密钥对，并将此信息写入 VDA 注册表位置。
  4. 安装在 VDA 上的代理从注册表读取密钥对，并向 Delivery Controller 生成一个启用 SSL 的 WebSocket 请求，其中服务密钥由私钥签名。
  5. Delivery Controller 使用来自 FMA 信任服务的公钥验证签名的服务密钥授权标头。
  6. 验证完成后，系统在 VDA 与 Delivery Controller 之间建立 WebSocket 连接。

对加入 AD 的 VDA 的 WebSocket 支持

开始之前

  1. 配置您的站点。有关详细信息，请参阅 创建站点。
  2. 在 Delivery Controller 上安装 TLS 证书。有关详细信息，请参阅 在 Controller 上安装 TLS 服务器证书。
  3. 在 VDA 上安装根 CA 和中间 CA 以信任 Delivery Controller。

过程

按照说明设置 WebSocket 连接：
  1. 在 Delivery Controller 上启用 WebSocket 连接。在站点中的每个 Delivery Controller 上运行以下命令：
    New-ItemProperty "HKLM:\SOFTWARE\Citrix\DesktopServer\WorkerProxy" -Name "WebSocket_Enabled" -PropertyType "DWord" -Value 1 -Force
    注意：
    确保在启用 WebSocket 后重新启动 Delivery Controller。
  2. 为使用 MCS 预配的已加入 AD 的 VDA 创建计算机目录。有关详细信息，请参阅创建计算机目录。
  3. 创建交付组并将 VDA 添加到其中。有关详细信息，请参阅创建交付组。
  4. 在 VDA 上启用 WebSocket 连接。在 VDA 上运行以下命令：
    New-ItemProperty "HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\CitrixBrokerAgent\WebSocket" -Name "Enabled" -PropertyType "DWord" -Value 1 -Force
    • 要检查 VDA 是否通过 WebSocket 连接到服务器，请检查以下注册表项值。
      密钥：
      HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\CitrixBrokerAgent\WebSocket
      名称：Connected
      类型：REG_DWORD
      值：1 或 0
      1：VDA 使用 WebSocket 连接到服务器。
      0：VDA 无法通过 WebSocket 连接到服务器，或者未启用 WebSocket。
    • 要检查是否已启用 WebSocket，请检查以下注册表项值。Enabled 的值必须为 1。
      键：
      HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\CitrixBrokerAgent\WebSocket
      名称：Connected
      类型：REG_DWORD
      值：1 或 0
      1：VDA 使用 WebSocket 连接到服务器。
      0：VDA 无法通过 WebSocket 连接到服务器，或者未启用 WebSocket。
    • 要检查是否已启用 WebSocket，请检查以下注册表项值。Enabled 的值必须为 1。
      键：
      HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\CitrixBrokerAgent\WebSocket
      名称：Enabled
      类型：REG_DWORD
      值：1