Netzwerk & Firewall – Verbindungsprobleme lösen

Erfahren Sie, welche Netzwerkanforderungen LemonScore hat, welche Ports freigegeben sein müssen und wie Sie häufige Verbindungsprobleme lösen.

LemonScore nutzt das lokale Netzwerk (LAN) für die Kommunikation zwischen Desktop-App, Fernsteuerung, Mobile App und externen Integrationen. Auf dieser Seite erfahren Sie, welche Netzwerk & Firewall-Einstellungen für einen reibungslosen Betrieb nötig sind.

💡

Alle Geräte müssen sich im selben lokalen Netzwerk (WLAN oder LAN) befinden. LemonScore funktioniert nicht über das Internet.

Benötigte Ports

PortDienstBeschreibung
4000Remote ServerFernsteuerung, Mobile App, Web Remote
4001API ServerREST-API, WebSocket, Stream Deck
5353mDNS (UDP)Automatische Erkennung der Desktop-App im Netzwerk

Stellen Sie sicher, dass diese Ports in der Firewall Ihres Betriebssystems und in allfälligen Netzwerk-Firewalls freigegeben sind.

Automatische Erkennung (mDNS)

Die Mobile App erkennt LemonScore-Instanzen automatisch über mDNS (Bonjour). Dabei wird der Dienst _lemonscore._tcp im lokalen Netzwerk gesucht. Die Erkennung dauert bis zu 10 Sekunden.

Falls die automatische Erkennung nicht funktioniert, können Sie die IP-Adresse des LemonScore-Rechners manuell eingeben.

Firewall konfigurieren

macOS

macOS fragt beim ersten Start von LemonScore, ob eingehende Verbindungen zugelassen werden sollen. Klicken Sie auf Erlauben. Falls Sie den Dialog verpasst haben:

  1. Öffnen Sie Systemeinstellungen → Netzwerk → Firewall.
  2. Klicken Sie auf Optionen.
  3. Fügen Sie LemonScore zur Liste der erlaubten Apps hinzu.

Windows

  1. Öffnen Sie Windows-Sicherheit → Firewall & Netzwerkschutz.
  2. Klicken Sie auf App durch Firewall zulassen.
  3. Fügen Sie LemonScore für Private Netzwerke hinzu.

Häufige Probleme

Mobile App findet den Server nicht

  • Prüfen Sie, ob beide Geräte im selben WLAN sind.
  • Deaktivieren Sie «Client-Isolation» oder «AP Isolation» im Router — diese Funktion verhindert die Kommunikation zwischen WLAN-Geräten.
  • Geben Sie die IP-Adresse manuell ein, falls mDNS blockiert ist.

Web Remote lädt nicht

  • Öffnen Sie http://<IP-Adresse>:4000 im Browser des Mobilgeräts.
  • Stellen Sie sicher, dass Port 4000 in der Firewall freigegeben ist.
  • Verwenden Sie http:// (nicht https://).

API-Verbindung fehlgeschlagen

  • Prüfen Sie, ob die API unter Einstellungen → Verbindungen aktiviert ist.
  • Stellen Sie sicher, dass Port 4001 erreichbar ist.
  • Testen Sie die Verbindung mit http://<IP-Adresse>:4001/api/v1/health.

Tipps und Hinweise

  • IP-Adresse finden — Die IP-Adresse des LemonScore-Rechners wird unter Einstellungen → Verbindungen angezeigt.
  • Feste IP vergeben — Vergeben Sie dem LemonScore-Rechner eine feste IP-Adresse im Router, damit sich die Adresse nicht bei jedem Neustart ändert.
  • Gastnetzwerk vermeiden — Gastnetzwerke isolieren Geräte voneinander. Verwenden Sie das reguläre Netzwerk.
⚠️

Öffentliche Netzwerke (Hotels, Stadion-WLAN) blockieren häufig die Kommunikation zwischen Geräten. Verwenden Sie ein eigenes, privates Netzwerk für den Livebetrieb.