Fehler 1010 tritt auf, wenn BigBlueButton beim Aufbau einer Audio- oder Videoverbindung keine funktionierende Netzwerkverbindung zwischen Ihrem Browser und dem Server herstellen kann – obwohl der Prozess gestartet wurde, läuft die zulässige Zeitspanne ab, bevor ein Verbindungsweg gefunden wird. Technisch gesehen handelt es sich um ein Timeout während der ICE-Aushandlung (Interactive Connectivity Establishment), einem Standardverfahren, das WebRTC-Verbindungen nutzen, um den optimalen Übertragungsweg zu ermitteln.

Wie äußert sich der Fehler?

Der Fehler erscheint als Fehlermeldung in BigBlueButton, wenn Sie versuchen, dem Meeting mit Mikrofon oder Kamera beizutreten. Statt einer erfolgreichen Verbindung erhalten Sie einen Hinweis auf Fehlercode 1010. Die Fehlermeldung kann auch als allgemeine Zeitüberschreitungsmeldung erscheinen (z. B. „There was a timeout in the request”). Im Gegensatz zu Fehler 1007, bei dem die ICE-Aushandlung sofort scheitert, läuft beim Fehler 1010 der Aushandlungsprozess an – er kommt jedoch innerhalb von etwa 15 Sekunden zu keinem Ergebnis und wird dann abgebrochen.

Mögliche Ursachen

ICE (Interactive Connectivity Establishment) ist ein Verfahren, bei dem Browser und Server Kandidaten für Netzwerkverbindungen sammeln und dann gegenseitig testen, bis ein funktionierendes Paar gefunden wird. Fehler 1010 bedeutet, dass diese Testphase nicht rechtzeitig erfolgreich abgeschlossen werden konnte.

• Aktives VPN oder mehrere Netzwerkschnittstellen: Wenn auf Ihrem Gerät gleichzeitig eine VPN-Verbindung und ein WLAN oder LAN aktiv sind, werden Verbindungskandidaten über alle Schnittstellen geprüft. Kandidaten über die VPN-Adresse schlagen langsam fehl und blockieren dabei das gesamte Zeitfenster, bevor ein gültiger Weg gefunden wird.
• Restriktive Firewall ohne TURN-Server: Unternehmensfirewalls, die ausgehenden UDP-Traffic blockieren, lassen keine direkten WebRTC-Verbindungen zu. Ohne einen TURN-Server, der als TCP-Relay auf Port 443 fungiert, laufen alle Verbindungsversuche in eine Zeitüberschreitung.
• Firefox-Inkompatibilität mit ICE-lite: Firefox weist einen bekannten Fehler im Zusammenspiel mit ICE-lite-Implementierungen auf, wie sie FreeSWITCH und mediasoup verwenden. Da ein ICE-lite-Peer keine eigenen Verbindungstests initiiert, wartet Firefox vergeblich – bis das Timeout greift.
• Falsch konfigurierte Server-IP (NAT): Wenn der BBB-Server seine öffentliche IP-Adresse nicht korrekt an den Client meldet, schlagen alle Verbindungstests zum Server still fehl.
• Fehlende Firewall-Freigaben auf dem Server: Sind die UDP-Ports 16384–32768 auf dem Server nicht erreichbar, können keine direkten WebRTC-Verbindungen aufgebaut werden.
• Überlasteter oder degradierter TURN-Server: Nach langer Laufzeit kann coturn (der BBB-TURN-Server) durch Ressourcenlecks in einen Zustand geraten, in dem Relay-Verbindungen still fehlschlagen (ab BBB 2.6).

Lösungen

Für Teilnehmer

1. VPN vorübergehend deaktivieren: Trennen Sie die VPN-Verbindung und versuchen Sie erneut, dem Meeting beizutreten. Falls das Meeting über VPN zugänglich sein muss, wenden Sie sich an Ihren Administrator.
2. Browser wechseln: Bei Firefox-spezifischen Problemen hilft oft ein Wechsel zu Google Chrome oder Microsoft Edge, da diese Browser die ICE-Aushandlung zuverlässiger durchführen.
3. Seite neu laden: Laden Sie die BBB-Sitzung vollständig neu (F5 oder Strg+R) und versuchen Sie erneut, dem Audio beizutreten.
4. Netzwerk wechseln: Wechseln Sie, wenn möglich, von WLAN auf eine Kabelverbindung oder umgekehrt. Versuchen Sie es auch über ein mobiles Datennetz (Hotspot), um eine restriktive Unternehmensfirewall zu umgehen.
5. Anderen Browser oder Gerät testen: Testen Sie mit einem anderen Gerät im gleichen Netzwerk, um zu prüfen, ob das Problem gerätespezifisch ist.

Für Administratoren

1. TURN-Server einrichten: Ein korrekt konfigurierter coturn-Server ist die wichtigste Maßnahme gegen Fehler 1010. Stellen Sie sicher, dass coturn auf Port 3478/UDP und 443/TCP+UDP erreichbar ist. Weitere Details zur Einrichtung finden Sie in der Dokumentation zu Fehler 1007.
2. Öffentliche IP in FreeSWITCH setzen: Prüfen Sie, ob external_rtp_ip und external_sip_ip in /opt/freeswitch/conf/vars.xml auf die öffentliche IP-Adresse des Servers zeigen.
3. Firefox-Kompatibilität mit forceRelayOnFirefox aktivieren (BBB 2.5+): Erzwingen Sie für Firefox-Verbindungen die Nutzung des TURN-Relays. Bearbeiten Sie /etc/bigbluebutton/bbb-html5.yml:

public:
  media:
    forceRelayOnFirefox: true

4. retryThroughRelay aktivieren (BBB 2.7+): Ermöglicht automatischen Fallback auf TURN, wenn die direkte Verbindung scheitert. In /etc/bigbluebutton/bbb-html5.yml:

public:
  media:
    retryThroughRelay: true

5. Firewall-Ports öffnen: Stellen Sie sicher, dass die UDP-Ports für WebRTC freigegeben sind:

sudo ufw allow 16384:32768/udp
sudo ufw allow 3478/udp
sudo ufw allow 443/tcp && sudo ufw allow 443/udp

6. coturn neu starten bei Degradierung (BBB 2.6+): Wenn Fehler 1010 nach längerer Serverlaufzeit plötzlich häufiger auftreten, kann ein Neustart von coturn helfen:

sudo systemctl restart coturn

7. Mediasoup externe IP konfigurieren (BBB 2.5+): Prüfen Sie, ob in /etc/bigbluebutton/bbb-webrtc-sfu/production.yml die announcedIp auf die korrekte öffentliche IP-Adresse gesetzt ist. Anschließend BBB neu starten mit sudo bbb-conf --restart.

Weitere Informationen

Fehler 1010 ist eng verwandt mit Fehler 1007 (ICE-Verbindung fehlgeschlagen) – der Hauptunterschied ist, dass 1010 ein Timeout darstellt (der ICE-Status verbleibt in „checking”), während 1007 einen expliziten Fehlschlag signalisiert (ICE-Status wechselt zu „failed”). Beide Fehler haben ähnliche Ursachen und Lösungsansätze. Auf BBB-Versionen 2.6 und neuer, auf denen coturn standardmäßig installiert ist und forceRelayOnFirefox automatisch erkannt wird, tritt Fehler 1010 deutlich seltener auf.