Una riunione BigBlueButton può caricarsi normalmente, ma i partecipanti potrebbero rimanere bloccati durante la connessione audio. Gli amministratori potrebbero visualizzare messaggi come "Timeout di registrazione SIP", "FreeSWITCH non si è registrato" o un errore di connessione audio in un registro o in uno strumento di monitoraggio. Questi messaggi non indicano sempre lo stesso problema. In una distribuzione standard di BigBlueButton, un errore di connessione audio può derivare da un processo FreeSWITCH arrestato, una connessione SIP o Event Socket bloccata, un indirizzo errato dietro NAT o un blocco dei media WebRTC. Un timeout di registrazione effettivo per un operatore o un gateway PBX è un caso a parte.
Inizia identificando il componente che va in timeout. Quindi controlla lo stato del servizio, i listener locali, i percorsi di rete e gli indirizzi, in quest'ordine. Evita di modificare le impostazioni SIP o di aprire le porte finché non avrai individuato il percorso interessato.
L'attuale stack audio di BigBlueButton utilizza il bbb-webrtc-sfuservizio per coordinare i contenuti multimediali con FreeSWITCH. La documentazione di BigBlueButton descrive la connessione dell'SFU al servizio SIP e all'Event Socket Layer (ESL) di FreeSWITCH. Questo è diverso dalla registrazione da parte di FreeSWITCH di un gateway in uscita verso un provider SIP esterno.
Se non sei sicuro di quale caso si applichi, salva il testo completo dell'errore e il nome del servizio che lo ha registrato. Il solo messaggio "Timeout di registrazione" non è sufficiente a giustificare la modifica di un profilo SIP.
Sul server, esegui la diagnostica consigliata da BigBlueButton:
sudo bbb-conf --checkEsamina tutto l'output, in particolare la sezione intitolata Potential problems. Questa sezione verifica se i processi richiesti sono in esecuzione e segnala i problemi di configurazione più comuni. Un avviso potrebbe riflettere una personalizzazione intenzionale, quindi confrontalo con la tua configurazione anziché applicare automaticamente ogni soluzione suggerita.
Successivamente, verifica lo stato del servizio:
sudo bbb-conf --status
sudo systemctl status freeswitch --no-pager
sudo systemctl status bbb-webrtc-sfu --no-pagerNelle versioni precedenti di BigBlueButton, i nomi dei servizi o l'architettura dei componenti potrebbero differire. Verifica la versione installata sudo bbb-conf --versione consulta la documentazione relativa a tale versione. I percorsi e gli esempi riportati di seguito si riferiscono principalmente alla documentazione di BigBlueButton 4.0, attualmente in fase di sviluppo.
Se freeswitch.serviceè inattivo, ha riscontrato un errore o si riavvia ripetutamente, leggere il suo registro prima di modificare la configurazione:
sudo journalctl -u freeswitch.service -b --no-pager -n 100Verifica la presenza di errori di associazione, errori di caricamento dei moduli, problemi di autorizzazione o errori del database in prossimità dell'ultimo avvio. La guida alla risoluzione dei problemi di BigBlueButton documenta casi specifici in cui FreeSWITCH non riesce ad associarsi a IPv4 o alla porta ESL 8021. Identifica inoltre un database FreeSWITCH danneggiato come possibile causa dopo un riavvio, ma raccomanda la pulizia del database solo in presenza dei corrispondenti errori del database.
Verifica quali indirizzi e porte sono in ascolto:
sudo ss -luntp | grep -E ':(5060|5066|8021)\b'Il listener SIP esatto dipende dalla versione e dalla configurazione di BigBlueButton. Un listener mancante suggerisce che FreeSWITCH non è riuscito ad avviare quel profilo o che è associato a un indirizzo diverso. La porta 8021 è l'interfaccia di controllo ESL locale in una tipica installazione preconfigurata; normalmente dovrebbe rimanere limitata a localhost o a una rete privata fidata. Non esporla a Internet pubblico.
Se FreeSWITCH è attivo, è possibile controllare lo stato del profilo SIP tramite la sua interfaccia a riga di comando (CLI). Il comando standard di FreeSWITCH è sofia status; utilizzare i nomi dei profili visualizzati dal server anziché presumere che ogni implementazione utilizzi gli stessi. Un profilo contrassegnato come attivo RUNNINGconferma l'avvio del profilo, ma non dimostra che i browser remoti possano raggiungere il percorso dei file audio.
La guida al firewall di BigBlueButton distingue un errore di segnalazione WebSocket da un errore ICE/media. Questa distinzione restringe la ricerca:
Per la configurazione predefinita del firewall di BigBlueButton, la guida ufficiale elenca le porte UDP 16384–32768per i contenuti multimediali in tempo reale. Consenti l'intervallo richiesto sia nel gruppo di sicurezza cloud o firewall perimetrale che nel firewall dell'host. Mantieni la regola limitata al server e al traffico necessario; aprire indiscriminatamente porte SIP non correlate non sostituisce una corretta configurazione NAT e WebRTC.
Ad esempio, se si utilizza UFW e si è verificato che questo intervallo è appropriato per la propria installazione, esaminare le regole esistenti e aggiungere l'intervallo di supporti:
sudo ufw status numbered
sudo ufw allow 16384:32768/udpAnche i firewall cloud e i gruppi di sicurezza del provider devono consentire il traffico. Una regola a livello host non può prevalere su un firewall a monte bloccato. Se solo gli utenti su una rete restrittiva riscontrano problemi mentre altri utenti riescono a connettersi, è necessario esaminare il percorso di rete o la configurazione TURN anziché riavviare ripetutamente FreeSWITCH.
Un server dietro NAT può avere un listener locale corretto e comunque pubblicizzare un indirizzo privato irraggiungibile ai browser. Verificare che l'indirizzo IP esterno, il port forwarding e la configurazione di FreeSWITCH siano coerenti. La guida al firewall 4.0 di BigBlueButton utilizza /opt/freeswitch/conf/vars.xmle /opt/freeswitch/conf/sip_profiles/external.xmlper il suo esempio NAT e rimanda a /etc/bigbluebutton/bbb-webrtc-sfu/production.ymlper le relative sovrascritture SFU.
Non copiare un IP di esempio né presumere che l'IP pubblico debba essere inserito in ogni campo. In una configurazione NAT, l'indirizzo a cui FreeSWITCH si associa localmente può differire dall'indirizzo pubblico che annuncia. Applica le istruzioni specifiche per la versione e per la tua topologia di rete, quindi verifica le relative impostazioni di inoltro del firewall. Se l'indirizzo esterno del server è cambiato di recente, verifica il DNS e tutti i valori di indirizzo configurati in BigBlueButton.
Quando un processo server deve raggiungere il proprio nome host pubblico, possono essere rilevanti anche il NAT hairpin o la risoluzione del nome host locale. La guida ufficiale del firewall illustra come mappare il nome host pubblico all'indirizzo del firewall in /etc/hostsquesto scenario. Testare questa soluzione solo se il modello di errore indica un loopback attraverso il nome host esterno; non è una soluzione universale per i timeout di registrazione.
Se l'elemento che causa l'errore è un gateway di un operatore specifico anziché il percorso audio interno di BigBlueButton, verificare separatamente lo stato del gateway. FreeSWITCH documenta sofia status gateway <name>lo stato del gateway sofia statuse il profilo caricato. Verificare che il nome host del provider sia risolvibile dal server, che il nome utente e la password SIP configurati corrispondano, che il trasporto e la porta scelti corrispondano ai requisiti del provider e che le regole del firewall in uscita consentano il traffico di segnalazione.
Non reimpostare i profili SIP inclusi in BigBlueButton per riparare un account del gestore telefonico. Evita di condividere pubblicamente le tracce SIP complete: potrebbero contenere numeri di telefono, indirizzi IP, nomi di account o dettagli relativi all'autenticazione. Oscura i valori sensibili prima di chiedere a un provider o a un amministratore di esaminare i log.
Dopo aver corretto un problema confermato relativo a un servizio, un indirizzo o un firewall, riavvia BigBlueButton utilizzando il comando supportato:
sudo bbb-conf --restartUtilizzare questa opzione sudo bbb-conf --cleansolo quando la documentazione specifica della release o le evidenze diagnostiche lo richiedono. Non si tratta di una risposta generica a ogni timeout SIP. Allo stesso modo, evitare di eliminare i file del database di FreeSWITCH a meno che non si presentino i sintomi di danneggiamento del database documentati; conservare i log e i backup della configurazione prima di qualsiasi intervento di riparazione che rimuova lo stato.
Esegui sudo bbb-conf --checknuovamente il test e verifica che FreeSWITCH e il firewall bbb-webrtc-sfusiano funzionanti. Partecipa a una riunione di prova da un browser esterno alla rete del server, seleziona l'opzione microfono o solo ascolto e verifica che la connessione venga stabilita. Per le modifiche al NAT o al firewall, esegui il test da almeno una rete che in precedenza non ha funzionato. Il solo stato verde del servizio non è sufficiente a dimostrare che i media UDP possano attraversare la rete.
Se il timeout persiste, raccogli la versione di BigBlueButton, il testo completo dell'errore, l' bbb-conf --checkoutput pertinente, lo stato del servizio, le voci recenti del journal di FreeSWITCH e SFU e la topologia di rete. Oscura i dati riservati e pubblici degli utenti. Queste informazioni aiutano a distinguere un listener non funzionante, un timeout ESL, un indirizzo pubblicizzato errato, un intervallo multimediale bloccato e un effettivo errore di registrazione del gateway SIP.
Documentazione verificata il 6 ottobre 2026. La documentazione di BigBlueButton 4.0 indica questa versione come in fase di sviluppo; verificare i percorsi e i comandi rispetto alla versione installata sul server.
Confronta sei server e collettori syslog gratuiti per Windows e Linux, inclusi strumenti con interfaccia grafica, opzioni open source, funzionalità di ricerca, avvisi e trasporto sicuro.
Scopri cosa fa Microsoft IIS, come funzionano la sua pipeline di richieste e i pool di applicazioni e quando Apache, NGINX o Caddy potrebbero essere più adatti alle tue esigenze di server web.
Diagnostica i picchi di utilizzo della CPU del browser Jitsi Meet e riduci il carico del client controllando i riquadri video, gli effetti della fotocamera, la grafica del browser e le impostazioni dell'host.
Monitora lo stato di salute, il carico della conferenza e il traffico di Jitsi Videobridge con il suo endpoint Prometheus integrato, quindi esplora e visualizza i dati in Grafana.
Configura un dominio personalizzato per Jitsi Meet Docker con DNS, URL pubblico, HTTPS, Let's Encrypt, porte del firewall, impostazioni NAT e verifica end-to-end.
Fix Zimbra Admin Console 404 errors after SSL renewal by checking the correct URL and port, proxy routing, service status, deployed certificates, and logs.
Scopri come diagnosticare e risolvere l'avviso di configurazione di PHP OPcache di Nextcloud controllando l'SAPI PHP attivo, i limiti di dimensionamento, i commenti e le impostazioni di riconvalida.
Risolvere i problemi di migrazione del database Kopano dopo un aggiornamento di MySQL o MariaDB verificando i backup, le versioni del server, le modalità SQL, il set di caratteri, lo stato dello schema e i log.
Collega Nextcloud a LDAP o Active Directory con trasporto sicuro, filtri per utenti e gruppi, attributi di accesso e un'implementazione collaudata.
Risolvi i problemi di notifiche di Element Android sui telefoni senza Google configurando UnifiedPush, le autorizzazioni Android, le impostazioni della batteria ed eseguendo test di verifica affidabili.
