VideoGrace Server — ReadMe

# VideoGrace Server

VideoGrace Server — сервер связи, веб-клиента, WebRTC-медиа, диагностической телеметрии и сервисной шины CAN.

Актуальный основной сценарий — браузерный клиент по HTTPS/WSS и WebRTC. WSM остается fallback-путем для совместимости и аварийных случаев.

## Первый запуск

- Адрес панели управления: `https://localhost/` на сервере или `https://server.example.ru/` из сети.
- Порт управления по умолчанию: `443/tcp`.
- Первый зарегистрированный пользователь получает роль owner и дальше управляет пользователями и правами через админку.
- Windows: данные и логи по умолчанию находятся в `C:\ProgramData\IVS\VideoGrace\Server`, бинарники — в `C:\Program Files\VideoGraceServer`.
- Linux: установка и данные по умолчанию находятся в `/opt/VideoGrace/Server`.
- Основные базы: `main.db`, `history.db`, `storage.db`, `api.db` в настроенной папке `db`.

## Сеть и сертификаты

Обязательные порты

- `443/tcp` — HTTPS, Admin API, WebSocket control, web-client, PWA/service worker.
- `5060/udp` — legacy RTP/translator и совместимость.
- `43000-43999/udp` — WebRTC ICE/DTLS/SRTP, если диапазон не изменен в конфиге.

TLS

- Для браузеров нужен доверенный HTTPS-сертификат на домен сервера.
- Self-signed/PKI режим доступен через страницу `/pki/`, но браузеры и мобильные ОС требуют доверия к корневому сертификату.
- Для Web Push и PWA HTTPS обязателен.

## Медиа-транспорт

- WebRTC-first: браузеры подключаются к RTC endpoint, выбранному сервером, и получают медиа по WebRTC.
- WSM fallback: используется только если WebRTC недоступен или явно выбран fallback-путь.
- Кодеки: аудио Opus; видео browser path ориентирован на H.264/VP8 по возможностям клиента и RTC endpoint.
- Диагностика: в админке доступны WebRTC counters, stalled/ok media status, remote audio/video health и клиентские probes.

## CAN, сервисы и хранилище

- CAN — внутренняя сервисная шина для задач, диагностических событий и интеграций recorder/rtc-edge/AI.
- Recorder/Consolidator пока могут работать как legacy-процессы, но новые сценарии строятся вокруг CAN и сервисов.
- Object storage хранит вложения и blob-объекты через файловый backend и `storage.db`; большие объекты должны отдаваться потоково.
- Web Push настраивается через VAPID в разделе Push настроек сервера; поддерживаются browser endpoints FCM и Apple Web Push.

## Эксплуатация

- Проверяйте состояние на главном dashboard админки: uptime, WebRTC, storage, CAN, обновления сервера.
- Логи Windows: `C:\ProgramData\IVS\VideoGrace\Server\logs`; Linux: `/var/log/vgserver/VGServer.log`.
- Настройки Windows: реестр `HKLM\Software\IVS\VideoGrace-Server`; Linux: `/opt/VideoGrace/Server/vgserver.conf`.
- После изменения сетевых портов или TLS-сертификатов перезапустите сервис.
- Резервируйте настроенную папку `db` и объектное хранилище.

## Поддержка

Документация администратора: https://videograce.ru/doc/admin/

Дистрибутивы и обновления: https://videograce.ru/download

E-mail: contact@videograce.ru

Сайт: https://videograce.ru/