Stel coturn in voor betrouwbare Matrix-spraak- en videogesprekken.

Voor Matrix-gesprekken die mislukken wanneer deelnemers zich op verschillende netwerken bevinden, implementeer coturn op een host met een openbaar IP-adres, schakel de tijdelijke TURN REST-referenties in en configureer Synapse met hetzelfde gedeelde geheim en dezelfde TURN-URI's. Sta vervolgens het bereik van de TURN-listener en de UDP-relay toe door elke firewall. STUN kan clients helpen netwerkpaden te ontdekken, maar TURN is de relay die media transporteert wanneer een direct pad niet kan worden vastgesteld.

Deze configuratie is geschikt voor een zelfgehoste Synapse-homeserver en een aparte Debian- of Ubuntu-TURN-host met een statisch publiek IPv4-adres. Het voorbeeld gebruikt de standaardlistener van coturn op poort 3478 en het standaard UDP-relaybereik 49152–65535. Vervang het voorbeelddomein, geheim en paden door uw eigen gegevens. Als coturn zich achter NAT bevindt, raadpleeg dan de NAT-opmerking hieronder; een direct bereikbare publieke host is eenvoudiger en betrouwbaarder.

1. Wijs een TURN-hostnaam naar de server.

Maak een DNS A-record aan dat turn.example.comverwijst naar het openbare IPv4-adres van de coturn-host. Gebruik een aparte hostnaam zodat de netwerk- en certificaatinstellingen onafhankelijk van de Matrix-webservice kunnen worden beheerd. Publiceer geen AAAA-record tenzij coturn een werkende IPv6-verbinding en de bijbehorende firewallregels heeft; een onbereikbaar IPv6-adres kan ertoe leiden dat sommige clients een pad kiezen dat niet werkt.

Volgens de huidige TURN-documentatie van Synapse heeft de TURN-service een openbaar IP-adres nodig. NAT werkt alleen als de gateway een openbaar adres heeft en de vereiste poorten correct doorstuurt. De documentatie waarschuwt bovendien dat NAT-configuraties nog steeds onbetrouwbaar kunnen zijn. Zie de Synapse TURN-configuratiedocumentatie .

2. Installeer coturn en configureer geauthenticeerde relay

Installeer op Debian of Ubuntu het distributiepakket:

sudo apt update
sudo apt install coturn

Open het bestand /etc/turnserver.confmet een editor en configureer de essentiële instellingen hieronder. Genereer een lang, willekeurig geheim met een wachtwoordmanager of een cryptografisch veilige generator. Voer datzelfde geheim later in Synapse in; hergebruik geen Matrix-gebruikerswachtwoord en publiceer het geheim niet in een openbare 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-secreten static-auth-secretschakel het TURN REST-referentiemechanisme in dat Synapse gebruikt om tijdelijke referenties uit te geven. realmmoet een domeinnaam zijn voor uw TURN-service. Het relay-poortbereik is gescheiden van de listener: clients nemen contact op met poort 3478 om een ​​toewijzing aan te vragen, waarna media de toegewezen relay-poorten gebruikt. De voorbeeldconfiguratie van coturn beschrijft de opties voor listener, relay, TLS en extern IP-adres; de standaardinstellingen en paden van distributiepakketten kunnen afwijken.

Schakel de service in en start deze, en controleer vervolgens de status ervan:

sudo systemctl enable --now coturn
sudo systemctl status coturn

Als uw pakket een aparte inschakelvlag heeft in het bestand /etc/default/coturn, volg dan de instructies in dat bestand voordat u de service start. Controleer de logbestanden sudo journalctl -u coturn -eals de service niet start.

3. Luister- en doorstuurverkeer toestaan

Sta inkomend UDP- en TCP-verkeer toe op poort 3478, plus inkomende UDP-poorten 49152–65535, in de hostfirewall en eventuele firewalls op providerniveau. Bijvoorbeeld met UFW:

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

Houd het relaybereik zo klein mogelijk, afhankelijk van wat uw implementatie toelaat, en zorg ervoor dat het bereik van coturn min-portovereenkomt max-portmet het firewallbereik. Als u een TLS-listener inschakelt, open dan ook de geconfigureerde poort en gebruik de overeenkomende turns:URI- en certificaatinstellingen. TLS op de TURN-verbinding is optioneel voor dit basisvoorbeeld; de Synapse-instructies vermelden dat WebRTC-spraak- en videomedia versleuteld blijven, zelfs wanneer TURN de gewone UDP/TCP-listener gebruikt, terwijl de beveiliging van de signalering afhangt van uw Matrix HTTPS-configuratie.

Voor een host achter NAT moet u external-ip=PUBLIC_IP/PRIVATE_IPde mapping van coturn configureren en zowel poort 3478 als het volledige relay-bereik doorsturen naar de coturn-host zonder de externe relay-poortnummers te wijzigen. Een openbare relay-poort 52000 moet bijvoorbeeld interne poort 52000 kunnen bereiken. Volgens de richtlijnen van Synapse kan NAT nog steeds problemen veroorzaken; als u geen breed UDP-bereik kunt doorsturen, is het plaatsen van coturn op een VPS met een openbaar IP-adres meestal een meer praktische oplossing.

4. Verbind Synapse met coturn

Voeg de volgende instellingen toe aan het actieve Synapse-configuratiebestand, meestal homeserver.yaml. Zorg ervoor dat de hostnaam, poort en secret overeenkomen met de coturn-configuratie:

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

