产品文档
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 的信息。

为支持 NVIDIA Capture SDK for Linux 的 NVIDIA GPU 启用 HDX™ 3D Pro

对于支持 NVIDIA Capture SDK for Linux 的 NVIDIA GPU，只需在安装 Linux VDA 时将 CTX_XDL_HDX_3D_PRO 设置为 Y 即可启用 HDX 3D Pro。无需额外配置。启用 HDX 3D Pro 后，硬件加速默认处于启用状态。

与不支持 NVIDIA Capture SDK for Linux 的 NVIDIA GPU 以及来自其他制造商（例如 AMD 和 Intel）的 GPU 兼容

注意：

在此场景中，仅支持软件编码。

步骤 1：在安装 Linux VDA 时将 CTX_XDL_HDX_3D_PRO 设置为 Y

例如，您可以运行 sudo apt-get install -y libxdamage1 以在 Ubuntu 20.04 上安装 XDamage。通常，XDamage 作为 XServer 的扩展存在。

步骤 3：运行以下命令以启用 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-->

步骤 4：修改 Xorg 配置文件

您可以在 /etc/X11 下找到以下四个模板配置文件。根据连接的显示器数量，修改其中一个名称中包含相应数字的模板配置文件。例如，如果只连接了一个显示器，请修改名称中包含数字 1 的模板配置文件，即 ctx-driver_name-1.conf。如果连接了两个显示器，请修改名称中包含数字 2 的模板配置文件，即 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

以 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-->

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

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

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

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

  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 应用程序并且所有配置都正确，则缺少图形输出或图形输出乱码是 Bug 导致的。使用 /opt/Citrix/VDA/bin/setlog 并将 GFX_X11 设置为 verbose 以收集跟踪信息进行调试。

非虚拟化 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.