Cargando

Cargando...

Перейти к содержимому
CubicLauncherDocs

Проблемы с графикой в Linux: NVIDIA и Wayland

Пустые окна, мерцание и сбои CubicLauncher с NVIDIA и Wayland. Использование WEBKIT_DISABLE_COMPOSITING_MODE=1 и альтернативы WebKitGTK.

В Linux CubicLauncher использует Tauri и WebKitGTK для отображения интерфейса. Некоторые комбинации WebKitGTK, драйвера NVIDIA и композитора могут вызывать пустые окна, мерцание или сбои. Эти проблемы могут возникать и в X11; использование NVIDIA или Wayland не означает автоматически, что вам нужен обходной путь.

Другие языки: Español · Français · English.

Быстрый обходной путь, о котором сообщалось для CubicLauncherредактировать

Если лаунчер не отображает своё окно, полностью закройте его, включая значок в системном лотке, и выполните:

bash
WEBKIT_DISABLE_COMPOSITING_MODE=1 cubiclauncher

Пользователь CubicLauncher с NVIDIA и Wayland сообщил, что эта команда решила его проблему. Официальное руководство Tauri по проблемам с графикой в Linux также описывает эту переменную как крайнюю меру, особенно для сбоев при изменении размера. Точные версии драйвера и композитора из этого сообщения недоступны, поэтому оно не устанавливает список затронутых систем.

Для AppImage замените имя файла в примере на своё:

bash
WEBKIT_DISABLE_COMPOSITING_MODE=1 ./CubicLauncher.AppImage
Что меняется

Эта переменная отключает ускоренный композитинг WebKitGTK. Она может сделать интерфейс менее плавным и увеличить нагрузку на процессор. Сама по себе она не отключает аппаратное ускорение графики Minecraft: у игры собственный движок рендеринга. Она применяется к этому запуску и не сохраняется как настройка.

Типичные симптомыредактировать

  • Окно открывается, но остаётся белым или пустым.
  • Интерфейс мерцает, особенно при изменении размера.
  • Приложение завершается при изменении размера, иногда без внятного сообщения об ошибке.
  • Терминал выводит ошибки, подобные следующим:
text
AcceleratedSurfaceDMABuf was unable to construct a complete framebuffer
Gdk-Message: Error 71 (Protocol error) dispatching to Wayland display.

Tauri объясняет многие из этих сбоев обменом графическими буферами между WebKitGTK и драйвером. Пустое окно не указывает на единственную причину: в истории отчётов WebKit встречаются разные сбои с похожими симптомами.

Диагностика и альтернативыредактировать

Пробуйте по одному варианту за раз и полностью закрывайте CubicLauncher между тестами. Приведённые ниже команды предполагают, что вы ещё не экспортировали эти параметры; если вы это сделали, удалите их перед сравнением результатов. Используйте наименее ограничительный обходной путь, который решает вашу проблему.

1. Обновите и проверьте окружениередактировать

Обновите CubicLauncher, WebKitGTK и драйвер NVIDIA поддерживаемыми в вашем дистрибутиве способами. Перезагрузитесь, если обновлялись ядро или драйвер. В Arch выполните полное обновление системы и см. руководство по установке.

Чтобы определить сеанс и драйвер:

bash
printenv XDG_SESSION_TYPE XDG_CURRENT_DESKTOP
nvidia-smi

XDG_SESSION_TYPE обычно имеет значение wayland или x11. Если оно пустое, проверьте сеанс в вашей рабочей среде. В гибридных системах один только nvidia-smi не определяет, какой GPU отрисовывает окно лаунчера.

Tauri также рекомендует проверить режим настройки ядра NVIDIA (KMS):

bash
cat /sys/module/nvidia_drm/parameters/modeset

Y означает, что режим включён; N — что отключён. Если файл отсутствует, проверьте, какой драйвер загружен. Если для чтения нужны права, вы можете просмотреть тот же файл с помощью sudo cat. Если KMS отключён, следуйте инструкциям вашего дистрибутива по его включению; Tauri упоминает nvidia_drm.modeset=1, особенно для старых драйверов. Добавлять этот параметр не нужно, если KMS уже включён.

2. Попробуйте отключить явную синхронизацию NVIDIAредактировать

Для некоторых ошибок Wayland, особенно Error 71, Tauri предлагает:

bash
__NV_DISABLE_EXPLICIT_SYNC=1 cubiclauncher

Это меняет поведение синхронизации драйвера, не отключая ускоренный композитинг WebKit. Эффективность зависит от драйвера и композитора.

3. Попробуйте отключить рендерер DMA-BUFредактировать

При ошибках кадрового буфера, пустых окнах или если предыдущий тест не помог:

