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

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

💡 В этом руководстве мы установим драйверы NVIDIA через стандартные репозитории Debian (рекомендуется для большинства) и через репозиторий NVIDIA CUDA (для самых новых видеокарт). Также разберём настройку Wayland, решение типичных проблем и полное удаление драйверов.

⚠️ Важно: Неправильная установка драйверов NVIDIA может привести к чёрному экрану или невозможности загрузить графическую оболочку. Внимательно следуйте инструкции, особенно при работе с удалённым сервером (если у вас нет физического доступа к консоли).

В этой статье вы узнаете:

  • Как подготовить Debian к установке драйверов NVIDIA
  • Как установить драйверы из официальных репозиториев Debian (метод 1)
  • Как установить новейшие драйверы из репозитория NVIDIA CUDA (метод 2)
  • Как настроить Wayland для работы с NVIDIA
  • Как решить типичные проблемы (чёрный экран, ошибки DKMS, конфликты пакетов)
  • Как полностью удалить драйверы NVIDIA

Для кого: владельцы видеокарт NVIDIA, геймеры, специалисты по машинному обучению (CUDA), пользователи Debian 11, 12 и 13 с видеокартами NVIDIA.

Оглавление

1. 🔧 Предварительные требования

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

  • У вас установлена 64-битная (amd64/x86_64) версия Debian 11, 12 или 13
  • Ваш компьютер имеет видеокарту NVIDIA (проверьте: lspci | grep -E "VGA|3D" | grep -i nvidia)
  • У вас есть доступ к терминалу (локально или по SSH)
  • Secure Boot в BIOS/UEFI отключён (или вы готовы подписывать модули ядра — это сложный процесс, выходящий за рамки данного руководства)

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

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

sudo whoami

✅ Если выводит root — всё в порядке, можете продолжать.

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

Обновление системы

Перед установкой всегда обновляйте список пакетов:

sudo apt update

Установка заголовков ядра

Драйверы NVIDIA используют DKMS для автоматической пересборки модулей ядра при обновлении. Для этого нужны заголовки вашего текущего ядра:

sudo apt install linux-headers-$(uname -r)

Что делает: Устанавливает заголовки ядра, соответствующие вашей текущей версии.

Зачем: Без заголовков DKMS не сможет собрать модуль драйвера.

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

Драйверы NVIDIA находятся в репозиториях contrib и non-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. 📊 Сравнение способов установки

МетодИсточникВерсияОбновленияДля кого
Debian
репозитории		Официальные
пакеты Debian		Версия
дистрибутива
(стабильная)		Автоматически
через
apt upgrade		Большинство
пользователей,
кому важна
стабильность
NVIDIA CUDA
репозиторий		Официальный
репозиторий
NVIDIA		Последние
стабильные ветки		Автоматически
через
apt upgrade		Новейшие
видеокарты,
открытые модули
ядра, быстрые
обновления

💡 Рекомендация: Начинайте с метода 1 (Debian репозитории). Если ваша видеокарта слишком новая и не поддерживается версией из Debian, или вам нужны открытые модули ядра — используйте метод 2 (NVIDIA CUDA репозиторий).

3. 🚀 Способ 1: Установка драйверов из репозиториев Debian

Этот метод использует официальные пакеты Debian, которые прошли проверку и обеспечивают максимальную стабильность.

3.1 Определение подходящего драйвера с помощью nvidia-detect

sudo apt install nvidia-detect -y
nvidia-detect

Что делает: Программа определяет вашу видеокарту NVIDIA и рекомендует подходящий пакет драйвера.

✅ Ожидаемый вывод (пример):

Detected NVIDIA GPU: 01:00.0 VGA compatible controller: NVIDIA Corporation GA107 [GeForce RTX 3050] (rev a1)
Your card is supported by the default nvidia-driver package.

3.2 Установка драйвера

Для большинства современных видеокарт:

sudo apt install nvidia-driver nvidia-smi nvidia-settings -y

