Ein BigBlueButton-Meeting kann normal geladen werden, während Teilnehmer beim Beitritt zur Audioverbindung Probleme haben. Administratoren sehen möglicherweise Meldungen wie „SIP-Registrierungstimeout“, „FreeSWITCH konnte sich nicht registrieren“ oder einen Audioverbindungsfehler in einem Protokoll oder Überwachungstool. Diese Meldungen weisen nicht immer auf dieselbe Fehlerursache hin. In einer Standardinstallation von BigBlueButton kann eine fehlgeschlagene Audioverbindung durch einen beendeten FreeSWITCH-Prozess, eine blockierte SIP- oder Event-Socket-Verbindung, eine falsche Adresse hinter NAT oder blockierte WebRTC-Medien verursacht werden. Ein tatsächlicher Registrierungstimeout eines Netzbetreibers oder PBX-Gateways ist ein Sonderfall.
Ermitteln Sie zunächst die Komponente, die einen Timeout verursacht. Überprüfen Sie anschließend in dieser Reihenfolge den Dienststatus, lokale Listener, Netzwerkpfade und Adressen. Vermeiden Sie Änderungen an den SIP-Einstellungen oder das Öffnen von Ports, bis der betroffene Pfad eindeutig identifiziert ist.
Zunächst muss geklärt werden, was mit „Registrierungstimeout“ gemeint ist.
Der aktuelle Audio-Stack von BigBlueButton nutzt diesen bbb-webrtc-sfuDienst zur Medienkoordination mit FreeSWITCH. Die BigBlueButton-Dokumentation beschreibt die Verbindung der SFU mit dem SIP-Dienst und der Event Socket Layer (ESL) von FreeSWITCH. Dies unterscheidet sich von der Registrierung eines ausgehenden Gateways bei einem externen SIP-Anbieter durch FreeSWITCH.
- Problem mit der BigBlueButton-Audioverbindung: Benutzer können nicht an der Audioübertragung teilnehmen, FreeSWITCH ist nicht erreichbar oder die SFU meldet einen Timeout. Untersuchen Sie FreeSWITCH, ESL, die konfigurierte SIP-Adresse und den Port, NAT und WebRTC-Transport.
- Problem bei der Registrierung des externen Gateways: FreeSWITCH meldet ein konfiguriertes Gateway als nicht erreichbar oder nicht registriert. Überprüfen Sie den Hostnamen, die Anmeldeinformationen, das Transportprotokoll, den Firewall-Pfad und den Kontostatus des Providers.
Wenn Sie sich nicht sicher sind, welcher Fall zutrifft, speichern Sie den vollständigen Fehlertext und den Namen des Dienstes, der ihn protokolliert hat. „Registrierungstimeout“ allein reicht nicht aus, um eine Änderung eines SIP-Profils zu rechtfertigen.
1. Führen Sie die Konfigurationsprüfung von BigBlueButton durch.
Führen Sie auf dem Server die von BigBlueButton empfohlene Diagnose durch:
sudo bbb-conf --check
Überprüfen Sie die gesamte Ausgabe, insbesondere den Abschnitt mit dem Titel „“ Potential problems. Dort wird geprüft, ob die erforderlichen Prozesse ausgeführt werden, und häufige Konfigurationsprobleme werden gemeldet. Eine Warnung kann auf eine beabsichtigte Anpassung hinweisen. Vergleichen Sie sie daher mit Ihrer Konfiguration, anstatt jede vorgeschlagene Korrektur automatisch anzuwenden.
Überprüfen Sie anschließend den Servicestatus:
sudo bbb-conf --status
sudo systemctl status freeswitch --no-pager
sudo systemctl status bbb-webrtc-sfu --no-pager
Bei älteren BigBlueButton-Versionen können Dienstnamen oder die Komponentenarchitektur abweichen. Überprüfen Sie Ihre installierte Version sudo bbb-conf --versionund verwenden Sie die zugehörige Dokumentation. Die folgenden Pfade und Beispiele beziehen sich hauptsächlich auf die BigBlueButton 4.0-Dokumentation, die sich noch in der Entwicklung befindet.
2. Vergewissern Sie sich, dass FreeSWITCH ausgeführt wird und lokale Verbindungen akzeptiert.
Falls freeswitch.servicedas System inaktiv ist, ausgefallen ist oder wiederholt neu startet, lesen Sie dessen Protokoll, bevor Sie die Konfiguration bearbeiten:
sudo journalctl -u freeswitch.service -b --no-pager -n 100
Suchen Sie nach Bindungsfehlern, Modulladefehlern, Berechtigungsproblemen oder Datenbankfehlern in der Nähe des letzten Starts. Die Fehlerbehebungsanleitung von BigBlueButton beschreibt spezifische Fälle, in denen FreeSWITCH keine Verbindung zu IPv4 oder dem ESL-Port 8021 herstellen kann. Sie nennt außerdem eine beschädigte FreeSWITCH-Datenbank als mögliche Ursache nach einem Neustart, empfiehlt jedoch eine Datenbankbereinigung nur bei Vorliegen entsprechender Datenbankfehler.
Prüfen Sie, welche Adressen und Ports aktiv sind:
sudo ss -luntp | grep -E ':(5060|5066|8021)\b'
Der genaue SIP-Listener hängt von Ihrer BigBlueButton-Version und -Konfiguration ab. Ein fehlender Listener deutet darauf hin, dass FreeSWITCH das entsprechende Profil nicht starten oder an eine andere Adresse gebunden hat. Port 8021 ist in einer typischen Paketinstallation die lokale ESL-Steuerungsschnittstelle und sollte normalerweise auf localhost oder ein vertrauenswürdiges privates Netzwerk beschränkt bleiben. Geben Sie ihn nicht im öffentlichen Internet frei.
Wenn FreeSWITCH aktiv ist, können Sie den SIP-Profilstatus über die Befehlszeilenschnittstelle (CLI) überprüfen. Der Standardbefehl von FreeSWITCH lautet `sip-profile sofia status- ...RUNNING
3. Ordnen Sie den Fehler dem fehlerhaften Netzwerkpfad zu.
Der Firewall-Leitfaden von BigBlueButton unterscheidet zwischen einem WebSocket-Signalisierungsfehler und einem ICE-/Medienfehler. Diese Unterscheidung schränkt die Suche ein:
- WebRTC-Fehler 1002: Der Browser konnte keine WebSocket-Verbindung herstellen. Überprüfen Sie, ob FreeSWITCH ausgeführt wird, die SIP-over-WebSocket-Route und die Reverse-Proxy-Konfiguration sowie alle Firewall-Regeln, die diesen Signalisierungspfad beeinflussen.
- WebRTC-Fehler 1007: Die WebSocket-Verbindung wurde hergestellt, aber der Browser konnte keine Medienverbindung über die zurückgegebenen Adresskandidaten herstellen. Überprüfen Sie die angekündigte IP-Adresse und die bidirektionale UDP-Erreichbarkeit.
Für die Standardkonfiguration der BigBlueButton-Firewall listet die offizielle Anleitung UDP-Ports 16384–32768für Echtzeitmedien auf. Erlauben Sie den erforderlichen Bereich sowohl in der Cloud-Sicherheitsgruppe bzw. der Perimeter-Firewall als auch in der Host-Firewall. Beschränken Sie die Regel auf den Server und den erforderlichen Datenverkehr; das allgemeine Öffnen von nicht benötigten SIP-Ports ersetzt keine korrekte NAT- und WebRTC-Konfiguration.
Wenn Sie beispielsweise UFW verwenden und bestätigt haben, dass dieser Bereich für Ihre Installation geeignet ist, überprüfen Sie die vorhandenen Regeln und fügen Sie den Medienbereich hinzu:
sudo ufw status numbered
sudo ufw allow 16384:32768/udp
Cloud-Firewalls und Provider-Sicherheitsgruppen müssen den Datenverkehr ebenfalls zulassen. Eine Host-Regel kann eine blockierte Upstream-Firewall nicht außer Kraft setzen. Wenn nur Benutzer in einem restriktiven Netzwerk Probleme haben, während andere Benutzer eine Verbindung herstellen können, sollten Sie deren Netzwerkpfad oder TURN-Konfiguration untersuchen, anstatt FreeSWITCH wiederholt neu zu starten.
4. Überprüfen Sie die NAT- und die beworbenen IP-Adressen.
Ein Server hinter einem NAT-Router kann zwar einen korrekten lokalen Listener haben, aber dennoch eine nicht erreichbare private Adresse an Browser weitergeben. Überprüfen Sie, ob die externe IP-Adresse, die Portweiterleitung und die FreeSWITCH-Konfiguration übereinstimmen. Die Firewall-Anleitung von BigBlueButton 4.0 verwendet /opt/freeswitch/conf/vars.xmlfür /opt/freeswitch/conf/sip_profiles/external.xmlihr NAT-Beispiel die entsprechenden Einstellungen und verweist /etc/bigbluebutton/bbb-webrtc-sfu/production.ymlfür relevante SFU-Überschreibungen auf die entsprechende URL.
Kopieren Sie keine Beispiel-IP-Adresse und gehen Sie nicht davon aus, dass die öffentliche IP-Adresse in jedes Feld gehört. In einer NAT-Konfiguration kann die von FreeSWITCH lokal zugewiesene Adresse von der öffentlich angekündigten Adresse abweichen. Wenden Sie die versionsspezifischen Anweisungen für Ihre Netzwerktopologie an und überprüfen Sie anschließend die entsprechende Firewall-Weiterleitung. Wenn sich die externe Adresse des Servers kürzlich geändert hat, überprüfen Sie die DNS-Einträge und alle in der BigBlueButton-Konfiguration hinterlegten Adresswerte.
Wenn ein Serverprozess seinen eigenen öffentlichen Hostnamen erreichen muss, können Hairpin-NAT oder die lokale Hostnamensauflösung relevant sein. Die offizielle Firewall-Anleitung beschreibt die Zuordnung des öffentlichen Hostnamens zur Firewall-Adresse für /etc/hostsdieses Szenario. Testen Sie dies nur, wenn das Fehlermuster auf eine Loopback-Verbindung über den externen Hostnamen hindeutet; es ist keine universelle Lösung für Registrierungs-Timeouts.
5. Wenn im Protokoll ein externes SIP-Gateway genannt wird.
Falls es sich bei dem fehlerhaften Element um ein benanntes Carrier-Gateway und nicht um den internen Audiopfad von BigBlueButton handelt, überprüfen Sie den Gateway-Status separat. FreeSWITCH dokumentiert sofia status gateway <name>den Gateway-Status sowie sofia statusden Status des geladenen Profils und des Gateways. Stellen Sie sicher, dass der Provider-Hostname vom Server aufgelöst wird, der konfigurierte SIP-Benutzername und das Passwort übereinstimmen, der gewählte Transport und Port den Anforderungen des Providers entsprechen und ausgehende Firewall-Regeln den Signalisierungsverkehr zulassen.
Setzen Sie die mit BigBlueButton mitgelieferten SIP-Profile nicht zurück, um ein Mobilfunkkonto zu reparieren. Vermeiden Sie die öffentliche Weitergabe vollständiger SIP-Protokolle: Diese können Telefonnummern, IP-Adressen, Kontonamen oder Authentifizierungsdaten enthalten. Schwärzen Sie sensible Daten, bevor Sie einen Anbieter oder Administrator bitten, die Protokolle zu überprüfen.
6. Nehmen Sie eine gezielte Änderung vor und starten Sie das System einmal neu.
Nachdem ein bestätigtes Problem mit einem Dienst, einer Adresse oder der Firewall behoben wurde, starten Sie BigBlueButton mit dem zugehörigen Befehl neu:
sudo bbb-conf --restart
Verwenden Sie diese Funktion sudo bbb-conf --cleannur, wenn die versionsspezifische Dokumentation oder die Diagnose dies erfordern. Sie ist keine allgemeine Antwort auf jeden SIP-Timeout. Vermeiden Sie es außerdem, FreeSWITCH-Datenbankdateien zu löschen, es sei denn, es treten die dokumentierten Symptome einer Datenbankbeschädigung auf. Sichern Sie Protokolle und Konfigurationssicherungen, bevor Sie Reparaturen durchführen, die den Zustand löschen.
Überprüfen Sie die Reparatur.
Führen Sie den Vorgang sudo bbb-conf --checkerneut aus und vergewissern Sie sich, dass FreeSWITCH und der Server bbb-webrtc-sfueinwandfrei funktionieren. Nehmen Sie über einen Browser außerhalb des Servernetzwerks an einer Testbesprechung teil, wählen Sie Mikrofon- oder Nur-Lese-Audio und prüfen Sie, ob die Verbindung hergestellt wird. Testen Sie nach Änderungen an NAT oder Firewall mindestens von einem Netzwerk aus, bei dem die Verbindung zuvor nicht funktioniert hat. Ein grüner Dienststatus allein beweist nicht, dass UDP-Medien das Netzwerk passieren können.
Falls das Timeout weiterhin besteht, erfassen Sie die BigBlueButton-Version, den vollständigen Fehlertext, die relevanten bbb-conf --checkAusgaben, den Dienststatus, die letzten FreeSWITCH- und SFU-Journaleinträge sowie die Netzwerktopologie. Schwärzen Sie vertrauliche und öffentliche Benutzerdaten. Diese Informationen helfen, zwischen einem inaktiven Zuhörer, einem ESL-Timeout, einer falschen angegebenen Adresse, einem blockierten Medienbereich und einem tatsächlichen Fehler bei der SIP-Gateway-Registrierung zu unterscheiden.
Offizielle Referenzen
Die Dokumentation wurde am 6. Oktober 2026 geprüft. In der Dokumentation zu BigBlueButton 4.0 wird diese Version als Entwicklungsversion gekennzeichnet; bitte überprüfen Sie die Pfade und Befehle anhand der auf Ihrem Server installierten Version.