这是本文档旧的修订版！

qflow gpu 容器版 rocky8.10 安装指南

适用系统：Rocky Linux 8.10
包含：NVIDIA 显卡驱动、Docker、nvidia-container-toolkit

1. 系统设置

1.1 关防火墙

sudo systemctl stop firewalld
sudo systemctl disable firewalld

2. 安装 NVIDIA 显卡驱动

2.1 确认系统能识别到 NVIDIA 显卡

# 安装工具包
sudo yum install pciutils -y
# 查看显卡型号
lspci | grep -i nvidia

2.2 检查驱动是否已经安装

nvidia-smi

如果能看到显卡型号、驱动版本、CUDA 版本等信息，说明驱动已正常安装，直接进行第 3 步；若未识别到驱动版本，请继续完成后续安装操作。

2.3 安装依赖包

# 安装开发工具组
sudo dnf groupinstall "Development Tools" -y
 
# 安装与当前内核匹配的开发包
sudo dnf install -y kernel-devel-$(uname -r) kernel-headers
 
# 启用必要的软件仓库
sudo dnf install epel-release -y
 
# 安装 DKMS，帮助内核更新后自动重建驱动
sudo dnf install -y dkms

2.4 禁用系统自带的 nouveau 驱动

sudo grubby --args="nouveau.modeset=0 rd.driver.blacklist=nouveau" --update-kernel=ALL
 
# 重启系统使配置生效
sudo reboot

2.5 使用 DNF 包管理器安装驱动

# 启用必要的软件仓库
sudo dnf config-manager --set-enabled powertools
 
# 添加 NVIDIA 官方仓库
sudo tee /etc/yum.repos.d/cuda-rhel8.repo << 'EOF'
[cuda-rhel8-x86_64]
name=cuda-rhel8-x86_64
baseurl=https://developer.download.nvidia.com/compute/cuda/repos/rhel8/x86_64
enabled=1
gpgcheck=1
gpgkey=https://developer.download.nvidia.com/compute/cuda/repos/rhel8/x86_64/D42D0685.pub
EOF
 
# 启用 nvidia-driver 模块的 latest-dkms 流（推荐使用 DKMS）
sudo dnf module enable nvidia-driver:570-dkms -y
 
# 安装驱动
sudo dnf install -y cuda-drivers

2.6 重启系统

sudo reboot

2.7 验证驱动安装

nvidia-smi

如果能看到显卡型号、驱动版本、CUDA 版本等信息，说明驱动已成功安装。

3. 安装 Docker

3.1 安装依赖并添加 Docker 官方仓库

# 安装依赖工具
sudo dnf install -y dnf-utils device-mapper-persistent-data lvm2
 
# 添加 Docker 官方仓库（使用阿里云镜像加速）
sudo dnf config-manager --add-repo \
  https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo

3.2 安装 Docker 引擎

sudo dnf install -y docker-ce docker-ce-cli containerd.io

3.3 启动并设置开机自启

sudo systemctl start docker
sudo systemctl enable docker

3.4 验证安装

sudo docker run --rm swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/hello-world:latest

3.5 （可选）配置非 root 用户权限

sudo usermod -aG docker $USER

注意：需要重新登录或重启会话才能生效。

4. 安装 nvidia-container-toolkit

4.1 安装 nvidia-container-toolkit

sudo dnf install -y nvidia-container-toolkit

4.2 配置 Docker 运行时

sudo nvidia-ctk runtime configure --runtime=docker

4.3 重启 Docker 服务

# 务必重启 Docker 服务使配置生效
sudo systemctl restart docker

4.4 验证安装

sudo docker run --rm --gpus all swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/nvidia/cuda:12.4.0-base-ubuntu22.04 nvidia-smi

如果容器内能正常输出 nvidia-smi 信息，说明 nvidia-container-toolkit 安装成功。

5. qflow gpu 容器版

点击链接, 从第二章导入镜像开始: 跳转到导入镜像章节跟着文档安装到结尾

龙讯旷腾 pwmat Wiki

目录