De geldigheidsduur wordt uitgedrukt in milliseconden; in dit voorbeeld wordt Synapse gevraagd om inloggegevens te verstrekken die 24 uur geldig zijn. Stel gasttoegang in volgens uw registratiebeleid; dit is niet nodig om alleen voor geregistreerde gebruikers te kunnen bellen. Houd de gegevens turn_shared_secretprivé en identiek aan die van coturn static-auth-secret. Voeg geen stun:URI toe als vervanging voor TURN: de twee protocollen vervullen verwante, maar verschillende functies.

Herstart Synapse na het valideren van de YAML-syntaxis:

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

Containerimplementaties moeten de gekoppelde Synapse-configuratie bijwerken en de Synapse-container opnieuw opstarten. Clients moeten mogelijk hun serverconfiguratie opnieuw laden of vernieuwen; Synapse merkt op dat het vernieuwen van TURN-instellingen door clients tot ongeveer een uur kan duren.

Een kandidaat voor een relais controleren

Test vanuit een browser of apparaat op een ander netwerk dan de TURN-server, bijvoorbeeld een telefoon die gebruikmaakt van mobiele data. Inspecteer in een browsergebaseerde Matrix-client het geauthenticeerde verzoek aan de homeserver /_matrix/client/v3/voip/turnServer(oudere clients gebruiken mogelijk het legacy- /r0/pad). Het antwoord moet TURN-URI's en tijdelijke gebruikersnaam-/wachtwoordvelden bevatten; de Matrix-specificatie definieert het antwoord met inloggegevens voor dit eindpunt.

Gebruik die inloggegevens in de officiële WebRTC Trickle ICE-test , voer een server in zoals turn:turn.example.com:3478?transport=udpen selecteer relay-testen als de pagina filteropties voor kandidaattypen biedt. Een succesvol resultaat bevat een kandidaat waarvan het type is relay. Plaats ten slotte een Matrix-gesprek tussen apparaten op verschillende netwerken. Een gesprek dat overgaat maar op 'verbinden' blijft staan, wijst vaak op geblokkeerde relaypoorten, een onjuiste NAT-mapping of niet-overeenkomende inloggegevens; controleer de coturn-logboeken en de TURN-probleemoplossingsnotities van Synapse voordat u instellingen wijzigt die niet relevant zijn voor een gesprek.

Voor browserdiagnostiek raadt Synapse chrome://webrtc-internals/Chrome en about:webrtcFirefox aan. Als de relay-kandidaat niet verschijnt, controleer dan eerst of het geheim exact overeenkomt en verifieer vervolgens UDP-poort 3478 en het volledige relay-bereik in zowel de host- als de providerfirewalls. Het coturn-project documenteert de poort- en externe-IP-opties in de turnserver-referentie .

Laat een reactie achter

Herstel Matrix Synapse veilig met een PostgreSQL-dump.

Maak een back-up van Synapse met pg_dump, bescherm de ondertekeningssleutel en de media, en herstel de back-up in een schone PostgreSQL-database zonder verouderde eenmalige sleutels opnieuw te gebruiken.

Mjölnir als Matrix Room Moderation Bot uitvoeren met Docker

Mjölnir als Matrix Room Moderation Bot uitvoeren met Docker

Configureer Mjölnir met een speciaal Matrix-account, een versleutelde beheerruimte, Docker Compose, een beleidslijst en toegangsrechtencontroles.

Schakel native Matrix Sliding Sync in voor sneller laden op mobiele apparaten.

Schakel native Matrix Sliding Sync in voor sneller laden op mobiele apparaten.

Sla de verouderde proxy over en configureer Synapse's ingebouwde Sliding Sync. Controleer de clientdetectie en meet vervolgens het laadgedrag van de kamerlijst en het herverbindingsgedrag op een compatibele telefoon.

Element Web hosten op Nginx met een aangepaste homeserver

Implementeer Element Web als een statische site, verwijs deze naar uw Matrix-homeserver, voeg HTTPS toe en configureer Nginx om updates te leveren zonder verouderde bestanden.

Een lichtgewicht Matrix-homeserver draaien op een Raspberry Pi 4

Configureer Conduit op een 64-bits Raspberry Pi 4 met permanente dataopslag, HTTPS-federatie, beveiligde registratie en controles voor een werkende thuisserver.

Stel een aangepaste Matrix-ruimtealias in op uw eigen domein.

Geef een Matrix-ruimte een eenvoudig te delen adres op uw domein met behulp van Element of de Matrix API, inclusief controles op machtigingen, Synapse-naamgeving en federatie.

Stel coturn in voor betrouwbare Matrix-spraak- en videogesprekken.

Configureer coturn en Synapse met overeenkomende TURN-gegevens, open de vereiste relaypoorten en controleer of Matrix-clients relaykandidaten kunnen verkrijgen.

Implementeer Matrix Synapse met Docker Compose en PostgreSQL.

Implementeer Matrix Synapse met Docker Compose en PostgreSQL.

Zet een permanente Synapse-homeserver op met Docker Compose, PostgreSQL, een privéconfiguratie en controles voordat je deze via HTTPS beschikbaar stelt.

Het thema en de huisstijl van Element Web aanpassen

Stel een merknaam, aangepaste kleuren en inloggegevens in voor uw Element Web-implementatie, en zorg ervoor dat u weet welke onderdelen het Element-merk behouden.

Verhoog de limiet voor systeembestanden in Synapse zonder te hoeven gissen.

Verhoog de limiet voor systeembestanden in Synapse zonder te hoeven gissen.

Stel vast of Synapse de limiet voor geopende bestanden per proces heeft bereikt, stel een systemd drop-in in voor de juiste service of worker en controleer de actuele limiet.