トラブルシューティング

最終公開日 : 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/2503/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 Service がセッションホストで実行されていることを確認します。
  5. Citrix Certificate Manager Service がセッションホストで実行されていることを確認します。実行されていない場合は、手動で開始してみてください。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テクニカルサポートにお問い合わせください。
  9. 証明書が存在する場合:
    1. セッションホストでCitrix Certificate Managerサービスを停止します。
    2. 自己署名ルートCA証明書と自己署名サーバー証明書の両方を削除します。
    3. セッションホストでCitrix Certificate Managerサービスを開始します。サービスは開始されると新しい証明書を作成します。
  10. 内部ユーザーの場合:
    1. セッションホストのファイアウォールが、HDX over EDTの場合はUDP 443、HDX over TCPの場合は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/操作 1 HDX ダイレクト 情報 内部ユーザー <username> のHDX Direct接続が確立されました。
アプリケーションとサービスログ > Citrix-HostCore-HDX Direct/操作 2 HDX ダイレクト 情報 外部ユーザー <username> のHDX Direct接続が確立されました。
アプリケーションとサービスログ > Citrix-HostCore-HDX Direct/操作 3 HDX ダイレクト 情報 ユーザー <username> のHDX Direct接続に失敗しました。

既知の問題

  • Rendezvousが無効になっている場合、Gateway Service を使用するWorkspace環境では、外部ユーザー向けのHDX Directが失敗する可能性があります。この問題を解決するには、Rendezvous が有効になっていることを確認してください。
  • 既に HDX Direct が有効になっているマシンで VDA のインプレースアップグレードを実行した後、HDX Direct が動作しなくなる可能性があります。この問題を解決するには、次の手順を実行します。
    1. セッションホスト上でCitrix Certificate Managerサービスを停止します。
    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サービスを開始します。