Настройте Coturn для надежных голосовых и видеозвонков Matrix.

Для вызовов Matrix, которые не удается выполнить, если участники находятся в разных сетях, разверните coturn на хосте с публичным IP-адресом, включите его временные учетные данные TURN REST и настройте Synapse с тем же общим секретом и URI TURN. Затем разрешите доступ к диапазону прослушивателя TURN и UDP-ретранслятора через все брандмауэры. STUN может помочь клиентам обнаруживать сетевые пути, но TURN является ретранслятором, передающим медиаданные, когда прямой путь установить невозможно.

Данная конфигурация подходит для самостоятельно размещенного домашнего сервера Synapse и отдельного хоста Debian или Ubuntu TURN со статическим публичным IPv4-адресом. В примере используется слушатель по умолчанию coturn на порту 3478 и диапазон UDP-ретранслятора по умолчанию 49152–65535. Замените домен, секрет и пути в примере на свои собственные. Если coturn находится за NAT, см. примечание о NAT ниже; напрямую доступный публичный хост проще и надежнее.

1. Направьте имя хоста TURN на сервер.

Создайте запись DNS A, turn.example.comуказывающую на публичный IPv4-адрес хоста coturn. Используйте выделенное имя хоста, чтобы его сетевые и сертификатные настройки можно было управлять независимо от веб-сервиса Matrix. Не публикуйте запись AAAA, если у coturn нет работающего IPv6-подключения и соответствующих правил брандмауэра; недоступный IPv6-адрес может привести к тому, что некоторые клиенты выберут путь, который не сработает.

В текущей документации Synapse по TURN указано, что для работы сервиса TURN требуется публичный IP-адрес. NAT может работать только в том случае, если шлюз имеет публичный адрес и корректно перенаправляет необходимые порты, и в документации предупреждается, что настройка NAT всё ещё может быть ненадёжной. См. документацию по настройке Synapse TURN .

2. Установите coturn и настройте аутентифицированное реле.

В Debian или Ubuntu установите следующий дистрибутивный пакет:

sudo apt update
sudo apt install coturn

Откройте файл /etc/turnserver.confв текстовом редакторе и настройте основные параметры, указанные ниже. Сгенерируйте длинный случайный секрет с помощью менеджера паролей или криптографически защищенного генератора. Позже сохраните этот же секрет в Synapse; не используйте повторно пароль пользователя Matrix и не раскрывайте секрет в общедоступном репозитории.

listening-port=3478
fingerprint
use-auth-secret
static-auth-secret=REPLACE_WITH_A_LONG_RANDOM_SECRET
realm=turn.example.com
server-name=turn.example.com
min-port=49152
max-port=65535

use-auth-secretи static-auth-secretвключить механизм учетных данных TURN REST, который Synapse использует для выдачи временных учетных данных. realmдолжно быть доменным именем для вашей службы TURN. Диапазон портов ретрансляции отделен от диапазона портов прослушивателя: клиенты обращаются к порту 3478 для запроса выделения, затем медиа-сервер использует выделенные порты ретрансляции. В примере конфигурации coturn описаны параметры прослушивателя, ретрансляции, TLS и внешнего IP-адреса; значения по умолчанию и пути для дистрибутивных пакетов могут отличаться.

Включите и запустите службу, затем проверьте ее состояние:

sudo systemctl enable --now coturn
sudo systemctl status coturn

Если в вашем пакете есть отдельный флаг включения /etc/default/coturn, следуйте инструкциям в этом файле перед запуском службы. sudo journalctl -u coturn -eЕсли служба не запускается, проверьте журналы с помощью команды `npm install`.

3. Разрешить трафик слушателя и ретранслятора.

Разрешите входящие UDP и TCP-соединения на порту 3478, а также входящие UDP-порты 49152–65535 в брандмауэре хоста и любом брандмауэре провайдера. Например, с UFW:

sudo ufw allow 3478/udp
sudo ufw allow 3478/tcp
sudo ufw allow 49152:65535/udp
sudo ufw status

Ограничьте диапазон ретрансляции настолько, насколько позволяет ваша система развертывания, и настройте параметры TURN min-portв max-portсоответствии с диапазоном брандмауэра. Если вы включаете прослушиватель TLS, откройте также его настроенный порт и используйте соответствующие turns:URI и параметры сертификата. Использование TLS в соединении TURN в этом базовом примере необязательно; в инструкциях Synapse отмечается, что голосовые и видеоданные WebRTC остаются зашифрованными, даже если TURN использует свой обычный UDP/TCP-прослушиватель, в то время как безопасность сигнализации зависит от настроек HTTPS в Matrix.

Для хоста, находящегося за NAT, настройте external-ip=PUBLIC_IP/PRIVATE_IPсопоставление портов в Coturn и перенаправьте как порт 3478, так и весь диапазон ретрансляции на хост Coturn, не изменяя номера внешних портов ретрансляции. Например, публичный порт ретрансляции 52000 должен достигать внутреннего порта 52000. В рекомендациях Synapse говорится, что NAT всё ещё может вызывать проблемы; если вы не можете перенаправлять широкий диапазон UDP, размещение Coturn на VPS с публичным IP-адресом обычно является более практичным вариантом.

4. Соедините Synapse с coturn.

Добавьте следующие параметры в активный конфигурационный файл Synapse, обычно это файл homeserver.yaml.com. Сопоставьте имя хоста, порт и секрет с конфигурацией coturn:

turn_uris:
  - "turn:turn.example.com:3478?transport=udp"
  - "turn:turn.example.com:3478?transport=tcp"
turn_shared_secret: "REPLACE_WITH_A_LONG_RANDOM_SECRET"
turn_user_lifetime: 86400000
turn_allow_guests: false

