xrdp и GNOME: как устранить конфликты сессий и чёрный экран | AdminWiki

xrdp и GNOME: как устранить конфликты сессий и чёрный экран

14 ноября 2026 15 мин. чтения
Содержание статьи

Чёрный экран в RDP при живом GNOME означает одно из двух: xrdp-sesman не смог поднять новую графическую сессию, потому что у пользователя уже открыта локальная сессия GNOME, либо сессия стартовала на Wayland, который xrdp не обслуживает. Сценарии лечатся разными правками, и путать их дорого: настройка GDM не поможет, если причина в занятом дисплее, а startwm.sh не спасёт, пока композитор остаётся Wayland.

Разбираем цепочку запуска. xrdp принимает подключение по порту 3389 и передаёт аутентификацию демону xrdp-sesman. Демон проверяет пользователя, поднимает X-сервер (Xorg с модулем xorgxrdp или Xvnc) со своим DISPLAY и выполняет /etc/xrdp/startwm.sh. Всё, что запустит этот скрипт, и становится рабочим столом в RDP. GNOME привязан к пользователю, к сессии logind и к шине dbus, поэтому второй экземпляр для того же аккаунта конфликтует с первым.

Дальше идём по маршруту: диагностика по симптомам, отдельная сессия, правка startwm.sh и переменных окружения, отключение Wayland через конфиг GDM, проверка результата и минимум по безопасности. Команды даём готовыми к копированию, с критерием проверки после каждого шага.

Пути к файлам и имена служб зависят от дистрибутива и версий пакетов xrdp, GDM и gnome-session. Часть рекомендаций ниже опирается на пользовательские обсуждения и документацию пакетов, а не на единую официальную инструкцию: поведение может отличаться между версиями. Прогоняйте правки на тестовом пользователе и держите резервные копии конфигов, прежде чем трогать рабочий сервер.

Почему GNOME через xrdp показывает чёрный экран

Причина первая: конфликт сессий. Пользователь один, а графических сессий фактически две, локальная на физическом мониторе и запрошенная через RDP. По умолчанию удалённое подключение под именем пользователя, чья сессия уже активна локально, не работает: возможна ошибка «Could not acquire name on session bus» либо чёрный экран без полной загрузки рабочего стола. GNOME плохо обрабатывает две сессии одного пользователя, и это самая частая причина чёрного экрана.

Причина вторая: Wayland. xRDP запускает собственную Xorg-сессию через xorgxrdp и вообще не использует Wayland: удалённая сессия всегда X11, тогда как локальный вход может оставаться на Wayland. Если же в RDP-сессии всё-таки поднимается Wayland-композитор, изображение не попадает в X-сервер xrdp, и клиент видит пустое полотно.

Отдельно стоит третий сценарий: рабочий скрипт startwm.sh, который завершается с ошибкой или запускает команды после exec. Тогда sesman закрывает сессию сразу после логина, и чёрный экран приходит вместе с обрывом соединения. Разделять три случая проще по логам, чем по внешнему виду окна.

Симптомы, указывающие на конфликт сессий

Сверьте наблюдения с таблицей: она покрывает большинство жалоб на «чёрный экран xrdp gnome».

СимптомЧто проверитьВероятная причина
Чёрный экран после ввода пароля, соединение не рвётсяloginctl list-sessionsвторая сессия того же пользователя
Окно RDP закрывается сразу после логинаjournalctl -u xrdp-sesman -esesman не запустил X-сервер или startwm.sh упал
Локального пользователя выбрасывает из GNOME при подключении по RDPloginctl show-session ID -p Type -p Remoteконфликт сессий, общая шина dbus
В профиле ошибки dbus или gnome-sessioncat ~/.xsession-errorsсессия стартует без собственной шины dbus
Курсор есть, рабочий стол не появляетсяtail -n 100 /var/log/xrdp-sesman.logWayland-композитор в X11-сессии

Базовый набор команд диагностики, выполнять от root или через sudo:

  • systemctl status xrdp xrdp-sesman - службы active (running), без падений в последних попытках входа;
  • journalctl -u xrdp -u xrdp-sesman -e - последние записи обоих юнитов, ищите строки про session, display и startwm;
  • cat ~/.xsession-errors - ошибки уровня пользовательской сессии;
  • loginctl list-sessions - сколько сессий у одного аккаунта и какие из них remote;
  • loginctl show-session ID -p Type -p Class -p Remote - тип сессии и признак удалённого входа по конкретному ID;
  • ss -tlnp 'sport = :3389' - слушает ли xrdp порт и на каком адресе.

