如何在debain系统中安装 NVIDIA docker Container Toolkit

下面给出在 Debian 12（Bookworm）上完整安装 NVIDIA Container Toolkit 的「一条龙」步骤，按顺序执行即可。所有命令均需要 root 权限（sudo）。

1. 前置检查

   • 已正确安装官方 NVIDIA 驱动（nvidia-smi 能正常输出）。

   • 已安装 Docker ≥20.10（Debian 官方源 docker.io 即可）：

     sudo apt update
     sudo apt install -y docker.io
     sudo systemctl enable --now docker

2. 添加 NVIDIA 软件源并安装 Toolkit

   # 1. 导入 GPG 密钥
   curl -fsSL https://nvidia.github.io/libnvidia-container/gpgkey \
        | sudo gpg --dearmor -o /usr/share/keyrings/nvidia-container-toolkit-keyring.gpg
   
   # 2. 添加 apt 源（Debian 稳定版）
   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://#' \
        | sudo tee /etc/apt/sources.list.d/nvidia-container-toolkit.list
   
   # 3. 更新索引并安装
   sudo apt update
   sudo apt install -y nvidia-container-toolkit

3. 让 Docker 认识 NVIDIA runtime

   sudo nvidia-ctk runtime configure --runtime=docker
   sudo systemctl restart docker

4. 验证安装

   sudo docker run --rm --runtime=nvidia --gpus all ubuntu nvidia-smi

   若能看到显卡型号、驱动版本等信息，说明 Toolkit 已正常工作。

附：如需锁定版本（可选）

export VER=1.17.8-1
sudo apt install -y \
  nvidia-container-toolkit=$VER \
  nvidia-container-toolkit-base=$VER \
  libnvidia-container-tools=$VER \
  libnvidia-container1=$VER

以上步骤综合自官方文档与社区实践