Wayland: типичные ошибки и как их исправить

Коротко о главном

Wayland описывает, как приложение общается с композитором, а не с отдельным X-сервером. Такая архитектура упрощает безопасность и улучшает работу с несколькими мониторами и масштабированием. Большинство современных дистрибутивов уже используют Wayland по умолчанию в GNOME и KDE Plasma. Разберём диагностику сессии, XWayland, порталы, демонстрацию экрана и типичные ограничения.

Wayland даёт более плавную графику и корректное дробное масштабирование на HiDPI-экранах. Изоляция приложений снижает риск, когда одна программа получает доступ к вводу другой. Композиторы лучше управляют кадрами и энергопотреблением. Понимание протокола помогает отличать ограничение приложения от ошибки системы.

Большинство проблем с Wayland сводится к нескольким повторяющимся ошибкам. Ниже — что проверить в первую очередь и как не усугубить ситуацию.

Почему это происходит

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

Типичные ошибки

Ниже — сбои, которые встречаются чаще всего. Перед исправлением сохраните текущие конфиги и запишите, какие изменения вносите: так проще откатиться.

1. Приложение не запускается на Wayland

Проверьте вывод в терминале и при необходимости запустите через XWayland командой GDK_BACKEND=x11. Если программа официально не поддерживает Wayland, это ожидаемо.

2. При демонстрации экрана виден чёрный кадр

Проверьте, запущены ли pipewire и портал ScreenCast. В некоторых композиторах нужно разрешить захват в настройках приватности.

3. Интерфейс размыт при дробном масштабировании

Используйте приложения с поддержкой Wayland и включите нативное масштабирование. Для старых X11-программ размытие может быть неустранимо без смены инструмента.

4. Сессия Wayland не появляется на экране входа

Проверьте настройки менеджера входа и драйвер видеокарты. Для GDM параметр WaylandEnable должен быть включён, а драйвер — поддерживать нужный композитор.

Как настроить правильно

Правильная последовательность проста: проверить версию и зависимости, сделать резервную копию конфигурации, внести минимальное изменение, проверить логи и только потом двигаться дальше.

Установка

В Debian, Ubuntu и Linux Mint используется пакетный менеджер APT:

sudo apt install wayland-utils

В Fedora и RHEL-совместимых системах пакет ставится через DNF:

sudo dnf install wayland-utils

В Arch Linux и производных пакет доступен в официальных репозиториях:

sudo pacman -S wayland-utils

1. Определите текущую сессию

Переменная XDG_SESSION_TYPE показывает, работает ли приложение на Wayland или X11. Команда loginctl выводит тип сессии для текущего пользователя. Это первый шаг при любой проблеме с графикой.

echo $XDG_SESSION_TYPE
loginctl show-session $(loginctl | awk '/tty/{print $1; exit}') -p Type

2. Проверьте композитор и протоколы

wayland-info перечисляет интерфейсы, которые предоставляет композитор. Если нужного протокола нет, функция не будет работать, даже если приложение её поддерживает. Сравните вывод с требованиями программы.

wayland-info
wayland-info | grep -i screencopy

3. XWayland для старых приложений

Приложения без поддержки Wayland работают через XWayland. Обычно он запускается автоматически, но некоторые программы нужно явно перевести в этот режим. Проверить, использует ли окно X11, можно через xeyes или xwininfo.

xeyes
xwininfo -root -tree | head
GDK_BACKEND=x11 ./app

4. Порталы и разрешения

Порталы дают приложениям доступ к файлам, экрану и микрофону через диалог пользователя. Без работающего портала программа не сможет выбрать файл или записать экран. Проверьте, что установлен xdg-desktop-portal и бэкенд для вашего окружения.

systemctl --user status xdg-desktop-portal
systemctl --user list-units 'xdg-desktop-portal*'

Рабочий конфиг

Начните с минимального рабочего варианта. Не копируйте большой конфиг целиком: добавляйте параметры по одному и проверяйте результат после каждого изменения.

[daemon]
WaylandEnable=true
# для отключения сессии Wayland замените на false
# WaylandEnable=false

Практические советы

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

Совет 1. Не отключайте Wayland при первой проблеме: сначала проверьте, поддержи

Не отключайте Wayland при первой проблеме: сначала проверьте, поддерживает ли приложение протокол.

Совет 2. Для скриншотов используйте инструменты, работающие через портал, напри

Для скриншотов используйте инструменты, работающие через портал, например grim на wlroots-композиторах.

Совет 3. Проверяйте версию xdg-desktop-portal: старые версии не умеют часть нов

Проверяйте версию xdg-desktop-portal: старые версии не умеют часть новых интерфейсов.

Совет 4. На NVIDIA используйте свежий проприетарный драйвер, если нужна сессия

На NVIDIA используйте свежий проприетарный драйвер, если нужна сессия Wayland.

Профилактика

Большинство повторяющихся сбоев с Wayland связано не с ошибкой в самой программе, а с окружением: обновились зависимости, изменился путь, закончилось место или другой администратор поправил конфиг. Поэтому профилактика начинается с фиксации исходного состояния.

Сохраните рабочий конфиг в систему контроля версий, добавьте короткий комментарий о том, зачем нужен каждый нестандартный параметр, и запишите команду проверки. Через месяц вы скажете себе спасибо: восстановить логику по чужому файлу без пояснений почти невозможно.

Итог

Большинство ошибок с Wayland лечится не переустановкой, а проверкой конфигурации, логов и прав доступа. Действуйте по одному изменению за раз — и причина быстро найдётся.