bbb-hilfe.de

Deutsche Hilfeseite

Fehler 1108: ICE-Verbindungsfehler bei der Bildschirmfreigabe

Start  /  Docs  /  Fehler 1108: ICE-Verbindungsfehler bei der Bildschirmfreigabe
bbbserver.de ausprobieren
Print

Fehler 1108 tritt auf, wenn die WebRTC-ICE-Verbindung für die Bildschirmfreigabe aufgebaut werden konnte, aber anschließend in den Zustand „failed” wechselt. BigBlueButton zeigt dann die Meldung „Code 1108. Could not share the screen.” an. Der Fehler betrifft ausschließlich die Bildschirmfreigabe – Audio, Webcam und Chat können dabei weiterhin funktionieren, da jede Medienart eine eigene WebRTC-Verbindung verwendet.

Wie äußert sich der Fehler?

Sobald ein Präsentator die Bildschirmfreigabe startet, bricht die Übertragung kurz nach dem Verbindungsaufbau ab. Im BBB-Interface erscheint eine Fehlermeldung mit dem Code 1108. Das geteilte Bild ist für alle Teilnehmer sofort nicht mehr sichtbar. Ein erneuter Versuch scheitert in der Regel ebenfalls, solange die Ursache nicht behoben wurde – 1108 gilt als fataler, nicht automatisch behebbarer Fehler.

Mögliche Ursachen

  • Falsche oder fehlende HTTPS-Konfiguration: Browser erlauben den Zugriff auf getDisplayMedia() (die Bildschirmfreigabe-API) nur über gesicherte HTTPS-Verbindungen mit gültigem Zertifikat. Ist das Zertifikat abgelaufen oder fehlt es, schlägt der ICE-Aufbau bereits vor dem ersten Paket fehl.
  • Falsche announcedIp-Einstellung in mediasoup (ab BBB 2.5): Auf Cloud- und NAT-Servern muss die öffentliche IP-Adresse explizit in der mediasoup-Konfiguration hinterlegt sein. Fehlt sie oder verweist sie noch auf 127.0.0.1, findet kein ICE-Kandidatenaustausch statt.
  • Firewall blockiert UDP-Ports 16384–32768: WebRTC-Medienströme laufen über diesen UDP-Portbereich. Unternehmens-Firewalls oder Heimrouter mit restriktiven Einstellungen blockieren ihn häufig vollständig.
  • Kein TURN-Server konfiguriert: Befinden sich Teilnehmer hinter einem symmetrischen NAT oder einem HTTPS-only-Unternehmensproxy, ist ein TURN-Server zwingend erforderlich, um eine Verbindung herzustellen.
  • Firefox-Inkompatibilität mit mediasoup (ICE-lite): Ab Firefox 92 verwendet Firefox ein aggressives ICE-Nominierungsverfahren, das mit dem ICE-lite-Modus von mediasoup kollidiert. Dieser Fehler tritt typischerweise nur in Firefox auf, während Chrome oder Edge problemlos funktionieren.
  • IP-Adresse des Servers hat sich geändert: Nach einem Cloud-Instanz-Neustart kann sich die öffentliche IP ändern, ohne dass die BBB-Konfiguration aktualisiert wurde.

Lösungen

Für Teilnehmer und Präsentatoren

  1. Browser wechseln: Verwenden Sie Google Chrome oder Microsoft Edge für die Bildschirmfreigabe. Firefox kann unter bestimmten Netzwerkbedingungen Fehler 1108 verursachen, der in Chrome nicht auftritt.
  2. Seite neu laden und erneut versuchen: Laden Sie die BBB-Sitzung im Browser komplett neu (F5 oder Strg+Shift+R) und starten Sie die Bildschirmfreigabe erneut. Gelegentlich liegt ein vorübergehender Verbindungsabbruch vor.
  3. VPN oder Proxy prüfen: Deaktivieren Sie vorübergehend ein aktives VPN oder einen Proxy. Diese leiten Datenverkehr um und können die UDP-Ports blockieren, die WebRTC benötigt.
  4. Netzwerk wechseln: Wechseln Sie von einem Unternehmensnetzwerk in ein Heimnetzwerk oder einen mobilen Hotspot. So lässt sich feststellen, ob eine restriktive Firewall die Ursache ist.

Für Administratoren

  1. HTTPS-Konfiguration und Zertifikat prüfen: Stellen Sie sicher, dass das TLS-Zertifikat gültig ist und nginx korrekt konfiguriert ist.
sudo bbb-conf --check | grep -i "ssl\|cert\|https"
sudo nginx -t
echo | openssl s_client -connect yourdomain.com:443 2>/dev/null | openssl x509 -noout -dates

Bei Verwendung von Let’s Encrypt:

sudo certbot renew --dry-run
  1. announcedIp in mediasoup korrigieren (ab BBB 2.5): Überprüfen und korrigieren Sie den Wert in der Konfigurationsdatei.
cat /etc/bigbluebutton/bbb-webrtc-sfu/production.yml

Der Wert bei announcedIp muss die öffentlich erreichbare IP-Adresse des Servers enthalten, nicht 127.0.0.1.

  1. BBB nach IP- oder Domainänderung neu konfigurieren:
sudo bbb-conf --setip yourdomain.com
sudo bbb-conf --restart
  1. Firefox-Kompatibilitätsoption aktivieren: Bearbeiten Sie /etc/bigbluebutton/bbb-html5.yml und fügen Sie folgendes ein:
public:
  kurento:
    forceRelayOnFirefox: true

Anschließend BBB neu starten: sudo bbb-conf --restart. Diese Einstellung ist die einzige serverseitige Lösung für den Firefox-ICE-lite-Bug.

  1. Firewall-Ports öffnen: Sowohl UDP als auch TCP im Portbereich 16384–32768 müssen erreichbar sein.
sudo ufw allow proto udp from any to any port 16384:32768
sudo ufw allow proto tcp from any to any port 16384:32768
  1. TURN-Server mit TCP/443 konfigurieren: Besonders in Umgebungen mit HTTPS-only-Proxy ist TURN über TCP-Port 443 entscheidend. Tragen Sie den TURN-Server in /etc/bigbluebutton/turn-stun-servers.xml ein.
  2. Logs auf Hinweise prüfen:
sudo journalctl -u bbb-webrtc-sfu --since "10 minutes ago" | grep -i "screenshare\|deskshare\|ice\|error\|fail"

Weitere Informationen

Fehler 1108 ist das Bildschirmfreigabe-Pendant zu Fehler 1107 (ICE-Verbindungsfehler bei der Webcam). Beide Fehler haben ähnliche Ursachen und Lösungen, da beide den gleichen mediasoup-Backend-Dienst verwenden. Wenn sowohl Webcam (1107) als auch Bildschirmfreigabe (1108) fehlschlagen, liegt die Ursache in der Regel in der Server- oder Netzwerkkonfiguration – insbesondere bei falscher announcedIp oder fehlenden Firewall-Freigaben. Tritt nur Fehler 1108 auf, ist die HTTPS-Konfiguration oder der Firefox-ICE-lite-Bug die wahrscheinlichste Ursache.

Mobiler Hinweis auf bbbserver.de