产品文档
Linux Virtual Delivery Agent
Current Release 2402 LTSR 2311 2308 2305 2303 2301 2212 2210 2209 2207 2206 2204 2203 LTSR 1912 LTSR 7.15 LTSR
查看 PDF

非虚拟化 GPU

April 10, 2026
投稿者: 
C C

  • 在 Linux VDA 文档中，非虚拟化 GPU 是指：

  • 在远程电脑访问场景中使用的 GPU

  • 从虚拟机管理程序直通的 GPU

  • 本文提供了有关为非虚拟化 GPU 启用 HDX™ 3D Pro 的信息。

先决条件

  • 启用 HDX 3D Pro。为此，在安装 Linux VDA 时将 CTX_XDL_HDX_3D_PRO 设置为 Y。有关环境变量的信息，请参阅步骤 8：设置运行时环境以完成安装。
  • 对于 NVIDIA Linux Capture SDK 支持的 GPU，在启用 HDX 3D Pro 后，硬件加速默认处于启用状态。无需额外配置。

  • 对于 NVIDIA Linux Capture SDK 不支持的 GPU，请安装 XDamage。例如，您可以运行 sudo apt-get install -y libxdamage1 以在 Ubuntu 20.04 上安装 XDamage。通常，XDamage 作为 XServer 的扩展存在。

  • 配置

  • 修改 Xorg 配置文件

适用于 NVIDIA 非虚拟化 GPU

配置文件会自动安装和设置。

适用于其他 GPU

您必须修改安装在 /etc/X11/ 下的四个模板配置文件：

  • ctx-driver_name-1.conf
  • ctx-driver_name-2.conf
  • ctx-driver_name-3.conf
  • ctx-driver_name-4.conf

以 ctx-driver_name-1.conf 为例，执行以下操作来修改模板配置文件：

  1. 将 driver_name 替换为您的实际驱动程序名称。

    例如，如果您的驱动程序名称是 intel，则可以将配置文件名称更改为 ctx-intel-1.conf。

  2. 添加视频驱动程序信息。

    每个模板配置文件都包含一个名为“Device”的部分，该部分已注释掉。此部分描述了视频驱动程序信息。在添加视频驱动程序信息之前启用此部分。要启用此部分：

    1. 请参阅 GPU 制造商提供的配置指南以获取配置信息。可以生成本机配置文件。验证您的 GPU 是否可以在本地环境中使用本机配置文件工作。

    2. 将本机配置文件的“Device”部分复制到 ctx-driver_name-1.conf。

  3. 运行以下命令设置注册表项，以便 Linux VDA 可以识别在步骤 1 中设置的配置文件名。

    /opt/Citrix/VDA/bin/ctxreg create -k "HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Citrix\XDamage" -t "REG_SZ" -v "DriverName" -d "intel" --force
<!--NeedCopy-->

启用 XDamage

如果您使用的 GPU 未列在 NVIDIA Linux Capture SDK 发行说明的受支持硬件部分中，请使用以下方法启用 XDamage：

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

远程电脑访问 VDA 的显示器消隐

Linux VDA 支持使用非虚拟化 GPU 的远程电脑访问 VDA 的物理显示器消隐。

支持此功能的经过全面测试的 Linux 发行版包括 Ubuntu 20.04 和 Debian 11.3。

此功能默认处于禁用状态。要启用它，请完成以下两个步骤：

  1. 根据您的 Linux 发行版安装 evdi-dkms 软件包：

    sudo apt install evdi-dkms
<!--NeedCopy-->

  2. 启用图形显示卸载到 EVDI：

    /opt/Citrix/VDA/bin/ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\Thinwire" -t "REG_DWORD" -v "Evdi" -d "0x00000001" --force
<!--NeedCopy-->

  3. 如果您使用的是 Intel GPU，请禁用显示管理器。否则，Intel GPU 将被显示管理器占用，无法用于 Citrix® 远程会话。

    sudo systemctl disable --now gdm
<!--NeedCopy-->

故障排除

图形输出缺失或乱码

如果您可以在本地运行 3D 应用程序并且所有配置都正确，则图形输出缺失或乱码是由于错误造成的。使用 /opt/Citrix/VDA/bin/setlog 并将 GFX_X11 设置为 verbose 以收集跟踪信息进行调试。

硬件编码不起作用

如果您使用 Xdamage，则仅支持软件编码。

非虚拟化 GPU
April 10, 2026
投稿者: 
C C
April 10, 2026
投稿者: 
C C

在本文中

站点反馈 | Your privacy choices footer link您的隐私选择 | 隐私和法律条款 | Cookie 首选项 | 同意设置 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.