nvidia-container-toolkit

2025-08-22

安装

[[Ubuntu]][[Debian]] 使用 [[apt]] 安装

Terminal window
# 先配置存储库
curl -fsSL https://nvidia.github.io/libnvidia-container/gpgkey | sudo gpg --dearmor -o /usr/share/keyrings/nvidia-container-toolkit-keyring.gpg \
&& curl -s -L https://nvidia.github.io/libnvidia-container/stable/deb/nvidia-container-toolkit.list | \
sed 's#deb https://#deb [signed-by=/usr/share/keyrings/nvidia-container-toolkit-keyring.gpg] https://#g' | \
sudo tee /etc/apt/sources.list.d/nvidia-container-toolkit.list
# 更新软件包
sudo apt-get update
# 安装
export NVIDIA_CONTAINER_TOOLKIT_VERSION=1.17.8-1
sudo apt-get install -y \
nvidia-container-toolkit=${NVIDIA_CONTAINER_TOOLKIT_VERSION} \
nvidia-container-toolkit-base=${NVIDIA_CONTAINER_TOOLKIT_VERSION} \
libnvidia-container-tools=${NVIDIA_CONTAINER_TOOLKIT_VERSION} \
libnvidia-container1=${NVIDIA_CONTAINER_TOOLKIT_VERSION}

因为网络的原因第一步骤可能会下载失败,下面是 nvidia-container-toolkit.list 的内容,保存到 /etc/apt/sources.list.d 目录下:

nvidia-container-toolkit.list
deb [signed-by=/usr/share/keyrings/nvidia-container-toolkit-keyring.gpg] https://nvidia.github.io/libnvidia-container/stable/deb/$(ARCH) /
#deb [signed-by=/usr/share/keyrings/nvidia-container-toolkit-keyring.gpg] https://nvidia.github.io/libnvidia-container/experimental/deb/$(ARCH) /

使用

大部分安装 nvidia-container-toolkit 驱动都是为了让 [[Docker]] 能支持 GPU,可以通过 nvida-ctk 进行配置:

Terminal window
sudo nvidia-ctk runtime configure --runtime=docker

该命令会自动在 /etc/docker/daemon.json 加上:

{
"runtimes": {
"nvidia": {
"args": [],
"path": "nvidia-container-runtime"
}
}

然后通过 [[systemctl]] 命令重启 Docker 进程:

Terminal window
sudo systemctl restart docker

参考