Erste Schritte: IT-Administrator

Diese Anleitung behandelt die technische Einrichtung von HandyCafe. Am Ende haben Sie den Server und die Clients installiert, das Netzwerk konfiguriert, App-Menüs erstellt und die Fernverwaltung getestet.

Zeitaufwand: 5 Minuten (plus Zeit für die Client-Bereitstellung)

Schritt 1: Installieren Sie den Server und die Clients

Serverinstallation:

1. Überprüfen Sie, ob Ihr Server-PC die Systemanforderungen erfüllt.
2. Laden Sie HandyCafe Server auf Ihren Verwaltungs-PC herunter und installieren Sie es.
3. Starten Sie den Server und schließen Sie den Ersteinrichtungsassistenten ab, um das Admin-Konto zu erstellen.
4. Notieren Sie sich die lokale IP-Adresse des Server-PCs. Die Clients benötigen diese zur Verbindung.

Clientinstallation (für jeden PC wiederholen):

1. Laden Sie HandyCafe Client auf jedem kundenorientierten PC herunter.
2. Installieren und starten Sie den Client.
3. Der Client sucht über mDNS-Erkennung im lokalen Netzwerk nach dem Server.
4. Wenn der Server nicht automatisch gefunden wird, geben Sie die Server-IP-Adresse manuell in den Client-Einstellungen ein.
5. Sobald die Verbindung hergestellt ist, erscheint der Client im Admin-Panel des Servers.

Tipp: Verwenden Sie die Auto-Benennungsfunktion des Servers (Einstellungen > Clients), um Clients automatisch mit einem Präfix wie "PC #1", "PC #2" usw. zu benennen. Sie können die Anzeigenamen später anpassen.

Siehe Serverinstallation und Clientinstallation für detaillierte Schritte.

Schritt 2: Konfigurieren Sie die Netzwerkeinstellungen

Navigieren Sie zu Einstellungen > Netzwerk auf dem Server.

HandyCafe verwendet vier Ports für die Kommunikation:

Konfiguration:

1. Legen Sie die Ports fest (Standardeinstellungen funktionieren für die meisten Setups).
2. Legen Sie den Verbindungsschlüssel fest. Dies ist ein gemeinsames Geheimnis für die HMAC-SHA256-Authentifizierung. Alle Clients müssen denselben Schlüssel verwenden.
3. Klicken Sie auf Speichern.

Firewall-Regeln:

Stellen Sie sicher, dass diese Ports sowohl auf dem Server als auch auf den Client-PCs geöffnet sind:

• TCP: 5001, 5002, 5003 (eingehend auf dem Server, ausgehend auf den Clients)
• UDP: 5004 (bidirektional für Bildschirm-Streaming)

Wichtig: Alle PCs müssen sich im selben lokalen Netzwerk (Subnetz) befinden. HandyCafe verwendet mDNS zur Client-Erkennung, was LAN-Konnektivität erfordert.

Siehe Netzwerkeinstellungen für alle Netzwerkoptionen.

Schritt 3: Richten Sie das Client-Menü ein

Das Client-Menü ist der App-Launcher, den Kunden auf ihrem Desktop sehen. Navigieren Sie zu Einstellungen > Clients > Inhalt-Tab.

1. Kategorien erstellen. Gruppieren Sie Apps nach Typ (z.B. Spiele, Browser, Soziale Medien, Tools).
2. Apps hinzufügen zu jeder Kategorie:
   • Legen Sie den App-Namen und die Beschreibung fest.
   • Wählen Sie die App-Art: Spiel, Browser, Link, Datei oder App.
   • Legen Sie den ausführbaren Pfad oder die Start-URI fest.
   • Laden Sie ein Icon und optional ein Posterbild für die App-Karte hoch.
3. Kategorien und Apps neu anordnen mit Drag-and-Drop.
4. Sichtbarkeit umschalten, um Elemente anzuzeigen oder zu verbergen.
5. Klicken Sie auf Speichern.

Änderungen werden in Echtzeit automatisch über TCP an alle verbundenen Clients übertragen.

