Bedrud использует LiveKit для обработки видео- и аудиосвязи в реальном времени. LiveKit предоставляет медиасервер SFU (Selective Forwarding Unit), а Bedrud обеспечивает аутентификацию, управление комнатами и административное управление.

Встроенный или внешний режим

Bedrud поддерживает два режима развёртывания LiveKit:

1. Встроенный режим (по умолчанию): Бэкенд запускает и управляет процессом сервера LiveKit внутренне. Дополнительная инфраструктура не требуется - бэкенд управляет жизненным циклом процесса LiveKit.
2. Внешний режим: Bedrud подключается к отдельному серверу или кластеру LiveKit. Это полезно для горизонтального масштабирования или при использовании управляемого экземпляра LiveKit Cloud.

Настройка внешнего режима

Для использования внешнего сервера LiveKit установите следующие ключи в config.yaml:

livekit:
  host: "wss://livekit.example.com:7880"    # Client WebSocket URL (ws:// or wss://)
  internalHost: "https://livekit.example.com:7880"  # Server-to-server API URL
  apiKey: "your-api-key"
  apiSecret: "your-api-secret"
  external: true          # Skip embedded LiveKit startup
  skipTLSVerify: false    # Set true if LiveKit uses self-signed certs

Когда embedded равно false, Bedrud пропускает запуск встроенного бинарного файла LiveKit. API-ключ и секрет должны совпадать с учётными данными внешнего сервера.

Для настройки кластера LiveKit и конфигурации обратитесь к документации LiveKit.

Конфигурация Webhook (только для внешнего режима)

При использовании внешнего сервера LiveKit вы обязаны настроить webhook’и, чтобы LiveKit мог уведомлять Bedrud об отключениях участников и закрытии комнат. Без webhook’ов состояние базы данных устареет.

Конечная точка: https://<your-domain>/api/livekit/webhook

Аутентификация: Использует подпись JWT LiveKit — те же apiKey/apiSecret, которые вы настроили выше. Отдельный секрет не требуется.

LiveKit Cloud: Настройки → Webhooks → Создать новый webhook. Введите URL конечной точки и выберите ваш API-ключ.

Самостоятельно размещённый LiveKit: Добавьте в вашу YAML-конфигурацию LiveKit (например, livekit.yaml):

webhook:
  urls: ["https://bedrud.example.com/api/livekit/webhook"]
  api_key: "your-api-key"

Совместимость версий LiveKit

Встроенный режим LiveKit в Bedrud автоматически генерирует совместимую конфигурацию. Однако, если вы самостоятельно размещаете внешний сервер LiveKit, учитывайте критические изменения между версиями LiveKit:

• LiveKit v1.12+ удалил поле tls верхнего уровня из своей конфигурации. Если вы использовали tls: в вашем YAML LiveKit, удалите его. Настройте http:// для internalHost и ws:// для host в конфигурации Bedrud. TURN TLS по-прежнему поддерживается в разделе turn:.
• LiveKit v1.11 и более ранние версии поддерживают tls: на верхнем уровне. Используйте https:// для internalHost и wss:// для host.

В случае сомнений проверьте версию вашего сервера LiveKit с помощью livekit-server --version и обратитесь к примечаниям к выпуску LiveKit.

Генерация встроенной конфигурации (Embedded Config Generation)

Когда TLS включён во встроенном режиме, Bedrud создаёт временную YAML-конфигурацию LiveKit (/tmp/bedrud-livekit-*.yaml) с:

• TURN включён, domain автоматически установлен из server.host, udp_port: 3478, tls_port: 5349, сертификат TLS сервера используется повторно для TURN/TLS
• node_ip определяется через livekit.nodeIP → server.host → автоматическое определение исходящего IP
• bind_addresses опущено (LiveKit по умолчанию привязывается ко всем интерфейсам)

Временный файл удаляется при завершении процесса LiveKit. Чтобы обойти автоматическую генерацию статической конфигурацией, установите livekit.configPath или LIVEKIT_CONFIG_PATH.

Как это работает

1. Создание комнаты

Когда пользователь создаёт комнату в Bedrud, сервер не создаёт комнату LiveKit немедленно. Комнаты LiveKit создаются по требованию, когда присоединяется первый участник.

2. Токены присоединения

Когда пользователь присоединяется к встрече:

1. Фронтенд отправляет запрос на /api/room/join.

2. Бэкенд проверяет, что у пользователя есть право присоединиться к этой комнате.

3. Бэкенд использует свой API Key и Secret для генерации подписанного JWT (Join Token).

4. Токен содержит:

   • Имя комнаты.
   • Идентификацию пользователя (отображаемое имя).
   • Разрешения - например, может ли пользователь публиковать аудио или демонстрировать экран.

5. Фронтенд получает этот токен и подключается напрямую к медиапорту LiveKit (по умолчанию 7880).

3. Управление комнатой (администрирование)

Бэкенд использует LiveKit Go SDK для выполнения административных действий:

• Исключение: Отключает участника.
• Отключение микрофона: Принудительно отключает микрофон участника.
• Разрешения: Изменяет возможности участника в реальном времени.

Сетевая архитектура

• API-порт (8090/443): Обрабатывает HTTP-запросы и WebSocket-сигнализацию для настройки звонков.
• Медиапорт (7880): Обрабатывает видео- и аудиоданные с использованием протоколов WebRTC. Резервный ICE/TCP использует порт 7881, когда UDP заблокирован.
• TURN-порт (3478 UDP / 5349 TLS): Ретранслирует медиа для клиентов за строгими NAT или файрволами. См. Руководство по TURN-серверу.

Для требований к файрволу и портам см. Подключение WebRTC.

Troubleshooting

Startup & Config Crashes

Connectivity

Media & TURN

Webhook & State

Recording (Egress)

Bedrud uses LiveKit’s RoomCompositeEgress API to record rooms as MP4 files.

Prerequisites

• Redis — LiveKit egress requires Redis for coordinating egress workers. Without Redis, StartRoomCompositeEgress returns permission errors.

• Egress S3 storage (external mode only) — For external LiveKit, you must configure an egress: section in your LiveKit YAML so recordings are stored to durable S3-compatible storage. Otherwise the FileURL is a local path unreachable from Bedrud.

  egress:
    s3:
      access_key: "your-s3-access-key"
      secret_key: "your-s3-secret-key"
      endpoint: "http://minio:9000"
      bucket: "bedrud-recordings"
      region: "us-east-1"
      force_path_style: true

Troubleshooting: Recording

См. также

• Руководство по TURN-серверу - архитектура TURN, конфигурация, TLS и устранение неполадок
• Подключение WebRTC - полный стек подключения STUN/ICE/TURN/SFU
• Обзор архитектуры - полная системная архитектура