Настройка xrdp с XFCE на сервере: готовый конфиг ~/.xsession и разбор чёрного экрана | AdminWiki

Настройка xrdp с XFCE на сервере: готовый конфиг ~/.xsession и разбор чёрного экрана

13 ноября 2026 13 мин. чтения

Зачем xrdp + XFCE на сервере и что понадобится

xrdp принимает RDP-подключения на порт 3389 и запускает для пользователя Xorg-сессию, поэтому с сервером можно работать штатным клиентом Windows (mstsc) или xfreerdp из Linux, без VNC-клиентов и лишних пробросов. XFCE закрывает вторую часть задачи: даёт панель, файловый менеджер, терминал и настройки. Полноценный GNOME или KDE для админских сценариев не нужен, XFCE поднимается быстрее и потребляет меньше памяти.

Связка окупается в трёх случаях: GUI-инструменты без нормального CLI (часть панелей управления, Java-консоли, средства восстановления), тестовые стенды с браузером на удалённой машине, демонстрация экрана коллеге вместо пересказа команд. Для чистой серверной рутины RDP проигрывает SSH, держать его постоянно открытым смысла нет.

Рабочий порядок на чистом сервере: ставим xrdp и xorgxrdp, ставим xfce4, включаем сервис, создаём в домашнем каталоге пользователя файл ~/.xsession с вызовом startxfce4, выставляем права, проверяем подключение. Штатный /etc/xrdp/startwm.sh править не обязательно: он передаёт управление стандартному механизму X-сессии, который подхватывает пользовательский скрипт. Ниже готовые конфиги, команды проверки и алгоритм разбора чёрного экрана.

Требования к серверу и версиям пакетов

Минимум: 1 vCPU, 1 ГБ RAM, 10 ГБ диска. С браузером и офисным пакетом внутри сессии комфортно на 2 ГБ. Проверенные платформы: Debian 12 и новее, Ubuntu 22.04/24.04, Rocky Linux 9, AlmaLinux 9. Пакеты xrdp и xorgxrdp для RHEL-семейства лежат в EPEL.

По версиям на 2026 год картина такая: ветка xrdp 0.9.x объявлена end-of-life, новые релизы 0.9.x выходят только при серьёзных уязвимостях или критических ошибках. Актуальная линия — 0.10.x: в 2026 году вышли v0.10.5 (27.01.2026), v0.10.6 (17.04.2026) и v0.10.6.1 (06.07.2026). Для лучшего опыта нужны оба пакета — xrdp и xorgxrdp; если xorgxrdp в дистрибутиве не предоставлен, используется бэкенд Xvnc.

КомпонентЗачем нужен
xrdpRDP-сервер: слушает 3389, принимает соединение и передаёт логин демону сессий
xorgxrdpДрайвер Xorg для xrdp. Без него бэкенд не стартует, и клиент получает чёрный экран
xrdp-sesmanДемон управления сессиями, слушает 3350 только на loopback
xfce4Базовое окружение: xfwm4, xfce4-panel, thunar, xfce4-session
xfce4-goodiesПлагины панели и дополнительные утилиты, нужны не всегда
dbus-x11Даёт dbus-launch для шины сессии в Debian/Ubuntu

Что подготовить до установки: sudo-доступ, отключённый display manager (gdm3, lightdm или sddm на сервере только занимают память и перехватывают альтернативу x-session-manager), открытый порт 3389 внутри доверенной сети или SSH-туннель. Wayland-сессии xorgxrdp не обслуживает: Xorg-драйвер работает только с X11, поэтому сессию XFCE нужно явно держать в X11.

Если машина только что установлена, сначала пройдите чек-лист первичной настройки Linux: sudo-пользователь, SSH-ключи, локаль и файрвол нужны раньше, чем графическая сессия, иначе RDP окажется единственной открытой дверью на сервере.

Установка xrdp и XFCE: команды и порядок действий

Debian и Ubuntu. Обновите индексы и поставьте окружение, затем сервер и Xorg-драйвер отдельными командами, чтобы видеть, какой пакет подтягивает зависимости.

