#Что означает ошибка
NVRM: API mismatch / nvidia-smi has failed
Установка драйвера NVIDIA в openSUSE чаще всего заканчивается чёрным экраном или откатом на nouveau, когда версия драйвера не соответствует ядру, не импортирован ключ Secure Boot (MOK) или включён Wayland без нужных параметров. Лучший способ — использовать официальный репозиторий NVIDIA.
Не устанавливайте .run-файл с сайта поверх пакетной системы.
Определите свою видеокарту и ветку драйвера.
Драйвер ставится из репозитория NVIDIA openSUSE. Ошибка API mismatch означает, что загружена старая версия модуля — перезагрузитесь после установки.
#Причины и решения
| Возможная причина | Как узнать | Что делать |
|---|---|---|
| Старый модуль | Нет перезагрузки. | Перезагрузитесь. |
| Не тот драйвер | Версия. | Выберите поддерживаемый. |
| Secure Boot | Подпись. | Отключите/зарегистрируйте. |
| Конфликт nouveau | Блокировка. | Заблокируйте. |
#Пошаговое решение
- Определите видеокартуОткройте терминал и выполните
lspci -nnk | grep -A 4 -Ei "VGA|3D|Display", чтобы увидеть видеокарту и используемый модуль. Затемuname -rиjournalctl -b -p warning --no-pagerдля ошибок загрузки драйвера. Если это не NVIDIA, не устанавливайте её драйвер. На ноутбуках с двумя видеокартами учитывайте гибридную графику и Secure Boot. - Добавьте репозиторий NVIDIAПеред добавлением репозитория выясните выпуск openSUSE (
cat /etc/os-release) и модель GPU (lspci | grep -i nvidia). Откройте официальную страницу openSUSE о драйверах NVIDIA и проверьте, что для вашего выпуска и модели указан поддерживаемый репозиторий. Добавляйте URL только по актуальной официальной инструкции через YaST или zypper, затем проверьтеsudo zypper lr -u. Не копируйте устаревший адрес для другой версии и не смешивайте Leap с Tumbleweed. - Установите драйвер через zypper inrСначала узнайте точную модель оборудования (
lspci -nnkлибоlsusb) и версию ядра (uname -r), проверьте, доступен ли штатный драйвер в вашем дистрибутиве. Перед установкой стороннего DKMS-модуля нужны совместимые заголовки ядра, резервная копия и возможность вернуться в текстовую консоль. После установки перезагрузитесь и проверьте модуль черезlsmod; не копируйте команды из другого дистрибутива. - Настройте Secure Boot (MOK)mokutil или отключите в UEFI. Изменения могут повлиять на запуск системы. Перед ними запишите исходные значения и подготовьте резервную копию или способ восстановления.
- Проверьте nvidia-smiПосле перезагрузки в терминале выполните
nvidia-smi. Если драйвер работает, утилита покажет модель GPU, версию драйвера и занятость памяти; отсутствие вывода или ошибка связи означает, что модуль не загружен или недоступен. Сравните результат сlsmod | grep nvidiaи журналомjournalctl -b -k | grep -i nvidia. Не ставьте другой драйвер без сверки совместимости, особенно при включённом Secure Boot. - Только диагностика устройства и загруженного драйвера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. Документация: .
mokutil --sb-statelsmod | grep -E "nvidia|nouveau"