Bei Matrix-Anrufen, die fehlschlagen, wenn sich die Teilnehmer in unterschiedlichen Netzwerken befinden, installieren Sie coturn auf einem Host mit öffentlicher IP-Adresse, aktivieren Sie die zeitlich begrenzten TURN-REST-Zugangsdaten und konfigurieren Sie Synapse mit demselben gemeinsamen Geheimnis und denselben TURN-URIs. Erlauben Sie anschließend den Zugriff auf den TURN-Listener und den UDP-Relay-Bereich durch alle Firewalls. STUN kann Clients bei der Ermittlung von Netzwerkpfaden unterstützen, TURN dient jedoch als Relay für die Medienübertragung, wenn kein direkter Pfad hergestellt werden kann.
Diese Konfiguration eignet sich für einen selbst gehosteten Synapse-Homeserver und einen separaten Debian- oder Ubuntu-TURN-Host mit einer statischen öffentlichen IPv4-Adresse. Das Beispiel verwendet den Standard-Listener von coturn auf Port 3478 und den Standard-UDP-Relay-Bereich 49152–65535. Ersetzen Sie die Beispiel-Domain, das Secret und die Pfade durch Ihre eigenen. Falls sich coturn hinter einem NAT-Router befindet, beachten Sie den NAT-Hinweis weiter unten; ein direkt erreichbarer öffentlicher Host ist einfacher und zuverlässiger.
1. Weisen Sie dem Server einen TURN-Hostnamen zu.
Erstellen Sie einen DNS-A-Eintrag, der turn.example.comauf die öffentliche IPv4-Adresse des Coturn-Hosts verweist. Verwenden Sie einen dedizierten Hostnamen, damit dessen Netzwerk- und Zertifikatseinstellungen unabhängig vom Matrix-Webdienst verwaltet werden können. Veröffentlichen Sie keinen AAAA-Eintrag, solange Coturn nicht über eine funktionierende IPv6-Verbindung und die entsprechenden Firewall-Regeln verfügt; eine nicht erreichbare IPv6-Adresse kann dazu führen, dass Clients einen fehlerhaften Pfad wählen.
Die aktuelle TURN-Dokumentation von Synapse besagt, dass der TURN-Dienst einen öffentlichen IP-Endpunkt benötigt. NAT funktioniert nur, wenn das Gateway über eine öffentliche Adresse verfügt und die erforderlichen Ports korrekt weiterleitet. Die Dokumentation weist jedoch darauf hin, dass NAT-Konfigurationen dennoch unzuverlässig sein können. Siehe die Synapse-TURN-Einrichtungsdokumentation .
2. Installieren Sie coturn und konfigurieren Sie das authentifizierte Relay.
Unter Debian oder Ubuntu installieren Sie das Distributionspaket:
sudo apt update
sudo apt install coturn
Öffnen Sie die Datei /etc/turnserver.confmit einem Editor und konfigurieren Sie die unten aufgeführten wichtigen Einstellungen. Generieren Sie ein langes, zufälliges Geheimnis mit einem Passwortmanager oder einem kryptografisch sicheren Generator. Fügen Sie dieses Geheimnis später exakt in Synapse ein; verwenden Sie kein Matrix-Benutzerpasswort wieder und veröffentlichen Sie das Geheimnis nicht in einem öffentlichen Repository.
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-secretAktivieren Sie static-auth-secretden TURN-REST-Anmeldeinformationsmechanismus, den Synapse zur Ausstellung temporärer Anmeldeinformationen verwendet. realmsollte ein Domänenname für Ihren TURN-Dienst sein. Der Relay-Portbereich ist vom Listener getrennt: Clients kontaktieren Port 3478, um eine Zuweisung anzufordern; die Medien nutzen dann die zugewiesenen Relay-Ports. Die Beispielkonfiguration von coturn dokumentiert Listener-, Relay-, TLS- und externe IP-Optionen; Standardeinstellungen und Pfade der Distributionspakete können abweichen.
Aktivieren und starten Sie den Dienst und überprüfen Sie anschließend seinen Status:
sudo systemctl enable --now coturn
sudo systemctl status coturn
Falls Ihr Paket ein separates Aktivierungsflag in der Datei `.enable` besitzt /etc/default/coturn, befolgen Sie die Anweisungen in dieser Datei, bevor Sie den Dienst starten. Überprüfen Sie die Protokolle mit dem Befehl `log`, sudo journalctl -u coturn -efalls der Dienst nicht startet.
3. Zuhörenden und Weiterleiten von Datenverkehr zulassen.
Erlauben Sie eingehenden UDP- und TCP-Verkehr auf Port 3478 sowie eingehende UDP-Ports 49152–65535 in der Host-Firewall und in allen Provider-Firewalls. Beispiel mit UFW:
sudo ufw allow 3478/udp
sudo ufw allow 3478/tcp
sudo ufw allow 49152:65535/udp
sudo ufw status
Halten Sie die Reichweite des Relays so gering wie möglich, und stellen Sie sicher, dass die Reichweite von coturn min-portmit max-portder Firewall-Reichweite übereinstimmt. Wenn Sie einen TLS-Listener aktivieren, öffnen Sie auch dessen konfigurierten Port und verwenden Sie die entsprechenden turns:URI- und Zertifikatseinstellungen. TLS für die TURN-Verbindung ist in diesem einfachen Beispiel optional. Die Synapse-Anleitung weist darauf hin, dass WebRTC-Sprach- und Videodaten auch dann verschlüsselt bleiben, wenn TURN seinen unverschlüsselten UDP/TCP-Listener verwendet, während die Signalisierungssicherheit von Ihrer Matrix-HTTPS-Konfiguration abhängt.
Bei einem Host hinter NAT konfigurieren Sie external-ip=PUBLIC_IP/PRIVATE_IPdas Mapping von coturn und leiten sowohl Port 3478 als auch den gesamten Relay-Bereich an den coturn-Host weiter, ohne die externen Relay-Portnummern zu ändern. Beispielsweise muss ein öffentlicher Relay-Port 52000 den internen Port 52000 erreichen. Laut Synapse-Anleitung kann NAT weiterhin Probleme verursachen. Wenn Sie keinen großen UDP-Bereich weiterleiten können, ist die Installation von coturn auf einem VPS mit öffentlicher IP-Adresse in der Regel die praktikablere Lösung.
4. Verbinden Sie Synapse mit coturn.
Fügen Sie die folgenden Einstellungen zur aktiven Synapse-Konfigurationsdatei hinzu (normalerweise homeserver.yaml). Passen Sie Hostname, Port und Secret an die coturn-Konfiguration an:
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
Die Gültigkeitsdauer wird in Millisekunden angegeben; in diesem Beispiel wird Synapse angewiesen, 24 Stunden gültige Anmeldeinformationen auszustellen. Legen Sie den Gastzugriff gemäß Ihrer Registrierungsrichtlinie fest; er ist nicht erforderlich, um Anrufe für registrierte Benutzer zu ermöglichen. Halten Sie die Einstellungen turn_shared_secretprivat und identisch zu denen von coturn static-auth-secret. Fügen Sie keine stun:URI als Ersatz für TURN hinzu: Die beiden Protokolle erfüllen verwandte, aber unterschiedliche Funktionen.
Starten Sie Synapse nach der Überprüfung der YAML-Syntax neu:
sudo systemctl restart matrix-synapse.service
sudo systemctl status matrix-synapse.service
Bei Container-Bereitstellungen muss die eingebundene Synapse-Konfiguration aktualisiert und der Synapse-Container neu gestartet werden. Clients müssen möglicherweise ihre Serverkonfiguration neu laden oder aktualisieren; Synapse weist darauf hin, dass die Aktualisierung der TURN-Einstellungen bis zu einer Stunde dauern kann.
Überprüfen Sie einen Relaiskandidaten
Testen Sie die Verbindung von einem Browser oder Gerät in einem anderen Netzwerk als dem TURN-Server, z. B. von einem Smartphone mit Mobilfunkdaten. Untersuchen Sie in einem browserbasierten Matrix-Client die authentifizierte Homeserver-Anfrage /_matrix/client/v3/voip/turnServer(ältere Clients verwenden möglicherweise den Legacy- /r0/Pfad). Die Antwort sollte TURN-URIs und temporäre Felder für Benutzername und Passwort enthalten; die Matrix-Spezifikation definiert die Antwort für die Anmeldeinformationen dieses Endpunkts.
Verwenden Sie diese Anmeldeinformationen im offiziellen WebRTC Trickle ICE-Test , geben Sie einen Server wie z. B. ein turn:turn.example.com:3478?transport=udpund wählen Sie Relay-Testing, falls die Seite eine Filterung nach Kandidatentyp anbietet. Ein erfolgreiches Ergebnis beinhaltet einen Kandidaten vom Typ „“ relay. Stellen Sie anschließend einen Matrix-Anruf zwischen Geräten in unterschiedlichen Netzwerken her. Ein Anruf, der klingelt, aber im Status „Verbinden“ verbleibt, deutet häufig auf blockierte Relay-Ports, eine fehlerhafte NAT-Zuordnung oder nicht übereinstimmende Anmeldeinformationen hin. Überprüfen Sie die coturn-Protokolle und die Hinweise zur TURN-Fehlerbehebung in Synapse, bevor Sie Änderungen an anderen Anrufeinstellungen vornehmen.
Für die Browserdiagnose empfiehlt Synapse die Verwendung chrome://webrtc-internals/von Chrome und about:webrtcFirefox. Falls der Relay-Kandidat nicht angezeigt wird, überprüfen Sie zunächst, ob das Geheimnis exakt übereinstimmt, und anschließend UDP 3478 sowie den gesamten Relay-Bereich in den Firewalls des Hosts und des Providers. Die Port- und externen IP-Optionen sind in der Turnserver-Referenz des Coturn-Projekts dokumentiert .