RDtop/README.md

RDtop — RustDesk Headless Display Setup

Автоматический виртуальный дисплей для RustDesk без подключенного HDMI монитора. Работает на Intel iGPU и CPU-only VPS.

---

Содержание

1. Проблема
2. Решение
3. Файлы проекта
4. Установка
   • Вариант А: Десктоп с Intel iGPU
   • Вариант Б: CPU-only VPS
5. Как это работает
6. Проверка
7. Troubleshooting
8. Откат

---

Проблема

Оборудование: Intel Alder Lake-N (i915), Ubuntu 24.04, X11 (GDM/GNOME).

Что происходит

1. При подключенном HDMI — Xorg инициализирует HDMI-1 на отдельный CRTC.
2. Когда кабель отключают — CRTC уничтожается.
3. У Xorg не остается активного выхода. Может остаться черный экран или fallback 8×8.
4. RustDesk все еще подключен, но захватывает Screen 0 — и видит либо черный экран, либо 8×8 пикселей.

Почему стандартные способы не помогли

Способ	Результат
Option "VirtualHeads" "1" (intel driver)	Работает! Но требует Driver "intel" + VirtualHeads в xorg.conf.
modesetting driver	Создает VIRTUAL1 через randr, но после reboot пропадает без intel config.
NoOutputInitialSize	Требует пересборки xorg или патчей.
Dummy plug (аппаратный)	Работает, но нужно покупать.

---

Решение

Хост (Intel iGPU): VIRTUAL1 = primary, HDMI1 = clone

+------------------------------------------------------------------------+
|                    X11 Screen 0: 1920x1080                              |
|                                                                         |
|   +-------------------------+   +------------------------------------+  |
|   |   VIRTUAL1              |   |   HDMI1                            |  |
|   |   [PRIMARY] 1920×1080   |   |   [CLONE --same-as VIRTUAL1]      |  |
|   |   Всегда активен        |   |   При отключении → off             |  |
|   +-------------------------+   +------------------------------------+  |
|                                                                         |
|   RustDesk: всегда захватывает PRIMARY (VIRTUAL1)                       |
+------------------------------------------------------------------------+

VPS (CPU-only): Dummy driver + Xorg + RustDesk

+------------------------------------------------------------------------+
|   Xorg Dummy Driver (1920×1080)                                         |
|   +-------------------------+                                           |
|   |   DUMMY0 = primary      |   ← RustDesk --server захватывает       |
|   |   1920×1080 @ 60Hz     |                                           |
|   +-------------------------+                                           |
|   Нет GPU, нет DRM — работает на любом VPS                             |
+------------------------------------------------------------------------+

---

Файлы проекта

Файл репозитория	Назначение	Системный путь
bin/hdmi-fallback.sh	Мониторинг HDMI-A-1 и авто-fallback на VIRTUAL1	~/.local/bin/hdmi-fallback.sh
bin/vps-start-xorg.sh	Стартер Xorg с dummy driver на VPS	/usr/local/bin/start-xorg-dummy.sh
config/x11/90-fallback.conf	Xorg fallback: Virtual 1920 1080 для modesetting	/etc/X11/xorg.conf.d/90-fallback.conf
config/x11-host/20-intel-virtual.conf	Intel driver + VirtualHeads=1	/etc/X11/xorg.conf.d/20-intel-virtual.conf
config/systemd/hdmi-fallback.service	systemd user unit (host)	~/.config/systemd/user/hdmi-fallback.service
config/vps/xorg-dummy.service	systemd system unit (VPS Xorg)	/etc/systemd/system/xorg-dummy.service
config/vps/rustdesk-dummy.service	systemd system unit (VPS RustDesk)	/etc/systemd/system/rustdesk-dummy.service
install.sh	Установщик для хоста	(запускается один раз)

---

Установка

Вариант А: Десктоп с Intel iGPU

bash -c "$(curl -fsSL https://git.softuniq.eu/NW/RDtop/raw/branch/main/install.sh)"

После установки перезагрузить компьютер или перезапустить GDM:

sudo systemctl restart gdm

Вручную:

# 1. Клонируем
git clone https://git.softuniq.eu/NW/RDtop.git ~/RDtop && cd ~/RDtop

# 2. Intel driver + VirtualHeads
sudo cp config/x11-host/20-intel-virtual.conf /etc/X11/xorg.conf.d/

# 3. Xorg fallback (резерв)
sudo cp config/x11/90-fallback.conf /etc/X11/xorg.conf.d/

# 4. Скрипт мониторинга
chmod +x bin/hdmi-fallback.sh
cp bin/hdmi-fallback.sh ~/.local/bin/

# 5. systemd unit
mkdir -p ~/.config/systemd/user
cp config/systemd/hdmi-fallback.service ~/.config/systemd/user/
systemctl --user daemon-reload
systemctl --user enable --now hdmi-fallback.service

# 6. Перезагрузка
sudo systemctl restart gdm

Вариант Б: CPU-only VPS

# 1. Установить Xorg + dummy
apt-get update
apt-get install -y xserver-xorg xserver-xorg-video-dummy rustdesk

