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 .