产品文档
Citrix Virtual Apps and Desktops 7 2402 LTSR
查看 PDF

故障排除

May 31, 2026
投稿者: 
C C

要确认 HDX Direct 已成功建立直接连接，您可以使用 VDA 计算机上的 CtxSession.exe 实用程序。

要使用 CtxSession.exe 实用程序，请在会话中启动命令提示符或 PowerShell 并运行 ctxsession.exe -v。如果 HDX Direct 连接成功建立，则 HDX Direct Status 为 Connected。

HDX 直接故障排除

您还可以查看会话主机的事件日志，以了解 HDX™ Direct 连接是成功建立还是失败。有关详细信息，请参阅“事件日志”部分。

注意：

根据环境以及会话主机可用的 IP 地址数量，HDX Direct 连接可能需要长达 5 分钟才能建立。

HDX Direct 未能建立直接连接时

如果 HDX Direct 未能建立直接连接，请查看以下步骤：

  1. 确保正在使用的 VDA 版本和 Workspace 应用程序版本支持该功能，符合系统要求。
  2. 确认已向 VDA 应用了启用 HDX Direct 的策略，并且没有其他优先级更高的策略禁用该功能。
  3. 确认已向 VDA 应用了设置所需 HDX Direct 模式的策略，并且没有其他优先级更高的策略覆盖此配置。
  4. 确保 Citrix ClxMtp 服务正在会话主机上运行。
  5. 确保 Citrix Certificate Manager 服务正在会话主机上运行。如果未运行，请尝试手动启动。如果 HDX Direct 被禁用，该服务将自动停止。
  6. 检查会话主机是否具有其自签名根 CA 证书：
    1. 颁发给: CA-<hostname> (例如，CA-FTLW11-001)
    2. 颁发者: CA-<hostname> (例如，CA-FTLW11-001)
    3. 颁发者详细信息：组织为思杰系统公司。
  7. 检查会话主机是否具有其自签名服务器证书:
    1. Issued to: <host FQDN> (For example, FTLW11-001.ctxlab.net)
    2. 颁发者: CA-<hostname> (例如，CA-FTLW11-001)
    3. 颁发者详细信息：公司名称为 Citrix Systems, Inc.
  8. 如果证书缺失，请联系 Citrix 技术支持。
  9. 如果证书已存在：
    1. 停止会话主机上的 Citrix 证书管理器服务。
    2. 删除自签名根 CA 证书和自签名服务器证书。
    3. 启动会话主机上的 Citrix 证书管理器服务。服务启动后会创建新证书。
  10. 对于内部用户:
    1. 确保会话主机的防火墙未阻止 UDP 443 或 TCP 443 上的入站流量，分别用于 HDX over EDT 和 HDX over TCP。
    2. 确保您的网络防火墙未阻止客户端网络和会话主机网络之间 UDP 443 和 TCP 443 上的流量。
  11. 对于外部用户：
    1. 检查客户端和会话主机的 NAT 类型，并确保该组合按预期工作。有关详细信息，请参阅 NAT 兼容性部分。
    2. 如果 NAT 测试在客户端或会话主机上失败：
      1. 如果系统上运行防火墙，请确保它没有阻止 UDP 3478 上的出站流量。
      2. 确保您的网络防火墙没有阻止 UDP 3478 上的出站流量。
      3. 确保防火墙没有阻止 STUN 服务器的响应。
    3. 确保您的网络防火墙已配置适当的规则以允许所有必要的流量。有关详细信息，请参阅网络要求部分。
    4. 如果您使用 HDX Direct 端口范围策略设置更改了默认端口范围，请确保您的防火墙规则已设置为自定义端口范围。

事件日志

以下事件记录在 VDA 计算机的事件日志中：

日志 ID 源 级别 详细信息
应用程序和服务日志 > Citrix-HostCore-HDX 直接/操作 1 HDX 直接 详细信息 内部用户 <username> 的 HDX Direct 连接已建立。
应用程序和服务日志 > Citrix-HostCore-HDX 直接/运行 2 HDX 直接 详细信息 外部用户 <username> 的 HDX Direct 连接已建立。
应用程序和服务日志 > Citrix-HostCore-HDX 直接/操作 3 HDX 直接 详细信息 用户 <username> 的 HDX Direct 连接失败。

已知问题

在已启用 HDX Direct 的计算机上执行 VDA 就地升级后，HDX Direct 可能会停止工作。 要解决此问题，请完成以下步骤：

  1. 停止会话主机上的 Citrix 证书管理器服务。
  2. 删除自签名根 CA 证书和自签名服务器证书。
  3. 打开注册表。
  4. 删除 HKLM\Software\Citrix\HDX-Direct 项。
  5. 转到 HKLM\SYSTEM\CurrentControlSet\Control\TerminalServer\Wds\icawd。
  6. 请将 SSLEnabled 的数值设定为 0。
  7. 删除 SSLThumbprint 值中的所有内容。
  8. 启动 Citrix 证书管理器服务。
故障排除
May 31, 2026
投稿者: 
C C
May 31, 2026
投稿者: 
C C

在本文中

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