Значение времени жизни указывается в миллисекундах; в этом примере Synapse запрашивает учетные данные, действительные в течение 24 часов. Настройте гостевой доступ в соответствии с вашей политикой регистрации; это не обязательно просто для разрешения вызовов для зарегистрированных пользователей. Сохраняйте turn_shared_secretконфиденциальность и идентичность протоколу coturn static-auth-secret. Не добавляйте stun:URI вместо TURN: эти два протокола выполняют схожие, но разные функции.

Перезапустите Synapse после проверки синтаксиса YAML:

sudo systemctl restart matrix-synapse.service
sudo systemctl status matrix-synapse.service

Для развертывания контейнеров необходимо обновить смонтированную конфигурацию Synapse и перезапустить контейнер Synapse. Клиентам может потребоваться перезагрузить или обновить конфигурацию сервера; Synapse отмечает, что обновление настроек TURN может занять у клиентов до часа.

Проверить кандидата на роль ретранслятора

Проведите тестирование в браузере или на устройстве, находящемся в другой сети, отличной от сети TURN-сервера, например, на телефоне, использующем сотовую связь. В браузерном клиенте Matrix проверьте аутентифицированный запрос к домашнему серверу /_matrix/client/v3/voip/turnServer(более старые клиенты могут использовать устаревший /r0/путь). Ответ должен содержать URI TURN и временные поля имени пользователя/пароля; спецификация Matrix определяет ответ с учетными данными для этой конечной точки.

Используйте эти учетные данные в официальном тесте WebRTC Trickle ICE , введите сервер, например turn:turn.example.com:3478?transport=udp, и выберите тестирование ретрансляции, если на странице доступна фильтрация по типу кандидата. Успешный результат включает кандидата, тип которого равен relay. Наконец, совершите вызов Matrix между устройствами в разных сетях. Вызов, который звонит, но остается в состоянии «подключение», часто указывает на заблокированные порты ретрансляции, неправильное сопоставление NAT или несовпадающие учетные данные; перед изменением не связанных с вызовом настроек проверьте журналы coturn и заметки по устранению неполадок TURN от Synapse.

Для диагностики браузера Synapse рекомендует chrome://webrtc-internals/использовать Chrome и Firefox. Если кандидат на ретрансляцию не отображается, сначала убедитесь, что секретный ключ точно совпадает, затем проверьте UDP 3478 и полный диапазон ретрансляции в брандмауэрах хоста и провайдера. В справочнике по turnserverabout:webrtc проект coturn описывает параметры порта и внешнего IP-адреса .

Оставить комментарий

Настройте собственный псевдоним для комнаты Matrix в своем домене.

Присвойте комнате Matrix легкодоступный адрес в вашем домене, используя Element или API Matrix, с проверкой прав доступа, именованием Synapse и федерацией.

Настройте Coturn для надежных голосовых и видеозвонков Matrix.

Настройте coturn и Synapse с использованием совпадающих учетных данных TURN, откройте необходимые порты ретрансляции и убедитесь, что клиенты Matrix могут получать кандидатов на ретрансляцию.

Развертывание Matrix Synapse с помощью Docker Compose и PostgreSQL

Развертывание Matrix Synapse с помощью Docker Compose и PostgreSQL

Перед тем как сделать его доступным по HTTPS, настройте постоянный домашний сервер Synapse с помощью Docker Compose, PostgreSQL, частной конфигурации и проверок.

Настройте тему и фирменный стиль Element Web.

Задайте фирменное название, пользовательские цвета и элементы авторизации для вашей веб-версии Element, при этом понимая, какие части останутся фирменными.

Увеличьте лимит файлов Systemd в Synapse без догадок.

Увеличьте лимит файлов Systemd в Synapse без догадок.

Проверьте, не превысил ли Synapse лимит на количество открытых файлов в одном процессе, установите параметр systemd для нужной службы или рабочего процесса и проверьте текущий лимит.

На экране отображается сообщение «Не удалось расшифровать»? Восстановите отсутствующий ключ от комнаты.

На экране отображается сообщение «Не удалось расшифровать»? Восстановите отсутствующий ключ от комнаты.

Выясните, ограничивается ли ошибка одним браузером или одним событием, затем используйте ключ восстановления Element или доверенное устройство, не рискуя при этом оставшейся зашифрованной историей.

Удалите старые сообщения и медиафайлы Synapse без потери данных.

Используйте API Synapse для очистки истории и мультимедиа или настройки хранения данных, чтобы безопасно удалить устаревшие данные, а затем проверьте завершение процесса и восстановление дискового пространства.

Создайте эхо-бота на основе матрицы на Python с помощью библиотеки Simple-Matrix-Bot-Lib.

Создайте эхо-бота на основе матрицы на Python с помощью библиотеки Simple-Matrix-Bot-Lib.

Установите текущую библиотеку, подключите выделенную учетную запись Matrix и запустите небольшой бот !echo с более безопасной обработкой учетных данных и понятным тестом.

Подключите Matrix к WhatsApp, Telegram и Discord с помощью отдельных мостов.

Подключите Matrix к WhatsApp, Telegram и Discord с помощью отдельных мостов.

Настройте три моста Mautrix с отдельными регистрациями, входами в систему и тестами — и избегайте неожиданностей, связанных с сетевыми настройками Docker, политиками учетных записей и синхронизацией.

Освободите место на диске Synapse Media, не нарушая работу общих файлов.

Узнайте, что заполняет хранилище Synapse, установите безопасное время хранения медиафайлов и очистите удаленный кэш, не удаляя файлы непосредственно с диска.