bbb-hilfe.de

Deutsche Hilfeseite

Fehler 1020: Mediadaten konnten den Server nicht erreichen

Home  /  Docs  /  Fehler 1020: Mediadaten konnten den Server nicht erreichen
bbbserver.de ausprobieren
Print

Fehlercode 1020 bedeutet, dass BigBlueButton zwar eine WebRTC-Verbindung aufgebaut hat, aber innerhalb von etwa 15 Sekunden keine Medienpakete (RTP) beim Server angekommen sind. Betroffen sind in der Regel Webcam und Bildschirmfreigabe – das Audio funktioniert häufig weiterhin, weil es über einen anderen Pfad (FreeSWITCH) übertragen wird. Der Fehler tritt also typischerweise auf, wenn Sie Ihre Kamera oder Ihren Bildschirm freigeben möchten und die Verbindung nach kurzer Wartezeit abbricht.

Wie äußert sich der Fehler?

Das häufigste Szenario: Sie sind mit Audio im Meeting und hören andere Teilnehmer problemlos. Sobald Sie jedoch Ihre Webcam aktivieren oder Ihren Bildschirm teilen, dreht sich kurz der Ladekreis – danach erscheint eine Fehlermeldung. Die Kamera- oder Freigabe-Schaltfläche springt wieder in den inaktiven Zustand zurück. Andere Teilnehmer sehen Ihren Video- oder Bildschirminhalt nie. In der Browser-Konsole ist häufig ein Eintrag mit dem Code 1020 oder dem Text „Media could not reach the server” sichtbar.

Mögliche Ursachen

  • Falsch konfigurierte öffentliche IP am Medienserver – Der BBB-Server (mediasoup ab BBB 2.5 bzw. Kurento bis BBB 2.4) gibt dem Browser eine nicht erreichbare IP-Adresse als ICE-Kandidaten. Pakete werden ins Leere geschickt.
  • Firewall blockiert UDP-Ports 16384–32768 – WebRTC-Video und Bildschirmfreigabe nutzen UDP in diesem Portbereich. Ist er gesperrt, erreichen die Medienpakete den Server nicht.
  • Kein TURN-Server vorhanden – Teilnehmer hinter symmetrischem NAT oder stark einschränkenden Unternehmens-Firewalls benötigen einen TURN-Server als Relay. Fehlt er, kommen keine Pakete an.
  • TURN-Server ausgefallen oder falsch konfiguriert – Abgelaufene Zertifikate, falsche Zugangsdaten oder Port-Konflikte verhindern das Relay.
  • Zu wenig Bandbreite – Eine sehr langsame Upload-Verbindung kann dazu führen, dass keine ausreichenden Medienpakete rechtzeitig eintreffen.
  • Veraltete iOS- oder Safari-Version – Vor iOS 14.3 bzw. Safari 14.0.2 bestehen bekannte WebRTC-Einschränkungen, die diesen Fehler auslösen können.

Lösungen

Für Teilnehmer

  1. Browser und Betriebssystem aktualisieren. Stellen Sie sicher, dass Sie einen aktuellen Chrome, Firefox oder Edge verwenden. Safari und iOS sollten mindestens Version 14.3 haben.
  2. VPN oder Proxy deaktivieren. Viele VPN-Clients blockieren oder verändern UDP-Verbindungen, was die Medienübertragung verhindert. Testen Sie die Verbindung ohne VPN.
  3. Netzwerk wechseln. Falls Sie sich in einem Firmennetz oder einem öffentlichen WLAN befinden, kann die dortige Firewall UDP sperren. Versuchen Sie es über Ihr Mobilfunknetz oder ein anderes WLAN.
  4. Browser-Cache und Cookies leeren und die Seite neu laden. Manchmal helfen veraltete Verbindungsdaten nicht weiter.
  5. Kameraberechtigung im Browser prüfen. Stellen Sie sicher, dass der Browser Zugriff auf Kamera und Mikrofon hat (Schloss-Symbol in der Adressleiste).

Für Administratoren

  1. announcedIp in mediasoup prüfen (BBB 2.5+). Der häufigste Grund für Fehler 1020 auf Cloud-Servern ist eine falsche oder fehlende öffentliche IP in der mediasoup-Konfiguration. Ermitteln und setzen Sie die korrekte öffentliche IP:
PUBLIC_IP=$(curl -s https://api.ipify.org)

yq w -i /etc/bigbluebutton/bbb-webrtc-sfu/production.yml \
    mediasoup.webrtc.listenIps[0].ip "0.0.0.0"
yq w -i /etc/bigbluebutton/bbb-webrtc-sfu/production.yml \
    mediasoup.webrtc.listenIps[0].announcedIp "$PUBLIC_IP"

sudo bbb-conf --restart
  1. externalIPv4 in Kurento setzen (BBB ≤ 2.4). Tragen Sie die öffentliche IP in /etc/kurento/modules/kurento/WebRtcEndpoint.conf.ini ein und starten Sie den Dienst neu:
externalIPv4=IHRE_ÖFFENTLICHE_IP
sudo systemctl restart kurento-media-server
sudo bbb-conf --restart
  1. UDP-Ports in der Firewall freigeben. WebRTC-Video benötigt UDP im Bereich 16384–32768:
sudo ufw allow 16384:32768/udp
sudo ufw allow 443/tcp
sudo ufw allow 443/udp
  1. TURN-Server einrichten. Falls Teilnehmer hinter restriktiven Firewalls sind, ist ein TURN-Server unerlässlich. Die Konfiguration erfolgt in /etc/bigbluebutton/turn-stun-servers.xml. Weitere Details finden Sie im Artikel zu Fehlercode 1007.
  2. Diagnose: BBB-Konfiguration prüfen. Mit den folgenden Befehlen können Sie den Zustand des Servers und des SFU-Dienstes prüfen:
sudo bbb-conf --check
sudo bbb-conf --status
sudo systemctl status bbb-webrtc-sfu
sudo journalctl -u bbb-webrtc-sfu -n 100

Weitere Informationen

Fehler 1020 ist eng verwandt mit anderen Verbindungsproblemen im Medienbereich. Falls dieser Artikel Ihr Problem nicht löst, können folgende Fehlercodes weitere Hinweise geben:

  • 1007 – Audio konnte den Server nicht erreichen (gleiche Grundursache, aber für den Audio-Pfad über FreeSWITCH)
  • 1107 / 1108 – ICE-Aushandlung für Webcam bzw. Bildschirmfreigabe fehlgeschlagen (Verbindungsaufbau scheitert bereits früher)
  • 2000 – Allgemeiner WebRTC-Fehler (wenn keine spezifischere Ursache ermittelt werden kann)
Mobiler Hinweis auf bbbserver.de