Что делает: Устанавливает драйвер, утилиту мониторинга и панель управления NVIDIA.

Какие версии драйверов в разных Debian:

Версия DebianВерсия драйвера NVIDIA по умолчанию
Debian 13 (Trixie)550.163.x
Debian 12 (Bookworm)535.261.x
Debian 11 (Bullseye)470.256.x (также доступен legacy 390.157.x)

3.3 Установка драйвера для старых видеокарт (Debian 11)

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

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

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

sudo reboot

4. 🚀 Способ 2: Установка драйверов из репозитория NVIDIA CUDA

Этот метод даёт самые новые драйверы, включая открытые модули ядра (open kernel modules) для Turing (RTX 20xx) и новее.

4.1 Импорт GPG-ключа и добавление репозитория

Для Debian 13:

curl -fsSL https://developer.download.nvidia.com/compute/cuda/repos/debian13/x86_64/8793F200.pub | sudo gpg --dearmor -o /usr/share/keyrings/nvidia-drivers.gpg
sudo tee /etc/apt/sources.list.d/nvidia-drivers.sources > /dev/null <<'EOF'
Types: deb
URIs: https://developer.download.nvidia.com/compute/cuda/repos/debian13/x86_64/
Suites: /
Components:
Signed-By: /usr/share/keyrings/nvidia-drivers.gpg
EOF

Для Debian 12:

curl -fsSL https://developer.download.nvidia.com/compute/cuda/repos/debian12/x86_64/3bf863cc.pub | sudo gpg --dearmor -o /usr/share/keyrings/nvidia-drivers.gpg
sudo tee /etc/apt/sources.list.d/nvidia-drivers.sources > /dev/null <<'EOF'
Types: deb
URIs: https://developer.download.nvidia.com/compute/cuda/repos/debian12/x86_64/
Suites: /
Components:
Signed-By: /usr/share/keyrings/nvidia-drivers.gpg
EOF

Для Debian 11:

curl -fsSL https://developer.download.nvidia.com/compute/cuda/repos/debian11/x86_64/3bf863cc.pub | sudo gpg --dearmor -o /usr/share/keyrings/nvidia-drivers.gpg
sudo tee /etc/apt/sources.list.d/nvidia-drivers.sources > /dev/null <<'EOF'
Types: deb
URIs: https://developer.download.nvidia.com/compute/cuda/repos/debian11/x86_64/
Suites: /
Components:
Signed-By: /usr/share/keyrings/nvidia-drivers.gpg
EOF

4.2 Обновление списка пакетов

sudo apt update

4.3 Выбор типа драйвера: проприетарный или открытый

  • Проприетарные модули ядра — максимальная совместимость со всеми GPU, включая старые
  • Открытые модули ядра — только для Turing (RTX 20xx) и новее, рекомендуются для новых карт

Для проприетарных модулей (рекомендуется для старых карт):

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

Для открытых модулей ядра (для Turing и новее, например RTX 3050, 3060, 4060 и т.д.):

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

4.4 Перезагрузка

sudo reboot

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

5.1 Проверка через nvidia-smi

nvidia-smi

✅ Ожидаемый вывод в терминале:

+-----------------------------------------------------------------------------+
| NVIDIA-SMI 550.163.01   Driver Version: 550.163.01   CUDA Version: 12.4     |
|-------------------------------+----------------------+----------------------+
| GPU  Name        Persistence-M| Bus-Id        Disp.A | Volatile Uncorr. ECC |
| Fan  Temp  Perf  Pwr:Usage/Cap|         Memory-Usage | GPU-Util  Compute M. |
|===============================+======================+======================|
|   0  NVIDIA GeForce ...  Off  | 00000000:03:00.0  On |                  N/A |
| 35%   45C    P8    10W / 200W |    350MiB /  8192MiB |      2%      Default |
+-------------------------------+----------------------+----------------------+

5.2 Проверка через NVIDIA Settings (GUI)

nvidia-settings

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

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

6.1 Проверка текущей сессии

