DKMS 与内核模块管理：模块加载、参数定制与自动编译

Linux 采用了**可扩展的单内核（Monolithic Kernel）架构。这意味着除了核心的进程调度与内存管理外，绝大多数硬件驱动程序、文件系统支持和网络协议栈都是以内核模块（Kernel Modules，.ko 文件）**的形式存在的。内核模块可以在系统运行时动态加载到内核空间或从中卸载，无需重启整个操作系统。

然而，当使用第三方（Out-of-Tree）驱动（例如 NVIDIA 专有显卡驱动、Realtek 无线网卡驱动或 VirtualBox 虚拟机模块）时，每次升级发行版内核，原有的二进制模块就会因为内核 ABI 不兼容而失效。DKMS（Dynamic Kernel Module Support） 正是解决这一痛苦难题的关键利器。

本文将系统介绍 Linux 内核模块的常规管理命令、/etc/modprobe.d/ 参数定制与驱动黑名单机制，并深度拆解 DKMS 的工作原理与自动化实战。

1. 内核模块基本管理与核心指令

在 Linux 中，内核模块存放于 /lib/modules/$(uname -r)/ 目录下，以 .ko（Kernel Object）或压缩的 .ko.zst / .ko.xz 形式存在。

/lib/modules/6.12.10-arch1-1/
├── kernel/
│   ├── drivers/          # 各种硬件驱动 (net, gpu, usb, bluetooth...)
│   ├── fs/               # 文件系统模块 (btrfs, ext4, zfs...)
│   └── net/              # 网络协议模块
├── modules.dep           # 模块依赖关系映射表 (由 depmod 生成)
└── modules.alias         # 硬件 VID/PID 与模块别名表

1.1 查看与检索已加载模块

lsmod 命令

lsmod 读取 /proc/modules 虚拟文件，列出当前已动态加载到内存中的所有内核模块：

lsmod | head -n 10

输出样例：

Module                  Size  Used by
nvidia_uvm           3522560  0
nvidia_modeset       1605632  4
nvidia              66191360  117 nvidia_uvm,nvidia_modeset
snd_hda_intel          61440  5
snd_intel_dspcfg       36864  1 snd_hda_intel
btrfs                2097152  1
  • Module：模块名称。
  • Size：模块在内核空间占用的内存大小（字节）。
  • Used by：引用计数及依赖该模块的其他内核模块列表。

modinfo 命令

使用 modinfo 查看特定模块的详细元数据（包括作者、许可证、所支持的硬件参数与配置项）：

modinfo nvidia

输出关键字段：

  • filename：模块物理存储路径。
  • vermagic：编译该模块时使用的内核版本及 GCC 版本（用于校验 ABI 兼容性）。
  • parm：模块支持的配置参数及其类型说明。

1.2 动态加载与卸载模块：modprobe vs insmod

智能加载命令：modprobe

在现代 Linux 中，强烈建议使用 modprobe 而非低级的 insmod。modprobe 会自动查询 /lib/modules/$(uname -r)/modules.dep 依赖数据库，按正确顺序递归加载目标模块及其依赖的所有父模块。

# 1. 动态加载无线网卡模块及其所有依赖
sudo modprobe iwlwifi
 
# 2. 传递临时参数启动模块
sudo modprobe iwlwifi power_save=0
 
# 3. 卸载模块及其未使用的依赖模块 (-r 即 --remove)
sudo modprobe -r iwlwifi

依赖数据库重建：depmod

当手动向 /lib/modules/$(uname -r)/ 添加或替换了 .ko 文件后，必须运行以下命令重建依赖映射树：

sudo depmod -a
⚠️ 为什么不推荐使用 insmod / rmmod？

insmod 和 rmmod 是直接对底层文件路径操作的低级工具。它们不会解析模块间的依赖关系。如果你尝试使用 insmod 加载一个缺少依赖的模块，系统将抛出 Unknown symbol in module 错误并拒绝加载。

2. 内核模块参数定制与黑名单配置

许多驱动模块在默认状态下可能无法发挥最佳性能，或者开源驱动与专有驱动之间会产生冲突。Linux 提供了全局配置目录 /etc/modprobe.d/ 来持久化设置模块参数与黑名单。

