Quando l'audio delle stanze virtuali di BigBlueButton non si connette, la prima domanda utile da porsi non è "quale servizio devo riavviare?", bensì "l'audio non funziona solo dopo essere entrati in una stanza virtuale o anche durante la riunione principale?". Questa distinzione permette di separare rapidamente un problema di transizione tra stanze virtuali da un problema più generale del browser, della rete o del server multimediale.
Questa guida è stata scritta per BigBlueButton 3.0, che rimane la versione stabile documentata a ottobre 2026; BigBlueButton 4.0 è ancora documentato come in fase di sviluppo. BigBlueButton 3.0 può utilizzare diversi bridge audio, tra cui bbb-webrtc-sfu, livekit, e freeswitchtramite l'API meeting, quindi è importante evitare di presumere che ogni implementazione abbia lo stesso percorso multimediale. La documentazione ufficiale dell'API di BigBlueButton descrive queste opzioni di bridge, mentre la guida alla risoluzione dei problemi di BigBlueButton rimane il punto di partenza migliore per i controlli lato server.
Un risultato positivo non si limita a vedere l'icona del microfono diventare verde. Dopo la correzione, un partecipante dovrebbe essere in grado di entrare in una stanza virtuale, attivare l'audio in pochi secondi, sentire gli altri partecipanti, parlare ed essere ascoltato, attivare e disattivare il microfono normalmente e tornare alla stanza principale senza rimanere bloccato in un ciclo di riconnessione. Se solo un browser o una rete continuano a non funzionare dopo che tutti gli altri hanno avuto successo, interrompere la modifica del server e concentrarsi sull'ambiente client.
| Osservazione | Area più probabile | Prossima mossa |
|---|---|---|
| L'audio della sala principale e delle sale riunioni non funziona. | Autorizzazioni del browser, dispositivo, firewall, TURN o media bridge | Inizia con i passaggi da 1 a 4 |
| La stanza principale funziona, la stanza secondaria è bloccata su "connessione". | Transizione di stanza, stato del client obsoleto, problema specifico del bridge | Inizia con i passaggi 1, 2 e 5 |
| Solo gli utenti di un ufficio, di una scuola o di una rete VPN non riescono | Filtraggio di rete o percorso ICE/TURN | Dare priorità al passaggio 4 |
| Molti utenti falliscono contemporaneamente | Configurazione del server o della rete | Dare priorità alle fasi 3-5 |
Prima di modificare la configurazione, riproduci il problema con un moderatore e un partecipante. Verifica che il partecipante possa attivare l'audio nella stanza principale, quindi spostalo in una stanza separata e annota esattamente cosa succede. Il messaggio "Connessione audio in corso..." che non viene mai completato è diverso da un rifiuto di autorizzazione del browser, da un dispositivo microfono mancante o da un audio che si connette ma non riproduce alcun suono.
Se la stanza principale funziona ma la stanza secondaria no, prova a uscire dalla stanza secondaria, tornare alla stanza principale e rientrare nella stanza secondaria una sola volta. Uno stato del client obsoleto temporaneo può essere risolto dopo un riavvio corretto. Se il problema si ripresenta regolarmente, continua con i controlli seguenti invece di aggiornare ripetutamente la pagina.
Verifica di successo: il partecipante si unisce alla sessione audio di gruppo una volta, esce, si riunisce e ottiene nuovamente l'audio. Se questo risultato è affidabile, il problema era probabilmente temporaneo. Se la stessa transizione fallisce ogni volta, si può procedere.
L'audio di BigBlueButton si basa su WebRTC nel browser, quindi un'autorizzazione negata per il microfono potrebbe sembrare un problema specifico della sessione di gruppo se l'utente se ne accorge solo dopo essere entrato nella stanza virtuale. Apri le autorizzazioni del sito nel browser per il nome host di BigBlueButton e assicurati che l'accesso al microfono sia consentito. Quindi verifica che sia selezionato il microfono desiderato e che nessun'altra applicazione stia monopolizzando il dispositivo.
Eseguire un test con una versione corrente di Firefox o di un browser basato su Chromium. Se il partecipante riesce a riprodurre lo stesso errore su due browser funzionanti, è meno probabile che si tratti di un problema legato al profilo del browser. Se un browser funziona e un altro no sulla stessa macchina e rete, reimpostare le autorizzazioni o eseguire un test con un profilo del browser pulito prima di modificare la configurazione di BigBlueButton.
Verifica di successo: l'indicatore di attività del microfono risponde, l'audio si attiva nella stanza principale e lo stesso browser può partecipare all'audio delle sessioni separate. Se la stanza principale continua a non funzionare, la vera causa del problema non risiede nelle sessioni separate.
Sul server, esegui il comando sudo bbb-conf --check. La documentazione di BigBlueButton consiglia di eseguirlo come prima diagnostica lato server perché verifica se i componenti principali sono stati avviati correttamente e individua i problemi di configurazione più comuni. Esamina tutto ciò che è elencato nella sezione "Problemi potenziali" invece di riavviare immediatamente tutti i servizi.
Esegui sudo bbb-conf --statuse controlla anche i servizi systemd pertinenti per il tuo bridge audio. Le implementazioni di BigBlueButton 3.0 utilizzano comunemente bbb-webrtc-sfuper impostazione predefinita l'audio, mentre LiveKit può essere abilitato per singola riunione o a livello di server. Se l'integrazione ha esito positivo audioBridge=livekit, risolvi i problemi di LiveKit invece di presumere che il percorso legacy di FreeSWITCH stia gestendo l'audio del browser.
La documentazione ufficiale dei file di configurazione raccomanda di posizionare le sovrascritture locali in /etc/bigbluebuttonmodo che gli aggiornamenti dei pacchetti non le sovrascrivano.
Verifica di successo: bbb-conf --check non vengono visualizzati errori inspiegabili, i servizi audio-bridge attivi sono in esecuzione e le nuove riunioni di prova si comportano in modo coerente. Se lo stato del servizio è buono ma una rete continua a non funzionare, concentrare l'attenzione su ICE, NAT e TURN.
WebRTC deve stabilire un percorso multimediale utilizzabile tra il browser e l'infrastruttura multimediale di BigBlueButton. Se la segnalazione ha successo ma il mezzo multimediale non riesce a trovare un percorso di rete valido, gli utenti potrebbero riscontrare errori di negoziazione ICE o rimanere bloccati durante la connessione audio. La documentazione del firewall di BigBlueButton indica specificamente annunci IP esterni errati e UDP bloccato come cause comuni.
Su Firefox, about:webrtcè utile perché mostra i candidati ICE e lo stato della connessione. Se vedi che il server pubblicizza un indirizzo interno quando è previsto un indirizzo esterno, controlla la configurazione NAT e announce-IP. La guida alla configurazione del firewall di BigBlueButton spiega come mediasoup dovrebbe annunciare l'indirizzo pubblico quando il server si trova dietro un NAT.
Se i problemi si concentrano su reti aziendali, scolastiche, alberghiere o VPN con restrizioni, è consigliabile configurare un server TURN. La documentazione di installazione di BigBlueButton raccomanda l'utilizzo di TURN per gli utenti che si trovano dietro firewall restrittivi. Un utile test di validazione consiste nel testare lo stesso utente su una rete diversa, ad esempio un hotspot telefonico. Se l'hotspot funziona e la rete gestita non funziona, ciò dimostra chiaramente che il fattore limitante risiede nel percorso di rete e non nella logica delle sale riunioni.
Non aprire ciecamente intervalli di porte generici copiati da vecchi post del forum. Utilizza i requisiti di porta e bridge specifici per la versione di BigBlueButton installata e per la topologia di implementazione. I consigli precedenti, specifici per FreeSWITCH o SIP.js, potrebbero non essere applicabili a un'installazione 3.0 corrente.
Verifica di successo: ICE raggiunge uno stato di connessione, viene visualizzato il candidato pubblico o di inoltro previsto e lo stesso utente interessato può partecipare all'audio di gruppo dalla rete che in precedenza non funzionava. Se l'utente continua a non riuscire mentre altri utenti sulla stessa rete riescono, tornare alla verifica del dispositivo/browser.
Se l'audio della sala principale funziona ma l'audio delle sessioni separate non funziona per molti utenti, verifica quale bridge audio viene effettivamente utilizzato dalla riunione. BigBlueButton 3.0 espone il audioBridgeparametro create con valori validi tra cui bbb-webrtc-sfu, livekit, e freeswitch. Un'integrazione può sovrascrivere l'impostazione predefinita del server per ogni riunione, quindi la configurazione che stai esaminando potrebbe non corrispondere al bridge utilizzato dalla sessione che non funziona.
Crea una nuova riunione di prova senza impostazioni personalizzate per ogni riunione, quindi ripeti la stessa sequenza: sala principale → sala di approfondimento → sala principale. Se la riunione di prova funziona correttamente, ma le riunioni create dal tuo LMS o dall'applicazione personalizzata non funzionano, controlla i parametri API inviati da tale integrazione. Se entrambe falliscono, è più probabile che il problema risieda nella configurazione dei media del server o in un difetto specifico della versione.
Dopo aver apportato modifiche alla configurazione, riavviare BigBlueButton solo quando necessario con sudo bbb-conf --restart, quindi eseguirlo sudo bbb-conf --checkdi nuovo. Evitare di sovrapporre diverse modifiche prima di testarle; una modifica alla volta consente di identificare quale regolazione ha effettivamente risolto il problema.
Verifica di successo: due partecipanti possono comunicare tra loro in una stanza virtuale, tornare alla stanza principale e rientrare in una stanza virtuale senza che la connessione si blocchi. Ripetere questa operazione da almeno una rete esterna prima di considerare l'incidente risolto.
Se il problema persiste anche dopo aver verificato le autorizzazioni del browser, lo stato del server, ICE/TURN e la selezione del bridge, raccogli prove invece di continuare a fare ipotesi. Annota la versione di BigBlueButton, le versioni del browser e del sistema operativo, se il problema si riproduce sulla demo pubblica di BigBlueButton, l'output di sudo bbb-conf --check, l'impostazione del bridge audio della riunione e qualsiasi diagnostica WebRTC del browser pertinente. La guida "Ottieni assistenza" di BigBlueButton richiede esplicitamente questo tipo di informazioni di rete e sull'ambiente quando si risolvono i problemi audio o video.
A ottobre 2026, la documentazione di BigBlueButton 3.0 rimane stabile, con le release 3.0 ancora disponibili su GitHub, mentre la documentazione della versione 4.0 è contrassegnata come "in fase di sviluppo". Questo è importante perché BigBlueButton 4.0 cambia il framework multimediale predefinito in LiveKit, quindi le indicazioni specifiche per la versione 4.0 non devono essere applicate automaticamente a un server 3.0. Consultare la pagina ufficiale delle release di BigBlueButton prima di seguire istruzioni specifiche per la versione.
bbb-conf --checkNon presenta errori inspiegabili relativi ai servizi multimediali.Se tutti e sei i controlli vengono superati ripetutamente, la riparazione sta producendo il risultato che conta: un audio stabile durante i cambi di stanza, e non solo un'icona verde temporanea del microfono.
Confronta strumenti di monitoraggio open source e proprietari in base a costi, supporto, personalizzazione, sicurezza e opzioni disponibili, tra cui Zabbix, Nagios, PRTG e altri.
Confronta i migliori server TFTP per Windows, Linux e macOS, tra cui SolarWinds, Tftpd64, tftpd-hpa, atftpd, haneWIN e dnsmasq.
Confronta cinque alternative a Microsoft Access per la gestione di database su desktop, SQLite, senza codice e tramite browser, evidenziandone punti di forza, limiti e casi d'uso più adatti.
Comprendere come i termini "ingress" e "egress" descrivono il traffico in entrata e in uscita, perché la direzione dipende dal confine della rete e come monitorare la larghezza di banda e individuare i trasferimenti di dati rischiosi.
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.
