xrdp ставится из штатных репозиториев Ubuntu и Debian, на RHEL-подобных системах — из EPEL, и сразу после установки начинает слушать 3389/TCP. Дальше остаётся включить автозапуск, ограничить доступ доверенной подсетью и проверить вход RDP-клиентом.
Ниже полный маршрут: установка xrdp и xorgxrdp, автозапуск через systemctl, открытие порта только для нужных адресов, первый коннект из mstsc или Remmina, локализация чёрного экрана и отказов аутентификации, финальный чек-лист с командами диагностики.
Ограничение, которое нужно принять до старта: xrdp работает поверх X11 и требует установленного окружения рабочего стола. На сервере без GUI сессия не поднимется, и это самая частая причина разочарования в инструменте.
apt update && apt install -y xrdp xorgxrdp systemctl enable --now xrdp systemctl is-enabled xrdp ss -tlnp | grep 3389
Что даёт xrdp и когда он уместен
xrdp — RDP-сервер для Linux. Он принимает подключения по протоколу RDP на 3389/TCP, а графическую сессию для пользователя поднимает отдельный демон xrdp-sesman. Клиенту всё равно, что на той стороне: Windows, macOS и Linux подключаются одинаково, стандартным RDP-клиентом.
Практические сценарии, где xrdp экономит время: доступ к GUI-приложениям администрирования, тестовые стенды с браузером и десктопными утилитами, работа с инструментами, у которых нет нормального CLI, доступ инженеров к внутренним сервисам через VPN.
Безопасность решаем до установки, а не после. Порт 3389 в открытом интернете находят боты: журнал заполняется неудачными входами, а один слабый пароль даёт доступ к серверу. Этот риск подробно разобран на примере терминального сервера Windows (настройка терминального сервера Windows 2019). Для xrdp вывод тот же: доступ через VPN или шлюз, ограничение источников по IP, стойкие пароли и блокировка учётной записи после серии неудачных попыток.
Ограничения и совместимость с окружениями рабочего стола
xrdp не рисует рабочий стол сам. Ему нужно окружение, которое он запустит внутри X-сессии: Xfce, MATE, GNOME, KDE. Лёгкие окружения дают предсказуемый результат и меньше зависимостей, тяжёлые требуют рабочего dbus и полного набора сессионных компонентов.
- Xfce и MATE — самый стабильный выбор для серверов, где GUI нужен эпизодически.
- GNOME рабочий, но тянет большой набор пакетов и чаще упирается в права на домашний каталог.
- Чистый сервер без GUI: сначала ставим минимальный десктоп, потом xrdp. В Ubuntu подойдёт пакет xfce4, в RHEL-семействе — группа «Server with GUI» или Xfce из EPEL.
Wayland создаёт сложности: xrdp поднимает Xorg-сессию, а гибридные конфигурации с Wayland по умолчанию могут приводить к чёрному экрану или падению сессии. Проверьте тип активной сессии:
loginctl list-sessions loginctl show-session <ID> -p Type
Если в ответе Type=wayland, для xrdp-сессии выбирайте Xorg на экране входа или настройте окружение так, чтобы стартовал X11. На сервере, который только готовите к работе, пройдите чек-лист первичной настройки Linux: обновления, sudo-пользователь, часовой пояс и файрвол экономят часть шагов ниже.
Установка xrdp на Ubuntu и Debian
Пакет есть в стандартных репозиториях. Ставим два компонента: сам xrdp и xorgxrdp, который даёт бэкенд на Xorg. Без xorgxrdp сервер уходит на VNC-бэкенд, а он медленнее и требует дополнительных пакетов.
apt update apt install -y xrdp xorgxrdp systemctl status xrdp --no-pager ss -tlnp | grep 3389
После установки служба уже запущена, но автозапуск проверяем отдельно. Пакет создаёт системного пользователя xrdp и добавляет его в группу ssl-cert, чтобы демон мог читать ключ /etc/ssl/private/ssl-cert-snakeoil.key. Если вы замените сертификат на свой, проверьте права на файл ключа, иначе TLS-слой не поднимется.
Проверка пакета и версии
dpkg -l | grep -E 'xrdp|xorgxrdp' xrdp --version apt-cache policy xrdp xorgxrdp
Держите xrdp и xorgxrdp из одного релиза: рассинхрон версий даёт ошибки при старте сессии, которые видно только в xrdp-sesman.log. Если пакет не найден, проверьте подключённые репозитории в /etc/apt/sources.list и в /etc/apt/sources.list.d/, включите компоненты main и universe и повторите apt update.
Про актуальность версий: ориентируйтесь на ветку xrdp 0.10.x. По данным проекта, релиз v0.10.5 вышел 2026/01/27, v0.10.6 — 2026/04/17, а v0.10.6.1 — 2026/07/06 и исправляет 10 уязвимостей и одну регрессию, внесённую исправлением уязвимости в предыдущем релизе. Ветка 0.9.x объявлена end-of-life (последний релиз v0.9.27 от 2026/01/28), поэтому старые сборки 0.9.x лучше не использовать. Точные версии пакетов в конкретном релизе Ubuntu или Debian проверяйте через apt-cache policy: они зависят от дистрибутива и его среза обновлений.
Установка xrdp на RHEL-подобных дистрибутивах
В RHEL, AlmaLinux и Rocky пакета в базовых репозиториях нет, он приходит из EPEL. Порядок такой:
dnf install -y epel-release dnf install -y xrdp xorgxrdp rpm -q xrdp xorgxrdp systemctl enable --now xrdp systemctl status xrdp --no-pager
Проверка версии и состава пакета: rpm -qi xrdp покажет сборку и дату, rpm -ql xrdp перечислит файлы конфигурации и юниты. Для EL9 в EPEL подтверждён пакет xorgxrdp версии 0.10.5-1.el9 (x86_64) — он доступен для RHEL 9, Rocky Linux 9, AlmaLinux 9 и CentOS 9 Stream. Наличие самого xrdp в EPEL проверяйте через dnf info xrdp после подключения epel-release: подтверждение в источниках есть только по xorgxrdp. Дальше обязательный шаг для RHEL-семейства: разобраться с SELinux и firewalld, иначе вход упрётся в отказ, который не виден в клиенте.
SELinux и firewalld: что учесть заранее
В режиме Enforcing SELinux может блокировать запуск сессии: политика не даёт демону читать домашний каталог или писать в собственные файлы. Смотрим режим и свежие отказы:
getenforce ausearch -m avc -ts today | grep -i xrdp restorecon -Rv /etc/xrdp /var/log/xrdp
Записи AVC в /var/log/audit/audit.log показывают конкретный запрещённый доступ: denied { read } на файл или denied { connectto } на сокет. По этой записи понятно, что править права или метку, а не отключать SELinux целиком. Порт 3389 открывает firewalld, и делать это нужно только для доверенной зоны, о чём ниже.
Автозапуск и управление службой через systemctl
systemctl enable --now xrdp systemctl is-enabled xrdp systemctl status xrdp --no-pager systemctl restart xrdp
enable добавляет юнит в автозапуск при загрузке, start запускает его сейчас, флаг --now делает оба действия одной командой. После правок в /etc/xrdp/xrdp.ini или /etc/xrdp/sesman.ini нужен restart, reload эти файлы не перечитывает. На части систем рядом живёт отдельный юнит xrdp-sesman, проверяйте оба:
systemctl status xrdp xrdp-sesman --no-pager systemctl is-enabled xrdp xrdp-sesman
Чтение статуса и типичные состояния
- active (running) — демон работает, порт занят, можно тестировать вход.
- inactive (dead) — служба остановлена или не включена в автозапуск.
- failed — старт завершился ошибкой; смотрите journalctl -u xrdp -n 50 --no-pager.
- activating (auto-restart) по кругу — почти всегда занятый порт 3389 или битый сертификат.
Статус running подтверждает только то, что процесс жив. Успешный вход он не гарантирует: сессию поднимает sesman, и сбой на этом этапе виден в отдельном логе.
Открытие порта 3389 и базовая защита доступа
xrdp слушает 3389/TCP. Открывайте порт только для доверенной подсети или VPN-пула, а не для всех адресов.
ufw allow from 10.8.0.0/24 to any port 3389 proto tcp ufw status verbose
firewall-cmd --permanent --zone=internal --add-source=10.8.0.0/24 firewall-cmd --permanent --zone=internal --add-port=3389/tcp firewall-cmd --reload firewall-cmd --list-all --zone=internal
Для firewalld рабочий вариант — отдельная зона, в которую добавлены доверенные источники и порт. Тогда глобальное открытие 3389 не нужно, а правило живёт в предсказуемом месте.
Публиковать 3389 в интернет не стоит: порт сканируют, слабый пароль приводит к захвату сервера, а журнал заполняется мусором. Рекомендация пускать пользователей через VPN или шлюз удалённых рабочих столов и включать блокировку учётной записи после нескольких неверных паролей сформулирована для Windows-терминального сервера (разбор рисков открытого RDP), для xrdp она работает так же. VPN на WireGuard поднимается за несколько минут, разбор конфигурации есть в руководстве по Linux для IT-специалистов.
Про NLA и CredSSP: в материалах нет официального подтверждения того, как именно xrdp соотносится с NLA/CredSSP, которых ожидает Windows-клиент, поэтому не стоит рассчитывать на полный паритет с Windows-сервером по этому механизму. Проверяйте поведение вашей версии по её конфигу и логам. В xrdp.ini есть параметр security_layer, который регулирует методы безопасности: если он не указан, применяется значение по умолчанию с Enhanced RDP Security (шифрование и прочие операции безопасности). Параметр можно задать явно, например security_layer=rdp, после чего нужен перезапуск службы: systemctl restart xrdp. Дополнительно поставьте нормальный сертификат вместо самоподписанного, ограничьте сеть и настройте блокировку через pam_faillock или fail2ban.
Проверка, что порт слушается и доступен только нужным
ss -tlnp | grep 3389 ss -tlnp | grep -E ':3350|:3389'
Нормальный вывод: LISTEN на 0.0.0.0:3389 или на конкретном адресе, в поле Process указан xrdp. По умолчанию xrdp слушает TCP-порт 3389; если в конфигурации указан только порт, xrdp слушает на всех интерфейсах, а директивами port и address в xrdp.ini задаются TCP-порт и интерфейс для входящих подключений. Если порт слушается на внешнем интерфейсе, а должен только на VPN-адресе, ограничьте привязку директивой address в xrdp.ini. Порт 3350 держит xrdp-sesman, и по умолчанию он слушает 127.0.0.1:3350 — наружу его открывать не нужно. Дополнительно убедитесь, что порт виден снаружи только с разрешённых адресов: проверьте ufw status verbose или firewall-cmd --list-all и сверьте список источников.
Подключение RDP-клиентом: первый вход
Windows: запустите mstsc, укажите адрес сервера и порт (например, 10.8.0.15:3389), затем логин и пароль Linux-пользователя. Поле домена оставьте пустым, если не используете доменную аутентификацию. Linux: Remmina с протоколом RDP, macOS: Microsoft Remote Desktop.
При первом коннекте xrdp покажет собственный экран входа, где выбирается модуль сессии. Выбирайте Xorg, вводите учётные данные пользователя. Успешный вход означает, что sesman поднял сессию, клиент получил рабочий стол и в логах нет ошибок сессии. Пользователь должен существовать в системе, иметь пароль и домашний каталог; тонкости создания учётных записей и ограничений по группам разобраны в материале про управление пользователями и доступом на сервере.
Тестируйте сначала из локальной сети или из VPN. Если вход не удался, вы не потратите время на разбор блокировок, которые включает защита от публичного доступа.
Что делать, если клиент не подключается
Разделите диагностику на три слоя: сеть, служба, аутентификация.
nc -zv 10.8.0.15 3389 systemctl status xrdp --no-pager journalctl -u xrdp -n 50 --no-pager
Таймаут на nc означает сеть или файрвол: порт закрыт, адрес не тот, маршрут через VPN не поднят. Мгновенный сброс соединения после ввода пароля уводит в sesman и окружение рабочего стола. Ошибка «неверный пароль» при верных данных указывает на PAM, блокировку или запрет входа в систему. Класс проблемы определяет, какой лог открывать первым.
Типичные ошибки первого коннекта и как их локализовать
| Симптом | Вероятная причина | Что проверить |
|---|---|---|
| Клиент долго висит на этапе подключения | Порт закрыт файрволом или служба не слушает | ss -tlnp | grep 3389, ufw status verbose, firewall-cmd --list-all |
| Соединение обрывается после ввода пароля | Нет окружения рабочего стола, падает sesman | tail -n 100 /var/log/xrdp-sesman.log |
| Чёрный экран после успешного входа | Не установлен xorgxrdp или сломан ~/.xsession | dpkg -l | grep xorgxrdp, содержимое ~/.xsession |
| Отказ в аутентификации при верном пароле | Учётная запись заблокирована pam_faillock | faillock --user user, passwd -S user |
| Служба падает, статус failed | Порт 3389 занят другим процессом | ss -tlnp | grep 3389, journalctl -u xrdp -n 50 |
Чёрный экран и проблемы сессии
Чёрный экран почти всегда означает, что X-сессия поднялась, но оконный менеджер не стартовал. Проверьте, установлен ли xorgxrdp и есть ли рабочее окружение:
dpkg -l | grep -E 'xorgxrdp|xfce4' ls -la ~/.xsession ~/.Xauthority tail -n 100 /var/log/xrdp-sesman.log
В логе ищите строки про запуск сессии и ошибки старта стартового скрипта. Частые причины: не задан ~/.xsession, права на ~/.Xauthority принадлежат другому пользователю, домашний каталог зашифрован, выбран GNOME без полного набора зависимостей. Быстрый способ проверить гипотезу про окружение — поставить Xfce и указать его в сессии. На RHEL-системах к этому добавляется SELinux: система может запрещать чтение домашнего каталога, и тогда нужен restorecon, а не переустановка пакетов.
Ошибки аутентификации и блокировки
journalctl -u xrdp -n 100 --no-pager tail -n 100 /var/log/auth.log faillock --user user faillock --user user --reset
PAM пишет причину отказа в auth.log (в RHEL-системах — в /var/log/secure). passwd -S user покажет состояние учётной записи: L в начале строки означает блокировку, NP или P — пароль задан. После серии неудачных попыток пользователь блокируется политикой faillock, и вход не проходит даже с правильным паролем; снимается блокировка командой faillock --user user --reset или истечением таймера. Параллельно проверьте, не отключён ли вход в систему для этой учётной записи и существует ли её домашний каталог.
Чек-лист проверки после установки и команды диагностики
- Пакет установлен, версия известна: xrdp --version, dpkg -l | grep xrdp или rpm -q xrdp.
- xorgxrdp стоит из того же релиза, что и xrdp.
- Служба в автозапуске: systemctl is-enabled xrdp возвращает enabled.
- Статус active (running) без ошибок в journalctl -u xrdp.
- Порт 3389 слушается: ss -tlnp | grep 3389 показывает процесс xrdp.
- Доступ ограничен доверенной подсетью или VPN, порт не опубликован в интернет.
- Учётная запись имеет пароль, домашний каталог и не заблокирована.
- Тестовый вход RDP-клиентом успешен, рабочий стол отрисовался.
- Логи xrdp.log и xrdp-sesman.log без критичных ошибок после теста.
Безопасность стоит проверить отдельно: список учётных записей, состояние файрвола, отсутствие лишних открытых портов. Готовые команды для такого прохода собраны в аудите безопасности Linux-серверов.
Команды диагностики логов xrdp
systemctl status xrdp xrdp-sesman --no-pager journalctl -u xrdp -n 100 --no-pager journalctl -u xrdp -f tail -n 100 /var/log/xrdp.log tail -n 100 /var/log/xrdp-sesman.log grep -i error /var/log/xrdp.log /var/log/xrdp-sesman.log ss -tlnp | grep 3389 ufw status verbose firewall-cmd --list-all
Логи xrdp и sesman разделены: первый отвечает за приём подключения и TLS, второй — за запуск сессии пользователя. Ошибка входа и чёрный экран диагностируются по разным файлам. Пути к логам задаются параметрами LogFile в /etc/xrdp/xrdp.ini и /etc/xrdp/sesman.ini. В xrdp.ini LogFile содержит путь к лог-файлу, абсолютный или относительный (в примерах документации — /var/log/sesman.log). В sesman.ini параметр LogFile тоже задаёт путь к лог-файлу, абсолютный или относительный, а если он не указан, по умолчанию используется ./sesman.log. Фактические значения в вашей системе видны в systemctl cat xrdp и systemctl cat xrdp-sesman. Часть сообщений службы может приходить только в journald — проверяйте и файлы, и journalctl.
Начните с двух проверок: ss -tlnp | grep 3389 и тестового входа из доверенной подсети. Если обе проходят, дальше остаётся окружение рабочего стола, и разбор идёт по xrdp-sesman.log, а не по конфигурации сети.