docs: added readme
This commit is contained in:
pyrshctjag
@@ -0,0 +1,187 @@
|
|||||||
|
# Headless OBS Studio on Proxmox LXC
|
||||||
|
|
||||||
|
Данный репозиторий содержит конфигурационные файлы для развертывания `obs-studio` в *headless*-режиме внутри контейнера **proxmox** (**lxc**) с пробросом **gpu** и **usb**-устройств захвата.
|
||||||
|
|
||||||
|
## Сравнение дистрибутивов
|
||||||
|
|
||||||
|
В процессе разработки были протестированы два окружения. Ниже приведен критический анализ возникших проблем:
|
||||||
|
|
||||||
|
| Характеристика | Alpine Linux | Debian 13 |
|
||||||
|
|:---:|:---|:---|
|
||||||
|
| **Графический стек** | `wayland` + `cage` + `wayvnc` | `x11` + `xvfb` + `x11vnc` |
|
||||||
|
| **Работа с железом** | Успешно: Стабильный захват `v4l2` | Критическая ошибка: Segfault в `linux-v4l2.so` |
|
||||||
|
| **Управление** | Проблема: Отсутствие плагина `obs-websocket` в репозиториях | Успешно: Полная поддержка `obs-websocket` |
|
||||||
|
| **Итог** | Идеально для картинки, невозможно управлять удаленно | Отличное управление, невозможно использовать родной `v4l2` |
|
||||||
|
|
||||||
|
### Почему **alpine** не подошел:
|
||||||
|
|
||||||
|
Основной блокирующий фактор — отсутствие нативной сборки `obs-websocket` в `apk` репозиториях. Поскольку проект требует удаленного управления через *api*, **alpine** без сложной ручной компиляции плагина оказался нежизнеспособен.
|
||||||
|
|
||||||
|
### Почему **debian** не подошел:
|
||||||
|
|
||||||
|
На ядре **proxmox** (`7.0.0-3-pve`) стандартный плагин `linux-v4l2.so` в **debian 13** вызывает ошибку обращения к памяти (`segmentation fault`) при инициализации устройств захвата.
|
||||||
|
|
||||||
|
## Текущий стек (arch + wayland)
|
||||||
|
|
||||||
|
После тестирования **alpine** и **debian**, финальным и наиболее стабильным решением стал **arch** в контейнере **lxc**. Это позволило получить доступ к свежим версиям `obs-studio` и плагина `obs-websocket` без проблем с сегфолтами ядра **proxmox**.
|
||||||
|
|
||||||
|
### Архитектурная схема
|
||||||
|
|
||||||
|
| Компонент | Технология | Описание |
|
||||||
|
| :---: | :--- | :--- |
|
||||||
|
| ОС | **arch linux** | Свежие репозитории и ядро, обеспечивающие совместимость с современными плагинами. |
|
||||||
|
| Графический стек | `wayland` + `cage` |Использование киоска для запуска `obs-studio` без тяжелого DE. |
|
||||||
|
| Удаленный доступ | `wayvnc` + `novnc` | Доступ к *gui* через браузер по вэбсокету. |
|
||||||
|
| Управление | `obs-websocket`| Нативная поддержка управления через *api* из коробки. |
|
||||||
|
| Работа с видео | `v4l2-input` | Стабильная работа вэбки и карты захвата без ошибок памяти. |
|
||||||
|
|
||||||
|
### Почему Arch Linux оказался идеальным решением:
|
||||||
|
|
||||||
|
Наличие `obs-websocket`: В отличие от **alpine**, пакет `obs-studio` в **arch** включает в себя актуальные плагины управления.
|
||||||
|
|
||||||
|
Исправленный `v4l2`: Плагин `linux-v4l2.so` в сборке **arch** не вызывает `segmentation fault` при инициализации устройств захвата на ядре **proxmox**.
|
||||||
|
|
||||||
|
Минимализм: Использование композитора `cage` позволяет держать потребление ресурсов на уровне **alpine**.
|
||||||
|
|
||||||
|
### Нюансы настройки (Troubleshooting)
|
||||||
|
|
||||||
|
* **Runtime Directory**: Для работы `wayland` необходимо вручную создавать и прокидывать `XDG_RUNTIME_DIR`, иначе композитор `cage` не сможет создать сокет.
|
||||||
|
|
||||||
|
* **WLR_BACKENDS**: При запуске в **lxc** без монитора необходимо явно указывать `WLR_BACKENDS=headless` для корректной инициализации виртуального экрана.
|
||||||
|
|
||||||
|
## Установка зависимостей
|
||||||
|
|
||||||
|
Включаем песочницу:
|
||||||
|
```bash
|
||||||
|
sed -i 's/#DisableSandbox/DisableSandbox/' /etc/pacman.conf
|
||||||
|
```
|
||||||
|
|
||||||
|
Инициализируем ключи для `pacman`:
|
||||||
|
```bash
|
||||||
|
pacman-key --init
|
||||||
|
pacman-key --populate archlinux
|
||||||
|
```
|
||||||
|
|
||||||
|
Устанавливаем программы:
|
||||||
|
```bash
|
||||||
|
# обновляем
|
||||||
|
pacman -Syu
|
||||||
|
# база
|
||||||
|
pacman -S obs-studio luajit cage wayvnc
|
||||||
|
# зависимости для yay
|
||||||
|
pacman -S base-devel linux-headers git nano
|
||||||
|
# видеодрайвера (в данном случае для амд)
|
||||||
|
pacman -S mesa vulkan-radeon
|
||||||
|
```
|
||||||
|
|
||||||
|
Далее пробрасываем устройства в контейнер с гипервизора, с **guid**'ами сверяемся в гостевой системе.
|
||||||
|
|
||||||
|
Пример:
|
||||||
|
```bash
|
||||||
|
dev0: /dev/dri/card0,gid=983,mode=0660,uid=0
|
||||||
|
dev1: /dev/dri/renderD128,gid=987,mode=0660,uid=0
|
||||||
|
dev2: /dev/video%N%,gid=983,mode=0660,uid=0
|
||||||
|
dev3: /dev/snd/controlC%N%,gid=995,mode=0660,uid=0
|
||||||
|
dev4: /dev/snd/pcmC%N%D0c,gid=995,mode=0660,uid=0
|
||||||
|
```
|
||||||
|
|
||||||
|
Перезапускаем контейнер и создаём юзера `obs`:
|
||||||
|
```bash
|
||||||
|
useradd -m -d /var/lib/obs -s /bin/bash obs
|
||||||
|
chown -R obs:obs /var/lib/obs
|
||||||
|
# wheel для yay
|
||||||
|
usermod -aG wheel,video,render,audio obs
|
||||||
|
```
|
||||||
|
|
||||||
|
Заходив в юзера и ставим `yay`:
|
||||||
|
```bash
|
||||||
|
# клонируем и ставим yay
|
||||||
|
cd /tmp
|
||||||
|
git clone https://aur.archlinux.org/yay.git
|
||||||
|
cd yay
|
||||||
|
makepkg -si
|
||||||
|
# устанавливаем novnc из aur
|
||||||
|
yay -S novnc
|
||||||
|
```
|
||||||
|
|
||||||
|
## systemd-units
|
||||||
|
|
||||||
|
### /etc/systemd/system/obs.service
|
||||||
|
```bash
|
||||||
|
[Unit]
|
||||||
|
Description=obs
|
||||||
|
After=network.target
|
||||||
|
|
||||||
|
[Service]
|
||||||
|
Type=simple
|
||||||
|
User=obs
|
||||||
|
Group=obs
|
||||||
|
RuntimeDirectory=obs-runtime
|
||||||
|
Environment=XDG_RUNTIME_DIR=/run/obs-runtime
|
||||||
|
Environment=WAYLAND_DISPLAY=wayland-0
|
||||||
|
Environment=WLR_BACKENDS=headless
|
||||||
|
Environment=WLR_LIBSEAT_BACKEND=noop
|
||||||
|
ExecStart=/usr/bin/cage -s -- /usr/bin/obs
|
||||||
|
Restart=always
|
||||||
|
RestartSec=3
|
||||||
|
|
||||||
|
[Install]
|
||||||
|
WantedBy=multi-user.target
|
||||||
|
```
|
||||||
|
### /etc/systemd/system/wayvnc.service
|
||||||
|
```bash
|
||||||
|
[Unit]
|
||||||
|
Description=wayvnc
|
||||||
|
After=obs.service
|
||||||
|
Requires=obs.service
|
||||||
|
|
||||||
|
[Service]
|
||||||
|
Type=simple
|
||||||
|
User=obs
|
||||||
|
Environment=XDG_RUNTIME_DIR=/run/obs-runtime
|
||||||
|
Environment=WAYLAND_DISPLAY=wayland-0
|
||||||
|
ExecStart=/usr/bin/wayvnc 127.0.0.1 5900
|
||||||
|
Restart=always
|
||||||
|
RestartSec=2
|
||||||
|
|
||||||
|
[Install]
|
||||||
|
WantedBy=multi-user.target
|
||||||
|
```
|
||||||
|
### /etc/systemd/system/novnc.service
|
||||||
|
```bash
|
||||||
|
[Unit]
|
||||||
|
Description=novnc
|
||||||
|
After=wayvnc.service
|
||||||
|
Requires=wayvnc.service
|
||||||
|
|
||||||
|
[Service]
|
||||||
|
Type=simple
|
||||||
|
User=obs
|
||||||
|
ExecStart=/usr/bin/novnc --listen 6080 --vnc localhost:5900
|
||||||
|
Restart=always
|
||||||
|
|
||||||
|
[Install]
|
||||||
|
WantedBy=multi-user.target
|
||||||
|
```
|
||||||
|
|
||||||
|
## Тестирование
|
||||||
|
|
||||||
|
### Схема аппаратного подключения
|
||||||
|
|
||||||
|
Для тестирования захвата видео и стабильности плагинов используется цепочка преобразования сигнала из аналогового в цифровой с последующим пробросом в виртуальную среду.
|
||||||
|
|
||||||
|
#### Цепочка передачи сигнала
|
||||||
|
|
||||||
|
1. **Источник:** **ps2**/**ps3** (+ **hdmi splitter** для расшифровки **hdcp**).
|
||||||
|
2. **Аналоговый вывод:** Проприетарный кабель **av multi out** → **component** (**YPbPr**).
|
||||||
|
3. **Конвертация:** Преобразователь **YPbPr** + → **HDMI**.
|
||||||
|
4. **Захват**: Карта видеозахвата **Fifine V3 RGB**.
|
||||||
|
5. **Хост**: Сервер под управлением **proxmox**.
|
||||||
|
|
||||||
|
## Скриншоты
|
||||||
|
|
||||||
|
|
||||||
|
*`novnc` — `obs-studio` запущен внутри **lxc** через `wayland` (`cage`)*
|
||||||
|
|
||||||
|
|
||||||
|
*лайв-стрим на твиче*
|
||||||
Reference in New Issue
Block a user