Docker 使用 NVIDIA GPU 驱动错误解决

本文最后更新于：2025年4月14日晚上

docker 安装后默认无法使用 GPU，本文记录解决方案。

错误描述

在使用Docker时，尝试配置NVIDIA GPU驱动支持时遇到了以下错误：

1	`Error response from daemon: could not select device driver "nvidia" with capabilities: [[gpu]]`

安装过程与解决方案

步骤1：加入NVIDIA Docker包仓库

首先，我们需要将NVIDIA Docker的包仓库添加到系统的APT源列表中。以下是具体的命令步骤：

添加NVIDIA Docker的GPG密钥：

1	`curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey \| sudo apt-key add -`

根据当前系统的发行版和版本号，添加NVIDIA Docker的APT源：

curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey | \
  sudo apt-key add -
distribution=$(. /etc/os-release;echo $ID$VERSION_ID)
curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.list | \
  sudo tee /etc/apt/sources.list.d/nvidia-docker.list

‌注意‌：如果上述命令不生效，可以尝试使用备份命令一次性完成密钥添加和源添加：

1
2
3

distribution=$(. /etc/os-release;echo $ID$VERSION_ID) \
   && curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey | sudo apt-key add - \
   && curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.list | sudo tee /etc/apt/sources.list.d/nvidia-docker.list

步骤2：安装 nvidia-container-toolkit 并更新Docker配置

更新APT包列表：
1
sudo apt-get update
安装nvidia-container-toolkit，这是nvidia-docker2的依赖包：
1
sudo apt-get install -y nvidia-container-toolkit
重启Docker服务以应用新的配置：
1
sudo systemctl restart docker