Fehler 1004 tritt in BigBlueButton auf, wenn die WebSocket-Verbindung zu FreeSWITCH zwar erfolgreich hergestellt wurde, die eigentliche Audioverbindung (SIP-Anruf bzw. ICE-Aushandlung) aber scheitert. Das bedeutet: Der Verbindungsaufbau beginnt, bricht jedoch ab, bevor Audio übertragen werden kann. Betroffene Teilnehmer hören und sprechen nichts; im Audiomodal erscheint die Fehlermeldung mit dem Code 1004, häufig ergänzt durch einen Hinweis wie „ICE Error” oder „SIP Failure Code”.

Wie äußert sich der Fehler?

Beim Versuch, dem Meeting mit aktivem Mikrofon beizutreten, schlägt die Verbindung fehl. Das Audiomodal von BigBlueButton zeigt den Fehlercode 1004 an, optional mit einer Zusatzangabe in Klammern (z. B. ICE Error, SIP Failure Code oder INCOMPATIBLE_DESTINATION). Eine Teilnahme im Nur-Zuhören-Modus (Listen-Only) ist in vielen Fällen weiterhin möglich, da dieser Modus keinen vollständigen WebRTC-Mediapfad benötigt.

Mögliche Ursachen

• STUN-Server nicht erreichbar: FreeSWITCH verwendet standardmäßig stun.freeswitch.org, einen öffentlichen Dienst, der unzuverlässig sein kann. Ist er nicht erreichbar, ermittelt FreeSWITCH seine öffentliche IP-Adresse nicht korrekt.
• Falsches externe IP-Konfiguration: Die Einträge external_rtp_ip oder external_sip_ip in vars.xml zeigen auf eine private statt auf die öffentliche IP-Adresse des Servers.
• UDP-Ports gesperrt: Die für RTP-Mediadaten benötigten UDP-Ports 16384–32768 sind durch eine Firewall oder Cloud-Sicherheitsgruppe geblockt.
• Kein TURN-Server vorhanden: Teilnehmer hinter einem strengen NAT oder einem symmetrischen NAT können keine direkte Verbindung aufbauen und benötigen einen TURN-Relay-Server.
• IPv6-Probleme: IPv6 ist auf dem Server nicht verfügbar, FreeSWITCH versucht jedoch, IPv6-ICE-Kandidaten zu nutzen.
• Firefox-Inkompatibilität: Firefox unterstützt ICE-Lite (genutzt ab BBB 2.5+) nicht vollständig, was in bestimmten Netzwerktopologien zu Fehler 1004 führen kann, während Chrome oder Edge problemlos funktionieren.
• Android Chrome (bekannter Bug): Auf Android 11 mit Chrome schlägt die ICE-Kandidatensammlung in BBB 2.4 fehl (GitHub Issue #14136).

Lösungen

Für Teilnehmer

1. Erneut versuchen: Schließen Sie das Audiomodal und versuchen Sie, dem Audio erneut beizutreten. Vorübergehende Netzwerkprobleme lassen sich so oft beheben.
2. Nur-Zuhören-Modus wählen: Falls das Mikrofon nicht zwingend benötigt wird, wählen Sie im Audiomodal „Nur zuhören”. Dieser Modus ist robuster gegenüber Verbindungsproblemen.
3. Browser wechseln: Testen Sie Google Chrome oder Microsoft Edge, besonders wenn Sie Firefox verwenden. Bei Firefox können ICE-Kompatibilitätsprobleme auftreten.
4. Netzwerk prüfen: Verbinden Sie sich nach Möglichkeit über ein anderes Netzwerk (z. B. vom mobilen Hotspot statt aus dem Firmennetzwerk). Strenge Firewalls oder VPNs können UDP-Datenverkehr blockieren.
5. Android-Nutzer: Wenn Sie Android 11 mit Chrome verwenden und Fehler 1004 erhalten, wechseln Sie zu Firefox für Android oder nutzen Sie die offizielle BBB-App.

Für Administratoren

1. Externe IP in vars.xml korrigieren: Ersetzen Sie den unzuverlässigen STUN-Server durch die feste öffentliche IP-Adresse des Servers. Bearbeiten Sie dazu /opt/freeswitch/conf/vars.xml und setzen Sie external_rtp_ip sowie external_sip_ip auf die tatsächliche öffentliche IPv4-Adresse. Tragen Sie die Änderung zusätzlich in /etc/bigbluebutton/bbb-conf/apply-config.sh ein, damit sie nach Updates erhalten bleibt.
2. UDP-Ports freigeben: Öffnen Sie den UDP-Bereich 16384–32768 in der Firewall (ufw, iptables oder Cloud-Sicherheitsgruppe). Außerdem müssen TCP-Port 80 und 443 erreichbar sein.
3. TURN-Server einrichten: Installieren Sie coturn auf einem separaten Server und konfigurieren Sie BBB über /etc/bigbluebutton/turn-stun-servers.xml. Ab BBB 2.6 wird coturn bei der Installation mit bbb-install.sh automatisch eingerichtet. Ein funktionierender TURN-Server löst die meisten ICE-Fehler bei Nutzern hinter restriktivem NAT.
4. IPv6-SIP-Profile deaktivieren (falls IPv6 nicht vorhanden): Prüfen Sie mit ip addr | grep inet6, ob IPv6 auf dem Server aktiv ist. Wenn nicht, benennen Sie die Profile internal-ipv6.xml und external-ipv6.xml in FreeSWITCH in .disabled um und starten Sie BBB neu.
5. TURN-Relay für Firefox erzwingen (BBB 2.5+): Setzen Sie in /etc/bigbluebutton/bbb-html5.yml den Wert public.kurento.forceRelayOnFirefox: true und starten Sie BBB mit sudo bbb-conf --restart neu.
6. BBB-Konfiguration prüfen (BBB 2.5+): Ab BBB 2.5 kommt mediasoup zum Einsatz. Prüfen Sie in /etc/bigbluebutton/bbb-webrtc-sfu/production.yml, ob announcedIp korrekt auf die öffentliche IP gesetzt ist.
7. Diagnosewerkzeuge nutzen: Öffnen Sie in Chrome chrome://webrtc-internals/ und prüfen Sie die ICE-Kandidatenpaare. Zeigt die Remote-Kandidatenliste eine private IP-Adresse, sendet FreeSWITCH eine falsche IP im SDP. In Firefox finden Sie vergleichbare Informationen unter about:webrtc.

Verwandte Fehlercodes

Fehler 1004 tritt häufig in Kombination mit anderen Audiofehlern auf oder wird mit ihnen verwechselt. Fehler 1002 (WebSocket-Verbindung fehlgeschlagen) deutet auf ein früheres Problem im Verbindungsaufbau hin – die WebSocket-Verbindung kommt nicht einmal zustande. Fehler 1007 (ICE-Negotiation-Fehler) ist eng verwandt und betrifft ebenfalls fehlschlagende ICE-Verbindungen, tritt jedoch in einem leicht anderen Kontext auf. Bei Fehler 1003 (Verbindungsabbruch) hingegen war die Audioverbindung zunächst erfolgreich, brach dann aber während der Sitzung ab.