Ubuntu 18.04安装Nvidia显卡驱动：从原理到实战的完整避坑指南

1. 项目概述与核心痛点

在Linux环境下，尤其是Ubuntu这类发行版上安装Nvidia显卡驱动，对于很多从Windows或macOS转过来的开发者、研究人员和爱好者来说，几乎可以算作一个“成人礼”。我见过太多人，包括我自己早期，在这个环节上耗费数小时甚至数天，最终可能以系统崩溃、黑屏、循环登录告终，不得不重装系统。Ubuntu 18.04作为一个长期支持版本，至今仍有大量生产环境和遗留项目在使用，其内核与Nvidia新驱动的兼容性问题，以及Ubuntu自带的nouveau开源驱动与Nvidia闭源驱动的冲突，构成了一个经典的“新手劝退”场景。

这篇文章的目的，就是彻底终结这个痛点。我将分享一套在Ubuntu 18.04上安装Nvidia驱动的完整、可靠流程，这套方法经过了从个人工作站到服务器集群的反复验证。核心思路不是简单地罗列命令，而是带你理解每一个步骤背后的“为什么”，让你知其然更知其所以然。无论是为了跑CUDA进行深度学习训练，还是为了获得更好的图形桌面性能，或是解决外接显示器的问题，这篇指南都将为你提供一个清晰、不坑的路径。

2. 安装前的深度准备与原理剖析

盲目执行安装命令是失败的主要根源。在动手之前，我们必须做好万全准备，并理解我们将要对抗的“敌人”是谁。

2.1 硬件与驱动型号确认

首先，你需要知道你的显卡具体型号和适合的驱动版本。这不是多此一举。

打开终端，使用lspci命令过滤出Nvidia设备：

lspci | grep -i nvidia

你会看到类似01:00.0 VGA compatible controller: NVIDIA Corporation GP106 [GeForce GTX 1060 6GB] (rev a1)的输出。记下你的显卡型号（例如 GP106 [GeForce GTX 1060 6GB]）。

接下来，访问Nvidia官方驱动下载网站。但这里有个关键点：不要直接下载网站首页给你的最新版驱动。对于Ubuntu 18.04（内核版本通常较老），最新驱动可能依赖更新的内核模块，导致安装失败。你应该查看Nvidia的“长期支持分支（Long Lived Branch）”或“生产就绪分支（Production Branch）”。

更稳妥的方法是，先查看Ubuntu官方仓库提供的驱动版本。执行：

ubuntu-drivers devices

这个命令会列出所有适用于你当前系统硬件的推荐驱动，包括开源和闭源版本。它会给出一个推荐版本（标记为recommended）。例如，输出可能包含driver : nvidia-driver-470 - third-party free recommended。这里的nvidia-driver-470就是一个相对稳定、与系统兼容性好的版本号。

注意：ubuntu-drivers命令是ubuntu-driver-common包的一部分，如果你的系统没有，可以先安装：sudo apt install ubuntu-drivers-common。

2.2 禁用罪魁祸首：Nouveau开源驱动

这是最关键的一步，也是导致安装后黑屏的元凶。Ubuntu默认使用开源的nouveau驱动来驱动Nvidia显卡。当我们要安装官方的闭源驱动时，两者会发生冲突，内核无法正确处理，导致图形界面崩溃。

禁用nouveau需要两个操作：将其加入内核黑名单，并更新初始内存盘（initramfs）。

首先，创建黑名单配置文件：

sudo nano /etc/modprobe.d/blacklist-nouveau.conf

在文件中输入以下内容：

blacklist nouveau options nouveau modeset=0

blacklist nouveau告诉内核不要加载nouveau模块。options nouveau modeset=0是双重保险，禁用该模块的内核模式设置功能。

保存退出后，更新initramfs。这个文件是系统启动初期加载的临时根文件系统，里面包含了启动所需的驱动模块。我们必须确保更新后的initramfs不包含nouveau。

sudo update-initramfs -u

操作完成后，必须重启系统。重启后，nouveau驱动应该已被禁用。你可以通过以下命令验证：

lsmod | grep nouveau

如果没有任何输出，说明禁用成功。此时，你的图形界面可能会变得非常卡顿，或者分辨率很低，这是正常的，因为系统现在没有合适的显卡驱动在运行。

2.3 进入纯命令行模式（Runlevel 3）

为了避免图形界面（X Server）对驱动安装过程的干扰，我们需要进入纯文本的多用户模式，也就是常说的运行级别3。

