Home A - Z
Page Index

An Otter Wiki

Jitsi-Meet

Jitsi Meet - аналог веб-конференций по типу Яндекс-Телемоста и Zoom, только с упором на self-hosted. Работает на WebRTC, позволяет шарить экранчик, собирать друзьяшек, имеет клиенты на мобилки и приложение на Electron. Можно чатиться, ставить реакции, а в рамках организации можно прикрутить LDAP, Etherpad и прочие штуки которые так любят в организациях. В рамках компании если необходимо организовать свой собственный сервер конференций - лучшее решение. Дискорд, конечно, не заменяет, имеются неудобства при шаринге окна и звуком, потому как звук с микрофона и звук с шары обьединен. Нужно ставить громкость в видео в 10% чтобы не перебивала речь и не оглушала собеседников.

Если хочется без особого пердолинга то лучше взять VDS, потому что если брать домашний сервер в котором все завернуто через реверс-прокси, нужно дополнительно пердолиться с тем чтобы открывать порты. Инсталляция в докере и прокинутый наружу через Nginx Proxy инстанс позволяет общаться тет-а-тет, но подключение третьего собеседника валит всю конференцию. Возможно проблема с STUN но мне было лениво разбираться

Самая копеечная виртуалка в timeweb позволяет держать до 10 пользователей одновременно (1 ядро/1 гб RAM)

Сам комплект ПО состоит из нескольких компонентов:

  • Jitsi Meet - по сути UI
  • Prosody - Внутренний XMPP сервер написаный на Lua. И да, говорят что другие XMPP-серверы использовать в данном комплекте нельзя, потому как очень много своей специфики
  • Jicofo - компонент XMPP который позволяет соединять клиентов
  • Jitsi Videobridge - внутренний маршрутизатор видео/аудио между участниками конференции. Этот компонент не занимается транскодингом видео
  • Jigasi - опциональный компонент для подключения SIP-телефонии. В конференцию можно позвать участника через SIP-телефонию. В данной инструкции не используется.
  • Jibri - опциональный компонент для записи видео. Звучит просто, но на деле внутри имеет в себе X11 Server, Chromium, Selenium, IceWM и еще кучу барахла. По сути имитирует участника конференции который находится с участниками в одной комнате и записывает экран, но не отображается в списке

Подготовка поддомена

Создаем A-запись в панели управления вашего регистратора домена

Record Type: A
Hostname: jitsi.domain.com
Public IP: IP-адрес сервера VDS
TTL: 1800

Установка на Debian 12

Для начала установим OpenJDK 11. Для этого подключаем доп репозиторий в /etc/apt/sources.list. Добавляем строчку:

deb http://deb.debian.org/debian unstable main non-free contrib

Далее обновляем репозиторий и ставим jdk:

sudo apt update
sudo apt install openjdk-11-jdk

Указываем hostname на VDS-сервере:

sudo hostnamectl set-hostname jitsi.domain.com

Устанавливаем пакеты curl, gnupg, ufw и lua5.2, потому как с коробки их нет в комплекте с базовой системой Debian

sudo apt install curl gnupg lua5.2 ufw

Добавим репозиторий Prosody

sudo curl -sL https://prosody.im/files/prosody-debian-packages.key -o /etc/apt/keyrings/prosody-debian-packages.key
echo "deb [signed-by=/etc/apt/keyrings/prosody-debian-packages.key] http://packages.prosody.im/debian $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/prosody-debian-packages.list

Добавим репозиторий Jitsi

curl -sL https://download.jitsi.org/jitsi-key.gpg.key | sudo sh -c 'gpg --dearmor > /usr/share/keyrings/jitsi-keyring.gpg'
echo "deb [signed-by=/usr/share/keyrings/jitsi-keyring.gpg] https://download.jitsi.org stable/" | sudo tee /etc/apt/sources.list.d/jitsi-stable.list

Обновляем репозиторий

sudo apt update

