Ubuntu 22.04 安装 NVIDIA Container Toolkit 配置 Docker GPU 加速

4. 验证插件安装成功

运行测试镜像，若正常输出 GPU 信息，则插件生效：

sudo docker run --rm --gpus all nvidia/cuda:11.8.0-base-ubuntu22.04 nvidia-smi

预期输出包含宿主机 GPU 型号、CUDA 版本等信息（如 RTX 3090 + CUDA 12.2）。

5. 离线安装

离线包下载镜像地址：https://mirror.cs.uchicago.edu/nvidia-docker/libnvidia-container/stable/ubuntu20.04/amd64/

Ubuntu 22.04 专属注意事项

1. 源路径正确性 Ubuntu 22.04 的源路径必须是 ubuntu22.04（对应 jammy），若误使用 ubuntu20.04（focal）会导致依赖冲突，安装失败。

2. Docker 版本兼容 Ubuntu 22.04 默认软件源的 Docker 版本可能较低（如 20.10.12），建议通过 Docker 官方脚本安装最新稳定版，避免 --gpus 参数不支持。

3. 驱动与 CUDA 版本匹配 Ubuntu 22.04 推荐安装 NVIDIA 驱动 515.43.04+，对应的 CUDA 版本建议 11.7+，可通过以下命令安装兼容驱动：

sudo ubuntu-drivers autoinstall
sudo reboot

4. 非 root 用户权限配置 若需免 sudo 使用 Docker GPU，除了添加 docker 用户组，还需确保 nvidia-container-toolkit 权限正确：

sudo chmod 666 /var/run/docker.sock
# 临时授权（重启后失效）

# 永久授权：编辑 Docker 服务配置
sudo nano /etc/systemd/system/docker.service.d/override.conf
# 添加内容：ExecStart=/usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock -H unix:///var/run/docker.sock
sudo systemctl daemon-reload && sudo systemctl restart docker

常见问题

1. 安装时提示'依赖未满足' 原因：源路径错误或系统未更新。解决方案：

sudo rm /etc/apt/sources.list.d/nvidia-container-toolkit.list
# 重新执行'添加 NVIDIA 官方源'步骤（确保路径为 ubuntu22.04）
sudo apt-get update && sudo apt-get install -y nvidia-container-toolkit

2. 容器内提示'CUDA driver version is insufficient for CUDA runtime version' 原因：宿主机驱动版本低于镜像要求。解决方案：

• 安装更高版本驱动：sudo ubuntu-drivers autoinstall
• 更换低版本 CUDA 镜像，如 nvidia/cuda:11.7.0-base-ubuntu22.04

3. nvidia-ctk 命令未找到 原因：Toolkit 安装不完整。解决方案：

sudo apt-get remove -y nvidia-container-toolkit
sudo apt-get autoremove -y
# 重新安装并清理缓存
sudo apt-get update && sudo apt-get install -y nvidia-container-toolkit --fix-missing