Fehlercode 1006 tritt auf, wenn BigBlueButton keine Audio-Verbindung zum Server aufbauen kann, weil der Verbindungsversuch nach etwa 20 Sekunden ohne Antwort abgebrochen wird. Der Fehler entsteht auf der SIP-Signalisierungsebene, bevor überhaupt eine Medienverbindung (ICE) versucht wird. Betroffene Teilnehmer können weder sprechen noch hören und erhalten eine Fehlermeldung im Browser.

Wie äußert sich der Fehler?

Nach dem Klick auf „Mikrofon” oder „Nur zuhören” startet BigBlueButton den Verbindungsaufbau zum Audio-Server. Läuft dieser Versuch in einen Timeout, erscheint im Browser die Fehlermeldung mit dem Code 1006 – sinngemäß: „Der Anruf hat eine Zeitüberschreitung”. Gelegentlich wird der Fehler auch als Toast-Benachrichtigung mit dem Text „Es gab eine Zeitüberschreitung bei der Anfrage” sichtbar (app.audioManager.requestTimeout). Die Benutzeroberfläche kehrt danach in den Ausgangszustand zurück, ohne dass eine Audioverbindung besteht.

Mögliche Ursachen

• Beschädigte FreeSWITCH-Datenbank: Nach einem unsauberen Serverneustart können die internen SQLite-Datenbanken von FreeSWITCH korrumpiert sein. FreeSWITCH kann dann keine SIP-Profile laden und nimmt keine Verbindungen an.
• IPv6 deaktiviert: FreeSWITCH wartet standardmäßig auf einer IPv6-Adresse. Ist IPv6 auf dem Server nicht verfügbar, kann der interne Event-Socket-Port 8021 nicht gebunden werden, und der Verbindungsaufbau hängt sich auf.
• Falsche nginx-SIP-Proxy-Konfiguration: Die Datei /etc/bigbluebutton/nginx/sip.nginx muss auf die korrekte IP-Adresse und den richtigen Port von FreeSWITCH zeigen. Ein falscher Eintrag führt dazu, dass der WebSocket-Handshake still fehlschlägt.
• Firewall blockiert SIP-Port: Die Ports 5066 (unverschlüsselt) bzw. 7443 (TLS) müssen intern erreichbar sein. Unternehmens-Firewalls oder Cloud-Sicherheitsgruppen, die diese Ports sperren, verhindern den Verbindungsaufbau.
• Unvollständiges BBB-Update: Ein reines apt upgrade ohne anschließendes bbb-conf --setip kann Konfigurationsdateien veraltet lassen und so Verbindungsfehler verursachen.

Lösungen

Für Teilnehmer

1. Audio erneut beitreten: Schließen Sie das Audio-Fenster und klicken Sie erneut auf das Mikrofon-Symbol, um einen neuen Verbindungsversuch zu starten.
2. Nur-Zuhören wählen: Wählen Sie statt „Mikrofon” die Option „Nur zuhören” – diese Verbindungsart ist weniger fehleranfällig und funktioniert oft, wenn das Mikrofon-Audio nicht aufgebaut werden kann.
3. Browser-Seite neu laden: Ein einfaches Neuladen der Seite (F5 bzw. Strg+R) kann einen vorübergehenden Verbindungsfehler beheben.
4. Netzwerk wechseln: Versuchen Sie, sich über ein anderes Netzwerk (z. B. mobiles Hotspot statt Firmen-WLAN) zu verbinden, falls eine Firewall den Verbindungsaufbau blockiert.
5. Anderen Browser oder Gerät verwenden: Tritt der Fehler nur in einem bestimmten Browser auf, probieren Sie Chrome, Firefox oder Edge als Alternative.

Für Administratoren

1. FreeSWITCH-Datenbankkorruption beheben: Prüfen Sie das FreeSWITCH-Log auf SQL-Fehler (SQL ERR [unsupported file format]). Falls vorhanden: FreeSWITCH stoppen, Datenbankdateien in /opt/freeswitch/var/lib/freeswitch/db/ löschen und den Dienst neu starten. FreeSWITCH legt die Dateien beim nächsten Start automatisch neu an. Hinweis: Ab BBB 2.6 werden diese Datenbanken im Arbeitsspeicher gehalten – dieser Fehler kann dort nicht mehr auftreten.
2. IPv6-Problem beheben: Prüfen Sie mit ip addr | grep inet6, ob IPv6 aktiv ist. Falls nicht, ändern Sie in /opt/freeswitch/etc/freeswitch/autoload_configs/event_socket.conf.xml den Listen-IP-Parameter von :: auf 127.0.0.1 und deaktivieren Sie die IPv6-SIP-Profile. Starten Sie anschließend BBB neu (bbb-conf --clean && bbb-conf --check).
3. nginx-SIP-Proxy prüfen: Kontrollieren Sie /etc/bigbluebutton/nginx/sip.nginx. Für SSL-Setups muss proxy_pass auf https://127.0.0.1:7443 zeigen, für Setups ohne SSL auf http://127.0.0.1:5066. Nach Änderungen nginx neu laden: nginx -t && systemctl reload nginx.
4. Nach unvollständigem Update neu konfigurieren: Führen Sie nach einem BBB-Update immer bbb-conf --setip IHRE_DOMAIN gefolgt von bbb-conf --clean && bbb-conf --check aus, um alle Konfigurationsdateien auf den aktuellen Stand zu bringen.
5. Systemstatus prüfen: Das Kommando bbb-conf --check gibt Hinweise auf Fehlkonfigurationen, etwa wenn FreeSWITCH nicht auf Port 8021 antwortet.

Weitere Informationen

Fehlercode 1006 betrifft ausschließlich die SIP-Signalisierungsschicht. Verwandte Fehlercodes sind 1007 (ICE-Aushandlung fehlgeschlagen – Verbindung kommt weiter, scheitert aber beim Medienpfad) und 1010 (ICE-Timeout). Tritt der Fehler bei vielen Teilnehmern gleichzeitig auf, liegt die Ursache fast immer auf Serverseite; tritt er nur vereinzelt auf, ist häufig eine Firewall oder ein Netzwerkproblem beim Endgerät die Ursache.