Configurați Coturn pentru apeluri vocale și video Matrix fiabile

Pentru apelurile Matrix care eșuează atunci când participanții se află în rețele diferite, implementați coturn pe o gazdă cu o adresă IP publică, activați acreditările sale TURN REST limitate în timp și configurați Synapse cu același secret partajat și aceleași URI-uri TURN. Apoi, permiteți ascultătorului TURN și intervalului de retransmisie UDP să treacă prin fiecare firewall. STUN poate ajuta clienții să descopere căile de rețea, dar TURN este retransmisiunea care transportă media atunci când nu se poate stabili o cale directă.

Această configurație se potrivește cu un server de acasă Synapse auto-găzduit și o gazdă Debian sau Ubuntu TURN separată cu o adresă IPv4 publică statică. Exemplul folosește listener-ul implicit al coturn pe portul 3478 și intervalul implicit de retransmisie UDP 49152–65535. Înlocuiți domeniul, secretul și căile din exemplu cu ale dvs. Dacă coturn se află în spatele NAT, consultați nota NAT de mai jos; o gazdă publică accesibilă direct este mai simplă și mai fiabilă.

1. Indicați un nume de gazdă TURN către server

Creați o înregistrare DNS A, cum ar fi turn.example.comcea care indică adresa IPv4 publică a gazdei coturn. Folosiți un nume de gazdă dedicat, astfel încât setările de rețea și certificat să poată fi gestionate independent de serviciul web Matrix. Nu publicați o înregistrare AAAA decât dacă coturn are o conectivitate IPv6 funcțională și regulile de firewall corespunzătoare; o adresă IPv6 inaccesibilă poate determina unii clienți să aleagă o cale care eșuează.

Documentația actuală TURN a Synapse precizează că serviciul TURN are nevoie de un punct final IP public. NAT poate funcționa numai atunci când gateway-ul are o adresă publică și redirecționează corect porturile necesare, iar documentația avertizează că configurațiile NAT pot fi totuși nesigure. Consultați documentația de configurare TURN a Synapse .

2. Instalați coturn și configurați releul autentificat

Pe Debian sau Ubuntu, instalați pachetul de distribuție:

sudo apt update
sudo apt install coturn

Deschideți /etc/turnserver.confcu un editor și configurați setările esențiale de mai jos. Generați un secret aleatoriu lung cu un manager de parole sau un generator criptografic securizat. Puneți exact acel secret în Synapse mai târziu; nu reutilizați o parolă de utilizator Matrix și nu expuneți secretul într-un depozit public.

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-secretși static-auth-secretactivați mecanismul de acreditare TURN REST pe care Synapse îl utilizează pentru a emite acreditări temporare. realmar trebui să fie un nume de domeniu pentru serviciul dvs. TURN. Intervalul de porturi de retransmitere este separat de listener: clienții contactează portul 3478 pentru a solicita o alocare, apoi mediul utilizează porturile de retransmitere alocate. Exemplul de configurare coturn documentează opțiunile de listener, retransmitere, TLS și IP extern; valorile implicite ale pachetului de distribuție și căile pot diferi.

Activați și porniți serviciul, apoi verificați starea acestuia:

sudo systemctl enable --now coturn
sudo systemctl status coturn

Dacă pachetul dvs. are un indicator de activare separat în /etc/default/coturn, urmați instrucțiunile fișierului respectiv înainte de a porni serviciul. Verificați jurnalele cu sudo journalctl -u coturn -edacă nu pornește.

3. Permite traficul de ascultare și de retransmitere

Permiteți UDP și TCP de intrare pe portul 3478, plus porturile UDP de intrare 49152–65535, în firewall-ul gazdă și în orice firewall la nivel de furnizor. De exemplu, cu UFW:

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

Păstrați intervalul de retransmisie cât mai restrâns pe care îl poate suporta implementarea dvs. și faceți co-turn-uri min-portși max-portpotriviți intervalul firewall-ului. Dacă activați un listener TLS, deschideți și portul configurat al acestuia și utilizați turns:setările URI și certificat corespunzătoare. TLS pe ​​conexiunea TURN este opțional pentru acest exemplu de bază; instrucțiunile Synapse menționează că media vocală și video WebRTC rămâne criptată chiar și atunci când TURN utilizează listener-ul său UDP/TCP simplu, în timp ce securitatea semnalizării depinde de configurația Matrix HTTPS.

Pentru o gazdă în spatele NAT, configurați maparea coturn external-ip=PUBLIC_IP/PRIVATE_IPși redirecționați atât portul 3478, cât și întregul interval de retransmisie către gazda coturn fără a modifica numerele porturilor de retransmisie externe. De exemplu, un port de retransmisie public 52000 trebuie să ajungă la portul intern 52000. Instrucțiunile Synapse spun că NAT poate cauza în continuare probleme; dacă nu puteți redirecționa un interval UDP larg, plasarea coturn pe un VPS cu IP public este de obicei o alegere mai practică.

4. Conectați Synapse la Coturn

Adăugați următoarele setări în fișierul de configurare Synapse activ, de obicei homeserver.yaml. Potriviți numele de gazdă, portul și secretul cu configurația 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