# 2. Копировать конфиги
git clone https://git.softuniq.eu/NW/RDtop.git /tmp/rdtop
cd /tmp/rdtop
sudo cp config/vps/xorg-dummy.service /etc/systemd/system/
sudo cp config/vps/rustdesk-dummy.service /etc/systemd/system/
sudo cp bin/vps-start-xorg.sh /usr/local/bin/start-xorg-dummy.sh
chmod +x /usr/local/bin/start-xorg-dummy.sh

# 3. Запустить
systemctl daemon-reload
systemctl enable --now xorg-dummy.service
systemctl enable --now rustdesk-dummy.service

# 4. Проверить
export DISPLAY=:0
xrandr --listmonitors
# Должно показать: DUMMY0 primary 1920x1080

---

Как это работает

Хост (Intel iGPU)

1. Xorg конфиг 20-intel-virtual.conf указывает Driver "intel" + Option "VirtualHeads" "1".
2. Intel driver создает VIRTUAL1 как software output (проверено на Alder Lake-N).
3. Скрипт hdmi-fallback.sh при старте:
   • Всегда активирует VIRTUAL1 как primary
   • Если HDMI connected — делает HDMI1 clone (--same-as)
   • Если HDMI disconnected — выключает HDMI1, VIRTUAL1 остается primary
4. RustDesk захватывает VIRTUAL1 (primary), а не HDMI1.

VPS (CPU-only)

1. Dummy driver (Driver "dummy") не требует GPU, работает на чистом CPU.
2. Xorg запускается без DRM, создает DUMMY0 1920×1080.
3. RustDesk --server захватывает DUMMY0 через X11 screen capture.
4. Нет GUI оболочки по умолчанию — если нужен рабочий стол, установить xfce4 + tightvncserver.

---

Проверка

Хост

# После перезагрузки
xrandr --listmonitors
# Должно быть:
#   0: +*VIRTUAL1 1920x... VIRTUAL1   [PRIMARY]
#   1: +HDMI1    1920x... HDMI1     [CLONE]

# Сервис
systemctl --user status hdmi-fallback.service

VPS

export DISPLAY=:0
xrandr --listmonitors
# Должно быть:
#   0: +*DUMMY0 1920x... DUMMY0   [PRIMARY]

# RustDesk
ps aux | grep rustdesk
# /usr/lib/rustdesk/rustdesk --server  должен быть запущен

---

Troubleshooting

VIRTUAL1 не появляется после reboot

# Проверить intel driver:
grep "Loading.*intel" /var/log/Xorg.0.log
# Должно быть: (II) Loading /usr/lib/xorg/modules/drivers/intel_drv.so

# Если modesetting загружается вместо intel:
# Убедиться что 20-intel-virtual.conf существует:
ls /etc/X11/xorg.conf.d/20-intel-virtual.conf
# Убедиться что нет других конфликтующих xorg.conf:
ls /etc/X11/xorg.conf 2>/dev/null || echo "OK: no xorg.conf"

RustDesk черный экран

# Проверить primary:
xrandr --verbose | grep primary
# Должно быть: VIRTUAL1 connected primary (или DUMMY0)

# Если primary = HDMI1 — переключить:
xrandr --output VIRTUAL1 --mode "1920x1080_60.00" --primary
xrandr --output HDMI1 --auto --same-as VIRTUAL1

VPS: RustDesk не видит DUMMY0

# Проверить что Xorg запущен:
ls /tmp/.X11-unix/X0
# Должен быть сокет

# Если нет — запустить вручную:
/usr/local/bin/start-xorg-dummy.sh

---

Откат

# Хост
sudo rm -f /etc/X11/xorg.conf.d/20-intel-virtual.conf
sudo rm -f /etc/X11/xorg.conf.d/90-fallback.conf
systemctl --user disable --now hdmi-fallback.service
rm -f ~/.local/bin/hdmi-fallback.sh

# VPS
systemctl disable --now xorg-dummy.service
systemctl disable --now rustdesk-dummy.service
sudo rm -f /etc/systemd/system/xorg-dummy.service
sudo rm -f /etc/systemd/system/rustdesk-dummy.service

---

Технические детали

Почему intel driver, а не modesetting?

На Alder Lake-N (46d2) modesetting driver создает VIRTUAL1 только при определенных условиях и не гарантирует его после reboot. Intel driver с VirtualHeads=1 создает VIRTUAL1 стабильно.

Почему клон, а не extended desktop?

--same-as клонирует framebuffer. При disconnect HDMI clone просто перестает рендериться, но primary (VIRTUAL1) не затрагивается — Xorg не теряет framebuffer.

Dummy driver на VPS

Не требует GPU, не использует DRM. Работает на любом Linux с xorg-server. RustDesk использует software capture через X11 API.

---

Авторы

• Deploy via AI Agent (Kilo Code Orchestrator)
• Target hardware: Intel Alder Lake-N (i915), Ubuntu 24.04
• VPS: CPU-only, Ubuntu 24.04, Hetzner/DigitalOcean/Linode

Ссылки

• Репозиторий: https://git.softuniq.eu/NW/RDtop
• Установщик: bash -c "$(curl -fsSL https://git.softuniq.eu/NW/RDtop/raw/branch/main/install.sh)"