Ubuntu 22.04 环境下安装 NVIDIA Container Toolkit 以启用 Docker GPU 支持。步骤包括更新系统依赖、添加 NVIDIA 官方源、安装核心插件并配置 Docker 运行时。验证通过运行测试镜像执行 nvidia-smi 命令确认 GPU 识别。注意事项涵盖源路径匹配、Docker 版本兼容性、驱动与 CUDA 版本对应关系以及非 root 用户权限配置。常见问题涉及依赖缺失、CUDA 版本不匹配及命令未找到等问题的解决方案。
sudo apt-get update && sudo apt-get upgrade -y && apt-get install -y ca-certificates curl gnupg lsb-release
docker --version
# 输出 Docker 版本，如 20.10.21
sudo systemctl status docker
# 确认 Docker 服务运行中
若未安装 Docker，先执行官方安装脚本。
sudo apt-get purge -y nvidia-docker nvidia-container-runtime
sudo rm -rf /etc/apt/sources.list.d/nvidia-docker.list
Ubuntu 22.04 对应 jammy 版本，需指定正确的源路径：
# 导入 GPG 密钥
curl -fsSL https://nvidia.github.io/libnvidia-container/gpgkey | sudo gpg --dearmor -o /usr/share/keyrings/nvidia-container-toolkit-keyring.gpg
# 添加 Ubuntu 22.04（jammy）专属源
curl -sL https://nvidia.github.io/libnvidia-container/ubuntu22.04/libnvidia-container.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 && sudo apt-get install -y nvidia-container-toolkit
# 生成 Docker 配置文件（自动关联 GPU 驱动）
sudo nvidia-ctk runtime configure --runtime=docker
# 重启 Docker 服务使配置生效
sudo systemctl restart docker
运行测试镜像，若正常输出 GPU 信息，则插件生效：
sudo docker run --rm --gpus all nvidia/cuda:11.8.0-base-ubuntu22.04 nvidia-smi
预期输出包含宿主机 GPU 型号、CUDA 版本等信息（如 RTX 3090 + CUDA 12.2）。
离线包下载镜像地址：https://mirror.cs.uchicago.edu/nvidia-docker/libnvidia-container/stable/ubuntu20.04/amd64/
源路径正确性
Ubuntu 22.04 的源路径必须是 ubuntu22.04（对应 jammy），若误使用 ubuntu20.04（focal）会导致依赖冲突，安装失败。
Docker 版本兼容
Ubuntu 22.04 默认软件源的 Docker 版本可能较低（如 20.10.12），建议通过 Docker 官方脚本安装最新稳定版，避免 --gpus 参数不支持。
驱动与 CUDA 版本匹配 Ubuntu 22.04 推荐安装 NVIDIA 驱动 515.43.04+，对应的 CUDA 版本建议 11.7+，可通过以下命令安装兼容驱动：
sudo ubuntu-drivers autoinstall
sudo reboot
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
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
sudo ubuntu-drivers autoinstallnvidia/cuda:11.7.0-base-ubuntu22.04nvidia-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
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
使用加密算法（如AES、TripleDES、Rabbit或RC4）加密和解密文本明文。 在线工具，加密/解密文本在线工具，online
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online