故障排除

Last published : Nov 13, 2026
要确认 HDX Direct 已成功建立直接连接,您可以使用 VDA 计算机上的 CtxSession.exe 实用程序。
要使用 CtxSession.exe 实用程序,请在会话中启动命令提示符或 PowerShell 并运行 ctxsession.exe -v。如果 HDX Direct 连接成功建立,则 HDX Direct Status 为 Connected。
HDX Direct 故障排除(/en-us/citrix-virtual-apps-desktops/current-release/media/hdx-direct-troubleshooting.png)

<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/hdx-transport/hdx-direct-troubleshooting.md 您还可以查看会话主机的事件日志,以了解 HDX™ Direct 连接是成功建立还是失败。有关详细信息,请参阅“事件日志”部分。

您还可以查看会话主机的事件日志,了解 HDX™ Direct 连接是成功建立还是失败。有关详细信息,请参阅“事件日志”部分。
注意:
根据环境以及会话主机可用的 IP 地址数量,HDX Direct 连接可能需要长达 5 分钟才能建立。

当 HDX Direct 无法建立直接连接时

如果 HDX Direct 无法建立直接连接,请查看以下步骤:
  1. 确保所使用的 VDA 版本和 Workspace 应用程序版本根据系统要求支持该功能。 <<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/hdx-transport/hdx-direct-troubleshooting.md
  2. 确认您已将启用 HDX Direct 的策略应用于 VDA,并且没有其他优先级更高的策略禁用此功能。
  3. 确认您已将设置所需 HDX Direct 模式的策略应用于 VDA,并且没有其他优先级更高的策略覆盖此配置。
  4. 确保 Citrix ClxMtp Service 正在会话主机上运行。
  5. 确保 Citrix Certificate Manager Service 正在会话主机上运行。如果未运行,请尝试手动启动。如果 HDX Direct 被禁用,该服务将自动停止。
  6. 检查会话主机是否具有其自签名根 CA 证书:

事件日志

以下事件记录在 VDA 计算机的事件日志中:
日志 ID 源 级别 描述
应用程序和服务日志 > Citrix-HostCore-HDX Direct/Operational 1 HDX 直接 信息 已建立内部用户 <username> 的 HDX Direct 连接。
应用程序和服务日志 > Citrix-HostCore-HDX Direct/Operational 2 HDX 直接 信息 已建立外部用户 <username> 的 HDX Direct 连接。
应用程序和服务日志 > Citrix-HostCore-HDX Direct/Operational 3 HDX 直接 信息 用户 <username> 的 HDX Direct 连接失败。
应用程序和服务日志 > Citrix-HostCore-HDX Direct/Operational 4 HDX 直接 信息 STUN 服务器 <URL:PORT> 为用户 <username> 提供了以下会话主机 IP 和端口映射:<IP>:<PORT>。
应用程序和服务日志 > Citrix-HostCore-HDX Direct/Operational 5 HDX 直接 信息 会话主机未从为用户 <username> 配置的任何 STUN 服务器接收到响应。
应用程序和服务日志 > Citrix-HostCore-HDX Direct/Operational 4 HDX 直接 信息 STUN 服务器 <URL:PORT> 为用户 <username> 提供了以下会话主机 IP 和端口映射: <IP>:<PORT>。
应用程序和服务日志 > Citrix-HostCore-HDX Direct/Operational 5 HDX 直接 信息 会话主机未收到来自任何已配置的 STUN 服务器针对用户 <username> 的响应。
应用程序和服务日志 > Citrix-HostCore-HDX Direct/Operational 6 HDX 直接 信息 客户端为用户 <username> 提供了 <IP>:<PORT> 作为外部映射。
应用程序和服务日志 > Citrix-HostCore-HDX Direct/Operational 7 HDX 直接 信息 客户端未为用户 <username> 提供外部映射。

已知问题

<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/hdx-transport/hdx-direct-troubleshooting.md
  • 如果 Rendezvous 被禁用,外部用户的 HDX Direct 可能会在使用 Workspace with Gateway Service 的环境中失败。要解决此问题,请确保 Rendezvous 已启用。

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