openSUSE openSUSE

openSUSE: драйвер NVIDIA не загружается

  • Обновлено
  • Чтение ≈ 3 минуты

Краткий ответ

Драйвер ставится из репозитория NVIDIA openSUSE. Ниже — причины и порядок действий от простого к сложному.

В этой статье
  1. Что означает ошибка
  2. Причины и решения
  3. Пошаговое решение
  4. Установка из репозитория
  5. Secure Boot
  6. Проблемы после установки

#Что означает ошибка

Сообщение
NVRM: API mismatch / nvidia-smi has failed

Установка драйвера NVIDIA в openSUSE чаще всего заканчивается чёрным экраном или откатом на nouveau, когда версия драйвера не соответствует ядру, не импортирован ключ Secure Boot (MOK) или включён Wayland без нужных параметров. Лучший способ — использовать официальный репозиторий NVIDIA.

Не устанавливайте .run-файл с сайта поверх пакетной системы.

Определите свою видеокарту и ветку драйвера.

Драйвер ставится из репозитория NVIDIA openSUSE. Ошибка API mismatch означает, что загружена старая версия модуля — перезагрузитесь после установки.

#Причины и решения

Возможная причинаКак узнатьЧто делать
Старый модульНет перезагрузки.Перезагрузитесь.
Не тот драйверВерсия.Выберите поддерживаемый.
Secure BootПодпись.Отключите/зарегистрируйте.
Конфликт nouveauБлокировка.Заблокируйте.

#Пошаговое решение

  1. Определите видеокартуОткройте терминал и выполните lspci -nnk | grep -A 4 -Ei "VGA|3D|Display", чтобы увидеть видеокарту и используемый модуль. Затем uname -r и journalctl -b -p warning --no-pager для ошибок загрузки драйвера. Если это не NVIDIA, не устанавливайте её драйвер. На ноутбуках с двумя видеокартами учитывайте гибридную графику и Secure Boot.
  2. Добавьте репозиторий NVIDIAПеред добавлением репозитория выясните выпуск openSUSE (cat /etc/os-release) и модель GPU (lspci | grep -i nvidia). Откройте официальную страницу openSUSE о драйверах NVIDIA и проверьте, что для вашего выпуска и модели указан поддерживаемый репозиторий. Добавляйте URL только по актуальной официальной инструкции через YaST или zypper, затем проверьте sudo zypper lr -u. Не копируйте устаревший адрес для другой версии и не смешивайте Leap с Tumbleweed.
  3. Установите драйвер через zypper inrСначала узнайте точную модель оборудования (lspci -nnk либо lsusb) и версию ядра (uname -r), проверьте, доступен ли штатный драйвер в вашем дистрибутиве. Перед установкой стороннего DKMS-модуля нужны совместимые заголовки ядра, резервная копия и возможность вернуться в текстовую консоль. После установки перезагрузитесь и проверьте модуль через lsmod; не копируйте команды из другого дистрибутива.
  4. Настройте Secure Boot (MOK)mokutil или отключите в UEFI. Изменения могут повлиять на запуск системы. Перед ними запишите исходные значения и подготовьте резервную копию или способ восстановления.
  5. Проверьте nvidia-smiПосле перезагрузки в терминале выполните nvidia-smi. Если драйвер работает, утилита покажет модель GPU, версию драйвера и занятость памяти; отсутствие вывода или ошибка связи означает, что модуль не загружен или недоступен. Сравните результат с lsmod | grep nvidia и журналом journalctl -b -k | grep -i nvidia. Не ставьте другой драйвер без сверки совместимости, особенно при включённом Secure Boot.
  6. Только диагностика устройства и загруженного драйвера
    Linux · Терминал (Bash)Команда
    Только диагностика устройства и загруженного драйвера. Пакет x11-video-nvidiaG06 подходит не всем поколениям GPU и выпускам openSUSE; выбирайте драйвер по официальному руководству NVIDIA/openSUSE для вашей модели.
    lspci -nnk | grep -iA3 -E "vga|3d"
    nvidia-smi

#Установка из репозитория

Узнайте модель: lspci | grep -i nvidia. Добавьте репозиторий: для Tumbleweed sudo zypper ar -f https://download.nvidia.com/opensuse/tumbleweed NVIDIA (для Leap — .../opensuse/leap/15.6). Установите: sudo zypper in nvidia-video-card-G06 (подходящий пакет определит sudo zypper inr). Пакеты nvidia-driver-G06-kmp-default и nvidia-utils-G06. Перезагрузитесь. Проверка: nvidia-smi, lsmod | grep nvidia.

#Secure Boot

При включённом Secure Boot модуль ядра нужно подписать: во время установки mokutil предложит задать пароль для импорта ключа, после перезагрузки в синем окне MOK выберите «Enroll MOK» → введите пароль. Проверка: mokutil --sb-state. Если не хотите возиться, отключите Secure Boot в UEFI. Без подписи драйвер не загрузится, в dmesg будет Key was rejected by service.

#Проблемы после установки

Чёрный экран: добавьте параметр ядра nvidia-drm.modeset=1 (YaST → Bootloader или /etc/default/grub, затем sudo grub2-mkconfig -o /boot/grub2/grub.cfg). Заблокируйте nouveau: /etc/modprobe.d/50-blacklist.conf с blacklist nouveau, затем sudo mkinitrd. После обновления ядра убедитесь, что пакет kmp собран под него. Ноутбуки с гибридной графикой: suse-prime (sudo prime-select nvidia). Откат: sudo zypper rm nvidia* и sudo mkinitrd. Документация: en.opensuse.org/SDB:NVIDIA_drivers.

Linux · Терминал (Bash)Команда
Только диагностика Secure Boot и модулей. Установка рекомендуемых пакетов zypper inr может изменить систему и не является обязательной для всех моделей NVIDIA.
mokutil --sb-state
lsmod | grep -E "nvidia|nouveau"

Так эту ошибку тоже называют

Источники и обновления

Последнее обновление статьи: 2 ноября 2026. Версии программ и интерфейсы меняются — если шаги не совпадают с вашей версией, сверяйтесь с документацией производителя.