在该目录下创建以 .conf 结尾的配置文件（例如 /etc/modprobe.d/custom-drivers.conf）。

2.1 驱动参数定制 (options)

语法：options <module_name> <parameter1>=<value1> <parameter2>=<value2>

实战场景 A：为 NVIDIA 显卡开启显存保护与 G-Sync 模式

# /etc/modprobe.d/nvidia.conf
options nvidia NVreg_PreserveVideoMemoryAllocations=1 NVreg_EnableGpuFirmware=0

实战场景 B：禁用 Intel 无线网卡的节能断连模式

# /etc/modprobe.d/iwlwifi.conf
options iwlwifi power_save=0 11n_disable=8

2.2 驱动黑名单与强禁用 (blacklist & install)

当系统接入某个硬件时，Linux 内核的 udev 机制会自动加载适配的默认驱动。但在安装专有驱动（如 NVIDIA 官方驱动）时，必须禁止开源驱动（如 nouveau）加载。

语法 1：标准黑名单 (blacklist)

# /etc/modprobe.d/blacklist-nouveau.conf
blacklist nouveau

注意：blacklist 仅防止 udev 自动加载该模块。如果其他未屏蔽的模块显式依赖了 nouveau，它仍然会被带入加载。

语法 2：绝对强禁用 (install /bin/true)

若要彻底杜绝某模块在任何情况下被加载，可使用重定向欺骗：

# /etc/modprobe.d/blacklist-nouveau.conf
blacklist nouveau
options nouveau modeset=0
install nouveau /bin/false

这指示 modprobe 在尝试加载 nouveau 时，执行 /bin/false（立即返回失败），从而达到 100% 的强隔离效果。

配置更新后，如果该驱动属于 Early-boot（系统早期引导需要）模块，别忘了刷新 initramfs：

# Arch Linux
sudo mkinitcpio -P
 
# Ubuntu / Debian
sudo update-initramfs -u

3. DKMS (Dynamic Kernel Module Support) 原理与实战

3.1 为什么需要 DKMS？

在 Linux 内核演进中，内核内部 ABI (Application Binary Interface) 并不保持稳定。每当系统升级内核（例如从 6.11.5 升级到 6.12.1），内核模块的函数符号和内存结构都会发生变化。

              ┌────────────────────────────────────────────────────────┐
              │             更新系统内核 (e.g. 6.11 -> 6.12)           │
              └───────────────────────────┬────────────────────────────┘
                                          │
                   ┌──────────────────────┴──────────────────────┐
                   ▼                                             ▼
     ┌───────────────────────────┐                 ┌───────────────────────────┐
     │   In-Tree 源码树模块       │                 │   Out-of-Tree 第三方驱动   │
     │ (随内核一同自动重新编译)    │                 │ (NVIDIA/Realtek/VirtualBox)│
     └───────────────────────────┘                 └─────────────┬─────────────┘
                                                                 │
                                                       ┌─────────┴─────────┐
                                                       ▼                   ▼
                                                【未安装 DKMS】      【已配置 DKMS】
                                                       │                   │
                                                       ▼                   ▼
                                                💥 模块无法加载      ✨ 自动触发后台编译
                                                (黑屏/无网卡驱动)    (生成新内核 .ko)

DKMS 是由 Dell 发起并由开源社区维护的框架。它的核心逻辑是：将第三方驱动的 C 源码保存在系统目录中。每当系统安装了新的 kernel-headers（内核头文件），DKMS 会在后台自动调用 GCC/Clang 针对新内核重新编译并安装驱动模块。

3.2 DKMS 核心工作流程与命令行

DKMS 的源码与构建基底位于 /usr/src/<module>-<version>/ 目录。

1. 查看当前 DKMS 模块状态

dkms status

输出示例：

nvidia/565.77, 6.12.9-arch1-1, x86_64: installed
nvidia/565.77, 6.12.10-arch1-1, x86_64: installed
vboxhost/7.1.4, 6.12.10-arch1-1, x86_64: installed

2. 手动构建与管理 DKMS 模块（当自动化构建失败时排错）

DKMS 模块的管理分为 4 个标准步骤：

# 步骤 1：向 DKMS 树注册源码 (要求 /usr/src/rtl8821ce-5.5.2.1 目录及 dkms.conf 存在)
sudo dkms add -m rtl8821ce -v 5.5.2.1
 
