USBリダイレクトの構成

最終公開日 : Nov 13, 2026
USBデバイスは、Citrix Receiver™とLinux VDAデスクトップ間で共有されます。USBデバイスがデスクトップにリダイレクトされると、ユーザーはそのUSBデバイスをローカルに接続されているかのように使用できます。
USBリダイレクトには、主に3つの機能領域があります。
  • オープンソースプロジェクトの実装 (VHCI)
  • VHCIサービス
  • USBサービス
オープンソースVHCI:
USBリダイレクト機能のこの部分は、IPネットワークを介した汎用USBデバイス共有システムを開発します。これは、Linuxカーネルドライバーと、カーネルドライバーと通信してすべてのUSBデータを取得できるユーザーモードライブラリで構成されています。Linux VDAの実装では、CitrixはVHCIのカーネルドライバーを再利用します。ただし、Linux VDAとCitrix Receiver間のすべてのUSBデータ転送は、Citrix ICA®プロトコルパッケージにカプセル化されます。
VHCIサービス:
VHCIサービスは、VHCIカーネルモジュールと通信するためにCitrixが提供するオープンソースサービスです。このサービスは、VHCIとCitrix USBサービス間のゲートウェイとして機能します。
USBサービス:
USBサービスは、USBデバイス上のすべての仮想化とデータ転送を管理するCitrixモジュールを表します。

USBリダイレクトの仕組み

通常、USBデバイスがLinux VDAに正常にリダイレクトされると、システム /dev パスに1つ以上のデバイスノードが作成されます。ただし、リダイレクトされたデバイスがアクティブなLinux VDAセッションで使用できない場合があります。USBデバイスは正常に機能するためにドライバーに依存しており、一部のデバイスは特別なドライバーを必要とします。ドライバーが提供されていない場合、リダイレクトされたUSBデバイスはアクティブなLinux VDAセッションからアクセスできません。USBデバイスの接続を確保するには、ドライバーをインストールし、システムを適切に構成してください。
Linux VDAは、クライアントとの間で正常にリダイレクトされるUSBデバイスのリストをサポートしています。さらに、デバイス、特にUSBディスクは適切にマウントされ、ユーザーは追加の構成なしでディスクにアクセスできます。

サポートされているUSBデバイス

以下のデバイスは、このバージョンのLinux VDAをサポートすることが確認されています。その他のデバイスも自由に使用できますが、予期しない結果が生じる可能性があります。
注:
Linux VDAはUSB 2.0プロトコルのみをサポートします。
USB大容量記憶装置 VID:PID ファイルシステム
ネタック テクノロジー株式会社 0dd8:173c FAT32
キングストン データトラベラー 101 II 0951:1625 FAT32
キングストン データトラベラー GT101 G2 1567:8902 FAT32
SanDisk SDCZ80 フラッシュドライブ 0781:5580 FAT32
WD HDD 1058:10B8 FAT32
USB 3Dマウス VID:PID
3Dコネクション スペースマウス プロ 046d: c62b
USBスキャナー VID:PID
エプソン パーフェクション V330 フォト 04B8: 0142

USBリダイレクトの構成

Citrixポリシーは、USBデバイスリダイレクトが有効か無効かを制御します。さらに、デバイスの種類はDelivery Controller™ポリシーを使用して指定することもできます。Linux VDAのUSBリダイレクトを構成する場合は、次のポリシーとルールを構成します。
  • クライアントUSBデバイスリダイレクトポリシー
  • クライアントUSBデバイスリダイレクト規則

USBリダイレクトポリシーを有効にする

Citrix Studioで、クライアントとの間でUSBデバイスリダイレクトを有効(または無効)にします(ワークステーションホストのみ)。
設定の編集ダイアログで、次のようにします。
  1. 許可を選択します。
  2. OKをクリックします。
USBリダイレクトを有効にするイメージ

USBリダイレクト規則を設定する

USBリダイレクトポリシーを有効にした後、Citrix Studioを使用して、Linux VDAで許可(または拒否)されるデバイスを指定することで、リダイレクト規則を設定します。
クライアントUSBデバイスリダイレクト規則ダイアログで、次のようにします。
  1. リダイレクト規則を追加するには新規をクリックし、既存の規則を確認するには編集をクリックします。
  2. 規則を作成(または編集)した後、OKをクリックします。
