Richten Sie coturn für zuverlässige Matrix-Sprach- und Videoanrufe ein.

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 .

Einen Kommentar hinterlassen

Richten Sie einen benutzerdefinierten Matrix-Raumalias auf Ihrer eigenen Domain ein.

Weisen Sie einem Matrix-Raum mithilfe von Element oder der Matrix-API eine einfach zu teilende Adresse in Ihrer Domäne zu, inklusive Prüfungen auf Berechtigungen, Synapse-Namensgebung und Föderation.

Richten Sie coturn für zuverlässige Matrix-Sprach- und Videoanrufe ein.

Konfigurieren Sie coturn und Synapse mit übereinstimmenden TURN-Zugangsdaten, öffnen Sie die erforderlichen Relay-Ports und überprüfen Sie, ob Matrix-Clients Relay-Kandidaten erhalten können.

Matrix Synapse mit Docker Compose und PostgreSQL bereitstellen

Matrix Synapse mit Docker Compose und PostgreSQL bereitstellen

Richten Sie einen persistenten Synapse-Homeserver mit Docker Compose, PostgreSQL, einer privaten Konfiguration und Prüfungen ein, bevor Sie ihn über HTTPS zugänglich machen.

Design und Branding von Element Web anpassen

Legen Sie einen Markennamen, benutzerdefinierte Farben und Anmeldeinformationen für Ihre Element Web-Bereitstellung fest und behalten Sie dabei im Blick, welche Teile weiterhin unter der Marke Element vertrieben werden.

Synapses Systemd-Dateilimit ohne Rätselraten erhöhen

Synapses Systemd-Dateilimit ohne Rätselraten erhöhen

Prüfen Sie, ob Synapse die maximale Anzahl offener Dateien pro Prozess erreicht hat, richten Sie ein systemd-Drop-in für den richtigen Dienst oder Worker ein und überprüfen Sie das aktuelle Limit.

Element zeigt „Entschlüsselung fehlgeschlagen“ an? Stellen Sie den fehlenden Raumschlüssel wieder her.

Element zeigt „Entschlüsselung fehlgeschlagen“ an? Stellen Sie den fehlenden Raumschlüssel wieder her.

Finden Sie heraus, ob der Fehler auf einen bestimmten Browser oder ein bestimmtes Ereignis beschränkt ist, und verwenden Sie dann den Wiederherstellungsschlüssel von Element oder ein vertrauenswürdiges Gerät, ohne Ihre übrigen verschlüsselten Verlaufsdaten zu riskieren.

Alte Synapse-Nachrichten und Mediendateien bereinigen, ohne Daten zu verlieren

Verwenden Sie die Verlaufs- und Medienbereinigungs-APIs oder die Aufbewahrungseinstellungen von Synapse, um veraltete Daten sicher zu entfernen, und überprüfen Sie anschließend den Abschluss und die Wiederherstellung des Speicherplatzes.

Erstelle einen Matrix-Echo-Bot in Python mit Simple-Matrix-Bot-Lib

Erstelle einen Matrix-Echo-Bot in Python mit Simple-Matrix-Bot-Lib

Installieren Sie die aktuelle Bibliothek, verbinden Sie ein dediziertes Matrix-Konto und führen Sie einen kleinen !echo-Bot mit sichererer Anmeldeinformationsverwaltung und einem klaren Test aus.

Verbinde Matrix mit WhatsApp, Telegram und Discord über separate Brücken.

Verbinde Matrix mit WhatsApp, Telegram und Discord über separate Brücken.

Richten Sie drei Mauttrix-Bridges mit separaten Registrierungen, Logins und Tests ein – und vermeiden Sie Überraschungen bei Docker-Netzwerken, Kontorichtlinien und Synchronisierung.

Synapse Media-Speicherplatz freigeben, ohne freigegebene Dateien zu beschädigen

Ermitteln Sie, was den Synapse-Speicher belegt, legen Sie eine sichere Medienaufbewahrung fest und leeren Sie den Remote-Cache, ohne Dateien direkt von der Festplatte zu löschen.