GPU no virtualizadas

Last published : Nov 13, 2026
En la documentación de Linux VDA, las GPU no virtualizadas se refieren a:
  • GPU utilizadas en escenarios de Acceso remoto a PC
  • GPU transferidas desde un hipervisor
Este artículo proporciona información sobre la compatibilidad con GPU no virtualizadas.
Related information
Gráficos

Habilitar HDX™ 3D Pro para GPU NVIDIA que admiten el SDK de captura de NVIDIA para Linux

Para las GPU NVIDIA que admiten el SDK de captura de NVIDIA para Linux, habilite HDX 3D Pro simplemente configurando CTX_XDL_HDX_3D_PRO en Y al instalar el VDA de Linux. No se requiere ninguna configuración adicional. La aceleración de hardware se habilita de forma predeterminada después de habilitar HDX 3D Pro.

Compatible con GPU NVIDIA que no admiten el SDK de captura de NVIDIA para Linux y GPU de otros fabricantes como AMD e Intel

Nota:
En este escenario, solo se admite la codificación por software.

Paso 1: Establezca CTX_XDL_HDX_3D_PRO en Y al instalar el VDA de Linux

Para obtener información sobre las variables de entorno, consulte Paso 8: Configurar el entorno de ejecución para completar la instalación.

Paso 2: Instale Xdamage

Por ejemplo, puede ejecutar sudo apt-get install -y libxdamage1 para instalar XDamage en Ubuntu 20.04. Normalmente, XDamage existe como una extensión de XServer.

Paso 3: Habilite XDamage ejecutando el siguiente comando

/opt/Citrix/VDA/bin/ctxreg create -k "HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Citrix\XDamage" -t "REG_DWORD" -v "XDamageEnabled" -d "0x00000001" --force

Paso 4: Modifique los archivos de configuración de Xorg

Puede encontrar los siguientes cuatro archivos de configuración de plantilla en /etc/X11. Según el número de monitores conectados, modifique uno de los archivos de configuración de plantilla con el número correspondiente en su nombre. Por ejemplo, si solo hay un monitor conectado, modifique el archivo de configuración de plantilla con el número 1 en su nombre, es decir, ctx-driver_name-1.conf. Si hay dos monitores conectados, modifique el archivo de configuración de plantilla con el número 2 en su nombre, es decir, ctx-driver_name-2.conf.
  • ctx-driver\_name-1.conf
  • ctx-driver\_name-2.conf
  • ctx-driver\_name-3.conf
  • ctx-driver\_name-4.conf
Tomando ctx-driver\_name-1.conf como ejemplo, haga lo siguiente para modificar los archivos de configuración de plantilla:
  1. Sustituya driver\_name por el nombre real de su controlador.
    Por ejemplo, si el nombre de su controlador es intel, puede cambiar el nombre del archivo de configuración a ctx-intel-1.conf.
  2. Agregue la información del controlador de vídeo.
    Cada archivo de configuración de plantilla contiene una sección denominada "Device", que está comentada. Esta sección describe la información del controlador de vídeo. Habilite esta sección antes de agregar la información de su controlador de vídeo. Para habilitar esta sección:
    1. Consulte la guía proporcionada por el fabricante de la GPU para obtener información de configuración. Se puede generar un archivo de configuración nativo. verificar que su GPU puede funcionar en un entorno local con el archivo de configuración nativo.
    2. Copie la sección "Device" del archivo de configuración nativo en ctx-driver\_name-1.conf.
  3. Ejecute el siguiente comando para establecer la clave de registro de modo que el VDA de Linux pueda reconocer el nombre del archivo de configuración establecido en el Paso 1.
    /opt/Citrix/VDA/bin/ctxreg create -k "HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Citrix\XDamage" -t "REG_SZ" -v "DriverName" -d "intel" --force

Apagado de monitor para VDA de Acceso con PC remoto

El VDA de Linux admite el apagado físico del monitor para los VDA de Acceso con PC remoto que utilizan GPU no virtualizadas.
Las distribuciones de Linux totalmente probadas que admiten la función incluyen Ubuntu 20.04 y Debian 11.
La función está deshabilitada de forma predeterminada. Para habilitarla, complete los dos pasos siguientes:
  1. Instale el paquete evdi-dkms según su distribución de Linux:
    sudo apt install evdi-dkms
  2. Habilite la descarga de la visualización de gráficos a EVDI:
    /opt/Citrix/VDA/bin/ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\Thinwire" -t "REG_DWORD" -v "Evdi" -d "0x00000001" --force
  3. Si utiliza una GPU Intel, deshabilite el administrador de visualización. De lo contrario, el administrador de visualización ocupa y hace que la GPU Intel no esté disponible para las sesiones remotas de Citrix®.
    sudo systemctl disable --now gdm

Solución de problemas

Salida gráfica nula o distorsionada

Si puede ejecutar aplicaciones 3D localmente y todas las configuraciones son correctas, la salida gráfica que falta o está distorsionada es el resultado de un error. Utilice /opt/Citrix/VDA/bin/setlog y establezca GFX\_X11 en "verbose" para recopilar la información de seguimiento para la depuración.