NVIDIA驱动安装：apt与.run深度对比与实战排障指南

上周有位读者私信我说他的 Ubuntu 24.04 跑得好好的某天系统提示更新他顺手点了一下重启后 nvidia-smi 直接报错桌面也进不去了。他去网上搜答案两极分化有人说要重装驱动有人说要用 apt 装省心还有人坚持必须用官网的 .run 文件。他问我到底 apt 安装和官网 .run 文件安装哪个才是 NVIDIA 驱动安装的正道这个问题我太有感触了。这些年我经手过十来台不同发行版、不同显卡的机器apt 和 .run 两种方式都反复用过结论是没有绝对的“哪个更好”但有非常明确的“哪个更适合什么场景”。核心区别不在安装速度而在安装包的机制。这篇文章我不打算做和稀泥式的对比而是把这两种安装方式从底层机制、适用边界到完整实战一次讲透。无论你是刚接触 Linux 的新手还是被驱动的“丢失”“加载失败”折磨过几天几夜的老兵这篇文章都值得读完。1. 先弄清楚 apt 和 .run 装的到底是什么1.1 .run 文件的真面目一个自解压的驱动全家桶很多人第一次拿到 NVIDIA 官网的NVIDIA-Linux-x86_64-550.120.run这个文件时会以为它是一个编译好的二进制安装包。实际上它的本质是一个 Shell 脚本加一段二进制 payload。当你执行sh安装脚本时脚本会先做一系列环境检查——检查内核版本、gcc 版本、是否已经安装过驱动、X Server 是否在运行——然后把 payload 解压到临时目录按你的选择编译内核模块并把 OpenGL、Vulkan、CUDA 运行库、nvidia-smi 工具、Xorg 驱动等全部部署到系统相应位置。这也解释了 .run 为什么体积大、内容全。它不依赖发行版的包管理器对 Debian、Ubuntu、CentOS、openSUSE 等几乎所有发行版通吃因为它把“如何集成为一个系统服务”这件事的决定权交给了安装参数而不是发行版仓库规则。1.2 apt 安装的本质发行版定制的驱动包apt 方式则完全不同。当你在 Ubuntu 里执行sudo apt install nvidia-driver-550Ubuntu 仓库里那个包并不是 NVIDIA 官方原封不动的驱动而是由 Ubuntu 或 Debian 的维护者基于官方驱动二次打包的产物。这些维护者会根据系统当前的内核版本、Xorg 版本、GCC 版本做适配添加一些补丁再通过 DKMS 机制让内核模块在不同内核版本之间自动重建。所以 apt 安装的驱动本质上是“为你的发行版量身定制过的驱动”。理论上它对系统的侵入性更小升级内核时应该能自动适配。这也是很多人推荐新手用 apt 的根本原因——依赖关系帮你处理内核升级后模块自动重建听起来确实省心。1.3 两种机制带来的关键差异为了把问题看得更清楚我把两种方式的核心差异整理成一张表对比维度apt 安装.run 安装驱动来源发行版仓库维护的“定制版”NVIDIA 官方原版版本新旧通常滞后官方数月与官网同步最新版第一时间可用依赖处理自动解决依赖但可能联动改动系统组件依赖需要自行铺垫内核适配通过 DKMS 自动适配新内核默认未注册 DKMS需要显式加--dkmsnouveau 屏蔽包安装脚本自动处理需要手动配置 blacklist卸载方式apt remove联动清理自带nvidia-uninstall脚本Secure Boot仓库包做过签名一般可直接加载未签名需要自行 MOK 注册适用范围主流发行版、主流显卡几乎全发行版、老卡新卡通吃除了表格里的差异还有两点很容易被忽略第一版本更新节奏不同。apt 里的驱动版本往往落后官方大半年。新 GPU 型号发布后驱动支持往往只在官网 .run 里出现。比如你现在拿着一块新出不久的显卡apt 搜索到的驱动可能完全不支持它而官网的 .run 已经写明了“ Added support for ...”。第二依赖处理的思路不同。apt 会自动拉取依赖但有时会“拆东墙补西墙”比如你在装 CUDA 相关组件时它升级驱动的同时可能把libnvidia-*的一堆库动掉结果就是你发现之前能跑的应用突然出问题。而 .run 方式把依赖和版本选择的控制权完全交给你出错时你能更清楚地定位是哪一步出了问题。理解了上面三点你就理解了为什么同样一张显卡、同一个系统两种方式装出来的体验可能天差地别。2. apt 安装方式的真实痛点在哪些场景爆发2.1 内核升级后驱动消失最经典的翻车现场apt 安装最让人头疼的问题就是系统推送内核更新之后驱动莫名其妙“没”了。网上随手一搜就有大把“Ubuntu 22.04 update kernel nvidia driver missing”的帖子。为什么明明说好 DKMS 自动重建却还是翻车我拆开看过这个过程。Ubuntu 每几个月就会推送新的内核包升级期间 DKMS 会尝试在/var/lib/dkms/nvidia/目录下为新内核重新编译内核模块。只要以下任何一个条件不满足DKMS 构建就会静默失败新内核对应的linux-headers-$(uname -r)没有安装gcc 版本与内核编译时用的版本不一致DKMS 版本与内核版本不兼容磁盘空间不足导致编译中断失败之后你的/lib/modules/$(uname -r)/updates/dkms/nvidia.ko就不存在了。表现在用户端就是重启后nvidia-smi: command not found桌面分辨率异常甚至直接卡死在登录界面。多数人在这个节点会跑去重新装驱动但根源其实是 DKMS 构建失败而不是驱动本身坏了。要验证是不是这个原因执行dkms status如果输出里 nvidia 模块下面标注的installed状态和当前内核版本对不上或者显示build失败那基本就坐实了。解决办法是用 apt 安装对应的linux-headers-generic然后重新触发 DKMS 构建sudo apt install linux-headers-$(uname -r) sudo dkms install -m nvidia -v 550.120但这里有个现实问题普通用户根本不会去看这些日志只会觉得“驱动又丢了”。这也是我后来逐渐倾向 .run 的原因之一——至少在 .run 的世界里你知道自己必须主动处理内核适配这个问题。2.2 历史遗留配置文件与 PPA 混源问题apt 方式第二个容易踩的坑是历史遗留配置。很多人的机器不是一张白纸可能之前手动改过/etc/modprobe.d/里的 blacklist 文件可能装过旧版驱动后没有彻底卸载也可能添加过第三方 PPA 源比如ppa:graphics-drivers/ppa。这个 PPA 本身是社区维护的更新频率比官方仓库高但带来的问题也很典型一旦 PPA 里的驱动版本与系统其他组件产生依赖冲突apt 会陷入一个非常尴尬的局面。常见报错是libnvidia-gl-550 : Depends: libnvidia-glcore-550 but it is not installable这种报错出现时apt 既装不上新版本又卸不掉旧版本卡在中间。我见过有读者因为这个把整个 Ubuntu 重装了——其实根本不需要通常把 PPA 先删除apt update再清理一遍残留的nvidia-*包就能恢复。但这个过程对新手来说确实劝退。2.3 新产品发布后的驱动滞后与离线场景还有一个 apt 天花板的问题新产品、新系统支持。热词里有些朋友已经在关注 Ubuntu 26.04、CUDA 13、NVIDIA B300 这些比较新的东西。每次 NVIDIA 发新卡、发新版 CUDAapt 仓库里能选的版本都落后一拍。如果你手里的卡太新apt 里搜出来的驱动版本根本不认识这块卡那 apt 方式就直接出局了。另一个容易被忽视的场景是离线/内网部署。很多公司的服务器是不连外网的你得拿着驱动文件去机房装。apt 方式这时候非常难搞——你要先在一个联网机器上把nvidia-driver-*和所有依赖的.deb包都下载好再拿到内网去离线安装。依赖关系稍微复杂一点你就会发现漏了一两个包来回跑得让人崩溃。而 .run 是一个自包含文件拷过去一个文件就能装这个优势在离线场景下是碾压级的。3. .run 文件为什么是“官方答案”优势与代价3.1 .run 解决的核心问题先聊 .run 不可替代的优势。一是版本自由。你可以在 NVIDIA 官网直接看到某个版本支持哪些显卡、修复了哪些 bug、加入了对哪个新 CUDA 版本的支持。想要什么版本就下载什么版本不用等发行版仓库慢慢更新。对跑深度学习、搞 CUDA 开发、需要精确控制驱动版本来配合 cuDNN 或 PyTorch 的人来说这种控制权非常重要。二是自包含部署。不管你是 Ubuntu 还是 CentOS甚至更冷门的发行版只要内核和工具链满足要求一个 .run 就能解决。比如 CentOS 7 上装 4090 驱动仓库里老到没法看很多教程都是直接下载官网 .run 来装。热词里也有centos7 安装 4090 驱动的需求基本只有走 .run 一条路。三是精细控制安装内容。.run 安装时可以指定很多参数比如不装 OpenGL、不装 32 位兼容库、不跑nvidia-xconfig、把驱动注册到 DKMS 等等。这种粒度是 apt 给不了的。四是卸载集中。用 .run 装完NVIDIA 会在/usr/bin/下放一个nvidia-uninstall脚本。想卸载的时候一条命令就能把相关文件清个七七八八比你自己去 apt 里挨个找nvidia-*包再批量 remove 要干净得多。3.2 选择 .run 前必须接受的四个代价不过 .run 也不是没有门槛至少下面这四件事你得认第一依赖得自己准备。装 .run 之前系统里必须有 gcc、make、kernel 头文件。很多新手在这里直接卡住因为./configure还没开始安装脚本就报错说找不到cc或者linux/version.h。这不是脚本问题是环境问题。第二nouveau 必须手动屏蔽。Ubuntu 默认加载的开源 NVIDIA 驱动 nouveau 会和官方驱动抢设备。跑安装脚本时它会检测到 nouveau 已经加载然后拒绝安装或者装完后启动时冲突。所以安装前必须把 nouveau 写进 blacklist再update-initramfs -u刷新 initramfs。这一步漏掉你后面八成会遇到“黑屏”或者“开机进不去”的鬼问题。第三安装过程中必须关闭图形界面。如果你在桌面环境下直接双击 run 脚本或者开着 X Server 去执行安装过程要么失败要么效果不完整。正确的姿势是先把显示管理器停掉切换到一个纯文本的终端模式再装。习惯用 Ubuntu Desktop 的人会觉得这一步很别扭但它恰恰是 .run 安装成功的关键。第四系统更新内核后驱动模块不会自动跟着重建。除非你在安装时加了--dkms参数否则每次升级内核后都需要重新手动跑一遍安装脚本否则新内核里根本没有 nvidia 模块。这个“丢驱动”问题我在第 5 章会展开讲它其实是很多“驱动又丢了”场景的真凶。3.3 一个可以套用的选择框架看了上面的对比很多人会问那我到底该用哪种我给一个可以对着自查的框架你的情况推荐方式理由日常办公、打游戏系统能正常升级、不折腾apt系统集成度高自动处理依赖和大部分初始化刚买的新显卡、需要最新驱动特性.runapt 仓库大概率还没跟上新硬件做 CUDA 开发、跑深度学习实验.run --dkms版本可控避免 apt 自动升级破坏环境CentOS/RHEL、Debian 等非 Ubuntu 系.run仓库驱动老旧且依赖复杂离线部署、内网机房.run单文件自包含最省事机器上已经残留了乱七八糟的 nvidia 包.run先清理再装apt 残留越多越容易出妖蛾子我自己常用的折中方案是.run 加--dkms。这样既保留了 .run 版本可控、自包含的优点又让驱动模块在新内核升级时能够自动重建补上了 .run 最容易被诟病的一块短板。4. .run 实战安装从准备到验证的完整过程4.1 环境检查装前先问系统三件事开始装之前先把系统状况摸清楚。以下命令依次执行# 查看显卡型号和 PCI 设备 ID lspci | grep -i nvidia # 检查当前是否已有 nvidia 驱动在运行 nvidia-smi # 查看当前内核版本 uname -r # 检查编译工具链和内核头文件 gcc --version make --version ls /usr/src/linux-headers-$(uname -r)如果/usr/src/linux-headers-$(uname -r)不存在需要先装sudo apt install build-essential linux-headers-$(uname -r) dkms这里是第一处容易翻车的地方很多人只会装build-essential忘了装linux-headers-$(uname -r)。没有内核头文件驱动编译的第一步就挂了。另外注意如果你之前升级过内核但没重启uname -r显示的可能是旧内核头文件包却对应新内核这种错位也会导致安装失败建议先重启一次确保环境干净。4.2 屏蔽 nouveau 并关闭图形界面环境就绪后第一步是屏蔽 nouveau。创建一个 blacklist 文件sudo bash -c echo blacklist nouveau /etc/modprobe.d/blacklist-nouveau.conf sudo bash -c echo options nouveau modeset0 /etc/modprobe.d/blacklist-nouveau.conf然后更新 initramfssudo update-initramfs -u更新完建议重启一次重启后执行lsmod | grep nouveau如果没有输出说明 nouveau 已经不再加载了。这一步做好后面安装成功率会高很多。第二步是关闭图形界面。Ubuntu 桌面版默认使用 GDM 或 LightDM 作为显示管理器需要先停掉它。可以用sudo systemctl isolate multi-user.target这条命令会直接切换到多用户命令行模式等价于以前的init 3。执行后你的图形界面会退出回到一个纯文本的登录终端。在这个终端里登录你的普通用户然后开始安装。如果你已经远程 SSH 到机器上也可以直接执行安装而不用切换到多用户模式但前提是当前没有人在用桌面、没有 X Server 进程占用 GPU。4.3 运行安装脚本参数说明与推荐组合现在进入正题。从 NVIDIA 官网下载对应显卡架构和操作系统平台的 .run 文件后给它加执行权限chmod x NVIDIA-Linux-x86_64-550.120.run然后运行。新手第一次不建议用静默模式先用交互模式看清楚每一步在干什么sudo sh NVIDIA-Linux-x86_64-550.120.run交互模式下安装程序会问你几个问题是否接受许可协议Accept / Decline是否安装 32 位兼容库32-bit compatibility libraries是否运行 nvidia-xconfig 来更新 X 配置对于大多数桌面用户32 位兼容库建议选 Yes因为 Steam 或者一些旧游戏依赖 32 位 OpenGL 库。nvidia-xconfig它会自动生成一份/etc/X11/xorg.conf如果你之前没有自定义过 X 配置选 Yes 省事如果你有自己调过的配置选 No 更稳妥。更推荐给有经验用户的做法是直接带上参数sudo sh NVIDIA-Linux-x86_64-550.120.run \ --dkms \ --no-x-check \ --no-nouveau-check \ --no-cc-version-check参数含义如下参数作用--dkms把驱动模块注册到 DKMS内核升级时自动重建--no-x-check跳过对 X Server 是否运行的检测--no-nouveau-check跳过对 nouveau 模块的检测--no-cc-version-check允许 gcc 大版本与内核编译版本不一致时继续编译--no-cc-version-check这个参数要慎用。它解决的是新系统 gcc 版本太新导致编译报版本错误的场景但跳过版本检查不代表能编译成功只是让安装流程继续走。最稳妥的还是提前装好匹配的内核头文件和 gcc不要指望靠这个参数绕过去。安装过程会持续几分钟到十几分钟不等期间会编译内核模块。看到类似Installation of the NVIDIA Accelerated Graphics Driver for Linux-x86_64 (version: 550.120) completed的输出说明装完了。4.4 安装后的验证与 CUDA 联动安装完先别急着重启先验证一下模块和工具是否就位lsmod | grep nvidia nvidia-smi如果nvidia-smi能正常打印出显卡型号、驱动版本、显存信息说明驱动已经生效。接下来重启系统回到桌面检查一下渲染是否正常glxinfo | grep OpenGL renderer如果你没有glxinfo先装mesa-utilssudo apt install mesa-utils正常输出会显示类似NVIDIA Corporation ...的渲染器信息。到这一步.run 驱动的核心安装就算完成了。如果你还需要 CUDA toolkit有两种选择一是从 NVIDIA 官网下载 CUDA 的.run安装包它会匹配当前驱动允许的 CUDA 版本二是用 apt 装cuda-toolkit-*但这时要注意驱动版本和 CUDA 版本之间的兼容矩阵。一般规律是驱动版本越新支持的最高 CUDA 版本越高。安装 CUDA 后记得在~/.bashrc里配置环境变量export PATH/usr/local/cuda/bin:$PATH export LD_LIBRARY_PATH/usr/local/cuda/lib64:$LD_LIBRARY_PATH配置完source ~/.bashrc再用nvcc --version验证。5. 安装后将踩的坑以及我给出的排查链路5.1 glxserver_nvidia 模块加载失败别急着重装很多人装完 .run 驱动后重启发现 X 服务起不来查看/var/log/Xorg.0.log会看到类似这样的报错(EE) NVIDIA: Failed to load module glxserver_nvidia (module does not exist, 0)这个报错的字面意思是 Xorg 在加载 NVIDIA 的 GLX 扩展模块时找不到文件。我第一次遇到时也慌了以为驱动没装好重装了好几遍都没用。后来冷静下来一查根因通常是下面三个之一第一之前 apt 残留的 nvidia glx 配置仍然指向老版本。比如/etc/X11/xorg.conf里写着Load glx但系统里对应路径下的模块是 apt 版本的旧文件名和 .run 装出来的新文件名对不上。第二安装时选择了不装 OpenGL 相关组件。如果你用了类似--no-opengl-files的参数那/usr/lib/xorg/modules/extensions/libglxserver_nvidia.so压根就不会存在Xorg 加载失败是必然的。第三Xorg 配置文件指定了一个不存在的驱动路径。某些发行版的/etc/X11/xorg.conf.d/下可能有第三方配置。排查链路我建议按这个顺序走# 1. 看日志确认报错来源 grep -i glxserver_nvidia /var/log/Xorg.0.log # 2. 检查模块文件是否存在 ls -l /usr/lib/xorg/modules/extensions/libglxserver_nvidia.so # 3. 检查 xorg.conf 里的 Load 配置 cat /etc/X11/xorg.conf | grep -i Load如果第二步文件存在问题大概率出在 xorg.conf 引用的路径或名字不对。最直接的验证方法是把 xorg.conf 备份后移走让 Xorg 自动探测sudo mv /etc/X11/xorg.conf /etc/X11/xorg.conf.bak sudo systemctl restart gdm3能起来就说明配置文件有问题再逐步把自定义配置加回去。这个方法我用了很多次比盲目重装驱动高效得多。5.2 “驱动丢失”的真相模块重建机制前面提到过.run 安装默认不会注册 DKMS。如果你没有加--dkms参数那么系统升级内核后新内核里没有 nvidia 内核模块重启后nvidia-smi当然就报错了。这不是驱动凭空“丢失”而是新内核根本不知道有这么个模块。遇到这种情况先别重装。执行dkms status看看 nvidia 模块的状态。如果你当时加了--dkms但模块仍然没加载多半是 DKMS 构建失败了原因可能是新内核的头文件没装。装上后再触发sudo apt install linux-headers-$(uname -r) sudo dkms autoinstall如果你当时没加--dkms那就只能重新跑一遍安装脚本sudo sh NVIDIA-Linux-x86_64-550.120.run --dkms安装脚本检测到已安装驱动时会问你是卸载重装还是保留选择重装即可。加上--dkms之后就一劳永逸了之后内核升级 DKMS 会自动帮你把模块重建好。这里给一个很重要的经验总结只要是通过 .run 装 NVIDIA 驱动不管什么场景都建议加上--dkms。这是我用大量翻车经历换来的教训。5.3 Secure Boot 和 Wayland两个容易被忽略的隐藏关卡热词里提到 Debian 13 GNOME、Ubuntu 24.04 默认 Wayland 会话的问题这也是很多新手装了驱动后进不去桌面或显示异常的原因之一。先说 Secure Boot。现在很多电脑出厂默认开启 Secure Boot。如果你在开启 Secure Boot 的机器上装 .run 驱动内核模块因为未签名会被系统拒绝加载。表现就是安装时一切正常重启后nvidia-smi报错dmesg里能看到类似Lockdown: modprobe: unsigned module loading is restricted的提示。解决办法是用 MOKMachine Owner Key注册你的模块签名sudo mokutil --import /var/lib/dkms/mok.pub执行后设置一个临时密码重启进入蓝色 MOK 管理界面选择 enroll key输入刚才设置的密码完成注册。之后模块就能正常加载了。这一步不会出现在 NVIDIA 官方安装教程里但现实中碰到的人非常多。再说 Wayland。新版 Ubuntu 和 Debian 的 GNOME 默认会话已经是 Wayland。NVIDIA 驱动虽然也支持 Wayland但不同版本的组合下体验差异很大有的版本在 Wayland 下渲染异常有的版本只有 Xorg 会话能正常启动。如果你装完驱动后发现登录界面选不了会话或者 Wayland 会话黑屏可以考虑在登录界面手动切换到 “Ubuntu on Xorg” 再试。如果你确定要禁用 Wayland 改用 Xorg可以在/etc/gdm3/custom.conf里取消注释WaylandEnablefalse重启 GDM。5.4 卸载与重装的最佳顺序避免二次踩坑最后聊一下卸载和重装因为热词里也有ubuntu24.04 卸载nvidia的需求。很多人卸驱动的方式是直接sudo apt remove nvidia-driver-*结果把一堆关联组件全拆了重启后 X 起不来又不知道怎么回事最后重装系统。正确的卸载顺序是这样的先把当前用户切到非 NVIDIA 驱动的输出方式。如果你有核显进 BIOS 切换到核显输出如果没有核显准备好一个能用的文本终端或者干脆做好重装驱动的心理准备。如果是 .run 安装的驱动用 NVIDIA 自带的卸载脚本sudo /usr/bin/nvidia-uninstall如果是 apt 安装的驱动先查看装了哪些包dpkg -l | grep -i nvidia然后按依赖顺序逐个卸载或者直接通配sudo apt purge nvidia-driver-* nvidia-kernel-common-* nvidia-utils-*清理完驱动后重启前把 nouveau 的 blacklist 去掉否则重启后进入桌面会因为没有显卡驱动而非常卡。这个顺序最核心的一点是卸载前先想清楚你靠什么输出画面。很多人栽在“卸载一时爽重启火葬场”就是因为没考虑画面输出问题。最后分享一点我用真金白银换来的体会装了这么多年驱动我现在养成了几个习惯新机器到手先看 Secure Boot 状态Ubuntu 系统一定先装好linux-headers-$(uname -r)再碰驱动能给 .run 加--dkms的绝不裸装日志文件的优先级永远高于刻板印象——报错发生后先dmesg、先/var/log/Xorg.0.log而不是直接重装。这两个习惯帮我省下了至少十几个小时的折腾时间。如果你现在正被 NVIDIA 驱动问题搞得焦头烂额不妨先停下来看看日志再决定下一步怎么走。