====== qflow gpu 容器版 centos 7.9 安装指南 ======

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

----

===== 1. 系统设置 =====

==== 1.1 关防火墙 ====

<code bash>
sudo systemctl stop firewalld
sudo systemctl disable firewalld
</code>

===== 2. 安装 NVIDIA 显卡驱动 =====

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

<code bash>
lspci | grep -i nvidia
</code>

==== 2.2 安装依赖包 ====

<code bash>
sudo yum install -y gcc kernel-devel-$(uname -r) kernel-headers-$(uname -r)
</code>

==== 2.3 禁用系统自带的 nouveau 驱动 ====

<code bash>
sudo tee /etc/modprobe.d/blacklist-nouveau.conf << 'EOF'
blacklist nouveau
options nouveau modeset=0
EOF
</code>

重建内核镜像并切换为文本模式启动：

<code bash>
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
</code>

==== 2.4 下载驱动并执行安装 ====

> 从 [[https://www.nvidia.cn/drivers/|NVIDIA 官网]] 下载对应版本的驱动文件(如 ''NVIDIA-Linux-x86_64-550.76.run'')
> 或 从如下链接
>
> 链接：http://223.70.160.60:9999/qflow/NVIDIA-Linux-x86_64-550.76.run
> 用户名：pwmat
> 密码: SimplyTheBest
>
>下载上传到服务器并执行:

<code bash>
sudo sh NVIDIA-Linux-x86_64-550.76.run --ui=none --no-questions --accept-license --no-opengl-files
</code>

==== 2.5 重启系统 ====

<code bash>
sudo reboot
</code>

==== 2.6 验证驱动安装 ====

<code bash>
nvidia-smi
</code>

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

----

===== 3. 安装 Docker =====

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

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

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

==== 3.2 安装 Docker ====

<code bash>
tar -xvf docker7.tar
cd docker7
sudo yum install -y *.rpm
</code>

==== 3.3 启动并设置开机自启 ====

<code bash>
sudo systemctl start docker
sudo systemctl enable docker
</code>

==== 3.4 验证安装 ====

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

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

<code bash>
sudo usermod -aG docker $USER
</code>

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

----

===== 4. 安装 nvidia-container-toolkit =====

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

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

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

==== 4.2 安装 ====

<code bash>
tar -zxvf nvidia-container7.tgz
cd nvidia-container7
sudo yum install -y *.rpm
</code>

==== 4.3 配置 Docker 运行时 ====

<code bash>
sudo nvidia-ctk runtime configure --runtime=docker
</code>

==== 4.4 重启 Docker 服务 ====

<code bash>
sudo systemctl restart docker
</code>

==== 4.5 验证安装 ====

<code bash>
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
</code>

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

===== 5. qflow gpu 容器版 =====

点击链接, 从 ''宿主机安装 server.py 服务'' 开始: [[qflow:quickstart_gpu#宿主机安装 server.py 服务|跳转到宿主机安装 server.py 服务章节]] 跟着文档安装到结尾

~~DISCUSSION:off~~