Если локальный вход и RDP упираются в один и тот же дисплей, в выводе loginctl будет две сессии одного пользователя с разными ID, при этом одна из них может быть помечена как active, а вторая как closing. Это и есть конфликт сессий.

Чем отличается конфликт сессий от ошибки Wayland

Критерий простой. Конфликт сессий проявляется только при уже активном локальном входе того же пользователя: пока на мониторе никто не работает, RDP поднимается штатно. Ошибка Wayland воспроизводится всегда, независимо от локальной сессии.

Проверка типа сессии в обеих средах:

  • в локальной сессии GNOME откройте терминал и выполните echo $XDG_SESSION_TYPE и echo $XDG_CURRENT_DESKTOP;
  • те же две команды выполните в терминале внутри RDP-сессии.

Если в RDP возвращается wayland, проблема в композиторе, и правки startwm.sh или GDM обязательны. Если сессия не создаётся вовсе (в логе sesman ошибка про display или session), а локальный вход активен, перед вами конфликт сессий. Прикладной порядок установки и первичной настройки пакета с проверкой служб разобран в материале как настроить xrdp на Linux, там же команды диагностики логов и проверка порта 3389.

Как организовать отдельную RDP-сессию, не мешающую локальному пользователю

Главный принцип: не переиспользовать локальную сессию, а поднимать отдельную. Два рабочих подхода дают разный уровень предсказуемости. Отдельный пользователь для RDP исключает конфликт по определению. Изоляция второго сеанса для того же аккаунта возможна, но требует аккуратной работы с dbus и тестирования.

Отдельный пользователь для RDP: плюсы и настройка

Самый надёжный вариант для сервера. Учётная запись rdpuser не совпадает с аккаунтом человека за монитором, поэтому оба GNOME-сеанса живут независимо, а домашний каталог остаётся изолированным.

  1. Создайте пользователя: useradd -m -s /bin/bash rdpuser
  2. Задайте пароль: passwd rdpuser
  3. Проверьте группы: id rdpuser. Права sudo добавляйте только при реальной необходимости: usermod -aG sudo rdpuser
  4. Убедитесь, что вход по паролю для RDP разрешён в настройках PAM вашего дистрибутива, и не отключайте для этой учётной записи локальный вход полностью.
  5. Подключитесь RDP-клиентом под rdpuser и проверьте, что локальная сессия не прервана: loginctl list-sessions покажет две независимые сессии с разными ID.

Для GUI-приложений новому пользователю нужен рабочий профиль: при первом входе GNOME создаст каталоги сам, но если профиль копируется с другого аккаунта, проверьте владельца файлов через ls -la /home/rdpuser и при необходимости выровняйте права chown -R rdpuser:rdpuser /home/rdpuser. Схема учётных записей, SSH-ключей и ограничений sudoers подробно разобрана в статье управление пользователями и доступом на сервере.

Изоляция сессии для того же пользователя

Вариант без второго аккаунта опирается на то, что sesman всё равно выдаёт отдельный DISPLAY. Задача сводится к тому, чтобы в startwm.sh поднять gnome-session с собственной шиной dbus, а не подключаться к уже существующей сессии пользователя. Создание нового экземпляра DBUS-шины для удалённой сессии позволяет ей функционировать независимо от существующей локальной сессии.

На практике это означает запуск gnome-session через dbus-launch, который создаёт отдельную шину автоматически, либо через dbus-run-session. DISPLAY и XAUTHORITY уже экспортированы sesman, их переопределять нельзя. Точная команда вида dbus-daemon --session --fork --print-address в проверенных источниках не приводится, поэтому опирайтесь на dbus-launch или dbus-run-session из вашего дистрибутива.

Ограничения подхода стоит знать заранее: помимо dbus есть keyring и настройки gsettings, часть приложений может ругаться на занятый порт сессии. Успех проверяется так: loginctl list-sessions показывает обе сессии, ни одна не закрывается при подключении второй. Если локального пользователя всё равно выбрасывает, возвращайтесь к схеме с отдельным аккаунтом. Разбор похожего сценария с лёгким окружением и разными стартовыми файлами есть в гайде настройка xrdp с XFCE и разбор чёрного экрана.

Настройка startwm.sh для запуска GNOME

/etc/xrdp/startwm.sh выполняет xrdp-sesman при создании сессии. Скрипт получает уже готовое окружение с DISPLAY и правами пользователя, поэтому его задача сводится к экспорту правильных переменных и запуску нужного рабочего стола.