bash
WEBKIT_DISABLE_DMABUF_RENDERER=1 cubiclauncher

Это позволяет избежать пути рендеринга DMA-BUF в WebKitGTK. Возможно, придётся пожертвовать более быстрым путём, но это не эквивалентно отключению всего ускоренного композитинга. И Tauri, и отчёты WebKitGTK описывают эту альтернативу.

4. Отключите ускоренный композитингредактировать

Если предыдущие альтернативы не работают, попробуйте быстрое обходное решение:

bash
WEBKIT_DISABLE_COMPOSITING_MODE=1 cubiclauncher

Сравните стабильность при открытии, изменении размера и использовании лаунчера. Если это единственный работающий вариант, вы можете оставить его для CubicLauncher и попробовать снова без него после обновления системы.

Дополнительный тест через XWaylandредактировать

Если ваш сеанс Wayland предоставляет XWayland, а GTK включает бэкенд X11, вы можете сравнить поведение с помощью:

bash
GDK_BACKEND=x11 cubiclauncher

Это выбирает X11 для приложения GTK; это не меняет весь ваш сеанс рабочего стола. Если XWayland отсутствует или сервер X недоступен, приложение может сообщить, что не может открыть дисплей. Успешный тест помогает диагностике, но не гарантирует, что все проблемы NVIDIA исчезнут в X11.

Применение обходного пути к ярлыкуредактировать

После того как вы определили, какая переменная работает, вы можете применять её при открытии CubicLauncher из меню приложений:

  1. Найдите его файл .desktop, обычно в /usr/share/applications/ или /usr/local/share/applications/. Имя файла зависит от пакета.
  2. Скопируйте его в ${XDG_DATA_HOME:-$HOME/.local/share}/applications/, создав каталог при необходимости и сохранив то же имя файла. Если личная копия уже существует, отредактируйте её.
  3. В строке Exec= добавьте env WEBKIT_DISABLE_COMPOSITING_MODE=1 перед существующим исполняемым файлом. Сохраните его путь, аргументы и коды полей, такие как %u или %U.

Например, если исходная строка Exec=cubiclauncher %U, она станет:

ini
Exec=env WEBKIT_DISABLE_COMPOSITING_MODE=1 cubiclauncher %U

Для AppImage сохраните абсолютный путь и заключите его в кавычки, если он содержит пробелы. Exec не интерпретируется как команда оболочки: не используйте ~, $HOME или присваивание переменной без env. Если файл содержит DBusActivatable=true, измените его на false в вашей личной копии, чтобы рабочий стол использовал Exec.

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

Откат и сравнение без обходных путейредактировать

Если вы использовали только префикс в терминале, закройте лаунчер и снова запустите cubiclauncher обычным образом. Если вы изменяли ярлык, восстановите его строку Exec и любое изменение DBusActivatable или удалите вашу личную копию, если вы создали её исключительно для этого обходного пути. Личные копии также могут скрывать будущие изменения ярлыка, поставляемого пакетом.

Если вы экспортировали переменные в своём сеансе, вы можете проверить без четырёх описанных здесь переменных:

bash
env -u WEBKIT_DISABLE_COMPOSITING_MODE -u WEBKIT_DISABLE_DMABUF_RENDERER -u __NV_DISABLE_EXPLICIT_SYNC -u GDK_BACKEND cubiclauncher

Применение переменных только к лаунчеру упрощает сравнения. Переменные окружения могут наследоваться дочерними процессами; целевой обходной путь не должен становиться глобальной настройкой рабочего стола.

Что включить в отчётредактировать

  • Версия CubicLauncher и формат пакета: AUR, AppImage, .deb, .rpm или Nix.
  • Дистрибутив, ядро, рабочий стол/композитор и тип сеанса.
  • Модель GPU, версия драйвера и, если пакет использует системные библиотеки, версия WebKitGTK. В Arch можно проверить с помощью pacman -Q webkit2gtk-4.1.
  • Возникает ли проблема при запуске, при изменении размера или при открытии определённого представления.
  • Результат каждого теста и точная команда, которая помогла.

Чтобы сохранить вывод обычного запуска:

bash
cubiclauncher 2>&1 | tee cubiclauncher-graphics.log

Просмотрите файл перед тем, как делиться им: вывод терминала не обязательно проходит через очистку данных встроенной консоли. Если лаунчер не открывается, приложите этот вывод; лог Minecraft не требуется. См. Диагностика лаунчера или Поддержка.

Источникиредактировать

Проверено 3 октября 2026 г. Результаты зависят от установленных версий; исторические отчёты не подразумевают, что затронуты все текущие версии.