Установка драйверов NVIDIA на Debian 13, 12, 11: подробное руководство

Драйверы NVIDIA необходимы для полноценной работы видеокарт этого производителя в Debian. Они обеспечивают аппаратное ускорение 3D-графики, позволяют играть в игры, использовать CUDA для вычислений (машинное обучение, рендеринг) и подключать несколько мониторов.

В этом обновлённом руководстве мы разберём два способа установки, которые реально работают на сегодняшний день:

  1. Из официальных репозиториев Debian (рекомендуемый, стабильный). Подходит для всех версий Debian.
  2. Из официального репозитория NVIDIA CUDA (для самых новых видеокарт и открытых модулей). Работает только на Debian 12 и 13.

⚠️ Важнейшие предупреждения:

  • Secure Boot: Драйверы NVIDIA могут не загрузиться, если он включён. В статье есть подробный раздел по его настройке (MOK).
  • Новый способ добавления репозитория: NVIDIA изменила метод, старый curl больше не работает (ошибка 403). Мы будем использовать официальный DEB-пакет cuda-keyring.
  • Правильная команда установки: Никогда не устанавливайте nvidia-smi отдельно! Это вызывает конфликт зависимостей. Он устанавливается автоматически.

Оглавление

1. Предварительные требования и подготовка системы

Перед установкой убедитесь, что:

  • У вас 64-битная (amd64/x86_64) версия Debian 11, 12 или 13.
  • Ваш компьютер имеет видеокарту NVIDIA (проверьте: lspci | grep -E "VGA|3D" | grep -i nvidia).

⚠️ ВАЖНО: Проверьте права sudo перед установкой

Если вы не уверены, есть ли у вашего пользователя права администратора, выполните в терминале:

sudo whoami

✅ Ожидаемый вывод: root

❌ Если выводит is not in the sudoers file — сначала пройдите наше руководство по настройке sudo.

1.1. Обновление системы и установка заголовков ядра

Перед установкой всегда обновляйте список пакетов и устанавливайте заголовки ядра. Это нужно для сборки модулей драйвера.

sudo apt update
sudo apt install linux-headers-$(uname -r) build-essential dkms -y

Что делает: Устанавливает заголовки вашего текущего ядра, компиляторы и инструмент DKMS для автоматической пересборки модулей.

1.2. Включение репозиториев contrib и non-free

Драйверы NVIDIA находятся в не-free репозиториях, которые по умолчанию отключены.

Для Debian 13 и 12 (файл /etc/apt/sources.list.d/debian.sources):

sudo sed -i 's/Components: main/Components: main contrib non-free non-free-firmware/' /etc/apt/sources.list.d/debian.sources

Для Debian 11 (файл /etc/apt/sources.list):

sudo sed -i 's/main$/main contrib non-free/' /etc/apt/sources.list

После включения обновите список пакетов:

sudo apt update

2. Способ 1: Установка из официальных репозиториев Debian (рекомендуемый)

Этот метод использует проверенные пакеты Debian. Он наиболее стабилен и подходит для большинства пользователей.

2.1. Определение подходящего драйвера (опционально)

Установите утилиту nvidia-detect, которая сама определит вашу карту и посоветует нужный драйвер:

sudo apt install nvidia-detect -y
nvidia-detect

Что делает: Анализирует вашу видеокарту и рекомендует пакет драйвера.

2.2. Установка драйвера и утилит

Установите драйвер и панель управления NVIDIA. Утилита nvidia-smi будет установлена автоматически как зависимость.

sudo apt install nvidia-driver nvidia-settings -y

Что делает: Устанавливает основной драйвер и графическую утилиту для настройки.

Версия DebianВерсия драйвера NVIDIA по умолчанию
Debian 13 (Trixie)550.xx
Debian 12 (Bookworm)535.xx
Debian 11 (Bullseye)470.xx (также доступен 390.xx для старых карт)

2.3. (Только для Debian 11) Установка драйвера для очень старых видеокарт

Если nvidia-detect рекомендует nvidia-legacy-390xx-driver, выполните:

sudo apt install nvidia-legacy-390xx-driver nvidia-settings-legacy-390xx -y

2.4. Перезагрузка

После установки драйвера обязательно перезагрузите систему, чтобы модуль ядра загрузился.

sudo reboot

3. Способ 2: Установка из репозитория NVIDIA CUDA (только Debian 12/13)

