使用Nvidia容器工具包时Docker内Vulkan无法识别Nvidia GPU

1. 验证宿主机基础环境 #

• 确认宿主机已正确安装Nvidia驱动（版本≥450，推荐535及以上）和Nvidia Container Toolkit：
  • 检查驱动状态：执行 nvidia-smi，输出需显示正常的GPU硬件信息和对应驱动版本
  • 验证Toolkit有效性：运行 docker run --rm --gpus all nvidia/cuda:11.8.0-base-ubuntu22.04 nvidia-smi，确保容器能正确识别GPU
• 确认宿主机Vulkan环境正常：执行 vulkaninfo | grep "GPU"，结果应包含Nvidia GPU的条目

2. 修复Ubuntu 22.04容器的Vulkan驱动挂载问题 #

Ubuntu 22.04容器默认不会自动挂载Nvidia的Vulkan驱动库，可通过以下两种方式解决：

方法一：自定义Ubuntu 22.04镜像 #

创建Dockerfile：

FROM ubuntu:22.04
RUN apt update && apt install -y vulkan-tools libvulkan1
# 指定驱动库路径，确保容器能访问宿主机的Nvidia Vulkan驱动
ENV LD_LIBRARY_PATH=/usr/lib/x86_64-linux-gnu:/usr/local/nvidia/lib64

构建并运行容器：

docker build -t vulkan-ubuntu22 .
docker run --rm --gpus all -e NVIDIA_DRIVER_CAPABILITIES=all -e NVIDIA_VISIBLE_DEVICES=all --net=host -v /tmp/.X11-unix:/tmp/.X11-unix -e DISPLAY=$DISPLAY vulkan-ubuntu22 vulkaninfo

方法二：使用适配Ubuntu 22.04的官方Nvidia Vulkan镜像 #

官方nvidia/vulkan镜像的驱动版本需与宿主机匹配，否则会报ERROR_INCOMPATIBLE_DRIVER：

# 替换<HOST_CUDA_VERSION>为宿主机nvidia-smi显示的CUDA版本（例如12.2）
docker run --rm --gpus all -e NVIDIA_DRIVER_CAPABILITIES=all -e NVIDIA_VISIBLE_DEVICES=all --net=host -v /tmp/.X11-unix:/tmp/.X11-unix -e DISPLAY=$DISPLAY nvidia/vulkan:1.3.268-cuda<HOST_CUDA_VERSION>-ubuntu22.04 vulkaninfo

3. 处理llvmpipe渲染报错 #

vkcube报错“Could not find both graphics and present queues”仅在依赖llvmpipe（CPU渲染）时出现，当容器成功识别Nvidia GPU并使用GPU渲染后，该问题会自动消失，无需额外处理。

核心注意事项 #

• 宿主机与容器的Nvidia驱动版本必须兼容（容器驱动版本不能高于宿主机），否则会触发驱动不兼容错误
• 运行图形化Vulkan应用时，必须挂载宿主机的X11套接字并传递DISPLAY环境变量，确保容器能访问显示输出
• 禁止在容器内安装Nvidia驱动，所有驱动依赖均由宿主机通过Nvidia Container Toolkit提供

内容的提问来源于stack exchange，提问作者Ricky Casavecchia