Debian 显卡驱动安装指南
一、准备与识别显卡
- 更新软件源并安装识别工具:
- sudo apt update
- sudo apt install -y pciutils lspci
- 查看显卡型号与厂商:
- lspci | grep -iE “vga|3d|display”
- 确认当前是否在使用开源 nouveau(NVIDIA 显卡常见):
- 建议准备可回退的环境(如保留一个 TTY 或恢复模式入口),并在操作前备份重要数据。
二、NVIDIA 专有驱动推荐安装(apt 方式)
- 启用 non-free 与 non-free-firmware(以 bookworm 为例,其他版本替换为对应代号):
- 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-detect
- nvidia-detect
- 安装推荐驱动(将“推荐包名”替换为 nvidia-detect 的输出):
- sudo apt install -y nvidia-driver firmware-misc-nonfree
- 可选:安装 32 位兼容库(部分应用需要)sudo apt install -y nvidia-driver-libs:i386
- 处理 Secure Boot(常见现象是重启后出现 MOK 管理器):
- 查看待导入密钥:sudo mokutil --list-new
- 导入密钥:sudo mokutil --import /var/lib/dkms/mok.pub(设置一次性密码)
- 重启,在 MOK 界面选择 Enroll MOK → Continue → Confirm,输入一次性密码完成注册
- 重启并验证:
- sudo reboot
- nvidia-smi
- 如出现图形问题,可用 sudo nvidia-xconfig 生成基础 Xorg 配置后再调整。
三、NVIDIA 官方 .run 安装(备选,适合需要特定版本或高级定制)
- 安装编译依赖与内核头文件:
- sudo apt install -y build-essential dkms linux-headers-$(uname -r)
- 禁用 nouveau 并更新 initramfs:
- echo -e “blacklist nouveau\noptions nouveau modeset=0” | sudo tee /etc/modprobe.d/blacklist-nouveau.conf
- sudo update-initramfs -u
- sudo reboot
- 进入纯文本控制台并关闭显示管理器(以 gdm3 为例,其他如 lightdm/gdm 类似):
- sudo systemctl isolate multi-user.target
- sudo systemctl stop gdm3
- 赋予执行权限并安装(建议使用 DKMS 以适配后续内核升级):
- chmod +x NVIDIA-Linux-x86_64-*.run
- sudo ./NVIDIA-Linux-x86_64-*.run --dkms --no-x-check --no-cc-version-check
- 安装过程中的常见选项:
- 选择为 DKMS 注册内核模块
- 32 位兼容库可按需选择
- X 配置建议选择 “No”(由系统或 nvidia-xconfig 后续生成)
- 重启并验证:
四、AMD 与 Intel 显卡
- AMD:现代 AMDGPU 驱动已在内核与 Mesa 中,通常无需额外安装专有驱动。建议:
- 确保启用 non-free-firmware(如 bookworm:/etc/apt/sources.list 中加入 non-free-firmware)
- sudo apt update && sudo apt install -y firmware-amd-graphics mesa-utils
- 验证:glxinfo | grep “OpenGL renderer”
- Intel:桌面与移动平台一般使用内核 i915 驱动与 Mesa,直接可用:
- sudo apt update && sudo apt install -y mesa-utils
- 验证:glxinfo | grep “OpenGL renderer”
五、常见问题与回退
- 无法进入图形界面或黑屏:
- 在 TTY 检查日志:cat /var/log/Xorg.0.log
- 回退:切换控制台,执行 sudo apt purge nvidia-*,移除黑名单并重建 initramfs:sudo update-initramfs -u,再重启
- Secure Boot 导致驱动未加载:
- 确认已通过 MOK 注册密钥;如未注册,按第二部分步骤导入并重启
- 内核升级后驱动失效:
- 使用 DKMS 的 NVIDIA 驱动会自动重建模块;若未使用 DKMS,需重新安装对应内核头文件并重建模块
- 验证命令汇总:
- NVIDIA:nvidia-smi、cat /proc/driver/nvidia/gpus/*/information 2>/dev/null
- OpenGL/渲染:glxinfo | grep “OpenGL renderer”
- 模块状态:lsmod | grep nvidia(或 lsmod | grep nouveau)