echo $XDG_SESSION_TYPE

6.2 Включение DRM modesetting

cat /sys/module/nvidia_drm/parameters/modeset

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

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

6.3 Включение сервисов приостановки/возобновления (для ноутбуков)

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

6.4 Перезагрузка

sudo reboot

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

7.1 Ошибка: nvidia-smi не найден

Симптом: bash: nvidia-smi: command not found

Решение: Установите пакет nvidia-smi:

sudo apt install nvidia-smi -y

7.2 Ошибка: NVIDIA-SMI не может взаимодействовать с драйвером

Симптом: NVIDIA-SMI has failed because it couldn't communicate with the NVIDIA driver.

Решение: Модуль ядра не загрузился. Проверьте статус DKMS:

dkms status

Если статус added, пересоберите модуль:

sudo dkms autoinstall
sudo update-initramfs -u
sudo reboot

7.3 Чёрный экран после перезагрузки

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

Решение 1: Переключитесь на виртуальную консоль: Ctrl+Alt+F2 (или F3-F6). Войдите под своим пользователем и проверьте логи:

sudo dmesg | grep -i nvidia

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

Решение 3: Удалите драйверы и вернитесь к открытому драйверу Nouveau:

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

7.4 Ошибка конфликта пакетов при установке из CUDA репозитория

Симптом: При sudo apt install nvidia-driver nvidia-smi nvidia-settings появляются ошибки зависимостей.

Причина: Пакет nvidia-smi уже включён в nvidia-driver и не должен устанавливаться отдельно.

Решение: Устанавливайте драйвер без явного указания nvidia-smi:

sudo apt install nvidia-driver nvidia-settings -y

7.5 Ошибка при импорте GPG-ключа (403 Forbidden)

Симптом: curl: (22) The requested URL returned error: 403

Решение: NVIDIA изменила способ распространения ключей. Используйте пакет cuda-keyring:

Для Debian 12:

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

Для Debian 11:

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

Затем обновите список пакетов:

sudo apt update

7.6 Ошибка Xorg при первом запуске с DRM modesetting (Debian 13)

Симптом: При загрузке появляется ошибка Xorg, и графическая оболочка не запускается, но после перезапуска дисплейного менеджера (например, SDDM) всё работает.

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

echo 'add_drivers+=" nvidia nvidia_modeset nvidia_uvm nvidia_drm "' | sudo tee /etc/dracut.conf.d/nvidia-modules.conf
sudo dracut --force
sudo reboot

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

8.1 Удаление пакетов драйверов

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

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

sudo rm -f /etc/apt/sources.list.d/nvidia-drivers.sources
sudo rm -f /usr/share/keyrings/nvidia-drivers.gpg
sudo apt update

8.3 Удаление конфигурации DRM modesetting

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

8.4 Перезагрузка

sudo reboot

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

  • [ ] Драйвер NVIDIA установлен: nvidia-smi показывает таблицу с видеокартой
  • [ ] Версия драйвера соответствует ожидаемой (для вашей видеокарты)
  • [ ] Графическая оболочка запускается без ошибок (нет чёрного экрана)
  • [ ] NVIDIA Settings (nvidia-settings) отображает настройки видеокарты
  • [ ] Можете запустить игру или приложение с 3D-графикой (например, glxgears)

Заключение

Вы успешно установили драйверы NVIDIA на Debian. Теперь ваша видеокарта работает на полную мощность: аппаратное ускорение 3D-графики, поддержка CUDA, подключение нескольких мониторов. Если вы выбрали метод 1 (Debian репозитории), драйвер будет обновляться вместе с системой. Если выбрали метод 2 (NVIDIA CUDA репозиторий), вы получаете самые свежие драйверы, включая открытые модули ядра для новых видеокарт.

Что дальше:

  • Если вы используете ноутбук с переключаемой графикой (Optimus), настройте PRIME render offload
  • Для игр установите Steam на Debian
  • Для машинного обучения изучите установку CUDA Toolkit

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *

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