# 步骤 2：针对特定内核版本进行编译 (如省略 -k，则默认针对当前 running 内核)
sudo dkms build -m rtl8821ce -v 5.5.2.1 -k 6.12.10-arch1-1
 
# 步骤 3：将编译好的 .ko 模块安装到 /lib/modules/ 下
sudo dkms install -m rtl8821ce -v 5.5.2.1 -k 6.12.10-arch1-1
 
# 步骤 4：卸载或移除历史旧模块
sudo dkms remove -m rtl8821ce -v 5.5.2.1 --all

3.3 手动为源码编写 dkms.conf 实例

假设你从 GitHub 克隆了一个没有打包的 Out-of-tree 驱动源码 mywifi，想要让它支持 DKMS 自动升级。只需在其源码根目录下创建 dkms.conf 文件：

# /usr/src/mywifi-1.0.0/dkms.conf
 
PACKAGE_NAME="mywifi"
PACKAGE_VERSION="1.0.0"
 
# 指定生成的模块名称 (不带 .ko 后缀)
BUILT_MODULE_NAME[0]="mywifi"
 
# 指定模块在 /lib/modules/$(uname -r)/updates/ 中的目标子目录
DEST_MODULE_LOCATION[0]="/kernel/drivers/net/wireless"
 
# 构建使用的 Make 指令 (使用内核头文件构建树)
MAKE[0]="make -C ${kernel_source_dir} M=${dkms_tree}/${PACKAGE_NAME}/${PACKAGE_VERSION}/build modules"
 
# 清理指令
CLEAN="make -C ${kernel_source_dir} M=${dkms_tree}/${PACKAGE_NAME}/${PACKAGE_VERSION}/build clean"
 
# 自动引导支持
AUTOINSTALL="yes"

编写完毕后，将整包拷贝至 /usr/src/mywifi-1.0.0/，运行 sudo dkms add -m mywifi -v 1.0.0 即可纳入 DKMS 的自动编译管辖！

4. 内核升级触发机制与故障排查

4.1 自动构建挂钩 (Hook) 原理

当你使用包管理器（apt、pacman 或 dnf）升级内核时，包管理器会自动触发包后处理脚本（Package Hooks）：

  • Debian/Ubuntu：/etc/kernel/postinst.d/dkms 自动被调用。
  • Arch Linux：alpm hook 触发 /usr/share/libalpm/hooks/71-dkms-install.hook。

它会检索所有状态为 AUTOINSTALL="yes" 的 DKMS 模块，遍历系统上安装的所有内核头文件，自动完成后台编译。

4.2 DKMS 编译失败快速定位

如果在内核升级后，发现显卡驱动未生效或网络断开，通常是由于新内核改动了某些 API 导致 DKMS 编译报错。

第一步：检查失败状态

dkms status

如果输出显示 added 或 built 但缺少 installed，说明编译或安装过程遇到了错误。

第二步：调取编译日志

DKMS 会为每一次构建保存日志，位于 /var/lib/dkms/<module>/<version>/build/make.log：

cat /var/lib/dkms/nvidia/565.77/build/make.log | grep -i error

常见原因与解决方案：

  1. 缺少 kernel-headers：安装匹配新内核版本的头文件（如 linux-headers 或 kernel-devel）。
  2. C 源码与新内核 API 不兼容：检查 Git 仓库是否有适配新内核版本的 Patch，或升级该第三方驱动至最新 upstream 版本。

5. 总结

掌握内核模块的管理与 DKMS 的运作机制，是确保 Linux 系统在升级内核时硬件驱动稳如磐石的关键保障。

  • 使用 lsmod / modprobe 进行运行时驱动的诊断与按需加载。
  • 在 /etc/modprobe.d/*.conf 中配置驱动参数与禁用冲突的开源/专有驱动。
  • 依靠 DKMS 将 Out-of-tree 第三方驱动纳入自动化源码构建生命周期，摆脱“一升级内核就黑屏/断网”的魔咒。
Previous
Linux 内核编译与定制：打补丁与 Zen/TkG 性能内核实战
Next
蓝牙与无线驱动排坑：BlueZ 实战与网卡驱动解决指南
Navigation