Порядок безопасной правки:

  1. Сделайте резервную копию: cp /etc/xrdp/startwm.sh /etc/xrdp/startwm.sh.bak
  2. Откройте файл в редакторе и найдите финальный блок, который вызывает Xsession или запускает окружение.
  3. Замените финальный блок на фрагмент ниже, остальные служебные строки (подключение /etc/default/locale, проверка прав) оставьте как есть.
  4. Проверьте синтаксис: bash -n /etc/xrdp/startwm.sh
  5. Перезапустите службу xrdp и подключитесь заново: systemctl restart xrdp

Переменные окружения, которые нужны GNOME

Каждая переменная закрывает конкретную проблему, а не добавлена для красоты.

  • XDG_SESSION_TYPE=x11 - сообщает сессии, что композитора Wayland нет. Без неё GNOME может пытаться запустить Wayland внутри X11-дисплея.
  • XDG_CURRENT_DESKTOP=GNOME - от него зависят темы, интеграция с порталами и поведение части приложений.
  • XDG_SESSION_DESKTOP=gnome - имя сессии в терминах xdg, используется gnome-session при выборе режима.
  • GNOME_SHELL_SESSION_MODE=ubuntu - включает раскладку Ubuntu. На Fedora и RHEL эту переменную обычно не задают либо ставят classic.
  • DESKTOP_SESSION - дублирует выбор сессии для старых сценариев и скриптов входа.

Проверка значений внутри RDP-сессии: echo $XDG_SESSION_TYPE, echo $XDG_CURRENT_DESKTOP. Ожидаем x11 и GNOME. Альтернатива правке системного файла: переменные можно вынести в ~/.xsessionrc пользователя RDP, а exec оставить в startwm.sh. Для второго пользователя это удобнее, потому что не меняет поведение для всех.

Готовый фрагмент startwm.sh

Фрагмент заменяет финальный вызов окружения. Строки с решёткой в начале - комментарии.

#!/bin/sh
# GNOME в X11 внутри RDP-сессии
export XDG_SESSION_TYPE=x11
export XDG_SESSION_DESKTOP=gnome
export XDG_CURRENT_DESKTOP=GNOME
export DESKTOP_SESSION=gnome
export GNOME_SHELL_SESSION_MODE=ubuntu
exec dbus-launch --exit-with-session gnome-session

Почему именно так:

  • exec заменяет процесс оболочки процессом gnome-session, и sesman корректно отслеживает жизненный цикл сессии. Команды после exec не выполняются никогда, поэтому ничего важного ниже ставить нельзя.
  • dbus-launch --exit-with-session создаёт отдельную шину dbus и закрывает её вместе с сессией. В окружениях, где dbus-launch отсутствует, используйте dbus-run-session gnome-session.
  • GNOME_SHELL_SESSION_MODE=classic даёт менее требовательный к ресурсам режим, если RDP-канал медленный.

Оговорка по проверяемости: единого подтверждённого рецепта именно с таким набором переменных и командой gnome-session в документации нет. В обсуждениях xrdp на Ubuntu 24.04 добавление одного export XDG_SESSION_TYPE=x11 не устраняло случайный чёрный экран, а в качестве команды запуска классической сессии приводится dbus-launch --exit-with-session /usr/bin/gnome-session-classic. Поэтому считайте фрагмент отправной точкой: если после перезапуска xrdp чёрный экран сохраняется, попробуйте gnome-session-classic и проверьте логи.

Проверка после перезапуска xrdp: tail -f /var/log/xrdp-sesman.log во время подключения. В логе должна появиться строка о старте сессии и не должно быть сообщений о невозможности открыть display. Ошибки gnome-session и dbus ищите в ~/.xsession-errors.

Почему GNOME требует отключения Wayland и как сделать это безопасно

xrdp передаёт изображение как X11-клиент. Wayland-композитор GNOME рисует кадры через собственный протокол и не отдаёт их в X-сервер xrdp, поэтому сессия остаётся пустой. Отключение Wayland переводит GDM на запуск GNOME в Xorg, и тогда RDP-сессия получает нормальную картинку.

Важная оговорка: это не универсальное лекарство. На Ubuntu 24.04 с GNOME 46 чёрные экраны при xRDP наблюдаются на xRDP 0.9.24 и 0.10, и в обсуждении xrdp отключение Wayland через параметр в /etc/gdm3/custom.conf не повлияло на решение проблемы. На Ubuntu 22.04, где Wayland используется по умолчанию, картина тоже может отличаться. Если после правки GDM чёрный экран остался, причина, скорее всего, в конфликте сессий, а не в Wayland.

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

