Remedierea expirărilor de înregistrare BigBlueButton FreeSWITCH SIP: Un ghid practic de diagnosticare

O întâlnire BigBlueButton se poate încărca normal, în timp ce participanții rămân blocați la conectarea la o sesiune audio. Administratorii pot vedea mesajele „SIP registration timeout” (expirare înregistrare SIP), „FreeSWITCH did not registered” (nu s-a înregistrat) sau o eroare de conexiune audio într-un jurnal sau într-un instrument de monitorizare. Aceste mesaje nu indică întotdeauna aceeași eroare. Într-o implementare BigBlueButton standard, o conexiune audio eșuată poate proveni dintr-un proces FreeSWITCH oprit, o conexiune SIP sau Event Socket blocată, o adresă greșită în spatele NAT sau un suport media WebRTC blocat. O expirare reală a înregistrării pentru un operator sau un gateway PBX este un caz separat.

Începeți prin a identifica componenta care expiră. Apoi verificați starea serviciului, listenerele locale, căile de rețea și adresele în această ordine. Evitați modificarea setărilor SIP sau deschiderea porturilor până când dovezile identifică calea afectată.

Mai întâi, identificați ce înseamnă „timeout de înregistrare”

Stiva audio actuală a BigBlueButton folosește bbb-webrtc-sfuserviciul pentru a coordona media cu FreeSWITCH. Documentația BigBlueButton descrie conectarea SFU la serviciul SIP al FreeSWITCH și la Event Socket Layer (ESL). Acest lucru este diferit de înregistrarea de către FreeSWITCH a unui gateway de ieșire către un furnizor SIP extern.

• Problemă de conexiune audio BigBlueButton: utilizatorii nu se pot conecta la conexiunea audio, FreeSWITCH este inaccesibil sau SFU raportează o expirare. Investigați FreeSWITCH, ESL, adresa SIP și portul configurate, NAT și transportul WebRTC.
• Problemă de înregistrare a gateway-ului extern: FreeSWITCH raportează un gateway configurat ca fiind nefuncțional sau neînregistrat. Investigați numele de gazdă, acreditările, transportul, calea firewall-ului și starea contului furnizorului.

Dacă nu sunteți sigur care caz se aplică, salvați textul complet al erorii și numele serviciului care a înregistrat-o. „Expirarea înregistrării” nu este suficientă pentru a justifica modificarea unui profil SIP.

1. Rulați verificarea configurației BigBlueButton

Pe server, rulează diagnosticarea recomandată de BigBlueButton:

sudo bbb-conf --check

Examinați toate rezultatele, în special secțiunea intitulată Potential problems. Aceasta verifică dacă procesele necesare rulează și raportează problemele comune de configurare. Un avertisment poate reflecta o personalizare intenționată, așadar comparați-l cu configurația dvs. în loc să aplicați automat fiecare corecție sugerată.

Apoi verificați starea serviciului:

sudo bbb-conf --status
sudo systemctl status freeswitch --no-pager
sudo systemctl status bbb-webrtc-sfu --no-pager

În versiunile mai vechi de BigBlueButton, numele serviciilor sau arhitectura componentelor pot diferi. Confirmați versiunea instalată cu sudo bbb-conf --versionși utilizați documentația pentru versiunea respectivă. Căile și exemplele de mai jos se referă în principal la documentația BigBlueButton 4.0, care este etichetată ca fiind în curs de dezvoltare.

2. Confirmați că FreeSWITCH rulează și acceptă conexiuni locale

Dacă freeswitch.serviceeste inactiv, a eșuat sau repornește în mod repetat, citiți jurnalul său înainte de a edita configurația:

sudo journalctl -u freeswitch.service -b --no-pager -n 100