Valoarea pe durata de viață este în milisecunde; acest exemplu solicită Synapse să emită acreditări valabile timp de 24 de ore. Setați accesul pentru oaspeți conform politicii dvs. de înregistrare; nu este necesar doar pentru a activa apelurile pentru utilizatorii înregistrați. Păstrați turn_shared_secretprivat și identic cu cel al lui coturn static-auth-secret. Nu adăugați un stun:URI ca înlocuitor pentru TURN: cele două protocoale servesc roluri corelate, dar diferite.

Reporniți Synapse după validarea sintaxei YAML:

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

Implementările containerelor trebuie să actualizeze configurația Synapse montată și să repornească containerul Synapse. Clienții pot fi nevoiți să reîncarce sau să actualizeze configurația serverului; Synapse notează că actualizarea setărilor TURN poate dura până la aproximativ o oră pentru clienți.

Verificați un candidat la ștafetă

Testați dintr-un browser sau dispozitiv dintr-o rețea diferită de serverul TURN, cum ar fi un telefon care utilizează date celulare. Într-un client Matrix bazat pe browser, inspectați solicitarea serverului de domiciliu autentificat către /_matrix/client/v3/voip/turnServer(clienții mai vechi pot utiliza calea moștenită /r0/). Răspunsul ar trebui să includă URI-uri TURN și câmpuri temporare pentru nume de utilizator/parolă; specificația Matrix definește răspunsul de acreditare al acestui punct final.

Folosește aceste acreditări în testul oficial WebRTC Trickle ICE , introdu un server precum turn:turn.example.com:3478?transport=udpși selectează testarea releului dacă pagina oferă filtrare pentru tipuri de candidat. Un rezultat de succes include un candidat al cărui tip este relay. În cele din urmă, efectuează un apel Matrix între dispozitive din rețele separate. Un apel care sună, dar rămâne la „conectare” indică adesea porturi de releu blocate, o mapare NAT greșită sau acreditări nepotrivite; verifică jurnalele coturn și notele de depanare TURN ale Synapse înainte de a modifica setările apelurilor fără legătură.

Pentru diagnosticarea browserului, Synapse recomandă utilizarea chrome://webrtc-internals/în Chrome și about:webrtcFirefox. Dacă candidatul pentru retransmisie nu apare, confirmați mai întâi potrivirile exacte ale secretului, apoi verificați UDP 3478 și intervalul complet de retransmisii atât în ​​firewall-urile gazdă, cât și în cele ale furnizorului. Proiectul coturn documentează opțiunile de port și IP extern în referința sa turnserver .

Lasă un comentariu

Configurați un alias personalizat pentru camera matricei pe propriul domeniu

Oferă unei camere Matrix o adresă ușor de partajat pe domeniul tău folosind Element sau API-ul Matrix, cu verificări pentru permisiuni, denumire Synapse și federație.

Configurați Coturn pentru apeluri vocale și video Matrix fiabile

Configurați coturn și Synapse cu acreditări TURN corespunzătoare, deschideți porturile de retransmisie necesare și verificați dacă clienții Matrix pot obține candidați de retransmisie.

Implementați Matrix Synapse cu Docker Compose și PostgreSQL

Implementați Matrix Synapse cu Docker Compose și PostgreSQL

Configurați un server de acasă Synapse persistent cu Docker Compose, PostgreSQL, o configurație privată și verificări înainte de expunerea acestuia prin HTTPS.

Personalizați tema și brandingul Element Web

Setați un nume de marcă, culori personalizate și resurse de conectare pentru implementarea Element Web, înțelegând în același timp care părți rămân cu marca Element.

Creșteți limita de fișiere Systemd a Synapse fără a face presupuneri

Creșteți limita de fișiere Systemd a Synapse fără a face presupuneri

Diagnosticați dacă Synapse a atins limita de fișiere deschise per proces, setați un drop-in systemd pentru serviciul sau worker-ul corect și verificați limita de funcționare.

Elementul afișează „Decriptare eșuată”? Restaurați cheia camerei lipsă

Elementul afișează „Decriptare eșuată”? Restaurați cheia camerei lipsă

Află dacă eroarea este limitată la un singur browser sau la un singur eveniment, apoi folosește cheia de recuperare Element sau un dispozitiv de încredere fără a risca istoricul criptat rămas.

Curățați mesajele și fișierele media vechi din sinapse fără a pierde date

Folosește API-urile sau setările de retenție pentru istoric și epurare media ale Synapse pentru a elimina în siguranță datele învechite, apoi verifică finalizarea și recuperarea spațiului pe disc.

Construiți un bot Matrix Echo în Python cu Simple-Matrix-Bot-Lib

Construiți un bot Matrix Echo în Python cu Simple-Matrix-Bot-Lib

Instalați biblioteca curentă, conectați un cont Matrix dedicat și rulați un mic bot !echo cu o gestionare mai sigură a acreditărilor și un test clar.

Conectează Matrix la WhatsApp, Telegram și Discord cu Bridge-uri separate

Conectează Matrix la WhatsApp, Telegram și Discord cu Bridge-uri separate

Configurați trei punți Mautrix cu înregistrări, conectări și teste separate - și evitați surprizele legate de rețelele Docker, politicile de cont și sincronizare.

Recuperați spațiul de pe disc Synapse Media fără a deteriora fișierele partajate

Găsiți ce umple spațiul de stocare Synapse, setați retenția sigură a suporturilor media și goliți memoria cache la distanță fără a șterge fișierele direct de pe disc.