麒麟os安装nvidia驱动需先确认硬件与系统信息，再禁用nouveau并重建initramfs，推荐apt一键安装或官方.run文件手动安装，安装后须验证nvidia-smi及opengl渲染器。
如果您在麒麟系统上运行图形密集型应用、AI训练或高分辨率桌面环境时出现渲染异常、GPU加速未启用、nvidia-smi命令报错或黑屏等问题，说明当前正在使用的Nouveau开源驱动无法发挥硬件真实性能，必须替换为NVIDIA官方专有驱动。
确认硬件与系统基础信息
这一步不能跳过，否则可能装错架构或内核版本导致驱动加载失败。先打开终端执行以下命令：
运行 lspci | grep -i vga 查看显卡型号（重点关注是否含“NVIDIA”及具体型号如RTX 4060、Tesla T4）；
运行 uname -r 获取当前内核版本（例如 5.10.0-108-generic 或 4.19.90-2109.3.0.012.ky10.aarch64）；
运行 cat /etc/kylin-release 确认麒麟OS版本（V10 SP3/V11/2503）和CPU架构（x86_64 或 aarch64）；
【关键前提】 若输出中显示内核版本含 ky10 或 aarch64，后续必须使用适配ARM架构的驱动包，x86_64的.run文件直接运行会报错退出。
禁用Nouveau并重建启动镜像
这是所有安装方式的强制前置步骤。Nouveau会抢占GPU控制权，不屏蔽会导致安装失败、黑屏或nvidia-smi不可用。
执行 sudo tee /etc/modprobe.d/blacklist-nouveau.conf → 按回车 → 输入 <code>blacklist nouveau → 按回车 → 输入 options nouveau modeset=0 → 按回车 → 输入 EOF；
执行 sudo update-initramfs -u（麒麟V10 SP3及以上部分版本需改用 sudo dracut -f）；
重启系统：sudo reboot；
重启后进入TTY终端（Ctrl+Alt+F1），运行 lsmod | grep nouveau —— 若无任何输出，说明禁用成功；若有输出，说明黑名单未生效，需检查文件路径和拼写。
方法一：APT仓库一键安装（推荐初学者）
适用于GTX 10系至RTX 30系列显卡，操作最简、自动适配内核，且支持后续apt upgrade升级。
第一步：更新源列表：sudo apt update；
第二步：查询已安装驱动：apt list --installed | grep nvidia-driver，若存在旧版本（如nvidia-driver-470），先执行 sudo apt remove --purge nvidia-* 彻底清理；
第三步：安装推荐驱动：sudo apt install nvidia-driver（自动选最优版本）或指定版本如 sudo apt install nvidia-driver-535；
第四步：重启生效：sudo reboot；
第五步：验证：nvidia-smi 应显示驱动版本、显卡型号及温度信息——若提示“command not found”，说明nvidia-utils未随驱动安装，补装：sudo apt install nvidia-utils-535。
方法二：官方.run文件手动安装（适配RTX 40/50系及aarch64）
当APT方式查不到设备或提示“no supported GPU found”时，必须用此法。尤其适用于RTX 4060、RTX 5070、Tesla T4等新卡或aarch64架构服务器。
方法一：静默安装（适合脚本化部署）
进入驱动所在目录后执行：sudo ./NVIDIA-Linux-x86_64-*.run --silent --dkms --no-opengl-files --no-x-check --no-nouveau-check；
方法二：交互式安装（适合首次操作）
运行 sudo ./NVIDIA-Linux-x86_64-*.run，遇到提示时：按空格翻页→输入yes接受协议→输入no跳过32位库→【务必输入yes注册DKMS】，否则下次内核更新后驱动失效；
注意：aarch64平台必须下载标有“ARM64”或“aarch64”的驱动包，官网Linux x86_64版本在海光/飞腾服务器上无法运行。
验证与故障排查
安装完成后，在图形界面或TTY中执行 nvidia-smi；
若返回正常信息，再运行 glxinfo | grep "OpenGL renderer"，输出应含“NVIDIA”字样而非“llvmpipe”或“nouveau”；
若仍显示nouveau或报错“Failed to initialize NVML”，说明禁用未生效或lightdm未停止——回到TTY执行 sudo systemctl stop lightdm 后重试 nvidia-smi；
若提示“Unable to load: nvidia_uvm”，需手动加载模块：sudo modprobe nvidia-uvm，并检查 /proc/driver/nvidia/gpus/0000:01:00.0/information 是否存在。