sudo apt update
sudo apt install -y xfce4 xfce4-goodies dbus-x11
sudo apt install -y xrdp xorgxrdp
sudo adduser xrdp ssl-cert
sudo systemctl enable --now xrdp
sudo systemctl enable --now xrdp-sesman

Если apt предлагает установить lightdm как рекомендованную зависимость, откажитесь: на сервере без физического дисплея он не нужен. Уже установленный менеджер входа отключите: sudo systemctl disable --now gdm3 lightdm sddm. Добавление пользователя xrdp в группу ssl-cert даёт демону чтение приватного ключа из /etc/ssl/private, без этого TLS-слой падает с ошибкой чтения ключа.

RHEL, Rocky Linux, AlmaLinux. Пакеты берутся из EPEL, XFCE ставится группой, а если группа в репозитории недоступна, перечислите пакеты явно.

sudo dnf install -y epel-release
sudo dnf install -y xrdp xorgxrdp
sudo dnf groupinstall -y "Xfce"
# альтернатива, если группы нет
sudo dnf install -y xfce4-session xfwm4 xfce4-panel thunar xfce4-terminal xfdesktop
sudo systemctl enable --now xrdp xrdp-sesman

На RHEL-семействе с включённым SELinux проверьте, что порт остался 3389. При смене порта его нужно сопоставить с типом rdp_port_t, иначе xrdp не сможет занять сокет: sudo semanage port -a -t rdp_port_t -p tcp 13389 (для уже существующей записи — -m вместо -a). Если команда semanage не найдена, установите пакет policycoreutils-python-utils и повторите, затем перезапустите xrdp. Отказы ищите командой sudo ausearch -m avc -ts recent.

Проверка после установки. Сервис должен быть активен, а порт 3389 слушаться, при этом 3350 обязан оставаться на 127.0.0.1.

systemctl is-enabled xrdp xrdp-sesman
systemctl status xrdp --no-pager
ss -tlnp | grep -E '3389|3350'
dpkg -s xrdp xorgxrdp | grep -E 'Package|Version'
# для RHEL-семейства
rpm -q xrdp xorgxrdp

Ожидаемый вывод ss: строка с 0.0.0.0:3389 или *:3389 и отдельная строка 127.0.0.1:3350. Если 3350 виден на внешнем адресе, проверьте настройку адреса прослушивания демона сессий в /etc/xrdp/sesman.ini и перезапустите xrdp-sesman.

Готовый конфиг сессии: ~/.xsession и .xsessionrc

После успешной аутентификации xrdp запускает от имени пользователя /etc/xrdp/startwm.sh. Штатный скрипт передаёт управление стандартному механизму X-сессии (/etc/X11/Xsession), который подключает пользовательские файлы окружения и запускает стартовый скрипт сессии. Отсюда простая тактика: не трогаем системный startwm.sh, а описываем сессию в двух файлах внутри домашнего каталога пользователя.

#!/bin/sh
# ~/.xsession: что запускать после логина через xrdp
if [ -z "$DBUS_SESSION_BUS_ADDRESS" ]; then
  eval "$(dbus-launch --sh-syntax)"
fi
exec startxfce4
# ~/.xsessionrc: переменные окружения сессии
# подключается через /etc/X11/Xsession до старта WM
export XDG_CURRENT_DESKTOP=XFCE
export XDG_SESSION_TYPE=x11
export XDG_SESSION_DESKTOP=xfce
export LANG=ru_RU.UTF-8
export LANGUAGE=ru_RU:ru
export QT_QPA_PLATFORM=xcb

Ключевой элемент в ~/.xsession - exec. Без него оболочка остаётся родителем startxfce4, Xsession завершает работу, а клиент видит чёрный фон. Проверка DBUS_SESSION_BUS_ADDRESS нужна, чтобы не поднимать вторую шину, если её уже создал dbus-x11. Переменная XDG_SESSION_TYPE=x11 отсекает попытки XFCE уйти в Wayland, который xorgxrdp не поддерживает.

Почему не работает startwm.sh по умолчанию

Штатный startwm.sh выполняет /etc/X11/Xsession, а тот без пользовательского ~/.xsession идёт по цепочке альтернатив x-session-manager. На сервере без DE альтернатива может указывать на отсутствующий бинарник, на тяжёлый GNOME или на скрипт, который завершается с ошибкой. Результат один: аутентификация проходит, рабочий стол не появляется.