クライアントUSBリダイレクト規則の設定

VHCIカーネルモジュールをビルドする

USBリダイレクトは、VHCIカーネルモジュール(usb-vhci-hcd.koおよびusb-vhci-iocif.ko)に依存します。これらのモジュールはLinux VDAディストリビューションの一部(RPMパッケージの一部)です。これらは公式のLinuxディストリビューションカーネルに基づいてコンパイルされ、次の表に示されています。
サポートされているLinuxディストリビューション カーネルバージョン
RHEL 7.3 3.10.0-514.el7.x86_64
RHEL 6.6 2.6.32-504.el6.x86_64
SUSE 12.2 4.4.49-92.11-デフォルト
SUSE 11.4 3.0.101-0.47.55-デフォルト
ウブントゥ 16.04 4.4.0-45-ジェネリック
重要:
お使いのマシンのカーネルがCitrixがLinux VDA用に構築したドライバーと互換性がない場合、USBサービスが起動に失敗することがあります。この場合、独自のVHCIカーネルモジュールを構築した場合にのみ、USBリダイレクト機能を使用できます。

カーネルがCitrixによって構築されたモジュールと一致しているかを確認する

コマンドラインで、次のコマンドを実行してカーネルの一貫性を確認します。
insmod /opt/Citrix/VDA/lib64/usb-vhci-hcd.ko
コマンドが正常に実行された場合、カーネルモジュールは正常にロードされており、バージョンはCitrixによってインストールされたものと一致しています。
コマンドがエラーで実行された場合、カーネルはCitrixモジュールと整合性が取れていないため、再構築する必要があります。

VHCIカーネルモジュールを再構築する

