nvidia/driver

NVIDIA Driver Docker镜像文档

镜像概述和主要用途

本镜像为NVIDIA GPU驱动的容器化版本，原Docker Hub镜像已停止更新，请使用NGC目录中的官方镜像：nvcr.io/nvidia/driver。该镜像用于在容器环境中提供NVIDIA GPU驱动支持，确保依赖GPU的应用程序（如AI训练、科学计算、图形渲染等）能够正常运行，简化驱动部署与版本管理。

核心功能和特性

• 多环境支持：兼容Ubuntu 16.04/18.04、CentOS 7及实验性支持CoreOS系统
• 多内核适配：提供默认内核、HWE（硬件启用）内核、AWS云环境内核等多种内核版本支持
• 多驱动版本：包含418.87.01、410.104、396.37等多个稳定驱动版本
• 容器化优势：通过容器封装驱动，确保环境一致性，简化跨主机/跨平台的驱动部署流程

使用场景和适用范围

适用场景

• AI/机器学习训练与推理（依赖CUDA的应用）
• 科学计算（如数值模拟、数据分析）
• 图形处理与渲染（如GPU加速的图形应用）
• 云环境GPU资源管理（如AWS等平台的GPU实例）

适用系统

• Ubuntu 16.04 LTS、Ubuntu 18.04 LTS
• CentOS 7
• CoreOS（实验性支持）

标签和版本信息

支持的发行版与内核类型

镜像标签格式为：[驱动版本]-[发行版]-[内核类型]，其中内核类型包括默认内核、HWE内核（硬件启用）、AWS内核（云环境优化）。

Ubuntu 16.04

Ubuntu 18.04

CentOS 7

CoreOS（实验性）

使用方法和配置说明

前提条件

• 主机已安装NVIDIA GPU硬件
• 主机内核版本需与镜像标签中的内核版本匹配（如4.15.0-65-ubuntu18.04需对应主机内核4.15.0-65）
• 已安装Docker引擎（建议19.03+）

从NGC拉取镜像

bash
docker pull ***-nvcr.xuanyuan.run/nvidia/driver:<标签>
# 示例：拉取Ubuntu 18.04默认内核的418.87.01版本
docker pull ***-nvcr.xuanyuan.run/nvidia/driver:418.87.01-ubuntu18.04

运行容器

驱动镜像需以特权模式运行，并挂载主机的GPU设备、内核源码及模块目录，示例命令：

bash
docker run -it --privileged \
  --name nvidia-driver \
  -v /dev/nvidia0:/dev/nvidia0 \
  -v /dev/nvidiactl:/dev/nvidiactl \
  -v /dev/nvidia-modeset:/dev/nvidia-modeset \
  -v /dev/nvidia-uvm:/dev/nvidia-uvm \
  -v /lib/modules:/lib/modules \
  -v /usr/src:/usr/src \
  ***-nvcr.xuanyuan.run/nvidia/driver:418.87.01-ubuntu18.04

参数说明：

• --privileged：授予容器特权，允许访问主机硬件设备
• -v /dev/nvidia*：挂载GPU相关设备文件
• -v /lib/modules：挂载主机内核模块目录，确保驱动模块加载
• -v /usr/src：挂载内核源码目录，用于驱动模块编译（如需）

许可协议

使用本镜像前，您必须阅读并同意http://www.nvidia.com/content/DriverDownload-March2009/licence.php?lang=us。下载或使用镜像即表示您已接受该协议的所有条款。