Коротко о главном
Wayland описывает, как приложение общается с композитором, а не с отдельным X-сервером. Такая архитектура упрощает безопасность и улучшает работу с несколькими мониторами и масштабированием. Большинство современных дистрибутивов уже используют Wayland по умолчанию в GNOME и KDE Plasma. Разберём диагностику сессии, XWayland, порталы, демонстрацию экрана и типичные ограничения.
Wayland даёт более плавную графику и корректное дробное масштабирование на HiDPI-экранах. Изоляция приложений снижает риск, когда одна программа получает доступ к вводу другой. Композиторы лучше управляют кадрами и энергопотреблением. Понимание протокола помогает отличать ограничение приложения от ошибки системы.
Этот материал — быстрый старт по Wayland. За 15 минут вы получите рабочую конфигурацию и поймёте, куда смотреть дальше.
Установка
В 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
Шпаргалка по командам
- Определите текущую сессию: echo $XDG_SESSION_TYPE
- Проверьте композитор и протоколы: wayland-info
- XWayland для старых приложений: xeyes
- Порталы и разрешения: systemctl —user status xdg-desktop-portal
- Демонстрация экрана: systemctl —user status pipewire
- Ввод, раскладка и переменные: localectl status
Практические советы
Эти рекомендации проверены на повседневных задачах. Начните с тех, которые закрывают вашу текущую боль, а не со всего списка сразу.
Совет 1. Не отключайте Wayland при первой проблеме: сначала проверьте, поддержи
Не отключайте Wayland при первой проблеме: сначала проверьте, поддерживает ли приложение протокол.
Совет 2. Для скриншотов используйте инструменты, работающие через портал, напри
Для скриншотов используйте инструменты, работающие через портал, например grim на wlroots-композиторах.
Совет 3. Проверяйте версию xdg-desktop-portal: старые версии не умеют часть нов
Проверяйте версию xdg-desktop-portal: старые версии не умеют часть новых интерфейсов.
Совет 4. На NVIDIA используйте свежий проприетарный драйвер, если нужна сессия
На NVIDIA используйте свежий проприетарный драйвер, если нужна сессия Wayland.
Что дальше
Быстрый старт не означает «настроить навсегда». Когда базовый сценарий заработает, вернитесь к конфигурации и проверьте, что она переживёт перезагрузку: файлы на месте, служба включена в автозагрузку, путь к данным не зависит от текущего каталога.
Дальше имеет смысл разобраться с резервной копией и журналами Wayland. Это не самая заметная часть работы, но именно она превращает эксперимент в инструмент, которым можно пользоваться каждый день.
Чек-лист
- Команды из шпаргалки выполняются без ошибок после перезагрузки.
- Пароли и токены не хранятся в истории команд и конфигурации в открытом виде.
- Понятно, где смотреть логи и что считать признаком проблемы.
- Есть копия конфигурации, которую можно восстановить.
Короткие ответы на частые вопросы
Нужно ли запускать всё от root?
Нет. Права root нужны для установки пакетов и изменения системных файлов, но сама программа и её данные должны принадлежать отдельному пользователю. Постоянная работа под root превращает любую ошибку в критическую.
Что делать, если после перезагрузки ничего не работает?
Сначала проверьте, включена ли служба в автозагрузку и не изменился ли путь к конфигурации. Посмотрите журнал текущей загрузки: он почти всегда указывает на отсутствующий файл, неверные права или занятый порт.
Как обновлять без сюрпризов?
Читайте примечания к версии, делайте резервную копию конфигурации и проверяйте обновление на тестовом стенде. Не обновляйтесь в пятницу вечером перед выходными: время на откат должно быть частью плана.
Итог
Этого достаточно, чтобы начать. Дальше углубляйтесь по мере задач: документация Wayland станет понятнее, когда появится реальный сценарий использования.