Указываем какие порты будут открыты с помощью UFW и включаем фаирволл

sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw allow 10000/udp
sudo ufw allow 22/tcp
sudo ufw allow 3478/udp
sudo ufw allow 5349/tcp
sudo ufw enable

Устанавливаем пакет jitsi-meet

sudo apt install jitsi-meet

При установке будет задан вопрос о домене и сертификате. Выбирайте Let's Encrypt Certificate. Далее вводим почту. Таким образом автоматически установится новый сертификат Далее можно заходить и пробовать создать комнату и звать друзей попробовать

Дополнительная настройка

Если используется сценарий когда сервер находится за NAT, или же есть проблема когда собеседники друг друга не слышат то нужно внести в фаил /etc/jitsi/videobridge/sip-communicator.properties дополнительно такие строчки:

org.ice4j.ice.harvest.NAT_HARVESTER_LOCAL_ADDRESS=<Local.IP.Address>
org.ice4j.ice.harvest.NAT_HARVESTER_PUBLIC_ADDRESS=<Public.IP.Address>

Включение авторизации

Необходимая вещь, когда сервер торчит в интернеты наружу. Позволяет только авторизованным юзерам создавать комнаты, при этом гостевой доступ уже в созданные комнаты остается без пароля. При этом создатель комнаты может дополнительно защитить паролем вход в комнату.

Открываем фаил /etc/prosody/conf.avail/jitsi.domain.com.cfg.lua и в поле VirtualHost с именем хоста меняем jitsi-anonymous на internal_hashed. Таким образом мы переключим анонимный вход на встроенный механизм аутентификации.

Теперь добавим возможность подключения гостям. После блока где мы переключили механизм аутентицикации добавляем следующее:

VirtualHost "guest.jitsi.domain.com"
   authentication = "anonymous"
   c2s_require_encryption = false

Важно уточнить что домен guest.jitsi.domain.com не нужно создавать в панели регистратора и прописывать A-запись и генерировать сертификат. Особенность работы конфигурации Jitsi Meet.

Теперь открываем /etc/jitsi/meet/jitsi.domain.com-config.js и блок hosts приводим к такому виду:

hosts: {
    // XMPP domain.
    domain: 'jitsi.domain.com',
    anonymousdomain: 'guest.jitsi.domain.com',

Последним моментом необходимо привести блок authentication в фаиле /etc/jitsi/jicofo/jicofo.conf к такому виду:

authentication: {
   enabled: true
   type: XMPP
   login-url: jitsi.domain.com
}

Перезапускаем сервисы:

sudo systemctl restart prosody jicofo jitsi-videobridge2

Для создания учетной записи воспользуемся командой:

sudo prosodyctl register LOGIN jitsi.domain.com PASSWORD

Zabbix мониторинг

Шаблон берем из зеркала здесь: https://git.y2z.ru/PublicMirrors/jitsi-videobridge-zabbix-template

Теперь для работы необходимо активировать REST API в модуле colibri

Исходя из предыдущей установки, правим файлы: Добавляем блок в /etc/jitsi/videobridge/jvb.conf

apis {
        rest {
            enabled = true
        }
    }

Добавляем в конце строчку в файле /etc/jitsi/videobridge/config

JVB_OPTS="--apis=rest,xmpp"

Приводим ниже перечисленные строчки к виду и добавляем если они отсутствуют в файле /etc/jitsi/videobridge/sip-communicator.properties

org.jitsi.videobridge.ENABLE_STATISTICS=true
org.jitsi.videobridge.STATISTICS_TRANSPORT=muc,colibri
org.jitsi.videobridge.STATISTICS_INTERVAL=5000

Рестартим все сервисы

sudo systemctl restart prosody jicofo jitsi-videobridge2

Проверяем работу API:

curl localhost:8080/colibri/stats | jq

Если появляется JSON-ответ то все работает. Просто подключаете плагин и все заработает без дополнительных настроек