bbb-hilfe.de

Deutsche Hilfeseite

Fehler 1011: ICE-Kandidatensammlung hat Zeitüberschreitung

Start  /  Docs  /  Fehler 1011: ICE-Kandidatensammlung hat Zeitüberschreitung
bbbserver.de ausprobieren
Print

Fehler 1011 tritt auf, wenn der Browser die sogenannte ICE-Kandidatensammlung (ICE Gathering) nicht rechtzeitig abschließen kann. ICE (Interactive Connectivity Establishment) ist das Verfahren, mit dem Browser und Server geeignete Netzwerkpfade für die Audio- und Videoübertragung aushandeln. Schlägt diese Vorbereitungsphase fehl, kommt keine Verbindung zustande – unabhängig davon, ob die eigentliche Netzwerkverbindung prinzipiell möglich wäre.

Wie äußert sich der Fehler?

Beim Versuch, einem BigBlueButton-Meeting beizutreten, bleibt der Browser im Zustand „Verbinde…” hängen. Nach Ablauf eines internen Zeitlimits erscheint eine Fehlermeldung mit dem Code 1011. Das Mikrofon und die Audioverbindung bleiben inaktiv. Häufig ist der Fehler auf bestimmte Browser (insbesondere Firefox) oder bestimmte Netzwerkkonfigurationen beschränkt, während andere Teilnehmer problemlos beitreten können.

Mögliche Ursachen

  • Firefox mit IPv6-Adresse und TURN-Server ohne IPv6-Unterstützung (häufigste Ursache): Firefox sammelt IPv6-Kandidaten und sendet eine TURN-Anfrage für die IPv6-Adresse. Unterstützt der TURN-Server kein IPv6, bleibt diese Anfrage unbeantwortet – die Sammlung hängt dauerhaft.
  • TURN-Server nicht erreichbar: Der TURN-Server ist ausgefallen, falsch konfiguriert oder durch eine Firewall blockiert, sodass Verbindungsanfragen nicht ankommen.
  • Ungültiges TLS-Zertifikat am TURN-Server: Ein abgelaufenes oder nicht vertrauenswürdiges Zertifikat verhindert den Verbindungsaufbau über TURNS (TLS), ohne eine klare Fehlermeldung zu erzeugen.
  • IPv6 in mediasoup nicht konfiguriert (BBB 2.5+): Der Server läuft in einer Dual-Stack-Umgebung, aber in der Datei production.yml fehlt ein IPv6-Eintrag für listenIps.
  • Ausgehende Ports gesperrt: Firewalls in Firmennetzwerken blockieren die für STUN/TURN benötigten Ports (3478 oder 443 ausgehend).

Lösungen

Für Teilnehmer

  1. Anderen Browser verwenden: Wechseln Sie von Firefox zu Google Chrome oder Microsoft Edge. Der Fehler tritt bei Firefox in IPv6-Umgebungen deutlich häufiger auf als bei Chromium-basierten Browsern.
  2. VPN deaktivieren: Ein aktives VPN kann die ICE-Kandidatensammlung stören. Deaktivieren Sie das VPN und versuchen Sie es erneut.
  3. Netzwerk wechseln: Versuchen Sie die Verbindung über ein anderes Netzwerk, z. B. über das Mobilfunknetz (Hotspot). So lässt sich prüfen, ob eine Firewall im Firmennetzwerk die Ursache ist.
  4. Seite neu laden: Laden Sie die Seite vollständig neu (Strg+Umschalt+R bzw. Cmd+Shift+R) und versuchen Sie erneut, dem Meeting beizutreten.
  5. Firefox-Test: Nur Relay-Kandidaten erzwingen: Rufen Sie in Firefox about:config auf, suchen Sie nach media.peerconnection.ice.relay_only und setzen Sie den Wert auf true. Wenn das Meeting danach funktioniert, liegt das Problem am TURN-Server oder der IPv6-Konfiguration des Servers.

Für Administratoren

  1. Firefox-Relay erzwingen (schnellste Abhilfe): Tragen Sie in /etc/bigbluebutton/bbb-html5.yml folgendes ein, um Firefox-Clients auf TURN-Relay-Kandidaten zu beschränken und den IPv6-Gathering-Hänger zu umgehen:
public:
  media:
    forceRelayOnFirefox: true
sudo systemctl restart bbb-html5

Hinweis: Ab BBB 2.6 wird diese Einstellung automatisch aktiviert, wenn ein TURN-Server vorhanden ist.

  1. IPv6-Unterstützung in coturn aktivieren: Ergänzen Sie in /etc/turnserver.conf die IPv6-Listening-Adresse und starten Sie coturn neu:
listening-ip=0.0.0.0
listening-ip=::
sudo systemctl restart coturn
  1. IPv6 in mediasoup konfigurieren (BBB 2.5+): Falls der Server eine öffentliche IPv6-Adresse besitzt, tragen Sie diese in /etc/bigbluebutton/bbb-webrtc-sfu/production.yml ein:
mediasoup:
  webrtc:
    listenIps:
      - ip: "::"
        announcedIp: "IHRE_OEFFENTLICHE_IPv6"
      - ip: "0.0.0.0"
        announcedIp: "IHRE_OEFFENTLICHE_IPv4"
sudo bbb-conf --restart
  1. TURN-Server-Status prüfen: Überprüfen Sie, ob coturn läuft und die erforderlichen Ports gebunden sind:
sudo systemctl status coturn
sudo netstat -antp | grep -E ':443|:3478'
  1. TURN-Verbindung manuell testen: Mit dem Tool turnutils_uclient lässt sich eine TURN-Allocation direkt testen:
turnutils_uclient -T -p 443 -W IHR_SECRET turn.beispiel.de

Weitere Informationen

Fehler 1011 unterscheidet sich von Fehler 1010: Bei 1010 wurde die ICE-Kandidatensammlung erfolgreich abgeschlossen, aber die anschließenden Verbindungsprüfungen schlugen fehl. Bei 1011 kommt es dagegen gar nicht erst dazu – die Sammlung selbst bleibt unvollständig. Der Fehler wurde eingeführt, um das bisherige Verhalten eines dauerhaften „Verbinde…”-Bildschirms durch eine aussagekräftige Fehlermeldung zu ersetzen.

Mobiler Hinweis auf bbbserver.de