カーネルモジュールがCitrixバージョンと整合性がない場合は、次の手順を実行します。
  1. CitrixダウンロードサイトからLVDAソースコードをダウンロードします。「Linux Virtual Delivery Agent (sources)」セクションに含まれるファイルを選択します。
  2. citrix-linux-vda-sources.zipファイルからファイルを復元します。VHCIソースファイルはlinux-vda-souces/vhci-hcd-1.15.tar.bz2にあります。VHCIファイルはtar xvf vhci-hcd-1.15.tar.bz2を使用して復元できます。
  3. ヘッダーファイルとModule.symversファイルに基づいてカーネルモジュールをビルドします。適切なLinuxディストリビューションに基づいてカーネルヘッダーファイルをインストールし、Module.symversを作成するには、次の手順を使用します。
    RHEL 7.3/RHEL 6.9/RHEL 6.6:
    yum install kernel-devel
    SUSE 12.2:
    zypper install kernel-devel

    zypper install kernel-source
    SUSE 11.4:
    zypper install kernel-source
    ウブントゥ 16.04:
    apt-get install linux-headers
    ヒント:
    インストールが成功すると、次のようなカーネルフォルダーが作成されます。
    /usr/src/kernels/3.10.0-327.10.1.el7.x86\_64
  4. /usr/src/kernels/3.10.0-327.10.1.el7.x86\_64フォルダーで、Module.symversファイルが存在することを確認します。このファイルがフォルダーにない場合は、カーネルをビルドしてこのファイルを取得するか(例: make oldconfig; make prepare; make modules; make)、**/usr/src/kernels/3.10.0-327.10.1.el7.x86\_64-obj/x86\_64/defaults/module.***からコピーします。
  5. vhci-hcd-1.15/Makefileファイルで、VCHIのMakefileを変更し、KDIRをカーネルディレクトリに設定します。
    #KDIR = $(BUILD_PREFIX)/lib/modules/$(KVERSION)/build

    KDIR = /usr/src/kernels/3.10.0-327.10.1.el7.x86_64
  6. フォルダー**vhci-hcd-1.15/**で、makeを実行してVHCIカーネルをビルドします。
    注:
    ビルドが成功した場合、usb-vhci-hcd.ko と usb-vhci-iocifc.ko は vhci-hcd-1.15/ フォルダーに作成されます。
  7. カーネルモジュールを新しくビルドしたものに置き換えます: cp -f usb-vhci-*.ko /opt/Citrix/VDA/lib64/
  8. USBサービスを再起動します: service ctxusbsd restart
  9. セッションからログオフし、再度ログオンします。USBリダイレクトが機能しているか確認します。

USBリダイレクトの問題のトラブルシューティング

このセクションの情報を使用して、Linux VDAの使用時に発生する可能性のあるさまざまな問題のトラブルシューティングを行います。

リダイレクトされたUSBディスクをアンマウントできない

Citrix ReceiverからリダイレクトされたすべてのUSBディスクのアクセス制御のため、Linux VDAは、所有者のみがリダイレクトされたデバイスにアクセスできるように、これらすべてのデバイスを管理者権限で管理します。その結果、ユーザーは管理者権限なしではデバイスをアンマウントできません。
デバイスをアンマウントできないイメージ

USBディスクのリダイレクトを停止するとファイルが失われる

USBディスクをセッションにリダイレクトし、それを変更しようとした場合(たとえば、ディスク上にいくつかのファイルを作成する)、その後Citrix Receiverのツールバーを使用してすぐにリダイレクトを停止すると、変更または作成したファイルが失われる可能性があります。この問題は、ファイルシステムにデータを書き込む際に、システムがファイルシステム内のメモリキャッシュをマウントするため発生します。データはディスク自体には書き込まれません。Citrix Receiverのツールバーを使用してリダイレクトを停止すると、データがディスクにフラッシュされる時間がなくなり、データが失われます。この問題を解決するには、USBリダイレクトを停止する前に、ターミナルでsyncコマンドを使用してデータをディスクにフラッシュします。
USBディスクのリダイレクトを停止するとファイルが失われるイメージ

Citrix Receiverのツールバーにデバイスがない

Citrix Receiverのツールバーにデバイスが表示されないことがあり、これはUSBリダイレクトが行われていないことを示します。この問題が発生した場合は、以下を確認してください。
  • USBリダイレクトを許可するようにポリシーが構成されている
  • カーネルモジュールはカーネルと互換性があります
受信側ツールバーのデバイスタブの画像(/en-us/linux-virtual-delivery-agent/7-15-ltsr/media/client-usb-redirection-troubleshoot.png)
注:
デバイスタブは、Citrix Receiver for Linuxでは利用できません。

Citrix ReceiverのツールバーにUSBデバイスが表示されるが、「ポリシー制限」と表示されている場合の、リダイレクトの失敗

この問題は、デバイスのポリシー構成が原因で発生します。このような場合は、次の手順を実行します。
  • リダイレクトを有効にするようにLinux VDAポリシーを構成します
  • Citrix Receiverのレジストリに追加のポリシー制限が構成されていないか確認します。デバイスはCitrix Receiverのレジストリ設定によってブロックされている可能性があります。レジストリパスのDeviceRulesを確認して、この設定によってデバイスへのアクセスが拒否されていないことを確認します。
    HKEY\_LOCAL\_MACHINE\\SOFTWARE\\Wow6432Node\\Citrix\\ICA Client\\GenericUSB

USBデバイスは正常にリダイレクトされますが、セッションで使用できません

通常、サポートされているUSBデバイスのみがリダイレクトできます。ただし、場合によっては、他の種類のデバイスがアクティブなLinux VDAセッションにリダイレクトされることがあります。このような状況では、リダイレクトされたすべてのデバイスに対して、ユーザーが所有するノードがシステム**/dev**パスに作成されます。ただし、ユーザーがデバイスを正常に使用できるかどうかは、ドライバーと構成によって決まります。所有されている(接続されている)がアクセスできないデバイスが見つかった場合は、そのデバイスを無制限のポリシーに追加してください。
注:
USBドライブの場合、Linux VDAはディスクを構成してマウントします。ユーザー(およびそれをインストールした所有者のみ)は、追加の構成なしでディスクにアクセスできます。これは、サポートされているデバイスリストにないデバイスには当てはまらない場合があります。