Configurar la redirección USB

Last published : Nov 13, 2026
Los dispositivos USB se comparten entre Citrix Receiver™ y el escritorio de Linux VDA. Cuando un dispositivo USB se redirige al escritorio, el usuario puede usar el dispositivo USB como si estuviera conectado localmente.
La redirección USB incluye tres áreas principales de funcionalidad:
  • Implementación de proyecto de código abierto (VHCI)
  • Servicio VHCI
  • Servicio USB
VHCI de código abierto:
Esta parte de la función de redirección USB desarrolla un sistema general de uso compartido de dispositivos USB a través de una red IP. Consta de un controlador de kernel de Linux y algunas bibliotecas en modo de usuario que permiten comunicarse con el controlador de kernel para obtener todos los datos USB. En la implementación de Linux VDA, Citrix reutiliza el controlador de kernel de VHCI. Sin embargo, todas las transferencias de datos USB entre Linux VDA y Citrix Receiver se encapsulan en el paquete de protocolo Citrix ICA®.
Servicio VHCI:
El servicio VHCI es un servicio de código abierto proporcionado por Citrix para comunicarse con el módulo de kernel VHCI. Este servicio funciona como una puerta de enlace entre VHCI y el servicio USB de Citrix.
Servicio USB:
El servicio USB representa un módulo de Citrix que gestiona toda la virtualización y las transferencias de datos en el dispositivo USB.

Cómo funciona la redirección USB

Normalmente, si un dispositivo USB se redirige correctamente al Linux VDA, se crean uno o más nodos de dispositivo en la ruta /dev del sistema. Sin embargo, a veces el dispositivo redirigido no se puede usar en una sesión activa de Linux VDA. Los dispositivos USB dependen de los controladores para funcionar correctamente y algunos dispositivos requieren controladores especiales. Si no se proporcionan controladores, los dispositivos USB redirigidos son inaccesibles para la sesión activa de Linux VDA. Para garantizar la conectividad del dispositivo USB, instale los controladores y configure el sistema correctamente.
El Linux VDA admite una lista de dispositivos USB que se redirigen correctamente hacia y desde el cliente. Además, el dispositivo se monta correctamente, especialmente el disco USB, lo que permite al usuario acceder al disco sin ninguna configuración adicional.

Dispositivos USB compatibles

Se ha verificado que los siguientes dispositivos son compatibles con esta versión de Linux VDA. Otros dispositivos se pueden usar libremente, pero pueden producir resultados inesperados:
Nota:
El Linux VDA solo admite protocolos USB 2.0.
Dispositivo de almacenamiento masivo USB VID:PID Sistema de archivos
Netac Technology Co., Ltd 0dd8:173c FAT32
Kingston Datatraveler 101 II 0951:1625 FAT32
Kingston Datatraveler GT101 G2 1567:8902 FAT32
Unidad flash SanDisk SDCZ80 0781:5580 FAT32
WD HDD 1058:10B8 FAT32
Ratón USB 3D VID:PID
3DConnexion SpaceMouse Pro 046d: c62b
Escáner USB VID:PID
Epson Perfection V330 foto 04B8: 0142

Configurar la redirección USB

Una directiva de Citrix controla si la redirección de dispositivos USB está habilitada o deshabilitada. Además, el tipo de dispositivo también se puede especificar mediante una directiva de Delivery Controller™. Al configurar la redirección USB para el VDA de Linux, configure la siguiente directiva y reglas:
  • Política de redirección de dispositivos USB de cliente
  • Reglas de redirección de dispositivos USB de cliente

Habilitar la política de redirección USB

En Citrix Studio, habilite (o deshabilite) la redirección de dispositivos USB hacia y desde el cliente (solo para hosts de estación de trabajo).
En el cuadro de diálogo Editar configuración:
  1. Seleccione Permitido.
  2. Haga clic en Aceptar.
Imagen de habilitación de la redirección USB

