环境准备
注意
安装前请仔细阅读，当前安装版本为专业版时，请跳过安装显卡驱动步骤，每台节点都需要完成以下所有环境准备的步骤，安装完成后自行做好服务器快照以方便进行快速恢复。
系统要求
请在部署前，使用相关命令确认服务器搭载系统版本。命令格式如下:
root@pro-manage-node:~/tools/aigate/init/k8s/cluster# lsb_release -a
No LSB modules are available.
Distributor ID: Ubuntu
Description: Ubuntu 22.04.5 LTS
Release: 22.04
Codename: jammy
说明
注意：集群支持 Ubuntu 22.04 和 Ubuntu 20.04
若您的版本与说明存在差异，强行安装可能引发程序崩溃、服务中断等故障，为保障使用体验，强烈建议使用官方推荐版本。
关闭内核自动更新
说明
- 若未禁用内核自动更新，系统重启后可能自动升级内核版本，导致当前内核与显卡驱动安装时依赖的内核版本不一致。
- 这会造成显卡驱动不可用，影响硬件功能正常使用。
- 为避免此类问题，建议在安装显卡驱动前，提前关闭系统的内核自动更新功能。
请使用相关命令打开配置文件 /etc/apt/apt.conf.d/10periodic，命令格式如下
vim /etc/apt/apt.conf.d/10periodic
在配置文件中添加相关内容，添加如下内容
APT::Periodic::Update-Package-Lists "0";
APT::Periodic::Download-Upgradeable-Packages "0";
APT::Periodic::AutocleanInterval "0";
请使用相关命令打开 /etc/apt/apt.conf.d/20auto-upgrades 配置文件，命令格式如下
vim /etc/apt/apt.conf.d/20auto-upgrades
在配置文件中添加相关内容，添加如下内容
APT::Periodic::Update-Package-Lists "0";
APT::Periodic::Unattended-Upgrade "0";
关闭 nouveau 开源驱动
请使用相关命令打开配置文件 /etc/modprobe.d/blacklist-nouveau.conf，命令格式如下
vim /etc/modprobe.d/blacklist-nouveau.conf
在配置文件中添加以下内容以禁用 nouveau 驱动，添加内容如下
blacklist nouveau
options nouveau modeset=0
更新 initramfs 以应用配置更改，命令格式如下
update-initramfs -u
完成后重启服务器，命令格式如下
reboot
检查驱动程序
1. NVIDIA
nvidia-smi
root@rtx3090-rtx3090-node-1:~# nvidia-smi
Wed Nov 26 06:03:47 2025
+-----------------------------------------------------------------------------------------+
| NVIDIA-SMI 570.153.02 Driver Version: 570.153.02 CUDA Version: 12.8 |
|-----------------------------------------+------------------------+----------------------+
| GPU Name Persistence-M | Bus-Id Disp.A | Volatile Uncorr. ECC |
| Fan Temp Perf Pwr:Usage/Cap | Memory-Usage | GPU-Util Compute M. |
| | | MIG M. |
|=========================================+========================+======================|
| 0 NVIDIA GeForce RTX 3090 Off | 00000000:01:00.0 Off | N/A |
| 36% 34C P0 111W / 350W | 0MiB / 24576MiB | 0% Default |
| | | N/A |
+-----------------------------------------+------------------------+----------------------+
| 1 NVIDIA GeForce RTX 3090 Off | 00000000:02:00.0 Off | N/A |
| 36% 34C P0 116W / 350W | 0MiB / 24576MiB | 2% Default |
| | | N/A |
+-----------------------------------------+------------------------+----------------------+
+-----------------------------------------------------------------------------------------+
| Processes: |
| GPU GI CI PID Type Process name GPU Memory |
| ID ID Usage |
|=========================================================================================|
| No running processes found |
+-----------------------------------------------------------------------------------------+
2. 曦云
mx-smi
root@mx-server:~# mx-smi
mx-smi version: 2.2.9
=================== MetaX System Management Interface Log ===================
Timestamp : Wed Nov 26 14:12:51 2025
Attached GPUs : 8
+---------------------------------------------------------------------------------+
| MX-SMI 2.2.9 Kernel Mode Driver Version: 3.3.12 |
| MACA Version: unknown BIOS Version: 1.29.1.0 |
|------------------+-----------------+---------------------+----------------------|
| Board Name | GPU Persist-M | Bus-id | GPU-Util sGPU-M |
| Pwr:Usage/Cap | Temp Perf | Memory-Usage | GPU-State |
|==================+=================+=====================+======================|
| 0 MetaX C500 | 0 Off | 0000:01:00.0 | 0% Disabled |
| 42W / 350W | 48C P0 | 858/65536 MiB | Available |
+------------------+-----------------+---------------------+----------------------+
| 1 MetaX C500 | 1 Off | 0000:21:00.0 | 0% Disabled |
| 37W / 350W | 43C P0 | 858/65536 MiB | Available |
+------------------+-----------------+---------------------+----------------------+
+---------------------------------------------------------------------------------+
| Process: |
| GPU PID Process Name GPU Memory |
| Usage(MiB) |
|=================================================================================|
| no process found |
+---------------------------------------------------------------------------------+
End of Log
若查询结果如上，表示驱动已存在，则跳过步骤4和步骤5，直接执行 下载安装脚本
下载驱动程序
1. NVIDIA
说明
- 访问 NVIDIA 驱动下载页面
- 根据显卡型号和操作系统版本选择对应的驱动程序并下载安装文件，示例如下。
① 输入显卡型号，手动搜索驱动。（以「 GeForce RTX 40 Series | NVIDIA GeForce RTX 4070 Ti | Linux 64-bit 」为例）
② 点击「 查找 」，查看驱动下载类型
③ 选择「 推荐驱动/认证驱动 」类型，点击「 查看 」，查看驱动详情
④ 点击「 下载 」，下载对应的驱动程序，并上传到服务器
2. 曦云
说明
- 访问 沐曦曦云 驱动下载页面
- 根据显卡型号和操作系统版本选择对应的驱动程序并下载安装文件，示例如下。
① 选择「 Linux 」->「 地部署 」->「 x86_64 」->「 Ubuntu22.04 」->「 Runfile 」安装
② 登录后点击「 wget命令复制 」或「 下载 」
③ 将下载的驱动程序，上传到服务器
安装驱动程序
1. NVIDIA
说明
以下NVIDIA-Linux-x86_64-570.144.run为示例文件，实际安装需要替换成实际驱动文件名称
赋予安装文件执行权限，命令格式如下
chmod +x NVIDIA-Linux-x86_64-570.144.run
运行安装程序，跳过 X Server 检查并不安装 OpenGL 文件（如适用），命令格式如下
./NVIDIA-Linux-x86_64-570.144.run -no-x-check -no-opengl-files
命令执行结果如下，选择 「 NVIDIA Proprietary 」，并点击
点击后，如若遇到下图所示结果，则使用相关命令执行安装程序；如若未遇到，则跳过此步骤
执行以下命令安装工具
apt update
apt install make gcc -y
再次运行安装程序
./NVIDIA-Linux-x86_64-570.144.run -no-x-check -no-opengl-files
安装完成后重新执行以下命令检查驱动
nvidia-smi
2. 曦云
说明
以下metax-driver-3.2.1.12-deb-x86_64.run为示例文件
赋予安装文件执行权限，命令格式如下
chmod +x metax-driver-3.2.1.12-deb-x86_64.run
执行安装
./metax-driver-3.2.1.12-deb-x86_64.run -- -f
重启机器
reboot
安装完成后重新执行以下命令检查驱动
mx-smi
下载安装脚本
说明
「 客户ID 」需要替换为您实际的信息，ID获取详见控制台-基本资料。
请使用相关命令在当前节点下载安装脚本，命令格式如下：
1.专业版
管理节点
wget -O install_manager.sh https://product-deploy.titanai.cloud/admin/deploy/env/professional/manager/install/<客户ID> && chmod +x install_manager.sh
存储节点
wget -O install_storage.sh https://product-deploy.titanai.cloud/admin/deploy/env/professional/storage/install/<客户ID> && chmod +x install_storage.sh
计算节点
下载免费版/标准版安装脚本
2.免费版/标准版
NVIDIA
wget -O install.sh https://product-deploy.titanai.cloud/admin/deploy/env/install/<客户ID> && chmod +x install.sh
曦云
wget -O install.sh https://product-deploy.titanai.cloud/admin/deploy/env/maca/install/<客户ID> && chmod +x install.sh
执行脚本
执行下载的脚本，当您看到相关日志时，恭喜您，说明安装已经完成，日志示例如下
[2025-04-07 01:46:41] Installation completed successfully
[2025-04-07 01:46:41] WARNING: System will reboot in 1 minute. Use 'shutdown -c' to cancel.
[2025-04-07 01:46:41] Executing: shutdown -r +1 'Reboot By InfraX'
Installation log has been saved to: /var/log/infra_install_20250407_014609.log
说明
WARNING: System will reboot in 1 minute. Use 'shutdown -c' to cancel. 请等待服务器重启后执行后续操作.