Второй путь, если нужна сессия для всех пользователей сразу: поправить startwm.sh с резервной копией.

sudo cp -a /etc/xrdp/startwm.sh /etc/xrdp/startwm.sh.bak
sudo tee /etc/xrdp/startwm.sh >/dev/null <<'EOF'
#!/bin/sh
if test -r /etc/profile; then . /etc/profile; fi
if test -r "$HOME/.profile"; then . "$HOME/.profile"; fi
unset DBUS_SESSION_BUS_ADDRESS
unset XDG_RUNTIME_DIR
exec startxfce4
EOF
sudo chmod 755 /etc/xrdp/startwm.sh
sudo systemctl restart xrdp

Минус такого решения: файл принадлежит пакету, при обновлении xrdp dpkg или rpm спросит про изменённый конфиг, а правка действует на всех пользователей одинаково. Пользовательский ~/.xsession переживает обновления и позволяет разным людям держать разные окружения. Промежуточный вариант для Debian/Ubuntu: sudo update-alternatives --config x-session-manager и выбор /usr/bin/startxfce4.

Права на .xsessionrc и типичные ошибки

Файлы должны принадлежать пользователю сессии и лежать в его домашнем каталоге. ~/.xsession требует бита x, иначе Xsession его проигнорирует и уйдёт по цепочке альтернатив. Для ~/.xsessionrc достаточно чтения владельцем, но строгие права 700 держат конфигурацию закрытой от остальных.

chown "$USER":"$USER" ~/.xsession ~/.xsessionrc
chmod 700 ~/.xsession
chmod 600 ~/.xsessionrc
ls -la ~/.xsession ~/.xsessionrc
file ~/.xsession

Что чаще всего ломает запуск:

  • Файлы созданы через sudo и принадлежат root. xrdp запускает сессию от пользователя, читать корневой файл он не сможет. Лечится chown из примера выше.
  • Отсутствует бит x у ~/.xsession. В ~/.xsession-errors появляется запись о том, что стартовый файл не найден.
  • Нет shebang. Xsession делает exec файла, а без строки #!/bin/sh ядро отвечает ошибкой формата.
  • CRLF после редактирования в Windows. Команда file ~/.xsession покажет "with CRLF line terminators", а в логе будет "bad interpreter: /bin/sh^M". Лечится через sed -i 's/\r$//' ~/.xsession или dos2unix.
  • Опечатка в имени: .xsession и .xsessionrc это разные файлы с разными ролями, .xsessionRC или .Xsession не читаются.
  • Файлы лежат в /root, а подключается другой пользователь. Домашний каталог должен совпадать с тем, под кем выполняется вход.

Проверка результата: сервис, порт, логи и подключение

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

systemctl status xrdp xrdp-sesman --no-pager
ss -tlnp 'sport = :3389'
sudo journalctl -u xrdp -u xrdp-sesman -n 50 --no-pager
sudo tail -n 30 /var/log/xrdp-sesman.log
ls -la ~/.xsession-errors

Подключение с Windows: mstsc, адрес сервера, логин и пароль пользователя, для которого создан ~/.xsession. С Linux удобнее xfreerdp с явным размером экрана, чтобы не получить нечитаемый рабочий стол на маленьком мониторе.

xfreerdp /v:10.0.0.15:3389 /u:deploy /size:1600x900 /dynamic-resolution

Успешный вход в логах xrdp-sesman выглядит как последовательность: принято соединение от sesman, аутентификация пользователя прошла, выделен дисплей с номером 10 или 11, запущен Xorg-сервер, сессия отмечена как активная. Признаки проблем: строки о невозможности стартовать X server, об ошибке pam_authenticate, о занятом дисплее или о повторной сессии для пользователя.