Establecer reglas de redirección USB

Después de habilitar la política de redirección USB, establezca las reglas de redirección mediante Citrix Studio especificando qué dispositivos están permitidos (o denegados) en el VDA de Linux.
En el cuadro de diálogo Reglas de redirección de dispositivos USB de cliente:
  1. Haga clic en Nuevo para agregar una regla de redirección, o haga clic en Editar para revisar una regla existente.
  2. Después de crear (o editar) una regla, haga clic en Aceptar.
Configuración de la regla de redirección USB de cliente

Compilar el módulo del kernel VHCI

La redirección USB depende de los módulos del kernel VHCI (usb-vhci-hcd.ko y usb-vhci-iocif.ko). Estos módulos forman parte de la distribución de Linux VDA (como parte del paquete RPM). Se compilan basándose en los kernels oficiales de las distribuciones de Linux y se indican en la siguiente tabla:
Distribución de Linux compatible Versión del kernel
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-default
SUSE 11.4 3.0.101-0.47.55-default
Ubuntu 16.04 4.4.0-45-generic
Importante:
Si el kernel de su máquina no es compatible con el controlador creado por Citrix para el VDA de Linux, es posible que el servicio USB no se inicie. En este caso, solo puede usar la función de redirección USB si crea sus propios módulos del kernel VHCI.

verificar si su kernel es compatible con los módulos creados por Citrix

En la línea de comandos, ejecute el siguiente comando para verificar si el kernel es compatible:
insmod /opt/Citrix/VDA/lib64/usb-vhci-hcd.ko
Si el comando se ejecuta correctamente, el módulo del kernel se ha cargado correctamente y la versión es compatible con la instalada por Citrix.
Si el comando se ejecuta con errores, el kernel es inconsistente con el módulo de Citrix y debe reconstruirse.

Reconstruir el módulo del kernel VHCI

Si el módulo del kernel es inconsistente con la versión de Citrix, haga lo siguiente:
  1. Descargue el código fuente de LVDA del sitio de descargas de Citrix. Seleccione el archivo contenido en la sección "Linux Virtual Delivery Agent (sources)".
  2. Restaure los archivos del archivo citrix-linux-vda-sources.zip; puede obtener los archivos fuente de VHCI en linux-vda-souces/vhci-hcd-1.15.tar.bz2; puede restaurar los archivos VHCI usando tar xvf vhci-hcd-1.15.tar.bz2.
  3. Compile el módulo del kernel basándose en los archivos de encabezado y el archivo Module.symvers. Siga estos pasos para instalar los archivos de encabezado del kernel y crear Module.symvers según la distribución de Linux adecuada:
    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
    Ubuntu 16.04:
    apt-get install linux-headers
    Sugerencia:
    Si la instalación se realiza correctamente, habrá una carpeta del kernel similar a:
    /usr/src/kernels/3.10.0-327.10.1.el7.x86\_64
  4. En la carpeta /usr/src/kernels/3.10.0-327.10.1.el7.x86\_64, verificar que el archivo Module.symvers esté presente. Si este archivo no se encuentra en la carpeta, compile el kernel para obtenerlo (por ejemplo, make oldconfig; make prepare; make modules; make) o cópielo de /usr/src/kernels/3.10.0-327.10.1.el7.x86\_64-obj/x86\_64/defaults/module.*
  5. En el archivo vhci-hcd-1.15/Makefile, cambie el Makefile de VCHI y establezca KDIR en el directorio del kernel:
    #KDIR = $(BUILD_PREFIX)/lib/modules/$(KVERSION)/build

    KDIR = /usr/src/kernels/3.10.0-327.10.1.el7.x86_64
  6. En la carpeta vhci-hcd-1.15/, ejecute make para compilar el kernel VHCI.
    Nota:
    Si la compilación se realizó correctamente, se crean usb-vhci-hcd.ko y usb-vhci-iocifc.ko en la carpeta vhci-hcd-1.15/.
  7. Reemplace el módulo del kernel por el recién compilado: cp -f usb-vhci-*.ko /opt/Citrix/VDA/lib64/
  8. Reinicie el servicio USB: service ctxusbsd restart
  9. Cierre la sesión y vuelva a iniciarla. Compruebe si la redirección USB funciona.

