olcrtc-panel

Веб-панель для разворачивания и управления olcrtc на сервере.

Панель создаёт пользователей, генерирует Jitsi/WBStream профили, запускает серверные olcrtc srv инстансы, выдаёт olcrtc:// URI и subscription-ссылки для клиентов.

Установка одной командой

curl -fsSL https://raw.githubusercontent.com/lebrit/olcrtc-panel/main/scripts/install.sh | sudo bash -s -- install

Установщик сразу спросит домен и секретный путь панели. Если путь оставить пустым, будет создан случайный путь вида /p-...; /panel по умолчанию больше не используется.

После установки меню доступно командой:

olcrtc-panel

Показать текущий URL панели, секретный путь и admin token:

olcrtc-panel info

Что входит

• FastAPI backend, SQLite state, React/Vite frontend.
• Docker Compose deployment.
• Caddy для HTTPS и секретного пути панели.
• Интерактивный installer/menu на русском.
• Автогенерация Jitsi room URL.
• Проверка доступных Jitsi серверов из сети сервера.
• WBStream profile wizard с account token / готовым Room ID.
• Пользователи с вложенными профилями, URI, room copy и subscription token.
• Start/stop/rotate key/logs из панели.
• Удаление профилей и пользователей с явным typed-подтверждением.

Jitsi

По умолчанию используется jitsi + datachannel, стартовый сервер: https://fairmeeting.net.

Панель умеет параллельно проверять расширенный список известных серверов и выбирать первый сервер без явных token/JWT требований. В список входят, например:

• https://fairmeeting.net
• https://meet.ffmuc.net
• https://meet.in-berlin.de
• https://meet.systemli.org
• https://meet.opensuse.org
• https://jitsi.debian.social
• https://jitsi.hamburg.ccc.de
• https://freejitsi01.netcup.net
• https://meet.jit.si

Если сервер отдаёт 401/403, не отдаёт рабочий config.js, в config.js видны token/JWT настройки или XMPP stream features не рекламируют ANONYMOUS, панель помечает его как неподходящий для anonymous olcrtc и не выбирает автоматически. Это закрывает кейсы meet.jit.si, где XMPP может вернуть token required, и серверы с ошибкой server does not advertise anonymous XMPP login.

Результаты проверки со статусом не отвечает, config.js недоступен, token/JWT ошибкой или запретом anonymous XMPP заблокированы в UI для выбора одним кликом. Если olcrtc всё равно завершился с ошибкой, карточка профиля показывает не только код выхода, но и хвост последних строк лога.

WBStream

По умолчанию используется wbstream + vp8channel.

Автосоздание WBStream room обновлено под текущий API payload roomInfo. Guest-token сейчас получает ответ Guests are not allowed to create room, поэтому для автосоздания нужен account token с правом создания room. Если room уже известен, его можно вставить в поле Room ID и отключить автосоздание.

wbstream + datachannel не включается по умолчанию, потому что guest-flow обычно не имеет canPublishData=true.

Данные

На сервере:

• /opt/olcrtc-panel/.env - домен, путь, admin token.
• /opt/olcrtc-panel/data/panel.db - пользователи и профили.
• /opt/olcrtc-panel/data/logs - логи профилей.
• /opt/olcrtc-panel/data/backups - локальные backups.

Обслуживание

olcrtc-panel status
olcrtc-panel info
olcrtc-panel logs
olcrtc-panel update
olcrtc-panel backup
olcrtc-panel config
olcrtc-panel doctor
olcrtc-panel rescue-up

olcrtc-panel update также проверяет и чинит доступ к панели: пересобирает .env и Caddyfile под текущую схему Caddy -> 127.0.0.1:18080, сохраняет admin token, делает backup старых файлов и печатает актуальный URL.

Если managed checkout в /opt/olcrtc-panel содержит локально изменённые tracked-файлы и git pull не может продолжить, update сохраняет patch/status в data/backups/git-local-changes-*.patch и приводит checkout к origin/main. .env, Caddyfile, база, логи и backups не удаляются.

Update выполняется линейно: обновляет checkout, ставит wrapper, пересобирает .env/Caddyfile, затем запускает Docker Compose. Отдельная команда update-apply оставлена только для ручного аварийного применения уже обновлённого checkout.