СимптомГде смотретьЧто это значит
Клиент сразу закрывает окноjournalctl -u xrdpОтказ на этапе протокола или TLS, часто из-за ключа и группы ssl-cert
Логин прошёл, экран чёрный~/.xsession-errorsСессия стартовала, но WM не запустился: права, shebang, startxfce4
Сессия висит и не завершаетсяloginctl list-sessionsОсталась старая сессия пользователя, новая не выделяется
X server failed to startjournalctl -u xrdp-sesmanНет xorgxrdp или занят дисплей
Соединение рвётся через минуту простоя/etc/xrdp/sesman.iniСработал IdleTimeLimit или DisconnectedTimeLimit

Чёрный экран при подключении: пошаговое решение

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

  1. Откройте ~/.xsession-errors. Команда: tail -n 30 ~/.xsession-errors. Нет файла вообще - значит сессия не дошла до Xsession, смотрите журнал xrdp-sesman.
  2. Проверьте права и владельца: ls -la ~/.xsession ~/.xsessionrc. Ожидается -rwx------ для .xsession и ваш логин в колонке владельца.
  3. Убедитесь, что установлен xorgxrdp и на месте драйвер: dpkg -l xorgxrdp или rpm -q xorgxrdp, затем ls /usr/lib/xorg/modules/drivers/xrdp_drv.so.
  4. Исключите занятую сессию: loginctl list-sessions, дальше loginctl terminate-session с номером зависшей.
  5. Временно отключите .xsessionrc: mv ~/.xsessionrc ~/.xsessionrc.bak, перезайдите. Если экран появился, проблема в переменной окружения.
  6. Упростите ~/.xsession до двух строк (shebang и exec startxfce4) и проверьте снова.

Диагностика по логам

Читайте три источника: ~/.xsession-errors (всё, что происходит внутри сессии), /var/log/xrdp-sesman.log (выделение дисплея и запуск Xorg), /var/log/xrdp.log (уровень протокола и TLS). В systemd-дистрибутивах то же самое доступно через journalctl -u xrdp -u xrdp-sesman.

tail -n 50 ~/.xsession-errors
sudo tail -n 50 /var/log/xrdp-sesman.log
sudo grep -iE 'error|fail|denied' /var/log/xrdp.log

Трактовка типовых записей: "unable to start X server" указывает на отсутствующий xorgxrdp или занятый номер дисплея; "pam_authenticate failed" на неверный пароль, заблокированную учётную запись или нестандартный PAM-стек; "session already active" на то, что для пользователя уже есть живая сессия; ошибки чтения key.pem на права группы ssl-cert. Строка про exec format error в ~/.xsession-errors означает CRLF или отсутствие shebang.

Конфликты сессий и зависшие процессы

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

loginctl list-sessions
loginctl terminate-session 12
pgrep -a -u deploy Xorg
pgrep -a -u deploy xfce4-session
pkill -u deploy xfce4-session
sudo systemctl restart xrdp-sesman

