Configura coturn per chiamate vocali e video Matrix affidabili.

Per le chiamate Matrix che non riescono quando i partecipanti si trovano su reti diverse, distribuisci coturn su un host con un IP pubblico, abilita le sue credenziali TURN REST a tempo limitato e configura Synapse con la stessa chiave segreta condivisa e gli URI TURN. Quindi, consenti al listener TURN e al relay UDP di attraversare ogni firewall. STUN può aiutare i client a scoprire i percorsi di rete, ma TURN è il relay che trasporta i contenuti multimediali quando non è possibile stabilire un percorso diretto.

Questa configurazione è adatta a un homeserver Synapse autogestito e a un host TURN separato basato su Debian o Ubuntu con un indirizzo IPv4 pubblico statico. L'esempio utilizza il listener predefinito di coturn sulla porta 3478 e l'intervallo di relay UDP predefinito 49152–65535. Sostituisci il dominio, il segreto e i percorsi dell'esempio con i tuoi. Se coturn si trova dietro un NAT, consulta la nota sul NAT riportata di seguito; un host pubblico direttamente raggiungibile è una soluzione più semplice e affidabile.

1. Puntare un hostname TURN al server

Crea un record DNS A che turn.example.compunti all'indirizzo IPv4 pubblico dell'host coturn. Utilizza un nome host dedicato in modo che le sue impostazioni di rete e del certificato possano essere gestite indipendentemente dal servizio web Matrix. Non pubblicare un record AAAA a meno che coturn non disponga di connettività IPv6 funzionante e delle relative regole del firewall; un indirizzo IPv6 irraggiungibile può indurre alcuni client a scegliere un percorso non valido.

La documentazione attuale di Synapse relativa a TURN afferma che il servizio TURN necessita di un endpoint IP pubblico. Il NAT può funzionare solo se il gateway dispone di un indirizzo pubblico e inoltra correttamente le porte richieste, e la documentazione avverte che le configurazioni NAT possono comunque risultare inaffidabili. Consultare la documentazione di configurazione di Synapse TURN .

2. Installare coturn e configurare il relay autenticato

Su Debian o Ubuntu, installa il pacchetto di distribuzione:

sudo apt update
sudo apt install coturn

Apri il file /etc/turnserver.confcon un editor e configura le impostazioni essenziali riportate di seguito. Genera una password segreta casuale e lunga utilizzando un gestore di password o un generatore crittograficamente sicuro. Inserisci poi esattamente quella password segreta in Synapse; non riutilizzare la password di un utente Matrix né esporre la password segreta in un repository pubblico.

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-secrete static-auth-secretabilitare il meccanismo di credenziali TURN REST che Synapse utilizza per rilasciare credenziali temporanee. realmdovrebbe essere un nome di dominio per il servizio TURN. L'intervallo di porte di inoltro è separato dal listener: i client contattano la porta 3478 per richiedere un'allocazione, quindi i media utilizzano le porte di inoltro allocate. La configurazione di esempio di coturn documenta le opzioni di listener, inoltro, TLS e IP esterno; le impostazioni predefinite e i percorsi del pacchetto di distribuzione possono essere diversi.

Abilita e avvia il servizio, quindi verificane lo stato:

sudo systemctl enable --now coturn
sudo systemctl status coturn

Se il tuo pacchetto ha un flag di abilitazione separato in /etc/default/coturn, segui le istruzioni di quel file prima di avviare il servizio. Controlla i log con sudo journalctl -u coturn -ese non si avvia.

3. Consentire il traffico di ascolto e inoltro

Consentire il traffico UDP e TCP in entrata sulla porta 3478, oltre al traffico UDP in entrata sulle porte 49152–65535, nel firewall dell'host e in qualsiasi firewall a livello di provider. Ad esempio, con UFW:

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

Mantieni il range di relay il più ristretto possibile in base alla tua implementazione e fai in modo min-portche max-portcorrisponda al range del firewall. Se abiliti un listener TLS, apri anche la porta configurata e utilizza le turns:impostazioni URI e certificato corrispondenti. Il TLS sulla connessione TURN è facoltativo per questo esempio di base; le istruzioni di Synapse indicano che i contenuti multimediali audio e video WebRTC rimangono crittografati anche quando TURN utilizza il suo listener UDP/TCP standard, mentre la sicurezza della segnalazione dipende dalla configurazione HTTPS di Matrix.

Per un host dietro NAT, configura il mapping di coturn external-ip=PUBLIC_IP/PRIVATE_IPe inoltra sia la porta 3478 che l'intero intervallo di relay all'host coturn senza modificare i numeri di porta del relay esterno. Ad esempio, una porta di relay pubblica 52000 deve raggiungere la porta interna 52000. Le linee guida di Synapse affermano che il NAT potrebbe comunque causare problemi; se non è possibile inoltrare un ampio intervallo UDP, posizionare coturn su un VPS con IP pubblico è solitamente una scelta più pratica.

4. Collega Synapse a coturn

Aggiungi le seguenti impostazioni al file di configurazione Synapse attivo, solitamente homeserver.yaml. Fai corrispondere hostname, porta e segreto alla configurazione di 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

Il valore di durata è espresso in millisecondi; questo esempio richiede a Synapse di rilasciare credenziali valide per 24 ore. Imposta l'accesso guest in base alla tua politica di registrazione; non è necessario semplicemente per abilitare le chiamate per gli utenti registrati. Mantieni turn_shared_secretprivato e identico a quello di coturn static-auth-secret. Non aggiungere un stun:URI come sostituto di TURN: i due protocolli svolgono ruoli correlati ma diversi.

