トラブルシューティング

最終公開日 : 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/2607-ltsr/media/hdx-direct-troubleshooting.png)
セッションホストのイベントログで、HDX™ Direct接続が正常に確立されたか、または失敗したかに関する情報を確認することもできます。詳細については、「イベントログ」セクションを参照してください。
注:
環境およびセッションホストで利用可能なIPアドレスの数によっては、HDX Direct接続が確立されるまでに最大5分かかる場合があります。

HDX Directが直接接続を確立できない場合

HDX Directが直接接続を確立できない場合は、次の手順を確認してください。
  1. 使用中のVDAバージョンとWorkspaceアプリバージョンが、システム要件に従ってこの機能をサポートしていることを確認してください。
  2. HDX Directを有効にするポリシーがVDAに適用されており、この機能を無効にする優先度の高い他のポリシーがないことを確認してください。
  3. 目的のHDX Directモードを設定するポリシーがVDAに適用されており、構成を上書きする優先度の高い他のポリシーがないことを確認してください。
  4. Citrix ClxMtpサービスがセッションホストで実行されていることを確認してください。
  5. Citrix Certificate Managerサービスがセッションホストで実行されていることを確認してください。実行されていない場合は、手動で開始してみてください。HDX Directが無効になっている場合、サービスは自動的に停止します。
  6. セッションホストに自己署名ルートCA証明書があるか確認してください。
    1. 発行先: CA-Citrix-Certificate-Manager
    2. 発行元: CA-Citrix-Certificate-Manager
    3. 発行者情報: 組織はCitrix Systems, Inc.です。
  7. セッションホストに自己署名サーバー証明書があるか確認します。
    1. 発行先: <host FQDN> (例: FTLW11-001.ctxlab.net)
    2. 発行元: CA-Citrix-Certificate-Manager
    3. 発行者情報: 組織はCitrix Systems, Inc.です。
  8. 証明書がない場合は、Citrix Tech Supportに連絡してください。
  9. 証明書がある場合:
    1. セッションホストでCitrix Certificate Manager Serviceを停止します。
    2. 自己署名ルートCA証明書と自己署名サーバー証明書の両方を削除します。
    3. セッションホストでCitrix Certificate Manager Serviceを開始します。サービスは開始すると新しい証明書を作成します。
  10. 内部ユーザーの場合:
    1. セッションホストのファイアウォールが、HDX over EDTおよびHDX over TCPの場合に、それぞれUDP 443またはTCP 443でのインバウンドトラフィックをブロックしていないことを確認してください。
    2. ネットワークファイアウォールが、クライアントのネットワークとセッションホストのネットワーク間でUDP 443およびTCP 443のトラフィックをブロックしていないことを確認してください。
  11. 外部ユーザーの場合:
    1. セッションホストにSTUNサーバーのリストが含まれていることを確認してください:
      • キー: HKLM\SOFTWARE\Citrix\HDX-Direct
      • 値の型: REG_MULTI_SZ
      • 値名: STUNServers
      • データ: stun.cloud.com:3478 stun.cloudflare.com:3478 stun.l.google.com:19302
    2. クライアントとセッションホストのNATタイプを確認し、その組み合わせが正常に機能することを確認してください。詳細については、「NAT互換性」セクションを参照してください。
    3. クライアントまたはセッションホストのいずれかでNATテストが失敗した場合:
      1. システムでファイアウォールが実行されている場合、UDP 3478での送信トラフィックをブロックしていないことを確認してください。
      2. ネットワークファイアウォールがUDP 3478での送信トラフィックをブロックしていないことを確認してください。
      3. ファイアウォールがSTUNサーバーからの応答をブロックしていないことを確認してください。
    4. ネットワークファイアウォールに、必要なすべてのトラフィックを許可するための適切なルールが構成されていることを確認してください。詳細については、「ネットワーク要件」セクションを参照してください。
    5. HDX Directポート範囲ポリシー設定を使用してデフォルトのポート範囲を変更した場合、ファイアウォールルールがカスタムポート範囲に設定されていることを確認してください。

イベントログ

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 6 HDX ダイレクト 情報 クライアントはユーザー <username> の外部マッピングとして <IP>:<PORT> を提供しました。
アプリケーションとサービスログ > Citrix-HostCore-HDX Direct/Operational 7 HDX ダイレクト 情報 クライアントからユーザー <username> の外部マッピングは提供されませんでした。

既知の問題

  • Rendezvousが無効になっている場合、Gateway Serviceを使用するWorkspace環境では、外部ユーザー向けのHDX Directが失敗する可能性があります。この問題を解決するには、Rendezvous が有効になっていることを確認してください。
  • HDX Direct がすでに有効になっているマシンでVDAのインプレースアップグレードを実行した後、HDX Direct が動作しなくなることがあります。この問題を解決するには、次の手順を実行します。
    1. セッションホストでCitrix Certificate Manager Serviceを停止します。
    2. 自己署名ルートCA証明書と自己署名サーバー証明書を削除します。
    3. レジストリを開きます。
    4. HKLM\Software\Citrix\HDX-Direct キーを削除します。
    5. HKLM\SYSTEM\CurrentControlSet\Control\TerminalServer\Wds\icawdにアクセスします。
    6. SSLEnabled の値を 0 に設定します。
    7. SSLThumbprint の値の内容を削除します。
    8. Citrix Certificate Manager Service を開始します。