Dateisynchronisation

Die Dateisynchronisation verteilt Dateien vom HandyCafe-Server auf Client-PCs im Netzwerk. Nutzen Sie sie, um Spielupdates, Konfigurationsdateien, Software-Installer und Client-Menü-Assets zu übertragen, ohne jeden Rechner einzeln besuchen zu müssen.

Es wird ein manifestbasierter Ansatz verwendet, sodass nur geänderte oder neue Dateien übertragen werden, was wiederholte Synchronisierungen schnell hält.

Die Seite befindet sich unter Einstellungen > Dateisynchronisation.

Client-Synchronisation aktivieren

Ein Schalter oben rechts auf der Seite steuert die gesamte Funktion. Solange Client-Synchronisation aktivieren ausgeschaltet ist, meldet die Seite, dass die Client-Synchronisation pausiert ist und sowohl Veröffentlichungs- als auch Löschaktionen blockiert sind. Schalten Sie sie ein, bevor Sie etwas veröffentlichen.

Eine Sync-Quelle veröffentlichen

Der Abschnitt Sync-Quelle veröffentlichen ist der Ort, an dem eine Synchronisation erstellt wird. Er erfordert zwei Werte:

Feld	Beschreibung
Quellpfad	Die Datei oder der Ordner auf dem Server, den Sie verteilen möchten. Verwenden Sie Datei auswählen oder Ordner auswählen, um ihn auszuwählen, oder geben Sie den Pfad direkt ein.
Zielpfad auf Clients	Der absolute Pfad, an dem der Inhalt auf jedem Client landen muss. Dies ist nicht optional. Beispiel: `C:\Games\SteamLibrary\common\Game` oder `/opt/apps/game`.

Der Zielpfad muss auf den Client-Rechnern gültig sein, nicht auf dem Server. Wenn Ihre Clients ihre Spiele auf D: speichern und Sie einen C:-Pfad eingeben, landet die Synchronisation am falschen Ort.

Wählen Sie Sync veröffentlichen, sobald beide Felder ausgefüllt sind. Der Inhalt wird direkt vom Quellpfad an die Clients geliefert. Der Server behält keine zweite Kopie.

Wie die Synchronisation funktioniert

Manifestbasierter Vergleich

Wenn eine Synchronisation beginnt, generiert der Server ein Dateimanifest: eine Liste aller zu synchronisierenden Dateien zusammen mit ihrer Prüfsumme. Jeder Client vergleicht dieses Manifest mit seinen eigenen lokalen Dateien.

Dateien, die auf dem Client nicht existieren, werden zum Download markiert.
Dateien, deren Prüfsummen unterschiedlich sind (was bedeutet, dass sie geändert wurden), werden zum Download markiert.
Dateien, die übereinstimmen, werden vollständig übersprungen.

Nur das Delta zwischen Server und Client wird übertragen, was wiederholte Synchronisierungen schnell macht.

Chunk-basierte Übertragung

Große Dateien werden in kleinere Chunks für die Übertragung über TCP aufgeteilt:

Zuverlässigkeit. Wenn ein Chunk fehlschlägt, wird nur dieser Chunk erneut übertragen, nicht die gesamte Datei.
Fortschrittsverfolgung. Der Übertragungsfortschritt wird auf Chunk-Ebene gemeldet.
Netzwerkeffizienz. Chunk-Größen sind für typische LAN-Bedingungen optimiert.

Übertragungen verwenden den dedizierten Dateiport aus den Netzwerkeinstellungen, standardmäßig 5002. Wenn dieser Port durch eine Firewall blockiert ist, erreicht keine Datei die Clients.

Synchronisierte Ordner

Die Liste Synchronisierte Ordner zeigt eine Zeile pro Zielpfad, jeweils mit der neuesten veröffentlichten Version. Eine Zeile meldet die Anzahl der Veröffentlichungen, die Anzahl der Dateien und die Gesamtgröße. Verwenden Sie Aktualisieren, um die Liste neu zu laden.

Wählen Sie eine Zeile aus, um deren Details rechts zu öffnen. Das Detailfenster listet jeden Eintrag in dieser Quelle mit seinem Pfad, Typ (Datei oder Verzeichnis), Größe und Prüfsumme auf, zusammen mit dem Quellstammverzeichnis, dem Zielpfad und der Veröffentlichungszeit. Das Suchfeld filtert Einträge nach relativem oder Zielpfad.

Eine Synchronisation entfernen

Es gibt zwei verschiedene Löschaktionen. Sie bewirken unterschiedliche Dinge:

Synchronisierten Ordner entfernen nimmt den Zielpfad aus der Synchronisationsliste. Ihre Quelldateien auf dem Server werden nicht berührt.
Eintrag löschen entfernt ein Element aus dem ursprünglichen Quellpfad auf dem Server. Dies ist dauerhaft und wird auch an die Clients übertragen. HandyCafe fragt zuerst nach einer Bestätigung.

Beide Aktionen erfordern, dass Client-Synchronisation aktivieren eingeschaltet ist.

Anwendungsfälle

Bereitstellung von Spielupdates. Puschen Sie Spiel-Patches auf alle Gaming-PCs gleichzeitig, sodass jede Maschine die gleiche Version ausführt.
Verteilung von Konfigurationsdateien. Verteilen Sie aktualisierte Netzwerkeinstellungen oder Anwendungseinstellungen auf alle Clients.
Verteilung von Software. Installieren Sie Anwendungen auf Client-PCs, indem Sie Installationspakete oder portable Anwendungen synchronisieren.
Aktualisierung von Client-Menü-Assets. Synchronisieren Sie neue Symbole, Poster oder Mediendateien, die vom Client-Menü verwendet werden.

Tipps

Planen Sie große Synchronisierungen außerhalb der Stoßzeiten, damit aktive Sitzungen nicht um Bandbreite konkurrieren.
Überprüfen Sie den Zielpfad vor der Veröffentlichung doppelt. Er ist die häufigste Ursache für eine Synchronisation, die scheinbar erfolgreich ist, während nichts auf dem Client erscheint.
Der Server und die Clients müssen sich im selben LAN befinden.