在Ubuntu 18.04中，可以使用以下命令：

sudo systemctl set-default multi-user.target sudo reboot

重启后，系统将直接进入命令行登录界面。

如果你在操作过程中已经处于图形界面，也可以使用快捷键Ctrl + Alt + F3（F1到F6通常对应不同的tty终端）切换到其中一个文本终端进行登录和后续操作。安装完成后，再用sudo systemctl set-default graphical.target改回图形界面启动。

3. 驱动安装的多种路径与选型

进入纯命令行环境后，我们就可以开始安装驱动了。主要有三种方法，各有优劣。

3.1 方法一：使用APT仓库安装（推荐首选）

这是最安全、最便于管理的方法。Ubuntu的官方仓库和Nvidia维护的PPA仓库提供了预编译的驱动包，它们能更好地与系统的包管理器和内核更新协同工作。

首先，添加NVIDIA的官方GPU驱动PPA（如果你需要比Ubuntu仓库更新的版本）：

sudo add-apt-repository ppa:graphics-drivers/ppa sudo apt update

然后，安装你在ubuntu-drivers devices中看到的推荐版本，例如470：

sudo apt install nvidia-driver-470

apt会自动处理驱动包的所有依赖，包括内核头文件（linux-headers-$(uname -r)）和编译工具。安装过程可能会比较长。

为什么推荐这种方法？

1. 自动管理：未来进行系统更新（sudo apt upgrade）时，驱动也会随之更新，并与新内核保持兼容。
2. 易于卸载：如果需要卸载，使用sudo apt remove --purge nvidia-driver-470即可清理干净。
3. 安全性：来自官方仓库的包经过签名和测试，相对可靠。

3.2 方法二：使用.run文件手动安装（高级/特定需求）

有时，你可能需要某个非常特定版本的驱动（例如某个CUDA版本明确要求的驱动），或者PPA里没有你需要的版本。这时就需要从Nvidia官网下载.run格式的安装包进行手动安装。

首先，在Nvidia官网根据你的显卡型号和系统类型（Linux 64-bit）下载对应的驱动文件，例如NVIDIA-Linux-x86_64-470.161.03.run。将其放到你的家目录下。

在安装前，必须确保系统已完全禁用Nouveau（如前所述），并且安装了必要的编译环境：

sudo apt update sudo apt install build-essential gcc make

如果你使用的是带安全启动（Secure Boot）的UEFI系统，还需要处理密钥签名问题，否则驱动无法加载。这通常更复杂，建议初学者在BIOS中暂时关闭Secure Boot。

接下来，给安装文件添加执行权限并运行：

chmod +x NVIDIA-Linux-x86_64-*.run sudo ./NVIDIA-Linux-x86_64-*.run

这时，安装程序会以字符界面运行。你会遇到几个关键选项：

• Would you like to register the kernel module sources with DKMS?：务必选择“Yes”。DKMS（Dynamic Kernel Module Support）是一个框架，它允许内核模块（如Nvidia驱动）在系统内核更新后自动重新编译适配。如果不启用，每次内核升级后你都需要手动重新安装驱动。
• Install NVIDIA's 32-bit compatibility libraries?：除非你明确需要运行32位程序，否则可以选“No”。
• Would you like to run the nvidia-xconfig utility...?：这个工具会自动帮你生成X Window的配置文件。对于大多数使用Ubuntu默认显示管理器（如GDM、LightDM）的用户，建议选择“No”。因为Ubuntu的显示管理器自己会处理配置，让nvidia-xconfig插手有时会导致配置冲突，引发登录循环。如果你选择“No”后图形界面有问题，可以再回来运行sudo nvidia-xconfig。

安装程序会编译内核模块并安装。完成后，重启系统。

3.3 方法三：使用ubuntu-drivers自动安装

这是一个更自动化的APT方式：

sudo ubuntu-drivers autoinstall

这个命令会自动识别硬件，并安装所有推荐的驱动包（包括Nvidia驱动）。它本质上是方法一的自动化封装。对于追求一键操作的用户很方便，但牺牲了对具体版本选择的控制权。

4. 安装后配置与验证

安装完成并重启后，我们需要验证驱动是否正常工作，并进行一些必要的配置。

4.1 基础验证

首先，回到图形界面（如果你之前切换到了运行级别3，执行sudo systemctl set-default graphical.target并重启）。登录后，打开终端，使用以下命令验证：