Отдельная причина - сохранённая сессия XFCE. Менеджер восстанавливает состояние из ~/.cache/sessions, и битый файл не даёт окружению собраться. Очистите каталог и войдите заново: rm -rf ~/.cache/sessions/*. Если испорчены настройки окружения, помогает временный перенос ~/.config/xfce4 в ~/.config/xfce4.bak, после чего XFCE создаст конфигурацию с нуля.

Автоматизируйте уборку через /etc/xrdp/sesman.ini. Параметр KillDisconnected отвечает за завершение сессии при разрыве, DisconnectedTimeLimit задаёт время в секундах, по истечении которого сессия завершается после отключения пользователя (работает только с сессиями xorgxrdp), IdleTimeLimit ограничивает простой — время в секундах до отключения сессии без ввода с клавиатуры и движений/кликов мыши; значение 0 отключает таймаут, а для IdleTimeLimit требуется xorgxrdp v0.2.9 или новее. Для админского доступа разумные значения: 3600 и 7200 соответственно.

Безопасность RDP-доступа и параметры sesman

RDP в интернет не выставляем. Два рабочих варианта: VPN (WireGuard, OpenVPN) с доступом к 3389 только из внутренней подсети или SSH-туннель до loopback. Второй вариант настраивается без изменения топологии сети.

ssh -N -L 3389:127.0.0.1:3389 deploy@10.0.0.15
# клиент подключается к localhost:3389

Чтобы туннель был единственным путём, привяжите xrdp к loopback в /etc/xrdp/xrdp.ini, секция [Globals]: address=127.0.0.1. Параметр address задаёт TCP-порт и интерфейс для входящих подключений; если указать только порт, xrdp слушает все интерфейсы, а порт RDP по умолчанию — 3389. Тогда внешние подключения к 3389 невозможны физически, даже при ошибке в правилах файрвола.

# ufw: доступ только из сети VPN
sudo ufw allow from 10.8.0.0/24 to any port 3389 proto tcp
sudo ufw deny 3389/tcp

# firewalld: то же через rich rule
sudo firewall-cmd --permanent --add-rich-rule='rule family=ipv4 source address=10.8.0.0/24 port port=3389 protocol=tcp accept'
sudo firewall-cmd --permanent --remove-port=3389/tcp
sudo firewall-cmd --reload

TLS в xrdp.ini по умолчанию согласуется с клиентом: параметр security_layer, если не задан, принимает значение negotiate. Сертификат и приватный ключ задаются параметром certificate и должны быть в PEM-формате; если параметр не указан, используется значение по умолчанию из пакета. Для внутреннего контура этого достаточно, но сертификат стоит перевыпустить под имя хоста и убрать предупреждение клиента. Проверьте пару параметров производительности: max_bpp ограничивает глубину цвета максимальным числом бит на пиксель (24 снижает трафик без заметной потери качества), а tcp_nodelay уменьшает задержку ввода в интерактивной работе.

ПараметрФайл и секцияЗначениеЗачем
addressxrdp.ini, [Globals]127.0.0.1Доступ только через туннель
max_bppxrdp.ini, [Globals]24Меньше трафик на медленных каналах
tcp_nodelayxrdp.ini, [Globals]trueОтклик мыши и клавиатуры
MaxSessionssesman.ini, [Sessions]5Максимум одновременных сессий; 0 или отсутствие значения — без ограничения
KillDisconnectedsesman.ini, [Sessions]trueНет брошенных сессий после разрыва

Для защиты от перебора добавьте jail xrdp в fail2ban: он читает /var/log/xrdp-sesman.log и блокирует адрес после серии неудачных аутентификаций. Сами учётные записи проверьте по чек-листу аудита безопасности Linux-сервера: RDP с паролем открывает тот же периметр, что и SSH, и требования к паролям, sudo и обновлениям здесь такие же жёсткие.

Чек-лист и что делать дальше

Сверьте конфигурацию по пунктам, каждый проверяется одной командой.

  • Пакеты xrdp, xorgxrdp и xfce4 установлены, версии совпадают по ветке: dpkg -l xrdp xorgxrdp xfce4 или rpm -q xrdp xorgxrdp.
  • Сервисы включены в автозапуск и активны: systemctl is-enabled xrdp xrdp-sesman.
  • Порт 3389 слушается, 3350 доступен только с loopback: ss -tlnp 'sport = :3389'.
  • Пользователь xrdp входит в группу ssl-cert: id xrdp.
  • ~/.xsession принадлежит пользователю, права 700, внутри shebang и exec startxfce4.
  • ~/.xsessionrc содержит XDG_CURRENT_DESKTOP=XFCE и XDG_SESSION_TYPE=x11, права 600.
  • Вход клиентом проходит, рабочий стол появляется, ~/.xsession-errors не пополняется ошибками.
  • Повторный вход после разрыва не даёт чёрный экран: проверьте loginctl list-sessions и KillDisconnected.
  • Доступ ограничен VPN или SSH-туннелем, 3389 закрыт снаружи: sudo ufw status или firewall-cmd --list-all.

Дальше имеет смысл закрыть смежные темы: постоянный SSH-туннель в конфиге клиента, fail2ban для xrdp и мониторинг состояния systemd-юнитов. Общая гигиена сервера разобрана в чек-листе аудита безопасности Linux-серверов, а базовые команды администрирования и работа с пакетными менеджерами в практическом руководстве по Linux.

Если графический доступ нужен только для веб-панели, xrdp с XFCE избыточен: хватит браузера на рабочей машине и правильно закрытой панели, как описано в материале про защиту веб-интерфейса сервера. RDP оставляйте для задач, где действительно нужен полноценный рабочий стол.

Источники

Поделиться: