debian驱动安装有哪些注意事项

Debian 驱动安装注意事项

一 源与依赖准备

• 优先使用发行版仓库安装闭源/专有驱动，编辑 /etc/apt/sources.list 确保启用 contrib 与 non-free（Debian 12 起还需 non-free-firmware），例如： deb http://deb.debian.org/debian/ bookworm main contrib non-free non-free-firmware 更新索引后再安装：sudo apt update。这样可获得与内核版本匹配的驱动与依赖，升级更安全。
• 安装匹配当前内核的头文件与构建工具，避免编译模块失败：sudo apt install linux-headers-$(uname -r) build-essential dkms。DKMS 用于在后续内核升级时自动重建专有内核模块。
• 若之前混用多种方式安装（如 .run 与 apt），先做彻底清理再装：sudo apt --purge remove “nvidia” “libxnvctrl” && sudo apt autoremove，减少冲突。

二 安全与兼容性设置

• 启用 Secure Boot 时，专有驱动（如 NVIDIA）常因签名问题加载失败。可在 BIOS 关闭 Secure Boot，或使用 MOK 注册密钥；安装前可用 mokutil --sb-state 检查状态。
• 使用 NVIDIA 专有驱动需禁用开源 nouveau：创建 /etc/modprobe.d/blacklist.conf，加入 blacklist nouveau options nouveau modeset=0 并在 GRUB 命令行添加 rd.driver.blacklist=nouveau，执行 sudo update-initramfs -u && sudo update-grub2 后重启；用 lsmod | grep nouveau 确认未加载。
• 安装或切换驱动前，建议切换到文本模式：sudo systemctl set-default multi-user.target，避免与正在运行的显示服务器冲突。
• 如确需使用 NVIDIA 官方 .run 文件（不推荐）：务必在文本模式、已禁用 nouveau、准备好头文件与 DKMS 的前提下执行；安装后按需重建 initramfs，并保留一份 DKMS 注册以便内核升级后自动编译模块。

三 安装方式与工具选择

• 优先选择包管理器安装：如 NVIDIA 可执行 sudo apt install nvidia-driver（或带版本号 nvidia-driver-xxx），仓库驱动与内核、X/Wayland 栈的适配更稳妥。
• 需要 DKMS 的场景：内核升级后模块能自动重建。若发现模块未随新内核加载，可手动执行：sudo dkms install -m nvidia -v <版本号>（版本号可在 /usr/src 下查到）。
• 源中无匹配驱动或需最新特性时，再考虑手动编译：
  • 使用 module-assistant（m-a）：sudo apt install module-assistant build-essential，随后 m-a prepare，m-a a-i <驱动名> 自动获取、编译并安装模块。
  • 厂商源码编译：按 README 执行 make/make install，注意与当前 内核头文件版本一致，并在需要时更新 initramfs。

四 验证与故障排查

• 基础验证：lspci | grep -E “VGA|3D” 确认 GPU 被识别；lsmod | grep nouveau 确认已禁用；nvidia-smi 或 nvitop 检查驱动与 GPU 状态。
• 显示会话与电源管理：
  • 使用 Wayland 时，可在 /etc/default/grub.d/nvidia-modeset.cfg 加入 GRUB_CMDLINE_LINUX=“$GRUB_CMDLINE_LINUX nvidia-drm.modeset=1” 并更新 GRUB，随后重启；部分桌面环境在 Wayland 下对 NVIDIA 支持仍不如 X11 稳定。
  • 启用挂起/休眠/恢复电源管理：sudo apt install nvidia-suspend-common，sudo systemctl enable nvidia-{suspend,hibernate,resume}.service；必要时设置内核参数 NVreg_PreserveVideoMemoryAllocations=1 以减少挂起恢复问题。
• 常见故障处理：
  • 黑屏/循环登录：多因 nouveau 未禁用、DKMS 未注册、或 Xorg 配置错误。检查 /etc/X11/xorg.conf 与备份文件冲突，必要时恢复备份；切到旧内核或文本模式修复 DKMS 注册与 initramfs。
  • 升级后模块未加载：用 dkms status 查看，执行 dkms install 重建；必要时重新生成 initramfs 并更新 GRUB。