1. 查看驱动版本和显卡信息：

   nvidia-smi

   这是最重要的命令。它会输出一个表格，显示驱动版本、CUDA版本（如果安装了）、GPU型号、温度、功耗以及每个GPU上的进程信息。如果这个命令能正常执行并显示信息，恭喜你，驱动安装基本成功了。

2. 查看系统设置的“关于”或“详细信息”：在图形界面中，通常会在图形设置里看到显卡信息变成了“NVIDIA Corporation”及你的显卡型号，而不是之前的“llvmpipe”或“Gallium”。

3. 使用nvidia-settings工具：这是一个图形化配置工具。

   sudo apt install nvidia-settings nvidia-settings

   运行后可以查看更详细的GPU信息、调节屏幕分辨率、配置多显示器、甚至超频（谨慎操作）。

4.2 解决常见图形界面问题：登录循环与分辨率异常

即使nvidia-smi正常工作，有时也会遇到图形界面问题。

• 登录循环：输入密码后，屏幕一闪又回到登录界面。 这通常是因为显示管理器（如GDM3）的配置与Nvidia驱动冲突。首先，尝试在登录界面按Ctrl + Alt + F3切换到命令行，登录后，尝试重新配置GDM：

  sudo dpkg-reconfigure gdm3

  或者，如果你使用的是LightDM：

  sudo dpkg-reconfigure lightdm

  在 reconfigure 过程中，可能会让你选择默认的显示管理器，确认即可。 另一个常见原因是.Xauthority文件权限问题，可以尝试删除它（下次登录会自动生成）：

  sudo rm ~/.Xauthority

• 分辨率异常/无法使用最高分辨率： 这可能是由于显示管理器没有正确读取EDID信息。可以尝试使用xrandr命令临时设置，或者创建一个固定的Xorg配置文件。一个更简单的方法是使用nvidia-settings工具，在“X Server Display Configuration”里正确设置分辨率并保存到X配置文件（通常位于/etc/X11/xorg.conf）。但请注意，现代Ubuntu倾向于不使用全局的xorg.conf，而是使用/usr/share/X11/xorg.conf.d/下的片段式配置。在nvidia-settings中保存配置时，最好选择“Save to X Configuration File”，并保存到/etc/X11/xorg.conf.d/10-nvidia.conf这样的位置。

4.3 配置PRIME（针对笔记本双显卡用户）

如果你使用的是带有Intel集成显卡和Nvidia独立显卡的笔记本，你需要配置PRIME来在两者之间切换。Ubuntu 18.04默认使用nvidia-prime工具包。

安装后，你可以使用以下命令切换：

• 切换到NVIDIA显卡：sudo prime-select nvidia
• 切换到Intel集成显卡：sudo prime-select intel
• 查询当前使用的显卡：prime-select query

每次切换后都需要注销并重新登录才能生效。你可以通过运行glxinfo | grep “OpenGL renderer”来验证当前正在使用哪个GPU进行渲染。

5. CUDA与cuDNN的关联安装（为深度学习准备）

对于深度学习开发者，安装驱动只是第一步。接下来需要安装CUDA工具包和cuDNN库。

一个重要原则：先确定你要用的深度学习框架（如TensorFlow, PyTorch）所需的CUDA版本，然后根据这个CUDA版本的要求，去安装对应版本的Nvidia驱动。

例如，PyTorch 1.12可能要求CUDA 11.6，而CUDA 11.6要求驱动版本>=510.xx。你可以在Nvidia的官方文档中找到CUDA版本与驱动版本的对应关系。

安装CUDA有两种主要方式：

1. 使用APT仓库（推荐）：在Nvidia CUDA Toolkit下载页面，选择“runfile”安装方式，但下面会给出对应的仓库安装指令。例如，对于CUDA 11.6，你会得到类似下面的命令：

   wget https://developer.download.nvidia.com/compute/cuda/repos/ubuntu1804/x86_64/cuda-ubuntu1804.pin sudo mv cuda-ubuntu1804.pin /etc/apt/preferences.d/cuda-repository-pin-600 sudo apt-key adv --fetch-keys https://developer.download.nvidia.com/compute/cuda/repos/ubuntu1804/x86_64/7fa2af80.pub sudo add-apt-repository "deb https://developer.download.nvidia.com/compute/cuda/repos/ubuntu1804/x86_64/ /" sudo apt update sudo apt install cuda-11-6

   这种方式同样由包管理器管理，更干净。

2. 使用.run文件（手动）：下载巨大的runfile，在安装时切记不要重复安装驱动！在运行安装程序时，会有选项让你取消勾选驱动安装（因为我们已经装好了）。只安装CUDA Toolkit和CUDA Samples等组件。

