Ubuntu系统使用中科大镜像源安装nvidia-container-toolkit教程

一、教程概述

本文主要介绍在Ubuntu系统中，如何替换官方源为中科大（USTC）镜像源，安装nvidia-container-toolkit工具，解决官方源下载速度慢、下载失败的问题。该工具主要用于让Docker等容器能够正常调用NVIDIA GPU，适用于需要在容器中运行GPU加速任务的场景。

二、核心适用信息

适用系统：Ubuntu（全系列兼容，无需额外适配）
镜像源：中国科学技术大学（USTC）镜像源，国内访问速度快、稳定性高
安装版本：nvidia-container-toolkit 1.18.2-1（固定版本，避免版本不兼容问题）
核心用途：实现Docker等容器对NVIDIA GPU的调用，支持GPU加速任务运行

三、详细安装步骤

以下步骤均需在终端中执行，可直接复制命令运行，确保终端拥有sudo权限（管理员权限）。

步骤1：安装基础依赖

更新软件源并安装curl、gnupg2依赖工具，用于后续导入密钥和获取镜像源列表：

bash
sudo apt-get update && sudo apt-get install -y --no-install-recommends curl gnupg2

步骤2：导入中科大GPG密钥

导入中科大镜像源的GPG密钥，用于验证软件包的合法性，避免安装恶意软件：

bash
curl -fsSL https://mirrors.ustc.edu.cn/libnvidia-container/gpgkey | sudo gpg --dearmor -o /usr/share/keyrings/nvidia-container-toolkit-keyring.gpg

步骤3：替换镜像源列表

获取中科大镜像源的列表文件，并替换系统中原有的nvidia-container-toolkit源列表，确保后续安装从国内镜像源下载：

bash
curl -s -L https://mirrors.ustc.edu.cn/libnvidia-container/stable/deb/nvidia-container-toolkit.list | sed 's#deb https://nvidia.github.io#deb [signed-by=/usr/share/keyrings/nvidia-container-toolkit-keyring.gpg] https://mirrors.ustc.edu.cn#g' | sudo tee /etc/apt/sources.list.d/nvidia-container-toolkit.list

步骤4：更新软件源

替换镜像源后，再次更新软件源，使系统识别新的镜像源：

bash
sudo apt-get update

步骤5：安装指定版本的nvidia-container-toolkit

固定安装1.18.2-1版本，避免因版本过高或过低导致的兼容性问题，命令如下：

bash
export NVIDIA_CONTAINER_TOOLKIT_VERSION=1.18.2-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其他版本，建议先卸载旧版本，再执行上述安装步骤，避免版本冲突。
安装完成后，可通过运行nvidia-container-toolkit --version命令，验证安装是否成功（显示1.18.2版本即为安装成功）。
该教程仅适用于Ubuntu系统，其他Linux发行版（如CentOS、Debian）步骤需另行调整。

目录