Включение созвонов на своём сервере

Для кого: IT-администратор (сервер и межсетевой экран) и администраторы рабочей области (проверка и лимиты) · Время: около 10 минут

Обзор

Созвоны — это быстрые аудиозвонки в переписке. На своём сервере они работают через аудиосервер (LiveKit), который входит в комплект Digital Workspace и запускается рядом с ним. Звук не покидает вашу сеть, поминутной оплаты нет, и лимита организации тоже нет. Установщик включает созвоны сам.

Эта статья посвящена серверу. Кто может начинать созвоны, число участников, месячный лимит, уведомления и использование настраивают администраторы рабочей области: см. статью «Настройка созвонов (аудиозвонки в переписке)».

Перед началом

HTTPS включён (см. статью «Включение HTTPS»). Браузеры дают доступ к микрофону только на защищённом адресе (https).
Удалённым коллегам тоже нужен VPN или доступ извне, чтобы достучаться до этих портов (см. статью «Доступ из-за пределов вашей сети»).
Вы можете войти на сервер и изменить настройки межсетевого экрана компании или знаете, кто может.

Шаги для IT-администратора

Откройте два порта в межсетевом экране из сетей пользователей (офисы, VPN) к серверу: TCP 7881 и UDP 7882. По ним идёт звук. Подключение к звонку идёт через обычный веб-адрес (/livekit на портах 80/443), больше ничего открывать не нужно.
Проверьте, что аудиосервер включён. В папке установки выполните:
```
cd /opt/digital-workspace
sudo ./huddles.sh status
```
Должно быть указано Huddles: on · server IP … · ports TCP 7881, UDP 7882.
Если указано Huddles: off (например, сервер установлен до появления созвонов — после его обновления), включите:
```
sudo ./huddles.sh on
```
Если у сервера несколько сетевых адресов, укажите тот, который доступен с компьютеров пользователей: sudo ./huddles.sh on 10.0.0.15.

Пробный звонок (администратор рабочей области)

Два человека открывают Digital Workspace по обычному HTTPS-адресу (не через порт 3000) и открывают одну и ту же переписку в Сообщениях.
Один нажимает Созвон. Второй слышит вызов и нажимает Присоединиться.
Оба разрешают доступ к микрофону, когда браузер его запросит, и проверяют, что слышат друг друга.
Откройте Настройки рабочей области › Созвоны и задайте лимиты для своей организации.

Отключение созвонов

Для всего сервера: sudo ./huddles.sh off. Ключи остаются в .env, и sudo ./huddles.sh on использует их снова. Чтобы отключить созвоны только для одной организации, администратор рабочей области выключает их в Настройках рабочей области › Созвоны.

Нагрузка

Рекомендуемый сервер выдерживает несколько сотен человек в созвонах одновременно. Звук — около 50 кбит/с на человека.

Решение для вашей компании

Хотите LiveKit Cloud вместо встроенного аудиосервера? Укажите LIVEKIT_URL, LIVEKIT_API_KEY и LIVEKIT_API_SECRET в .env, добавьте вебхук https://<your address>/api/huddles/webhook в проекте LiveKit и перезапустите командой sudo docker compose up -d app. Нужен доступ в интернет из офисов, а LiveKit берёт оплату поминутно. При этом звук звонков покидает вашу сеть (см. статью «Какие данные покидают ваш сервер»).

Устранение неполадок

Симптом	Решение
Для микрофона в созвонах нужен защищённый адрес (https). Попросите администратора включить HTTPS.	Включите HTTPS, затем откройте приложение по адресу https://.
Для созвонов нужен аудиосервер на этой установке (Настройки рабочей области › Созвоны) или «Созвоны на этом сервере ещё не настроены.»	Выполните на сервере `sudo ./huddles.sh on`.
«Не удалось подключиться к созвону» или звонок соединяется, но никого не слышно	Порты TCP 7881 и UDP 7882 заблокированы между сетью пользователя и сервером. Откройте их в межсетевом экране (и в VPN). Если у сервера несколько адресов, выполните `sudo ./huddles.sh on <IP>` с адресом, доступным пользователям.
Созвоны не подключаются, если приложение открыто по адресу http://<IP сервера>:3000	Откройте Digital Workspace по обычному адресу. Порт 3000 обходит веб-прокси, через который идёт подключение к звонку.
Couldn't detect this server's IP address. (не удалось определить IP-адрес сервера)	Укажите адрес сами: `sudo ./huddles.sh on <IP>`.

← 12. Настройка единого входа (SSO) через Microsoft 365 14. Настройка созвонов (аудиозвонки в переписке) →

Эти статьи есть и в базе знаний на вашем сервере после обновления.

Нужна помощь? Пишите на info@digitalworkspace.app.