安装cuDNN则需要从Nvidia开发者网站下载对应CUDA版本的库文件（通常是.tgz或.deb格式），按照官方指南解压并复制到CUDA目录中。

6. 疑难杂症排查与修复实录

即使按照步骤操作，也可能遇到奇怪的问题。这里记录几个我踩过的坑和解决方法。

6.1 内核更新后驱动失效

这是使用.run文件手动安装且未启用DKMS的典型后遗症。系统自动更新内核后，重启发现nvidia-smi命令找不到，图形界面可能回退到开源驱动。

解决方案： 如果你安装了DKMS，理论上它会自动为新内核重新编译模块。你可以手动触发：

sudo dkms install -m nvidia -v <你的驱动版本号>

如果你当初安装时没有启用DKMS，最彻底的方法是卸载现有驱动，用APT方式重装一次。手动卸载.run安装的驱动比较麻烦，可以尝试运行安装程序并选择卸载，或者直接使用APT安装覆盖。

6.2nvidia-smi显示“No devices were found”

这表示驱动加载了，但没有识别到GPU硬件。

1. 首先确认你的显卡是否被系统识别：lspci | grep -i nvidia。
2. 如果能看到硬件，可能是PCIe电源管理或复位问题。尝试在GRUB内核参数中添加pci=noaer或pci=realloc=off，然后更新GRUB并重启。
3. 对于某些笔记本，可能需要进入BIOS，确保独立显卡是“可切换显卡”或“独显直连”模式已开启，而不是被彻底禁用。

6.3 性能低下或风扇狂转

驱动安装成功，但感觉GPU没有全力工作，或者待机时风扇也很响。

1. 检查GPU运行模式：nvidia-smi -q | grep “Performance State”。正常情况桌面待机应该是P8（最低功耗）。
2. 安装nvidia-settings，在“PowerMizer”设置中，将模式从“自适应”改为“最高性能”可能会提升性能（但增加功耗和发热）。待机风扇狂转，可能是“自适应”模式下的Bug，可以尝试切换到“自动”或安装第三方工具如coolbits来手动控制风扇曲线（有风险）。

6.4 无法挂起或休眠（Suspend/Hibernate）

这是Linux上Nvidia驱动的老问题。挂起后无法唤醒，或唤醒后屏幕异常。

1. 尝试在GRUB参数中添加acpi_sleep=nonvs，并禁用nvidia模块的深睡眠状态：创建一个文件/etc/modprobe.d/nvidia-power.conf，加入options nvidia NVreg_EnableMSI=0 NVreg_SuspendTypes=2。
2. 这些方法不一定都有效，很大程度上取决于你的主板、BIOS和内核版本的组合。有时，最新的驱动反而能解决这些问题。

7. 维护与升级建议

系统是活的，驱动也需要维护。

1. 定期检查更新：如果你使用PPA方式安装，sudo apt update && sudo apt upgrade会连同驱动一起更新。更新后如果遇到问题，可以尝试切换到旧的驱动版本。PPA通常保留多个版本，你可以使用apt install nvidia-driver-XXX来安装特定版本。

2. 备份你的Xorg配置：如果你通过nvidia-settings或手动修改了/etc/X11/xorg.conf，在升级驱动或内核前，最好备份这个文件。因为升级过程有时会覆盖或修改它。

3. 关注内核更新：在进行重大的内核版本升级（例如从5.4升级到5.15）前，最好先查阅一下Nvidia官方论坛或Ubuntu社区，看看新内核与你当前驱动版本是否有已知的兼容性问题。稳妥的做法是，先升级内核，重启进入新内核后，再升级Nvidia驱动。

4. 清理旧内核：为了避免/boot分区被占满导致更新失败，定期清理旧内核镜像是个好习惯。可以使用sudo apt autoremove，或者使用ubuntu-cleaner等工具。

最后，我想说的是，在Linux上安装Nvidia驱动从“玄学”变成“可重复的工程”，关键就在于理解每个步骤的目的，并做好预案。这套流程在Ubuntu 18.04上非常稳定，其核心思想——禁用冲突驱动、进入纯净环境、选择合适安装源、善用DKMS——同样适用于Ubuntu 20.04、22.04等新版本，只是在一些细节命令（如关闭图形界面的命令）上略有不同。希望这篇超详细的指南能帮你一次成功，把时间花在更有创造性的工作上，而不是和驱动斗智斗勇。