Debian Minimal如何安装GPU驱动

Debian Minimal 安装 GPU 驱动

一 准备与识别显卡

• 更新索引并安装必要工具（Minimal 默认可能未装 lspci）：
  sudo apt update && sudo apt install -y pciutils
• 识别显卡型号与当前内核模块：
  lspci | grep -iE ‘VGA|3D|Display’
  lspci -k | grep -EA3 ‘VGA|3D|Display’
• 确认内核头文件与构建工具（编译内核模块需要）：
  sudo apt install -y linux-headers-$(uname -r) build-essential
  以上步骤为后续安装 NVIDIA/AMD 驱动的共同准备。

二 安装 NVIDIA 显卡驱动

• 启用 non-free 仓库（Debian 12/Bookworm 建议同时启用 non-free-firmware）：
  echo “deb https://deb.debian.org/debian bookworm main contrib non-free non-free-firmware” | sudo tee /etc/apt/sources.list.d/non-free.list
  sudo apt update
• 安装驱动与依赖：
  sudo apt install -y nvidia-driver firmware-misc-nonfree
• 如系统使用 Secure Boot，安装过程中会生成密钥并提示注册到 MOK；按屏幕指引完成，否则 nvidia 内核模块不会加载。
• 重启：
  sudo reboot
• 验证：
  nvidia-smi
  lsmod | grep nvidia
  若提示找不到 nvidia-smi，多为未装驱动、Secure Boot 未注册或 nouveau 仍在占用，见下文排错。

三 安装 AMD 显卡驱动

• 大多数 AMD GPU 使用内核内置的 amdgpu 驱动，Minimal 只需确保系统更新与基础组件：
  sudo apt update && sudo apt full-upgrade
  sudo apt install -y mesa-utils xserver-xorg-video-amdgpu firmware-amd-graphics
• 验证：
  glxinfo | grep -i “renderer”
  lspci -k | grep -i amdgpu
• 如需 ROCm（机器学习/计算场景），请参考 Debian 官方 ROCm 文档，按硬件与内核版本选择对应版本，过程较复杂，不建议在 Minimal 上自行混装闭源 Catalyst。

四 安装 Intel 显卡驱动

• Intel 显卡驱动已集成在 Linux 内核 与 Mesa 中，Minimal 通常无需额外安装：
  sudo apt update && sudo apt full-upgrade
  sudo apt install -y mesa-utils xserver-xorg-video-intel
• 验证：
  glxinfo | grep -i “renderer”
  lspci -k | grep -i vga
  如为较新的 Arc 系列，确保启用 non-free-firmware 并更新内核以获得完整支持。

五 常见问题与排错

• 黑屏/循环登录：多因 Secure Boot 未注册 NVIDIA MOK。重启进入 MOK 管理界面完成注册，或暂时禁用 Secure Boot。
• 驱动未生效/仍用 nouveau：
  • 检查黑名单：cat /etc/modprobe.d/blacklist-nouveau.conf
  • 更新 initramfs：sudo update-initramfs -u
  • 重启后再试
• 找不到 nvidia-smi：
  • 确认已安装 nvidia-driver 与对应内核头文件
  • 检查 Secure Boot 状态与 MOK 注册
  • 查看内核日志：dmesg | grep -i nvidia
• 虚拟机场景：
  • NVIDIA vGPU/GRID 需 vGPU 驱动与授权，普通虚拟机通常仅使用 virtio 或 SVGA 驱动，无需安装 NVIDIA 专有驱动。
  • AMD/Intel 直通或嵌套虚拟化需按宿主机与显卡型号配置，安装步骤与物理机不同。