Căutați erori de legare, erori de încărcare a modulelor, probleme de permisiuni sau erori ale bazei de date în apropierea celei mai recente porniri. Ghidul de depanare BigBlueButton documentează cazuri specifice în care FreeSWITCH nu se poate lega la IPv4 sau la portul ESL 8021. De asemenea, identifică o bază de date FreeSWITCH coruptă ca o posibilă cauză după o repornire, dar recomandă curățarea bazei de date numai atunci când sunt prezente erorile corespunzătoare ale bazei de date.

Verificați ce adrese și porturi ascultă:

sudo ss -luntp | grep -E ':(5060|5066|8021)\b'

Ascultătorul SIP exact depinde de versiunea și configurația BigBlueButton. Un ascultător lipsă sugerează că FreeSWITCH nu a reușit să pornească acel profil sau s-a legat la o altă adresă. Portul 8021 este interfața locală de control ESL într-o instalare tipică; în mod normal, ar trebui să rămână restricționat la localhost sau la o rețea privată de încredere. Nu îl expuneți la internetul public.

Dacă FreeSWITCH este activ, puteți inspecta starea profilului SIP cu ajutorul interfeței sale CLI. Comanda standard FreeSWITCH este sofia status; utilizați numele de profil afișate de serverul dvs., în loc să presupuneți că fiecare implementare folosește aceleași nume. Un profil marcat RUNNINGconfirmă că profilul a fost pornit, dar nu dovedește că browserele la distanță pot ajunge la calea media audio.

3. Potriviți eroarea cu calea de rețea defectă

Ghidul firewall-ului BigBlueButton distinge o eroare de semnalizare WebSocket de o eroare ICE/media. Această distincție restrânge căutarea:

• Eroare WebRTC 1002: browserul nu a putut stabili conexiunea WebSocket. Verificați dacă FreeSWITCH rulează, ruta SIP-over-WebSocket și configurația proxy-ului invers și orice reguli de firewall care afectează acea cale de semnalizare.
• Eroare WebRTC 1007: WebSocket-ul s-a conectat, dar browserul nu a putut stabili un mediu media folosind adresele candidate returnate. Verificați adresa IP anunțată și accesibilitatea UDP bidirecțională.

Pentru configurația implicită a firewall-ului BigBlueButton, ghidul oficial listează porturile UDP 16384–32768pentru media în timp real. Permiteți intervalul necesar atât în ​​grupul de securitate cloud sau în firewall-ul perimetral, cât și în firewall-ul gazdă. Păstrați regula limitată la server și la traficul necesar; deschiderea pe scară largă a porturilor SIP fără legătură nu înlocuiește configurația corectă NAT și WebRTC.

De exemplu, dacă utilizați UFW și ați confirmat că acest interval este potrivit pentru instalarea dvs., verificați regulile existente și adăugați intervalul media:

sudo ufw status numbered
sudo ufw allow 16384:32768/udp

Firewall-urile în cloud și grupurile de securitate ale furnizorilor trebuie, de asemenea, să permită traficul. O regulă la nivel de gazdă nu poate suprascrie un firewall blocat în amonte. Dacă doar utilizatorii dintr-o rețea restrictivă eșuează în timp ce alți utilizatori se conectează, investigați calea lor de rețea sau configurația TURN, în loc să reporniți în mod repetat FreeSWITCH.

4. Verificați NAT-ul și adresele IP anunțate

Un server din spatele NAT poate avea un listener local corect și totuși să anunțe o adresă privată inaccesibilă browserelor. Verificați dacă adresa IP externă, redirecționarea portului și configurația FreeSWITCH sunt conforme. Ghidul firewall-ului BigBlueButton 4.0 folosește /opt/freeswitch/conf/vars.xmlși /opt/freeswitch/conf/sip_profiles/external.xmlpentru exemplul său NAT și indică /etc/bigbluebutton/bbb-webrtc-sfu/production.ymlpentru suprascrierile SFU relevante.