Правка конфига GDM и перезапуск

  1. Сделайте копию: cp /etc/gdm3/custom.conf /etc/gdm3/custom.conf.bak (на RHEL-подобных системах и Arch путь /etc/gdm/custom.conf).
  2. В секции [daemon] добавьте или раскомментируйте строку WaylandEnable=false.
  3. Проверьте результат правки: grep -n WaylandEnable /etc/gdm3/custom.conf
  4. Перезапустите GDM: systemctl restart gdm3 на Debian и Ubuntu, systemctl restart gdm на RHEL-подобных системах. В части окружений достаточно перезагрузки.
  5. Проверьте тип сессии: loginctl show-session ID -p Type должно вернуть Type=x11, а echo $XDG_SESSION_TYPE в локальном терминале вернёт x11.

Если после перезапуска локальный вход показывает Wayland, проверьте, не переопределяет ли значение другой файл в /etc/gdm3/ или дроп-ин в /etc/systemd/system/gdm.service.d/. Пути и имена юнитов зависят от дистрибутива, при сомнениях сверяйтесь с man gdm и man logind на своей системе.

Откат изменений, если что-то пошло не так

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

  • cp /etc/gdm3/custom.conf.bak /etc/gdm3/custom.conf - вернуть исходный конфиг;
  • systemctl restart gdm3 - перезапустить менеджер входа;
  • diff /etc/gdm3/custom.conf.bak /etc/gdm3/custom.conf - убедиться, что различий нет;
  • проверить локальный вход и повторно подключиться по RDP, чтобы зафиксировать состояние до и после.

Каждую правку фиксируйте в changelog или заметке с датой и причиной: через месяц вопрос «почему Wayland выключен» возникнет снова.

Проверка результата: команды и критерии успеха

Успех определяется не фактом подключения, а набором проверок на сервере и внутри сессии.

  • systemctl status xrdp и systemctl status xrdp-sesman - обе службы active (running);
  • ss -tlnp 'sport = :3389' - порт слушается, адрес привязки соответствует вашей политике доступа;
  • loginctl list-sessions - видна RDP-сессия с отдельным ID, локальная сессия на месте;
  • loginctl show-session ID -p Type -p Remote - тип x11, признак удалённого входа выставлен;
  • внутри RDP: echo $XDG_SESSION_TYPE возвращает x11, echo $XDG_CURRENT_DESKTOP возвращает GNOME;
  • xrandr - разрешение и частота соответствуют ожидаемым, список режимов непустой;
  • journalctl -u xrdp -u xrdp-sesman -e - без свежих ошибок dbus, display и gnome-session;
  • локальный пользователь не прерван: рабочая сессия на мониторе продолжает отвечать.

Чек-лист успешной настройки

  1. Службы xrdp и xrdp-sesman запущены и не перезапускались с ошибкой после последней правки.
  2. Порт 3389 слушается только на нужном интерфейсе.
  3. RDP-сессия создаётся под отдельным пользователем.
  4. Тип сессии в RDP - x11, рабочий стол GNOME отображается.
  5. Локальная сессия не затронута, оба пользователя работают одновременно.
  6. В ~/.xsession-errors и логах sesman нет ошибок dbus и gnome-session.
  7. Резервные копии startwm.sh и custom.conf лежат рядом с оригиналами.
  8. Изменения зафиксированы в заметке с датой и причиной.

Безопасность RDP-доступа и изоляция сессий

Открытый в интернет порт 3389 регулярно становится объектом перебора паролей. Схема с отдельным пользователем снижает ущерб от компрометации, но не заменяет сетевые ограничения.

  • Не публикуйте RDP напрямую. Ограничьте доступ на межсетевом экране: ufw allow from 10.0.0.0/24 to any port 3389 proto tcp, для nftables или firewalld аналогичное правило по подсети.
  • Проверьте, где слушается порт: ss -tlnp 'sport = :3389' и ufw status. Привязка к 0.0.0.0 при закрытом снаружи firewall допустима, привязка к локальному адресу безопаснее.
  • Включите TLS для RDP в /etc/xrdp/xrdp.ini: параметры security_layer и certificate, а также key_file для приватного ключа. Сертификат и ключ должны быть в формате PEM. При security_layer=tls используется Enhanced RDP Security через TLS. Без настроенного TLS канал RDP не защищён должным образом, поэтому не оставляйте значения по умолчанию на публичном сервере.
  • Держите rdpuser вне группы sudo, если задачи не требуют повышения прав. Проверка: id rdpuser, groups rdpuser.
  • Добавьте fail2ban с фильтром по журналу xrdp-sesman, чтобы ограничить число неудачных попыток входа.

