这是本文档旧的修订版！

qflow gpu 容器版 centos 7.9 安装指南

适用系统：CentOS 7.9
包含：NVIDIA 显卡驱动、Docker、nvidia-container-toolkit

1. 安装 NVIDIA 显卡驱动

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

lspci | grep -i nvidia

1.2 安装依赖包

sudo yum install -y gcc kernel-devel-$(uname -r) kernel-headers-$(uname -r)

1.3 禁用系统自带的 nouveau 驱动

sudo vim /etc/modprobe.d/blacklist-nouveau.conf

在文件中写入以下两行内容：

blacklist nouveau
options nouveau modeset=0

保存并退出后，重建内核镜像并切换为文本模式启动：

sudo mv /boot/initramfs-$(uname -r).img /boot/initramfs-$(uname -r).img.bak
sudo dracut /boot/initramfs-$(uname -r).img $(uname -r)
sudo systemctl set-default multi-user.target
sudo reboot

1.4 下载驱动并执行安装

从 NVIDIA 官网下载对应版本的驱动文件（如 NVIDIA-Linux-x86_64-570.181.run），上传到服务器后执行：

chmod +x NVIDIA-Linux-x86_64-570.181.run
sudo ./NVIDIA-Linux-x86_64-570.181.run

安装程序会启动交互式向导，按照提示操作，通常保持默认选项即可。

1.5 重启系统

sudo reboot

1.6 验证驱动安装

nvidia-smi

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

2. 安装 Docker

CentOS 7.9 推荐使用离线 RPM 包方式安装，避免网络依赖。

2.1 下载 RPM 离线包并上传到服务器

链接：http://223.70.160.60:9999/docker.tar
用户名：pwmat
密码: SimplyTheBest

2.2 安装 Docker

tar -xvf docker.tar
cd docker
sudo yum install -y *.rpm

2.3 启动并设置开机自启

sudo systemctl start docker
sudo systemctl enable docker

2.4 验证安装

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

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

sudo usermod -aG docker $USER

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

3. 安装 nvidia-container-toolkit

推荐使用离线 RPM 包方式安装（CentOS 7 官方源支持有限）。

3.1 下载离线包并上传到服务器

链接：http://223.70.160.60:9999/nvidia-container7.tgz
用户名：pwmat
密码: SimplyTheBest

3.2 安装

tar -zxvf nvidia-container7.tgz
cd nvidia-container7
sudo yum install -y *.rpm

3.3 配置 Docker 运行时

sudo nvidia-ctk runtime configure --runtime=docker

3.4 重启 Docker 服务

sudo systemctl restart docker

3.5 验证安装

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 安装成功。

4. qflow gpu 容器版

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

龙讯旷腾 pwmat Wiki

目录