olcrtc-panel info печатает URL/token до проверки Docker Compose, а docker compose ps ограничен timeout, чтобы команда не зависала молча. Для диагностики wrapper, .env, git checkout, Docker и Compose есть olcrtc-panel doctor.

olcrtc-panel rescue-up - аварийный запуск: обновляет checkout, переписывает wrapper, сохраняет текущие URL/token из .env, затем пересобирает и пересоздаёт контейнеры через Docker Compose.

Wrapper /usr/local/bin/olcrtc-panel устанавливается атомарно через временный файл и заменяет старый symlink, если он остался от ранней версии. Это защищает managed checkout от ситуации, когда запись wrapper-а случайно перезаписывает /opt/olcrtc-panel/scripts/install.sh.

Кнопка Sub в карточке профиля копирует ссылку только на этот профиль: /sub/<token>?profile_id=<id>. Общая подписка пользователя остаётся доступна через API /api/users/<id>/subscription и содержит все включённые профили пользователя.

Удаление разделено по scope:

olcrtc-panel uninstall        # остановить контейнеры, данные оставить
olcrtc-panel delete-runtime   # удалить runtime/volumes, базу оставить
olcrtc-panel delete-backups   # удалить локальные backups
olcrtc-panel purge            # полное удаление

Разработка

Backend:

python -m venv .venv
. .venv/bin/activate
pip install -r backend/requirements-dev.txt
PYTHONPATH=backend pytest backend/tests
python -m compileall -q backend/olcrtc_panel

Frontend:

cd frontend
npm ci
npm run lint
npm run build

Installer:

bash -n scripts/install.sh

Версии

Текущая версия: 0.1.14.

Каждое изменение, которое доходит до сборки, должно обновлять:

• VERSION
• frontend/package.json
• scripts/install.sh
• Git tag/release
• этот README при изменении поведения

Что улучшить дальше

• Проверить WBStream room auto-create на живом account token и зафиксировать права/поля API.
• Добавить managed olcrtc server через pkg/olcrtc/tunnel и AuthHook, чтобы отключать пользователей без отдельного room/key на профиль.
• Добавить real-provider e2e проверки Jitsi/WBStream прямо из панели.
• Добавить traffic accounting по профилям без парсинга логов.
• Добавить импорт существующих olcrtc:// и sub.md в панель.
• Добавить кэширование Docker build слоёв в CI, чтобы релизы собирались быстрее.
• Добавить matrix smoke-test установщика на чистых Debian/Ubuntu/Fedora образах.
• Добавить UI-проверку, что текущая панель действительно открыта только через секретный путь.
• Добавить real XMPP join-check для Jitsi, чтобы отсеивать серверы до старта профиля.
• Добавить отдельную кнопку repair-доступа в меню с проверкой HTTP-кода панели после перезапуска Caddy.
• Добавить авто-предложение пересоздать профиль на ближайшем рабочем Jitsi после ошибки запуска.
• Расширить olcrtc-panel doctor HTTP-проверкой публичного URL и локального backend /api/status.
• Добавить в installer проверку фактической версии контейнера после docker compose up, чтобы сразу ловить старый image/tag.
• Добавить full XMPP websocket join-check с временным room/nick, чтобы проверка полностью совпадала с olcrtc.
• Добавить отдельный repair-start без git-операций: только переписать .env/Caddyfile и поднять контейнеры.
• Добавить проверку, что PANEL_VERSION в .env не старее checkout версии, и автоматически чинить mismatch в doctor.
• Добавить mobile-client smoke-test импорта olcrtc:// и sub.md, чтобы сразу ловить несовпадение transport на телефоне.
• Добавить installer self-test wrapper-а: проверять, что /usr/local/bin/olcrtc-panel не symlink и не указывает на managed scripts/install.sh.
• Добавить non-TTY smoke-test установщика с занятыми портами 80/443, чтобы prompt-ветки не писали ошибки /dev/tty.
• Добавить проверку Jitsi + vp8channel на SSRC is already used и автоматически предлагать datachannel или другой Jitsi/WBStream.
• Добавить явную кнопку Sub все профили у пользователя, чтобы не путать её с профильной кнопкой Sub.