Skonfiguruj coturn, aby zapewnić niezawodne połączenia głosowe i wideo Matrix

W przypadku połączeń Matrix, które nie powiodą się, gdy uczestnicy znajdują się w różnych sieciach, należy wdrożyć coturn na hoście z publicznym adresem IP, włączyć jego ograniczone czasowo poświadczenia TURN REST i skonfigurować Synapse z tym samym wspólnym tajnym hasłem i identyfikatorami URI TURN. Następnie zezwolić na nasłuchiwanie TURN i zakres przekaźników UDP na każdej zaporze sieciowej. STUN może pomóc klientom w odnajdywaniu ścieżek sieciowych, ale TURN jest przekaźnikiem, który przesyła media, gdy nie można ustanowić bezpośredniej ścieżki.

Ta konfiguracja obejmuje samodzielnie hostowany serwer domowy Synapse oraz oddzielny host TURN z systemem Debian lub Ubuntu ze statycznym publicznym adresem IPv4. W przykładzie użyto domyślnego nasłuchiwacza coturn na porcie 3478 i domyślnego zakresu przekaźników UDP 49152–65535. Zastąp przykładową domenę, sekret i ścieżki własnymi. Jeśli coturn znajduje się za NAT-em, zapoznaj się z poniższą uwagą dotyczącą NAT-u; bezpośrednio dostępny host publiczny jest prostszy i bardziej niezawodny.

1. Wskaż nazwę hosta TURN na serwerze

Utwórz rekord DNS A, taki jak turn.example.comten, który wskazuje na publiczny adres IPv4 hosta coturn. Użyj dedykowanej nazwy hosta, aby móc zarządzać ustawieniami sieci i certyfikatów niezależnie od usługi sieciowej Matrix. Nie publikuj rekordu AAAA, chyba że coturn ma działającą łączność IPv6 i odpowiednie reguły zapory sieciowej; nieosiągalny adres IPv6 może spowodować, że niektórzy klienci wybiorą ścieżkę, która się nie powiedzie.

Aktualna dokumentacja TURN firmy Synapse podaje, że usługa TURN wymaga publicznego punktu końcowego IP. NAT może działać tylko wtedy, gdy brama ma adres publiczny i poprawnie przekierowuje wymagane porty. Dokumentacja ostrzega, że ​​konfiguracje NAT mogą być nadal zawodne. Zapoznaj się z dokumentacją konfiguracji TURN w Synapse .

2. Zainstaluj coturn i skonfiguruj uwierzytelniony przekaźnik

W systemie Debian lub Ubuntu zainstaluj pakiet dystrybucyjny:

sudo apt update
sudo apt install coturn

Otwórz /etc/turnserver.confedytor i skonfiguruj poniższe niezbędne ustawienia. Wygeneruj długi, losowy klucz tajny za pomocą menedżera haseł lub generatora kryptograficznie bezpiecznego. Umieść ten klucz tajny w Synapse później; nie używaj ponownie hasła użytkownika Matrix ani nie udostępniaj go w publicznym repozytorium.

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-secreti static-auth-secretwłącz mechanizm poświadczeń TURN REST, którego Synapse używa do wydawania tymczasowych poświadczeń. realmPowinna to być nazwa domeny dla usługi TURN. Zakres portów przekaźnikowych jest niezależny od odbiornika: klienci kontaktują się z portem 3478 w celu uzyskania alokacji, a następnie media korzystają z przydzielonych portów przekaźnikowych. Przykładowa konfiguracja coturn dokumentuje opcje odbiornika, przekaźnika, TLS i zewnętrznego adresu IP; domyślne ustawienia i ścieżki pakietów dystrybucyjnych mogą się różnić.

Włącz i uruchom usługę, a następnie sprawdź jej status:

sudo systemctl enable --now coturn
sudo systemctl status coturn

Jeśli Twój pakiet ma osobną flagę enable w pliku /etc/default/coturn, postępuj zgodnie z instrukcjami zawartymi w tym pliku przed uruchomieniem usługi. Sprawdź logi, sudo journalctl -u coturn -ejeśli usługa się nie uruchomi.

3. Zezwól na ruch nasłuchujący i przekazujący