Этот метод даёт самые новые драйверы, включая открытые модули ядра (для видеокарт Turing и новее: RTX 20xx, 30xx, 40xx). Debian 11 не поддерживается этим способом.

3.1. Определение типа GPU

Чтобы узнать, можете ли вы использовать открытые модули, определите архитектуру вашей видеокарты:

lspci | grep -E "VGA|3D" | grep -i nvidia
  • Turing (RTX 20xx) и новее: Можете использовать открытые модули (nvidia-kernel-open-dkms).
  • Pascal (GTX 10xx) и старше: Используйте только проприетарные модули (nvidia-kernel-dkms).

3.2. Добавление официального репозитория NVIDIA

Это критически важный шаг! NVIDIA изменила способ добавления репозитория. Используйте готовый DEB-пакет cuda-keyring.

Для Debian 13 (Trixie):

wget https://developer.download.nvidia.com/compute/cuda/repos/debian13/x86_64/cuda-keyring_1.1-1_all.deb
sudo dpkg -i cuda-keyring_1.1-1_all.deb

Для Debian 12 (Bookworm):

wget https://developer.download.nvidia.com/compute/cuda/repos/debian12/x86_64/cuda-keyring_1.1-1_all.deb
sudo dpkg -i cuda-keyring_1.1-1_all.deb

Что делает: Скачивает и устанавливает официальный пакет с ключом и настройками репозитория NVIDIA.

Теперь обновите список пакетов:

sudo apt update

3.3. Выбор типа драйвера и установка

Вариант А: Проприетарные модули (максимальная совместимость)

Подходит для любых карт, включая старые.

sudo apt install nvidia-driver nvidia-settings -y

Вариант Б: Открытые модули ядра (только для Turing и новее)

Рекомендуется для новых карт (RTX 20xx, 30xx, 40xx, 50xx).

sudo apt install nvidia-driver nvidia-kernel-open-dkms nvidia-settings -y

Обратите внимание, что в обоих вариантах мы не указываем nvidia-smi отдельно.

3.4. Перезагрузка

sudo reboot

4. Настройка Wayland для NVIDIA (опционально)

Если вы используете Wayland, для корректной работы драйверов NVIDIA требуется включить DRM modesetting.

4.1. Проверка и включение DRM modesetting

Проверьте, включён ли modesetting:

cat /sys/module/nvidia_drm/parameters/modeset

Если вывод N, включите его:

echo "options nvidia-drm modeset=1" | sudo tee /etc/modprobe.d/nvidia-drm.conf
sudo update-initramfs -u

4.2. Настройка сервисов энергосбережения (для ноутбуков)

sudo apt install nvidia-suspend-common -y
sudo systemctl enable nvidia-suspend.service nvidia-hibernate.service nvidia-resume.service

4.3. Перезагрузка

sudo reboot

5. Решение типичных проблем

5.1. Ошибка 403 при импорте GPG-ключа

Симптом: При попытке добавить репозиторий старым методом (через curl) вы получаете ошибку curl: (22) The requested URL returned error: 403.

Причина: NVIDIA изменила способ распространения ключей и репозиториев.

Решение: Используйте официальный DEB-пакет cuda-keyring, как описано в разделе 3.2.

5.2. Конфликт пакетов nvidia-smi

Симптом: При установке возникает ошибка Conflicts: nvidia-smi или nvidia-smi : Depends: nvidia-alternative (= ...) but ... is to be installed.

Причина: Пакет nvidia-smi является транзитным и конфликтует с основным драйвером.

Решение: Никогда не устанавливайте nvidia-smi вручную. Он автоматически устанавливается вместе с nvidia-driver. Используйте команды, приведённые в этой статье (без nvidia-smi).

5.3. Secure Boot блокирует загрузку модуля (MOK)

Симптом: После установки драйвера и перезагрузки система продолжает использовать драйвер Nouveau, или вы видите чёрный экран.

Причина: Если Secure Boot включён в BIOS/UEFI, система не загрузит неподписанный модуль ядра NVIDIA.

Решение (без отключения Secure Boot в BIOS):

Шаг 1: Установите необходимые пакеты.

sudo apt install mokutil openssl

Шаг 2: Сгенерируйте и импортируйте сертификат.

sudo dkms generate_mok
sudo mokutil --import /var/lib/dkms/mok.pub

