a0b2b5ebf7
- Host: 20-intel-virtual.conf with Driver intel + VirtualHeads 1 - VPS: xorg-dummy.service + rustdesk-dummy.service for CPU-only - Updated README with dual setup (host Intel iGPU + VPS dummy) - Verified: VIRTUAL1 primary after reboot, HDMI1 clone - Verified: DUMMY0 primary on VPS without GPU
292 lines
11 KiB
Markdown
292 lines
11 KiB
Markdown
# RDtop — RustDesk Headless Display Setup
|
||
|
||
**Автоматический виртуальный дисплей для RustDesk без подключенного HDMI монитора. Работает на Intel iGPU и CPU-only VPS.**
|
||
|
||
---
|
||
|
||
## Содержание
|
||
|
||
1. [Проблема](#проблема)
|
||
2. [Решение](#решение)
|
||
3. [Файлы проекта](#файлы-проекта)
|
||
4. [Установка](#установка)
|
||
- [Вариант А: Десктоп с Intel iGPU](#вариант-а-десктоп-с-intel-igpu)
|
||
- [Вариант Б: CPU-only VPS](#вариант-б-cpu-only-vps)
|
||
5. [Как это работает](#как-это-работает)
|
||
6. [Проверка](#проверка)
|
||
7. [Troubleshooting](#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
|
||
bash -c "$(curl -fsSL https://git.softuniq.eu/NW/RDtop/raw/branch/main/install.sh)"
|
||
```
|
||
|
||
После установки **перезагрузить компьютер** или перезапустить GDM:
|
||
```bash
|
||
sudo systemctl restart gdm
|
||
```
|
||
|
||
**Вручную:**
|
||
```bash
|
||
# 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
|
||
|
||
```bash
|
||
# 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`.
|
||
|
||
---
|
||
|
||
## Проверка
|
||
|
||
### Хост
|
||
```bash
|
||
# После перезагрузки
|
||
xrandr --listmonitors
|
||
# Должно быть:
|
||
# 0: +*VIRTUAL1 1920x... VIRTUAL1 [PRIMARY]
|
||
# 1: +HDMI1 1920x... HDMI1 [CLONE]
|
||
|
||
# Сервис
|
||
systemctl --user status hdmi-fallback.service
|
||
```
|
||
|
||
### VPS
|
||
```bash
|
||
export DISPLAY=:0
|
||
xrandr --listmonitors
|
||
# Должно быть:
|
||
# 0: +*DUMMY0 1920x... DUMMY0 [PRIMARY]
|
||
|
||
# RustDesk
|
||
ps aux | grep rustdesk
|
||
# /usr/lib/rustdesk/rustdesk --server должен быть запущен
|
||
```
|
||
|
||
---
|
||
|
||
## Troubleshooting
|
||
|
||
### VIRTUAL1 не появляется после reboot
|
||
|
||
```bash
|
||
# Проверить 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 черный экран
|
||
|
||
```bash
|
||
# Проверить 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
|
||
|
||
```bash
|
||
# Проверить что Xorg запущен:
|
||
ls /tmp/.X11-unix/X0
|
||
# Должен быть сокет
|
||
|
||
# Если нет — запустить вручную:
|
||
/usr/local/bin/start-xorg-dummy.sh
|
||
```
|
||
|
||
---
|
||
|
||
## Откат
|
||
|
||
```bash
|
||
# Хост
|
||
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)"`
|