Zezwól na przychodzące połączenia UDP i TCP na porcie 3478 oraz na przychodzące porty UDP 49152–65535 w zaporze hosta i dowolnej zaporze na poziomie dostawcy. Na przykład, z UFW:

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

Utrzymuj zakres przekaźników tak wąski, jak to możliwe w danym wdrożeniu, i dostosuj go min-portdo max-portzakresu zapory sieciowej. Jeśli włączysz nasłuchiwacz TLS, otwórz również jego skonfigurowany port i użyj pasujących turns:ustawień URI i certyfikatu. TLS w połączeniu TURN jest opcjonalny w tym podstawowym przykładzie; instrukcje Synapse wskazują, że multimedia głosowe i wideo WebRTC pozostają szyfrowane nawet wtedy, gdy TURN korzysta ze swojego zwykłego nasłuchiwacza UDP/TCP, a bezpieczeństwo sygnalizacji zależy od konfiguracji protokołu HTTPS w Matrix.

W przypadku hosta z NAT należy skonfigurować external-ip=PUBLIC_IP/PRIVATE_IPmapowanie coturn i przekierować zarówno port 3478, jak i cały zakres przekaźników do hosta coturn bez zmiany numerów zewnętrznych portów przekaźnikowych. Na przykład, publiczny port przekaźnikowy 52000 musi dotrzeć do wewnętrznego portu 52000. Wskazówki Synapse wskazują, że NAT nadal może powodować problemy; jeśli nie można przekierować szerokiego zakresu UDP, umieszczenie coturn na serwerze VPS z publicznym adresem IP jest zazwyczaj bardziej praktycznym rozwiązaniem.

4. Połącz Synapse z coturn

Dodaj następujące ustawienia do aktywnego pliku konfiguracyjnego Synapse, zazwyczaj homeserver.yaml. Dopasuj nazwę hosta, port i klucz tajny do konfiguracji 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

Wartość czasu życia jest podana w milisekundach; w tym przykładzie Synapse prosi o wydanie poświadczeń ważnych przez 24 godziny. Ustaw dostęp gościa zgodnie z polityką rejestracji; nie jest to wymagane, aby umożliwić połączenia zarejestrowanym użytkownikom. Zachowaj turn_shared_secretprywatność i identyczność z protokołem coturn static-auth-secret. Nie dodawaj stun:URI jako zamiennika dla TURN: oba protokoły pełnią podobne, ale różne role.

Uruchom ponownie Synapse po sprawdzeniu składni YAML:

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

Wdrożenia kontenerów wymagają aktualizacji zamontowanej konfiguracji Synapse i ponownego uruchomienia kontenera Synapse. Klienci mogą potrzebować przeładować lub odświeżyć konfigurację serwera; Synapse zauważa, że ​​odświeżenie ustawień TURN może również zająć klientom około godziny.

Zweryfikuj kandydata na przekaźnik

Przeprowadź test z przeglądarki lub urządzenia w innej sieci niż serwer TURN, na przykład telefonu z transmisją danych komórkowych. W kliencie Matrix opartym na przeglądarce sprawdź uwierzytelnione żądanie serwera domowego /_matrix/client/v3/voip/turnServer(starsze wersje klientów mogą korzystać ze starszej /r0/ścieżki). Odpowiedź powinna zawierać identyfikatory URI TURN oraz tymczasowe pola nazwy użytkownika i hasła; specyfikacja Matrix definiuje odpowiedź uwierzytelniającą tego punktu końcowego.

Użyj tych danych uwierzytelniających w oficjalnym teście WebRTC Trickle ICE , wprowadź serwer, taki jak turn:turn.example.com:3478?transport=udp, i wybierz testowanie przekaźnika, jeśli strona oferuje filtrowanie typu kandydata. Wynik pozytywny obejmuje kandydata, którego typ to relay. Na koniec wykonaj połączenie Matrix między urządzeniami w oddzielnych sieciach. Połączenie, które dzwoni, ale pozostaje w stanie „nawiązywania połączenia”, często wskazuje na zablokowane porty przekaźnikowe, nieprawidłowe mapowanie NAT lub niezgodne dane uwierzytelniające; sprawdź logi coturn i notatki dotyczące rozwiązywania problemów z TURN w Synapse przed zmianą niezwiązanych z tym ustawień połączenia.

