预装驱动
前提条件
适用于GPU计算加速型云主机部署Tesla驱动,无资源池功能限制。
需选择带有预装Tesla驱动关键字的专属公共镜像。
操作步骤
进入创建云主机页面,选择GPU计算加速型云主机规格,在镜像选择环节,选择名称含预装Tesla驱动标识的公共镜像;
完成其余云主机配置后,提交创建申请;
云主机创建成功后,Tesla驱动及配套CUDA、cuDNN组件已默认部署完成,可直接启用GPU计算相关业务。
自动安装
前提条件
仅适用于GPU计算加速型云主机部署Tesla驱动。
仅部分资源池支持该功能,若目标资源池无此功能,可选择其他安装方式。
仅支持Linux系列操作系统的公共镜像。
操作步骤
进入创建云主机页面,选择GPU计算加速型云主机规格,在镜像环节选择Linux系列公共镜像;
进入云主机配置环节,找到并勾选安装GPU驱动功能选项;
在弹出的版本选择界面,按需选择匹配的Driver、CUDA、cuDNN版本;
完成其余云主机配置后,提交创建申请;
云主机创建完成后,系统将自动完成所选版本的Tesla驱动及配套组件的安装部署,无需手动干预,安装过程相对耗时,云主机启动时间会更长,并伴有自动重启。
一键部署安装
前提条件
仅适用于Tesla驱动、CUDA、cuDNN部署。
仅支持的操作系统与内核版本章节列举的Linux操作系统及内核版本支持该脚本,若不支持可切换为手动安装方式。
适用于已成功创建并处于正常运行状态的GPU计算加速型云主机。
如果云主机安装过驱动、CUDA、cuDNN等,请完全卸载后再使用一键部署方式重新安装。
一键部署方式使用内网下载安装包,需使用内网DNS访问内网YUM源,请确保网络连通性(http://internal.mirrors.ctyun.cn)。
篡改系统标识、进行网络隔离等操作可能导致一键部署失败。
注意
一键部署安装包含下载与安装操作,整体耗时较长,并伴有自动重启。
支持的操作系统与内核版本
一键部署安装会自动识别云主机的操作系统及内核版本,匹配并安装对应的驱动、CUDA和cuDNN,无需手动选择版本,支持范围如下表所示:
| 操作系统 | 操作系统版本号 | 内核版本 |
|---|---|---|
| CentOS | 7.X | 3.10.0 |
| CentOS | 8.X | 4.18.0 |
| CentOS | 9.X | 5.14.0 |
| CTyunOS | 2.0.1 | 4.19.90 |
| CTyunOS | 22.06 | 4.19.90 |
| CTyunOS | 23.01 | 5.10.0 |
| Ubuntu | 18.04 | 4.15.0 |
| Ubuntu | 20.04 | 5.4.0 |
| Ubuntu | 22.04 | 5.15.0 |
| Ubuntu | 24.04 | 6.8.0 |
| Kylin | V10 | 4.19.90 |
操作步骤
下载脚本
将自动安装脚本auto_install.sh下载至本地。
auto_install.sh脚本使用说明
auto_install.sh脚本具备安装 NVIDIA 驱动、CUDA 和 cuDNN的能力,可以根据操作系统及内核自动选择合适的版本进行安装,也支持用户指定驱动版本。
参数说明如下:
--driver <version> 指定驱动版本
check 检查安装状态
--help 显示帮助信息
支持的驱动、CUDA 和 cuDNN版本如下:
535.154.05 对应 CUDA 12.1.1, cuDNN 8.9.7.29
550.90.07 对应 CUDA 12.4.1, cuDNN 9.2.0.82
570.133.20 对应 CUDA 12.8.1, cuDNN 9.8.0.87
在安装过程中,脚本会自动安装CUDA补丁,因此选择安装的CUDA版本与最终显示的小版本存在差异,属于正常情况。
开始安装
上传脚本:将下载好的auto_install.sh脚本上传至云主机。
切换权限:登录云主机,确保以root用户身份执行后续操作。
添加可执行权限:进入脚本所在目录,执行以下命令为脚本添加可执行权限。
chmod +x auto_install.sh运行脚本:执行以下命令启动安装流程,脚本会自动完成驱动、CUDA、cuDNN的匹配、安装及配置。
# 安装推荐的驱动版本 bash auto_install.sh # 指定驱动版本安装 bash auto_install.sh --driver 535.154.05等待执行与重启:安装过程中请勿中断脚本运行,脚本执行完成后会自动重启系统,无需手动操作。
一键部署执行结果
脚本安装成功后,会打印以下日志信息,并自动触发系统重启:
# 示例日志
[ALWAYS] 2026-03-17 10:50:18 All components verified successfully, installation complete!
[INFO] 2026-03-17 10:50:18 Installation verified successfully, system will reboot to complete configuration
[INFO] 2026-03-17 10:50:19 Rebooting system...重启后验证
系统重启完成后,登录云主机,执行以下命令验证组件安装状态,若能正常输出组件版本则说明安装成功:
bash auto_install.sh check从示例可以看出安装已成功完成,驱动版本为535.154.05、CUDA版本为V12.1.105、cuDNN版本为8.9.7。
常见问题及解决方案
问题1:脚本报错“YUM source unreachable”
若脚本运行时提示“YUM source unreachable”,大概率是云主机网络连通性异常导致。若您曾对云主机进行过DNS修改、网关变更和网段调整等影响网络连通性的操作,均可能触发该报错。建议优先排查并恢复云主机网络正常访问,确保能正常连通脚本所需的下载源后,再重新执行脚本。
问题2:脚本报错“Unsupported XXX version or kernel”或者“Unsupported operating system”
若脚本运行时提示“Unsupported XXX version or kernel”或“Unsupported operating system”,则表明当前云主机的操作系统版本或内核版本暂不支持一键部署的安装方式。遇到此问题时,请先确认是否对云主机进行过内核相关信息的修改,若有修改请先尝试恢复原有内核配置;若未进行过以上修改,可参见手动安装Tesla驱动指引,根据自身云主机的操作系统、显卡等信息自行选择适配的驱动版本进行安装。
问题3:脚本报错“ERROR: Driver 570.133.20 (CUDA 12.8.1) is NOT supported on this OS!”
如果用户指定了驱动版本,但是脚本执行的时候打印了版本不支持的信息,请根据脚本提示使用正确的版本。如截图中的示例,可以使用550.90.07或者535.154.05的驱动版本。