Tipp: Verwenden Sie die IGDB-Integration, um Spieledaten und Icons automatisch zu suchen.

Siehe Client-Menü für die vollständige Dokumentation des Menüerstellers.

Schritt 4: Konfigurieren Sie den Leerlaufbildschirm und das Erscheinungsbild

Leerlaufbildschirm (Einstellungen > Clients > Leerlaufbildschirm-Tab):

Der Leerlaufbildschirm ist das, was Kunden sehen, wenn keine Sitzung aktiv ist (der Sperrbildschirm).

1. Aktivieren Sie die Diashow für den Leerlaufbildschirm.
2. Fügen Sie Bilder oder Videos hinzu (PNG, JPG, WebP, GIF, MP4, WebM).
3. Legen Sie die Dauer pro Element und den Übergangseffekt fest (verblassen, gleiten, zoomen).
4. Optional können Sie eine Uhr-Überlagerung und die Anzeige des Cafénamens mit benutzerdefinierten Farben aktivieren.
5. Klicken Sie auf Speichern.

Erscheinungsbild (Einstellungen > Clients > Erscheinungsbild-Tab):

Konfigurieren Sie das Aussehen des Online-Desktops, den Kunden während der Sitzungen verwenden.

1. Wählen Sie ein Thema: Neon Arena, Crimson Pulse oder Emerald Depth.
2. Wählen Sie ein Layout-Preset: Split Classic, Hero Wide Top, Catalog Wide Bottom oder Compact Focus.
3. Konfigurieren Sie den Hintergrund: Volltonfarbe, Verlauf, Bild oder Video mit Überlagerungs- und Unschärfe-Einstellungen.
4. Passen Sie die Kartendichte (Groß, Mittel, Kompakt) und die Hover-Effekte an.
5. Klicken Sie auf Speichern.

Siehe Client-Leerlaufbildschirm und Client-Erscheinungsbild für alle Optionen.

Schritt 5: Testen Sie Remote Desktop und Screenshots

Überprüfen Sie, ob die Fernverwaltung funktioniert:

Screenshots:

1. Wählen Sie im Admin-Panel eine beliebige Online-Client-Karte aus.
2. Klicken Sie auf Screenshot auf der Client-Karte.
3. Ein Screenshot des Client-Bildschirms erscheint im Viewer.
4. Sie können den Screenshot herunterladen oder aktualisieren.

Remote Desktop:

1. Wählen Sie eine Online-Client-Karte aus und klicken Sie auf Remote Desktop.
2. Ein Remote-Desktop-Fenster öffnet sich mit Live-H.264-Streaming.
3. Sie können die Maus und Tastatur auf dem Remote-PC steuern.
4. Die Zwischenablage-Synchronisation funktioniert zwischen Server und Client.

Hinweis: Remote Desktop verwendet UDP-Streaming. Wenn das Video verzögert ist, überprüfen Sie Ihre Netzwerkbandbreite und stellen Sie sicher, dass der UDP-Port 5004 nicht blockiert ist. Sie können auch die Bitrate in den Stream-Einstellungen anpassen (350-25.000 kbps).

Siehe Remote Desktop und Screenshots für alle Fernfunktionen.

Überblick über die Netzwerkarchitektur

Server-PC (Verwaltung)
    |
    |--- TCP (5001) --- Befehl/Antwort (bincode + HMAC-SHA256)
    |--- TCP (5002) --- Dateitransfers
    |--- TCP (5003) --- Fernverwaltungssteuerung
    |--- UDP (5004) --- Bildschirm-Streaming (H.264)
    |--- mDNS ------- Client-Erkennung (automatisch)
    |
    +-- Client-PC 1
    +-- Client-PC 2
    +-- Client-PC 3
    +-- ...

Was als Nächstes zu tun ist

• Dateisynchronisation: Dateien und Konfigurationen auf Client-PCs bereitstellen
• Netzwerküberwachung: Bandbreite und Verbindungsstatus überwachen
• Softwarelizenzen: Gleichzeitige Softwarelizenzen auf PCs verfolgen
• OAuth-Login: Soziales Login für Kunden einrichten