Do diagnostyki przeglądarek Synapse zaleca korzystanie chrome://webrtc-internals/z Chrome i about:webrtcFirefox. Jeśli kandydat na przekaźnik nie pojawi się, najpierw należy potwierdzić dokładne dopasowanie hasła, a następnie zweryfikować protokół UDP 3478 i pełny zakres przekaźników w zaporach hosta i dostawcy. Projekt Coturn dokumentuje opcje portu i zewnętrznego adresu IP w dokumentacji Turnserver .

Zostaw komentarz

Skonfiguruj niestandardowy alias pokoju macierzy w swojej własnej domenie

Nadaj pokojowi Matrix łatwy do udostępniania adres w swojej domenie, korzystając z Element lub interfejsu API Matrix, ze sprawdzaniem uprawnień, nazewnictwem Synapse i federacją.

Skonfiguruj coturn, aby zapewnić niezawodne połączenia głosowe i wideo Matrix

Skonfiguruj coturn i Synapse przy użyciu zgodnych poświadczeń TURN, otwórz wymagane porty przekaźnikowe i sprawdź, czy klienci Matrix mogą uzyskać kandydatów na przekaźniki.

Wdrażanie Matrix Synapse z Docker Compose i PostgreSQL

Wdrażanie Matrix Synapse z Docker Compose i PostgreSQL

Skonfiguruj trwały serwer domowy Synapse z Docker Compose, PostgreSQL, prywatną konfiguracją i sprawdź, czy jest on udostępniany przez HTTPS.

Dostosuj motyw i branding Element Web

Ustaw nazwę marki, niestandardowe kolory i zasoby logowania dla wdrożenia Element Web, pamiętając jednocześnie, które części pozostaną markowe dla Element.

Podnieś limit plików Systemd w Synapse bez zgadywania

Podnieś limit plików Systemd w Synapse bez zgadywania

Sprawdź, czy Synapse osiągnął limit otwartych plików dla każdego procesu, ustaw drop-in systemd dla właściwej usługi lub pracownika i zweryfikuj limit aktywności.

Element wyświetla komunikat „Nie udało się odszyfrować”? Przywróć brakujący klucz do pokoju

Element wyświetla komunikat „Nie udało się odszyfrować”? Przywróć brakujący klucz do pokoju

Sprawdź, czy błąd dotyczy jednej przeglądarki lub jednego zdarzenia, a następnie użyj klucza odzyskiwania Element lub zaufanego urządzenia, nie ryzykując utraty zaszyfrowanej historii.

Oczyść stare wiadomości i media Synapse bez utraty danych

Użyj interfejsów API Synapse do czyszczenia historii i multimediów lub ustawień przechowywania, aby bezpiecznie usunąć nieaktualne dane, a następnie zweryfikuj ukończenie operacji i odzyskanie miejsca na dysku.

Zbuduj bota Matrix Echo w Pythonie za pomocą Simple-Matrix-Bot-Lib

Zbuduj bota Matrix Echo w Pythonie za pomocą Simple-Matrix-Bot-Lib

Zainstaluj aktualną bibliotekę, podłącz dedykowane konto Matrix i uruchom małego bota !echo z bezpieczniejszą obsługą poświadczeń i przejrzystym testem.

Połącz Matrix z WhatsApp, Telegramem i Discordem za pomocą oddzielnych mostów

Połącz Matrix z WhatsApp, Telegramem i Discordem za pomocą oddzielnych mostów

Skonfiguruj trzy mosty Mautrix z oddzielnymi rejestracjami, logowaniami i testami, aby uniknąć niespodzianek związanych z siecią Docker, polityką kont i synchronizacją.

Odzyskaj miejsce na dysku Synapse Media bez naruszania współdzielonych plików

Znajdź elementy zapełniające pamięć masową Synapse, ustaw bezpieczne przechowywanie multimediów i wyczyść zdalną pamięć podręczną bez konieczności usuwania plików bezpośrednio z dysku.