Riavvia Synapse dopo aver convalidato la sintassi YAML:

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

Le distribuzioni dei container devono aggiornare la configurazione Synapse montata e riavviare il container Synapse. I client potrebbero dover ricaricare o aggiornare la configurazione del server; Synapse precisa inoltre che l'aggiornamento delle impostazioni TURN da parte dei client può richiedere fino a un'ora circa.

Verificare un candidato per la staffetta

Esegui il test da un browser o un dispositivo su una rete diversa da quella del server TURN, ad esempio un telefono che utilizza la connessione dati cellulare. In un client Matrix basato su browser, esamina la richiesta autenticata al server principale /_matrix/client/v3/voip/turnServer(i client meno recenti potrebbero utilizzare il /r0/percorso legacy). La risposta dovrebbe includere gli URI TURN e i campi temporanei per nome utente e password; la specifica Matrix definisce la risposta delle credenziali di questo endpoint.

Utilizza queste credenziali nel test ufficiale WebRTC Trickle ICE , inserisci un server come turn:turn.example.com:3478?transport=udpe seleziona il test di inoltro se la pagina offre il filtro per tipo di candidato. Un risultato positivo include un candidato il cui tipo è relay. Infine, effettua una chiamata Matrix tra dispositivi su reti separate. Una chiamata che squilla ma rimane su "connessione in corso" spesso indica porte di inoltro bloccate, una mappatura NAT errata o credenziali non corrispondenti; controlla i log di coturn e le note di risoluzione dei problemi di TURN di Synapse prima di modificare impostazioni di chiamata non correlate.

Per la diagnostica del browser, Synapse consiglia chrome://webrtc-internals/di utilizzare Chrome e about:webrtcFirefox. Se il relay candidato non viene visualizzato, verificare innanzitutto che il segreto corrisponda esattamente, quindi controllare la porta UDP 3478 e l'intero intervallo di relay sia nel firewall dell'host che in quello del provider. Il progetto coturn documenta le opzioni relative alla porta e all'indirizzo IP esterno nella sua documentazione di riferimento turnserver .

Lascia un commento

Configura coturn per chiamate vocali e video Matrix affidabili.

Configurare coturn e Synapse con le credenziali TURN corrispondenti, aprire le porte relay necessarie e verificare che i client Matrix possano ottenere i candidati relay.

Distribuisci Matrix Synapse con Docker Compose e PostgreSQL

Distribuisci Matrix Synapse con Docker Compose e PostgreSQL

Configura un server domestico Synapse persistente con Docker Compose, PostgreSQL, una configurazione privata ed effettua i controlli necessari prima di esporlo tramite HTTPS.

Personalizza il tema e l'immagine coordinata di Element Web

Imposta un nome personalizzato, colori e elementi di accesso per la tua implementazione di Element Web, tenendo presente quali parti rimangono a marchio Element.

Aumenta il limite di file di Systemd in Synapse senza dover fare supposizioni.

Aumenta il limite di file di Systemd in Synapse senza dover fare supposizioni.

Diagnostica se Synapse ha raggiunto il limite di file aperti per processo, imposta un comando systemd specifico per il servizio o il worker corretto e verifica il limite effettivo.

Element mostra "Decrittazione non riuscita"? Ripristina la chiave della stanza mancante

Element mostra "Decrittazione non riuscita"? Ripristina la chiave della stanza mancante

Scopri se l'errore è limitato a un singolo browser o a un singolo evento, quindi utilizza la chiave di ripristino di Element o un dispositivo attendibile senza rischiare di perdere la cronologia crittografata rimanente.

Elimina i vecchi messaggi e file multimediali di Synapse senza perdere dati.

Utilizza le API di Synapse per la cancellazione della cronologia e dei supporti di memorizzazione o le impostazioni di conservazione per rimuovere in modo sicuro i dati obsoleti, quindi verifica il completamento dell'operazione e il recupero dello spazio su disco.

Crea un bot di tipo Matrix Echo in Python con Simple-Matrix-Bot-Lib

Crea un bot di tipo Matrix Echo in Python con Simple-Matrix-Bot-Lib

Installa la libreria corrente, collega un account Matrix dedicato ed esegui un piccolo bot !echo con una gestione più sicura delle credenziali e un test chiaro.

Collega Matrix a WhatsApp, Telegram e Discord con bridge separati.

Collega Matrix a WhatsApp, Telegram e Discord con bridge separati.

Configura tre bridge Mautrix con registrazioni, accessi e test separati, ed evita sorprese legate alla rete Docker, alle policy degli account e alla sincronizzazione.

Recupera spazio su disco in Synapse Media senza compromettere i file condivisi.

Scopri cosa occupa spazio di archiviazione in Synapse, imposta la conservazione sicura dei file multimediali e svuota la cache remota senza eliminare i file direttamente dal disco.

Disattivare gli utenti Matrix inattivi senza eliminare la cronologia delle stanze

Disattivare gli utenti Matrix inattivi senza eliminare la cronologia delle stanze

Esamina l'attività del dispositivo, disattiva gli account Synapse inattivi confermati tramite l'API di amministrazione e scopri cosa rimuove effettivamente il flag di cancellazione opzionale.