Solucionar problemas de redirección USB

Utilice la información de esta sección para solucionar varios problemas que pueden surgir al usar Linux VDA.

No se puede desmontar el disco USB redirigido

Para el control de acceso de todos los discos USB redirigidos desde Citrix Receiver, Linux VDA administra todos estos dispositivos con privilegios administrativos para garantizar que solo el propietario pueda acceder al dispositivo redirigido. Como resultado, el usuario no puede desmontar el dispositivo sin privilegios administrativos.
Imagen de que no se puede desmontar un dispositivo

Archivo perdido al dejar de redirigir un disco USB

Si redirige un disco USB a una sesión e intenta modificarlo (por ejemplo, crear algunos archivos en el disco) y, a continuación, deja de redirigirlo inmediatamente mediante la barra de herramientas de Citrix Receiver, el archivo modificado o creado puede perderse. Este problema se produce porque, al escribir datos en un sistema de archivos, el sistema monta la caché de memoria en el sistema de archivos. Los datos no se escriben en el disco. Si deja de redirigir mediante la barra de herramientas de Citrix Receiver, no queda tiempo para que los datos se vacíen en el disco, lo que provoca la pérdida de datos. Para resolver este problema, utilice el comando sync en un terminal para vaciar los datos en el disco antes de detener la redirección USB.
imagen de archivo perdido al dejar de redirigir un disco USB

No hay dispositivos en la barra de herramientas de Citrix Receiver

A veces, es posible que no vea los dispositivos enumerados en la barra de herramientas de Citrix Receiver, lo que indica que no se está realizando ninguna redirección USB. Si encuentra este problema, verificar lo siguiente:
  • La directiva está configurada para permitir la redirección USB
  • El módulo del kernel es compatible con su kernel
Imagen de la ficha Dispositivos en la barra de herramientas del receptor
Nota:
La ficha Dispositivos no está disponible en Citrix Receiver para Linux.

Redirección fallida cuando los dispositivos USB se ven en la barra de herramientas de Citrix Receiver, pero están etiquetados como restringidos por política

Este problema se produce debido a la configuración de la política del dispositivo. En tales casos:
  • Configure la política de Linux VDA para habilitar la redirección
  • Compruebe si hay restricciones de política adicionales configuradas en el registro de Citrix Receiver. Un dispositivo podría estar bloqueado por la configuración del registro de Citrix Receiver. Compruebe DeviceRules en la ruta del registro para asegurarse de que este ajuste no deniegue el acceso al dispositivo:
    HKEY\_LOCAL\_MACHINE\\SOFTWARE\\Wow6432Node\\Citrix\\ICA Client\\GenericUSB

Un dispositivo USB se redirige correctamente, pero no puedo usarlo en mi sesión

Normalmente, solo se pueden redirigir dispositivos USB compatibles. Sin embargo, a veces, otros tipos de dispositivos pueden redirigirse a una sesión activa de Linux VDA. En estas situaciones, para cada dispositivo redirigido, se crea un nodo propiedad del usuario en la ruta /dev del sistema. Sin embargo, son los controladores y la configuración los que determinan si el usuario puede usar el dispositivo correctamente. Si encuentra un dispositivo que es de su propiedad (conectado) pero inaccesible, añada el dispositivo a una política sin restricciones.
Nota:
En el caso de las unidades USB, el VDA de Linux configura y monta el disco. El usuario (y solo el propietario que lo instaló) puede acceder al disco sin ninguna configuración adicional. Este podría no ser el caso de los dispositivos que no están en la lista de dispositivos compatibles.