开启 NVIDIA Vulkan 渲染 | BitaHub 帮助中心

在云端开发机或容器环境中运行依赖图形渲染、无头渲染（Headless Rendering）或 3D 仿真（如 Isaac Gym、Blender、MuJoCo 等）的任务时，可能遇到 Vulkan 驱动未正确挂载或无法识别 NVIDIA GPU 的情况。本文介绍如何在环境中配置并开启 NVIDIA Vulkan 渲染支持。

一、配置与启用步骤

前置检查

请确认当前开发机或实例已挂载 NVIDIA GPU 资源，并通过终端或 SSH 成功登录实例。

步骤一：安装 Vulkan 工具包

更新软件源并安装基础 Vulkan 诊断与命令行工具：

apt update && apt install -y vulkan-tools

步骤二：创建 Vulkan 配置目录

创建存放自定义 Vulkan ICD 配置的目录：

mkdir -p /opt/vulkan

步骤三：生成 NVIDIA EGL ICD 配置

使用 Python 读取默认 NVIDIA ICD 配置并生成适配 EGL 的 ICD JSON 文件：

python3 - <<'PY'
import json

src = "/etc/vulkan/icd.d/nvidia_icd.json"
dst = "/opt/vulkan/nvidia-egl-icd.json"

with open(src) as f:
    data = json.load(f)

data["ICD"]["library_path"] = "libEGL_nvidia.so.0"

with open(dst, "w") as f:
    json.dump(data, f, indent=2)

print("NVIDIA Vulkan EGL ICD created:", dst)
PY

步骤四：设置 Vulkan 环境变量

设置 VK_DRIVER_FILES 环境变量指向新生成的 ICD 文件：

export VK_DRIVER_FILES=/opt/vulkan/nvidia-egl-icd.json

步骤五：写入 bashrc 持久化环境变量

将环境变量配置写入用户 ~/.bashrc 文件，确保新开终端窗口自动生效且避免重复添加：

grep -qxF 'export VK_DRIVER_FILES=/opt/vulkan/nvidia-egl-icd.json' ~/.bashrc || echo 'export VK_DRIVER_FILES=/opt/vulkan/nvidia-egl-icd.json' >> ~/.bashrc

步骤六：验证 Vulkan 与 GPU 状态

执行 vulkaninfo 摘要命令，验证 Vulkan 驱动是否已成功识别并绑定 NVIDIA GPU 设备：

vulkaninfo --summary

二、注意事项与建议

注意如果在后续使用过程中重置了系统容器或切换了 Python 虚拟环境，请确认 ~/.bashrc 中的环境变量依然有效。
如果输出中未列出 NVIDIA 独立显卡设备，请执行 nvidia-smi 确认底层 NVIDIA 驱动与显卡状态是否正常。

此页面对您有帮助吗？

一、配置与启用步骤​