Шаг 3: Придумайте и введите одноразовый пароль. Система запросит его дважды.

Шаг 4: Перезагрузитесь.

sudo reboot

Шаг 5: При загрузке появится синий экран менеджера ключей (MOK). Выберите:

  • Enroll MOK → Continue → Yes → введите ваш одноразовый пароль → Reboot.

После этого система загрузится с подписанным модулем NVIDIA.

5.4. Чёрный экран или падение X11/SDDM при первом запуске (Debian 13)

Симптом: После установки драйверов и перезагрузки графическая оболочка (например, KDE Plasma) не запускается, но после переключения на TTY (Ctrl+Alt+F2) и рестарта дисплейного менеджера всё работает.

Причина: Рендер-устройства NVIDIA не успевают инициализироваться к моменту запуска дисплейного менеджера (SDDM).

Решение: Добавьте модули NVIDIA в раннюю загрузку.

sudo install -d /etc/dracut.conf.d
printf '%s\n' 'add_drivers+=" nvidia nvidia_modeset nvidia_uvm nvidia_drm "' | sudo tee /etc/dracut.conf.d/nvidia-modules.conf > /dev/null
sudo dracut --force
sudo reboot

5.5. nvidia-smi: command not found

Симптом: После установки драйвера команда nvidia-smi не найдена.

Решение: Убедитесь, что вы устанавливали драйвер без явного указания nvidia-smi. Если он всё равно не появился, попробуйте переустановить nvidia-driver:

sudo apt install --reinstall nvidia-driver

5.6. NVIDIA-SMI не может взаимодействовать с драйвером

Симптом: Команда nvidia-smi выдаёт ошибку NVIDIA-SMI has failed because it couldn't communicate with the NVIDIA driver.

Причина: Модуль ядра не загружен или не собран.

Решение: Проверьте статус DKMS и пересоберите модуль.

sudo dkms status
sudo dkms autoinstall
sudo update-initramfs -u
sudo reboot

5.7. Ошибка Xorg при запуске (Debian 13 и KDE)

Симптом: Ошибка в логах Xorg (/var/log/Xorg.0.log) и падение SDDM.

Решение (альтернативное к п. 5.4): Добавьте задержку перед запуском SDDM.

sudo install -d /etc/systemd/system/sddm.service.d
printf '%s\n' '[Service]' 'ExecStartPre=/bin/sleep 2' | sudo tee /etc/systemd/system/sddm.service.d/nvidia-wait.conf > /dev/null
sudo systemctl daemon-reload
sudo reboot

6. Проверка установки

После загрузки выполните проверку:

nvidia-smi

✅ Ожидаемый вывод: Таблица с драйвером, CUDA версией и вашей видеокартой.

nvidia-settings

✅ Ожидаемый вывод: Откроется графическое окно с настройками NVIDIA.

7. Удаление драйверов NVIDIA

Если вам нужно вернуться к драйверу Nouveau или переустановить драйверы:

7.1. Удаление пакетов

sudo apt purge nvidia* -y
sudo apt autoremove -y

7.2. Удаление репозитория NVIDIA CUDA (если использовали)

sudo apt purge cuda-keyring
sudo rm -f /etc/apt/sources.list.d/nvidia-drivers.list
sudo apt update

7.3. Удаление файлов конфигурации MOK (если настраивали)

sudo rm -f /etc/modprobe.d/nvidia-drm.conf
sudo update-initramfs -u

7.4. Перезагрузка

sudo reboot

8. Чек-лист: всё готово к работе

  • [ ] Драйвер NVIDIA установлен: nvidia-smi работает.
  • [ ] Графическая оболочка запускается: нет чёрного экрана.
  • [ ] NVIDIA Settings (nvidia-settings) открывается.
  • [ ] Для Wayland: cat /sys/module/nvidia_drm/parameters/modeset показывает Y.
  • [ ] Secure Boot не блокирует загрузку: модуль ядра успешно подписан (если включён).

Заключение

Вы успешно установили драйверы NVIDIA на Debian, используя самый актуальный и безопасный метод. Теперь ваша видеокарта работает на полную мощность.

Что дальше?

  • Игры: Установите Steam на Debian.
  • Машинное обучение: Установите CUDA Toolkit.
  • Ноутбуки с Optimus: Настройте PRIME render offload (отдельное руководство).

Связанные записи