HandyCafe Docs
it-admin

Synchronizacja plików

Synchronizacja plików dystrybuuje pliki z serwera HandyCafe do komputerów klienckich w sieci. Użyj jej, aby przesyłać aktualizacje gier, pliki konfiguracyjne, instalatory oprogramowania i zasoby menu klienta bez konieczności odwiedzania każdej maszyny.

Wykorzystuje podejście oparte na manifestach, dzięki czemu tylko zmienione lub nowe pliki są przesyłane, co przyspiesza powtarzające się synchronizacje.

Strona znajduje się w Ustawienia > Synchronizacja plików.

Włącz synchronizację klienta

Przełącznik w prawym górnym rogu strony kontroluje całą funkcję. Gdy Włącz synchronizację klienta jest wyłączone, strona informuje, że synchronizacja klienta jest wstrzymana, a działania publikacji i usuwania są zablokowane. Włącz ją przed opublikowaniem czegokolwiek.

Publikowanie źródła synchronizacji

Sekcja Publikowanie źródła synchronizacji to miejsce, gdzie tworzona jest synchronizacja. Wymaga dwóch wartości:

Pole Co to jest
Ścieżka źródłowa Plik lub folder na serwerze, który chcesz dystrybuować. Użyj Wybierz plik lub Wybierz folder, aby go wybrać, lub wpisz ścieżkę bezpośrednio.
Ścieżka docelowa na klientach Absolutna ścieżka, gdzie zawartość musi trafić na każdym kliencie. To nie jest opcjonalne. Przykład: C:\Games\SteamLibrary\common\Game lub /opt/apps/game.

Ścieżka docelowa musi być poprawna na komputerach klienckich, a nie na serwerze. Jeśli twoi klienci przechowują gry na D:, a wpiszesz ścieżkę C:, synchronizacja trafi w niewłaściwe miejsce.

Wybierz Publikuj synchronizację, gdy oba pola są wypełnione. Zawartość jest serwowana klientom bezpośrednio ze ścieżki źródłowej. Serwer nie przechowuje drugiej kopii.

Jak działa synchronizacja

Porównanie oparte na manifestach

Gdy rozpoczyna się synchronizacja, serwer generuje manifest plików: listę każdego pliku do zsynchronizowania wraz z jego sumą kontrolną. Każdy klient porównuje ten manifest ze swoimi lokalnymi plikami.

  • Pliki, które nie istnieją na kliencie, są oznaczane do pobrania.
  • Pliki, których sumy kontrolne różnią się (co oznacza, że zostały zmodyfikowane), są oznaczane do pobrania.
  • Pliki, które pasują, są całkowicie pomijane.

Przesyłana jest tylko różnica między serwerem a klientem, co sprawia, że powtarzające się synchronizacje są szybkie.

Transfer oparty na fragmentach

Duże pliki są dzielone na mniejsze fragmenty do przesyłania przez TCP:

  • Niezawodność. Jeśli fragment się nie powiedzie, tylko ten fragment jest ponownie przesyłany, a nie cały plik.
  • Śledzenie postępu. Postęp transferu jest raportowany na poziomie fragmentów.
  • Efektywność sieci. Rozmiary fragmentów są dostosowane do typowych warunków LAN.

Transfery używają dedykowanego portu plików z Ustawień sieciowych, domyślnie 5002. Jeśli ten port jest zablokowany przez zaporę, żaden plik nie dotrze do klientów.

Zsynchronizowane foldery

Lista Zsynchronizowane foldery pokazuje jeden wiersz na ścieżkę docelową, każdy z najnowszym opublikowanym wydaniem. Wiersz raportuje liczbę wydań, liczbę plików i całkowity rozmiar. Użyj Odśwież, aby przeładować listę.

Wybierz wiersz, aby otworzyć jego szczegóły po prawej stronie. Panel szczegółów wymienia każdy wpis w tym źródle wraz z jego ścieżką, rodzajem (plik lub katalog), rozmiarem i sumą kontrolną, a także ścieżką źródłową, ścieżką docelową i czasem publikacji. Pole wyszukiwania filtruje wpisy według ścieżki względnej lub docelowej.

Usuwanie synchronizacji

Istnieją dwie różne akcje usuwania. Robią różne rzeczy:

  • Usuń zsynchronizowany folder usuwa ścieżkę docelową z listy synchronizacji. Twoje pliki źródłowe na serwerze nie są dotykane.
  • Usuń wpis usuwa element z oryginalnej ścieżki źródłowej na serwerze. Jest to trwałe i również przesyłane do klientów. HandyCafe prosi najpierw o potwierdzenie.

Obie akcje wymagają, aby Włącz synchronizację klienta było włączone.

Przypadki użycia

  • Wdrażanie aktualizacji gier. Przesyłaj poprawki gier do wszystkich komputerów do gier jednocześnie, aby każda maszyna działała na tej samej wersji.
  • Przesyłanie plików konfiguracyjnych. Dystrybuuj zaktualizowane ustawienia sieciowe lub preferencje aplikacji na wszystkich klientach.
  • Dystrybucja oprogramowania. Instaluj aplikacje na komputerach klienckich, synchronizując pakiety instalacyjne lub aplikacje przenośne.
  • Aktualizacja zasobów menu klienta. Synchronizuj nowe ikony, plakaty lub pliki multimedialne używane przez menu klienta.

Wskazówki

  • Planuj duże synchronizacje poza godzinami szczytu, aby aktywne sesje nie konkurowały o przepustowość.
  • Dokładnie sprawdź ścieżkę docelową przed publikowaniem. To najczęstsza przyczyna synchronizacji, która wydaje się zakończona sukcesem, ale nic nie pojawia się na kliencie.
  • Serwer i klienci muszą być w tej samej sieci LAN.

Powiązane strony