Nu copiați un exemplu de IP și nu presupuneți că IP-ul public aparține fiecărui câmp. Într-o configurație NAT, adresa pe care FreeSWITCH o leagă local poate diferi de adresa publică pe care o anunță. Aplicați instrucțiunile specifice versiunii pentru topologia rețelei dvs., apoi verificați redirecționarea firewall-ului relevant. Dacă adresa externă a serverului s-a modificat recent, verificați DNS-ul și orice valori ale adresei menținute în configurația BigBlueButton.

Când un proces de server trebuie să ajungă la propriul nume de gazdă public, NAT-ul hairpin sau rezoluția locală a numelui de gazdă pot conta, de asemenea. Ghidul oficial al firewall-ului discută despre maparea numelui de gazdă public la adresa firewall-ului /etc/hostspentru acest scenariu. Testați această opțiune numai atunci când modelul de eroare indică o buclă inversă prin numele de gazdă extern; nu este o soluție universală pentru expirarea înregistrării.

5. Dacă jurnalul denumește un gateway SIP extern

Dacă elementul care defectă este un gateway de operator denumit și nu calea audio internă a BigBlueButton, verificați separat starea gateway-ului. FreeSWITCH documentează sofia status gateway <name>starea gateway-ului, sofia statusprofilul încărcat și starea gateway-ului. Verificați dacă numele de gazdă al furnizorului se rezolvă de pe server, dacă numele de utilizator SIP și parola configurate se potrivesc, dacă transportul și portul alese corespund cerințelor furnizorului și dacă regulile firewall-ului de ieșire permit traficul de semnalizare.

Nu resetați profilurile SIP incluse în pachetul BigBlueButton pentru a repara un cont de operator. Evitați partajarea publică a tuturor urmelor SIP: acestea pot conține numere de telefon, adrese IP, nume de conturi sau detalii legate de autentificare. Redactați valorile sensibile înainte de a solicita unui furnizor sau administrator să revizuiască jurnalele.

6. Aplicați o modificare specifică și reporniți o dată

După corectarea unei probleme confirmate legate de serviciu, adresă sau firewall, reporniți BigBlueButton folosind comanda sa acceptată:

sudo bbb-conf --restart

Utilizați sudo bbb-conf --cleannumai atunci când documentația specifică versiunii sau dovezile de diagnosticare o solicită. Nu este un răspuns generic la fiecare expirare SIP. De asemenea, evitați ștergerea fișierelor bazei de date FreeSWITCH, cu excepția cazului în care apar simptomele documentate de corupere a bazei de date; păstrați jurnalele și copiile de rezervă ale configurației înainte de orice reparație care elimină starea.

Verificați reparația

Executați sudo bbb-conf --checkdin nou și confirmați că FreeSWITCH și bbb-webrtc-sfusunt funcționale. Alăturați-vă unei întâlniri de testare dintr-un browser din afara rețelei serverului, selectați microfon sau audio doar pentru ascultare și confirmați că conexiunea se finalizează. Pentru modificările NAT sau firewall-ului, testați din cel puțin o rețea care a eșuat anterior. O stare verde a serviciului în sine nu este o dovadă că suporturile media UDP pot traversa rețeaua.

Dacă expirarea persistă, colectați versiunea BigBlueButton, textul complet al erorii, bbb-conf --checkieșirea relevantă, starea serviciului, intrările recente din jurnalul FreeSWITCH și SFU și topologia rețelei. Redactați secretele și datele publice ale utilizatorilor. Aceste dovezi ajută la distingerea unui ascultător mort, a unei expirari ESL, a unei adrese anunțate greșit, a unui interval media blocat și a unei erori reale de înregistrare a gateway-ului SIP.

Referințe oficiale

• Ghid de depanare BigBlueButton 4.0
• Configurarea firewall-ului BigBlueButton 4.0
• Referință comenzi CLI și API FreeSWITCH
• Profiluri SIP FreeSWITCH cu Sofia

Documentația a fost verificată pe 6 octombrie 2026. Documentația BigBlueButton 4.0 etichetează această versiune ca fiind în curs de dezvoltare; confirmați căile și comenzile pentru versiunea instalată pe serverul dvs.