Минимальные права и отдельный пользователь

RDP-аккаунт существует для графических задач, поэтому набор привилегий должен быть минимальным. Не храните в его профиле ключи и пароли в открытом виде, не выдавайте sudo «на всякий случай» и не переиспользуйте домашний каталог администратора. Проверка прав выполняется двумя командами: id rdpuser и ls -ld /home/rdpuser. Каталог должен принадлежать самому пользователю, а права группы и остальных не должны позволять чтение чужих файлов.

Типичные ошибки и как их избежать

ОшибкаПризнакИсправление
Запуск gnome-session для пользователя с активной локальной сессиейчёрный экран, две сессии в loginctlотдельный пользователь для RDP
Wayland не отключёнсессия типа wayland, пустой экранWaylandEnable=false в конфиге GDM и перезапуск
Синтаксическая ошибка в startwm.shсессия закрывается сразу после логинаbash -n /etc/xrdp/startwm.sh
Команды после execчасть настроек не применяетсяперенести их до строки exec
Перезапуск GDM в рабочее времялокальные сессии оборваныокно обслуживания и предупреждение
Нет резервных копий конфиговнечего вернуть при ошибкекопия с суффиксом .bak перед правкой
Путаница /etc/gdm3/custom.conf и /etc/gdm/custom.confправка не действуетпроверить путь через ls /etc/gdm3 /etc/gdm

Как откатить изменения

  1. Восстановите стартовый скрипт: cp /etc/xrdp/startwm.sh.bak /etc/xrdp/startwm.sh
  2. Восстановите конфиг GDM: cp /etc/gdm3/custom.conf.bak /etc/gdm3/custom.conf
  3. Перезапустите службы: systemctl restart xrdp и systemctl restart gdm3
  4. Проверьте локальный вход и RDP-подключение по чек-листу выше.
  5. Если файл конфигурации повреждён целиком, переустановите пакет: apt reinstall xrdp или dnf reinstall xrdp, предварительно выяснив принадлежность файла через dpkg -S /etc/xrdp/startwm.sh (для RPM-систем rpm -qf).

Совместимость версий и адаптация под дистрибутив

Инструкции применимы к системам с GDM и xrdp из штатных репозиториев. Отличаются пути и имена служб, логика запуска GNOME одинакова.

ДистрибутивКонфиг GDMУстановкаПроверка версии
Ubuntu, Debian/etc/gdm3/custom.confapt install xrdp xorgxrdpdpkg -l | grep xrdp
Fedora, RHEL, Rocky/etc/gdm/custom.confdnf install xrdp xorgxrdprpm -qa | grep xrdp
Arch/etc/gdm/custom.confpacman -S xrdp xorgxrdppacman -Q xrdp

Путь /etc/gdm/custom.conf подтверждён для Arch Linux и производных, а также для RHEL (включая Fedora и CentOS). Для Debian и Ubuntu путь /etc/gdm3/custom.conf встречается в пользовательских обсуждениях, а не в официальной документации, поэтому сверяйте его на своей системе. Пакет xorgxrdp нужен для Xorg-сессии: разработчики xorgxrdp указывают, что при входе через RDP-клиент нужно выбирать Xorg, и тогда xrdp-sesman запустит Xorg с конфигурацией, активирующей модули xorgxrdp. В РЕД ОС 8 пакет ставится вместе с xrdp командой dnf install xrdp xorgxrdp pipewire-module-xrdp.

Проверьте фактические версии перед настройкой: xrdp --version, gnome-shell --version, gdm --version. Значение GNOME_SHELL_SESSION_MODE подбирается по дистрибутиву: ubuntu на Ubuntu, classic для классической раскладки, переменную можно не задавать на Fedora и RHEL.

Общая логика администрирования Linux, включая работу с пакетными менеджерами и проверку состояния служб, собрана в руководстве практическое руководство по Linux для ИТ-специалистов. Тестируйте startwm.sh на отдельном пользователе: одна правка, одно подключение, проверка по чек-листу. Такой цикл занимает минуты и не оставляет сервер в промежуточном состоянии, когда локальный вход уже сломан, а RDP ещё не работает.

Источники

Поделиться: