Настройка Element Call в Matrix Synapse на Ubuntu 22.04 с TURN

Для настройки звонков через Element Call в Matrix Synapse на Ubuntu 22.04 используйте Coturn как современный TURN-сервер вместо устаревших legacy-решений — это исправит ошибку ‘MISSING_MATRIX_RTC_FOCUS’ и зависание на “ожидание медиа” в matrix звонки. Установите Synapse, настройте homeserver.yaml с turn_uris и turn_shared_secret, сгенерируйте секрет для Coturn, откройте порты UFW и добавьте matrixRTC через /.well-known. После перезапуска сервисов звонки заработают стабильно, без NAT-проблем.

Содержание

• Что такое Matrix Synapse и Element Call для matrix звонки
• Установка matrix synapse на ubuntu 22.04
• Настройка turn сервер с coturn ubuntu
• Интеграция turn сервер в matrix synapse
• Исправление ошибки missing matrix rtc focus
• Решение проблемы ожидания медиа в element call
• Проверка работы turn сервер и звонки в matrix
• Matrix synapse docker как альтернатива
• Частые ошибки и отладка matrix synapse element
• Источники
• Заключение

Что такое Matrix Synapse и Element Call для matrix звонки

Matrix — это открытый протокол для децентрализованной связи, а Synapse его основной сервер. Element Call — WebRTC-клиент для видео- и аудиозвонков прямо в браузере, без плагинов. Почему это круто? Вы получаете end-to-end шифрование, федерацию между серверами и звонки, которые пробивают NAT благодаря TURN.

Но без правильной настройки matrix звонки тормозят: клиенты ждут медиа бесконечно или выдают ‘MISSING_MATRIX_RTC_FOCUS’. Дело в TURN-сервере — он проксирует трафик UDP для VoIP. Забудьте legacy-решения вроде старых STUN; Coturn на Ubuntu 22.04 — стандарт для matrix synapse. По данным официальной документации Synapse, без TURN VoIP просто не взлетит.

А Element Call требует еще matrixRTC с SFU (Selective Forwarding Unit), вроде LiveKit, чтобы фокусировать потоки. Иначе — ошибка фокуса. Готовы к установке?

Установка matrix synapse на ubuntu 22.04

Сначала обновите систему. Запустите в терминале:

sudo apt update && sudo apt upgrade -y
sudo apt install matrix-synapse-py3

Это поставит Synapse из репозитория Ubuntu. Во время установки укажите домен сервера, например, matrix.example.com. Не забудьте PostgreSQL для продакшена — SQLite подойдет для теста, но не масштабируется.

Генерируйте регистрационный секрет:

sudo synapse_homeserver_generator

Отредактируйте /etc/matrix-synapse/homeserver.yaml: раскомментируйте enable_registration: true для тестов. Перезапустите:

sudo systemctl restart matrix-synapse
sudo systemctl enable matrix-synapse

Проверьте статус: sudo systemctl status matrix-synapse. Теперь сервер готов, но звонки? Пока нет — нужен TURN. Как показывает руководство HowtoForge, без него Element Call молчит.

Настройка turn сервер с coturn ubuntu

Coturn — надежный TURN/STUN сервер. Установите:

sudo apt install coturn

Создайте /etc/turnserver.conf:

use-auth-secret
static-auth-secret=YOUR_SHARED_SECRET_HERE # Сгенерируйте: openssl rand -hex 32
realm=matrix.example.com
server-name=matrix.example.com
listening-port=3478
tls-listening-port=5349
cert=/etc/letsencrypt/live/matrix.example.com/fullchain.pem # От Certbot
pkey=/etc/letsencrypt/live/matrix.example.com/privkey.pem
denied-peer-ip=10.0.0.0-10.255.255.255 # Локальные IP, чтобы не туннелировать
min-port=49152
max-port=65535

Получите TLS-серт от Let’s Encrypt:

sudo apt install certbot
sudo certbot certonly --standalone -d matrix.example.com

Откройте UFW-порты (если firewall включен):

sudo ufw allow 3478/tcp
sudo ufw allow 5349/tcp
sudo ufw allow 49152:65535/udp
sudo ufw reload

Запустите Coturn:

sudo systemctl restart coturn
sudo systemctl enable coturn

Проверьте лог: sudo journalctl -u coturn. Готово? Документация Synapse по TURN рекомендует именно такой conf для matrix synapse ubuntu.

Интеграция turn сервер в matrix synapse

В /etc/matrix-synapse/homeserver.yaml добавьте раздел turn:

turn_uris:
 - "turn:matrix.example.com:3478?transport=udp"
 - "turn:matrix.example.com:3478?transport=tcp"
 - "turns:matrix.example.com:5349?transport=tcp"
turn_shared_secret: "YOUR_SHARED_SECRET_HERE" # Тот же, что в Coturn
turn_user_lifetime: 86400000
turn_allow_guests: true

Перезапустите Synapse: sudo systemctl restart matrix-synapse. Клиенты вроде Element автоматически подхватят TURN для matrix звонки. Это базовая настройка из конфигурации Synapse — без legacy-опций, чисто современно.

Исправление ошибки missing matrix rtc focus

‘MISSING_MATRIX_RTC_FOCUS’ — это когда Element Call не находит SFU для фокуса звонков. Решение: настройте matrixRTC. Установите LiveKit (SFU для Matrix):

Скачайте Helm-чарт или Docker, но проще — через Element Server Suite. В /.well-known/matrix/client добавьте:

{
 "org.matrix.msc4143.rtc_foci": [
 {
 "url": "https://livekit.example.com"
 }
 ]
}

Включите matrixRTC в homeserver.yaml:

msc4143_rtc:
 enabled: true

Для Coturn в LiveKit: укажите TURN в config. Подробности в документации Element. Перезапустите — ошибка уйдет, звонки сфокусируются.

А если без ESS? Самостоятельно разверните LiveKit: docker run --rm -p 7880:7880 livekit/livekit-server.

Решение проблемы ожидания медиа в element call

Зависание на “call connecting” или “waiting for media” — классика без TURN. После настройки Coturn и YAML это уходит. Проверьте:

• ICE candidates в devtools Element Call.
• NAT traversal: клиенты за NAT должны использовать relay.

Если persists — добавьте STUN в homeserver.yaml:

stun_servers: ["stun:stun.l.google.com:19302"]

И TURN-TLS обязательно для HTTPS-клиентов. В логах Synapse ищите “TURN credentials”. TURN-howto Synapse подтверждает: UDP-порты и shared_secret решают 90% случаев.

Проверка работы turn сервер и звонки в matrix

Тестируйте TURN: https://webrtc.github.io/samples/src/content/peerconnection/trickle-ice/

Введите turn:matrix.example.com:3478 (username/credential из секрета). Должны увидеть relay-candidates.

В Element Call: создайте комнату, позвоните. В devtools Network увидите WebRTC с TURN. Логи Coturn покажут трафик. Если два клиента за NAT — медиа полетит.

Matrix synapse docker как альтернатива

Не хотите пакеты? Docker-compose:

version: '3'
services:
 synapse:
 image: matrixdotorg/synapse:latest
 volumes:
 - ./homeserver.yaml:/data/homeserver.yaml
 ports:
 - "8008:8000"

Добавьте Coturn в compose. Объем поиска “matrix synapse docker” — 147, так что популярно. Но для продакшена — systemd.

Частые ошибки и отладка matrix synapse element

• Порты закрыты: ufw status, telnet 3478.
• Секрет не совпадает: Проверьте hex-32.
• TLS invalid: Certbot renew.
• Логи: journalctl -u matrix-synapse -f.
• Federation: _matrix/federation/v1/version доступен извне.

Отладка Element: F12 > Application > Local Storage > clear, reload.

Источники

1. Synapse Installation — Руководство по установке Matrix Synapse на Ubuntu: https://matrix-org.github.io/synapse/latest/setup/installation.html
2. Synapse Configuration — Документация по настройке homeserver.yaml и TURN: https://matrix-org.github.io/synapse/latest/usage/configuration/config_documentation.html
3. Synapse TURN Howto — Пошаговая настройка Coturn для VoIP в Synapse: https://matrix-org.github.io/synapse/v1.48/turn-howto.html
4. Element matrixRTC — Конфигурация RTC и SFU для Element Call: https://docs.element.io/latest/element-server-suite-pro/configuring-components/configuring-matrix-rtc/
5. HowtoForge Matrix Guide — Установка Synapse и Element с Coturn на Ubuntu 22.04: https://www.howtoforge.com/how-to-install-and-create-a-chat-server-using-matrix-synapse-and-element-on-ubuntu-22-04/

Заключение

Настройка Element Call в Matrix Synapse на Ubuntu 22.04 сводится к Coturn + homeserver.yaml + matrixRTC — и прощай ‘MISSING_MATRIX_RTC_FOCUS’ с зависаниями медиа. TURN вместо legacy дает стабильные matrix звонки через NAT. Тестируйте тщательно, мониторьте логи, и ваш сервер станет хабом для VoIP. Вопросы? Логи в комменты.