Netzwerkanforderungen und Firewall-Einstellungen

Wann brauchst du das?

Die meisten Heim- und Kleinbüro-Netzwerke funktionieren mit Screenbird ohne weitere Konfiguration. Diesen Artikel brauchst du nur, wenn dein Netzwerk:

  • Eine strenge Firewall hat, die unbekannte Domains blockiert
  • Einen Webfilter oder Proxy nutzt, der ausgehenden Traffic einschränkt
  • Ein separates VLAN für Displays ohne Internetzugang hat

Erforderliche Domains

Füge diese Domains zur Whitelist hinzu, sowohl für das Dashboard (genutzt von den Personen, die Inhalte verwalten) als auch für den Player (läuft auf dem Bildschirm).

Dashboard-Domains

  • screenbird.app: Hauptanwendung
  • dev.screenbird.app: Staging (nur nötig, wenn dein Team Staging nutzt)
  • api.screenbird.app: Geräte-API
  • *.supabase.co: Datenbank und Authentifizierung
  • cdn.screenbird.app: statische Assets und Inhalte
  • media.screenbird.app: Bilder und Videos

Player-Domains

  • player.screenbird.app: Player-Anwendung
  • cdn.screenbird.app: Inhaltsauslieferung
  • *.supabase.co: Verbindung zu deinem Konto
  • api.screenbird.app: Heartbeat und Inhaltssynchronisation

Optionale Domains (von einigen Apps und Integrationen genutzt)

  • apis.google.com: Google Slides, Sheets, Docs Picker
  • *.googleusercontent.com: Google Drive Thumbnails
  • images.pexels.com: Pexels-Bildbibliothek
  • api.qrserver.com: QR-Codes in Templates
  • geocoding-api.open-meteo.com: Standortvervollständigung in der Wetter-App
  • challenges.cloudflare.com: Cloudflare Turnstile (genutzt bei Registrierung und Kontaktformularen)

Wenn du eine bestimmte Integration nicht nutzt, musst du ihre Domain nicht freischalten.

Erforderliche Ports

  • HTTPS (443): Die gesamte Kommunikation läuft über HTTPS auf Port 443.
  • WebSocket (443): Echtzeitkommunikation läuft ebenfalls über Port 443.

Screenbird nutzt keine nicht-standardisierten Ports.

Erforderliche Protokolle

  • HTTPS für den gesamten Traffic
  • WebSocket Secure (WSS) für Echtzeit-Updates vom Dashboard zum Player

Bandbreitenanforderungen

  • Player im Leerlauf: unter 10 KB pro Minute (nur Heartbeat)
  • Player spielt statische Bilder ab: minimal, sobald der Inhalt heruntergeladen ist
  • Player spielt 1080p-Video ab: Initialer Download abhängig von der Dateigröße, danach 0 Traffic während der Wiedergabe (Videos werden lokal zwischengespeichert)
  • Player spielt Live-Streams (YouTube, RSS) ab: abhängig vom Stream

Für die meisten Signage-Netzwerke reichen 5 Mbit/s Download mehr als aus, pro Bildschirm. Screenbird ist so konzipiert, dass es offline funktioniert, sobald die Inhalte heruntergeladen sind, sodass kurze Netzausfälle die Wiedergabe nicht unterbrechen.

Dein Netzwerk testen

Um zu prüfen, ob ein Bildschirm Screenbird erreichen kann, öffne einen Browser auf dem Gerät und gehe zu:

  • https://player.screenbird.app: sollte den Player-Login-Bildschirm laden
  • https://screenbird.app: sollte die Dashboard-Login-Seite laden

Wenn eines davon fehlschlägt, prüfe in den Firewall-Logs nach blockierten Anfragen an die oben aufgeführten Domains.

Brauchst du Hilfe beim Enterprise-Rollout?

Wenn du viele Bildschirme hinter Unternehmensnetzwerken ausrollst und Hilfe bei Whitelist-Dokumentation, IT-Validierung oder Proxy-Konfiguration brauchst, kontaktiere uns unter support@screenbird.app, und wir helfen dir.

© screenbird.app