Перед установкой
- Подготовьте Linux-сервер и административный доступ, домен и DNS.
- Выберите оператора и контакт поддержки; определите правила регистрации и обработки данных.
- Подготовьте SMTP или разрешённый почтовый шлюз Sibrel. Подтверждение регистрации требует работающей почты.
- Выберите S3-совместимое хранилище: локальный MinIO или внешний бакет.
- Выберите локальный или отдельный LiveKit для звонков.
- Согласуйте требуемые порты с firewall сервера и провайдера.
Установка и готовность
Используйте мастер управления хостами в совместимой версии приложения/панели. Он запрашивает SSH-доступ, настройки почты, хранения и медиа. Разрешайте ему изменять только предназначенные для Sibrel машины.
После установки проверьте GET /api/host/readiness, регистрацию с письмом, загрузку и чтение файла, звонок между двумя внешними сетями и подключение бота. Успешный HTTP-ответ сам по себе не подтверждает качество звонков.
Прокси и Gateway
Reverse proxy должен передавать WebSocket Upgrade для /api/bots/gateway и клиентских сокетов. Не записывайте query-параметр token в access log. Обновляйте сертификаты автоматически и проверяйте сроки их действия.
Параметры портов LiveKit и TURN выбирайте по своей конфигурации. Раздельные S3 и медиаузлы должны быть доступны с нужных серверов и клиентских сетей.
Резервные копии и обновления
- Копируйте PostgreSQL, объектное хранилище, конфигурацию и ключи федерации в защищённое место.
- Задайте срок хранения и периодичность; регулярно проверяйте восстановление на отдельной машине.
- Перед обновлением сверяйте миграции и совместимость клиентов, делайте резервную копию.
- Обновление установленных мастером хостов может остановить приложение. Предупреждайте пользователей.
- Резервная копия БД при обновлении не означает автоматический откат БД при любой ошибке.
- Защищайте SSH, сервисные секреты и резервные копии от доступа посторонних.
Перенос сервисов и дополнительные узлы
Дополнительные S3-узлы распределяют новые загрузки, но не создают реплики старых файлов. Комнаты закрепляются за медиаузлами; удаление узла из конфигурации не переносит существующие комнаты.
При смене адресов и бакетов сохраните доступ к старым объектам. Перенос файлов, DNS и удаление старых машин выполняются отдельно. Не считайте диаграмму инфраструктуры доказательством успешной миграции.
Федерация и правила
Связывайте только известные хосты с проверенными ключами. Контролируйте совместимость версий, доступность маршрутов и обработку повторов. Ретрансляция не является гарантированной очередью и не улучшает медиа автоматически.
Оператор отвечает за свой хост и пользователей в пределах своих полномочий. Прочитайте правила создания и использования хостов и опубликуйте собственные сведения об обработке данных.
Регистрация и управление доступом
В админ-панели владелец хоста может закрыть публичную регистрацию и создать аккаунт вручную. Это настройка конкретного хоста. Перед обновлением сервера примените миграции, сохраните резервную копию базы и проверьте вход существующих пользователей.