HandyCafe Docs
it-admin

Sincronizzazione File

La Sincronizzazione File distribuisce file dal Server HandyCafe ai PC client attraverso la rete. Usala per inviare aggiornamenti di giochi, file di configurazione, installatori di software e risorse del menu client senza dover visitare ogni macchina.

Utilizza un approccio basato su manifest in modo che solo i file modificati o nuovi vengano trasferiti, mantenendo le sincronizzazioni ripetute rapide.

La pagina si trova in Impostazioni > Sincronizzazione File.

Abilitare la Sincronizzazione Client

Un interruttore in alto a destra della pagina controlla l'intera funzionalità. Quando Abilita Sincronizzazione Client è disattivato, la pagina segnala che la sincronizzazione client è in pausa e sia le azioni di pubblicazione che di eliminazione sono bloccate. Attivala prima di pubblicare qualsiasi cosa.

Pubblicare una Sorgente di Sincronizzazione

La sezione Pubblica Sorgente di Sincronizzazione è dove viene creata una sincronizzazione. Richiede due valori:

Campo Descrizione
Percorso Sorgente Il file o la cartella sul server che vuoi distribuire. Usa Seleziona File o Seleziona Cartella per sceglierlo, o digita direttamente il percorso.
Percorso Target sui Client Il percorso assoluto dove il contenuto deve arrivare su ogni client. Questo non è opzionale. Esempio: C:\Games\SteamLibrary\common\Game o /opt/apps/game.

Il percorso target deve essere valido sulle macchine client, non sul server. Se i tuoi client conservano i giochi su D: e inserisci un percorso C:, la sincronizzazione finirà nel posto sbagliato.

Seleziona Pubblica Sincronizzazione una volta che entrambi i campi sono compilati. Il contenuto viene servito ai client direttamente dal percorso sorgente. Il server non mantiene una seconda copia.

Come Funziona la Sincronizzazione

Confronto Basato su Manifest

Quando inizia una sincronizzazione, il server genera un manifest dei file: un elenco di ogni file da sincronizzare insieme al suo checksum. Ogni client confronta questo manifest con i propri file locali.

  • I file che non esistono sul client sono contrassegnati per il download.
  • I file i cui checksum differiscono (significa che sono stati modificati) sono contrassegnati per il download.
  • I file che corrispondono vengono completamente ignorati.

Solo la differenza tra server e client viene trasferita, il che rende rapide le sincronizzazioni ripetute.

Trasferimento Basato su Chunk

I file di grandi dimensioni sono suddivisi in chunk più piccoli per il trasferimento su TCP:

  • Affidabilità. Se un chunk fallisce, solo quel chunk viene ritentato anziché l'intero file.
  • Monitoraggio del progresso. Il progresso del trasferimento viene riportato a livello di chunk.
  • Efficienza di rete. Le dimensioni dei chunk sono ottimizzate per le condizioni tipiche della LAN.

I trasferimenti utilizzano la Porta File dedicata dalle Impostazioni di Rete, 5002 per impostazione predefinita. Se quella porta è bloccata da un firewall, nessun file raggiungerà i client.

Cartelle Sincronizzate

L'elenco Cartelle Sincronizzate mostra una riga per ogni percorso target, ciascuna con la sua versione più recente pubblicata. Una riga riporta il conteggio delle versioni, il conteggio dei file e la dimensione totale. Usa Aggiorna per ricaricare l'elenco.

Seleziona una riga per aprire i suoi dettagli a destra. Il pannello dei dettagli elenca ogni voce in quella sorgente con il suo percorso, tipo (file o directory), dimensione e checksum, insieme al percorso radice della sorgente, percorso target e orario di pubblicazione. La casella di ricerca filtra le voci per percorso relativo o target.

Rimuovere una Sincronizzazione

Esistono due diverse azioni di eliminazione. Fanno cose diverse:

  • Rimuovi Cartella Sincronizzata rimuove il percorso target dall'elenco di sincronizzazione. I tuoi file sorgente sul server non vengono toccati.
  • Elimina Voce rimuove un elemento dal percorso sorgente originale sul server. Questo è permanente e viene anche inviato ai client. HandyCafe chiede prima conferma.

Entrambe le azioni richiedono che Abilita Sincronizzazione Client sia attivo.

Casi d'Uso

  • Distribuzione di aggiornamenti di giochi. Invia patch di gioco a tutti i PC da gioco contemporaneamente in modo che ogni macchina esegua la stessa versione.
  • Invio di file di configurazione. Distribuisci impostazioni di rete aggiornate o preferenze applicative su tutti i client.
  • Distribuzione di software. Installa applicazioni sui PC client sincronizzando pacchetti di installazione o applicazioni portatili.
  • Aggiornamento delle risorse del menu client. Sincronizza nuove icone, poster o file multimediali utilizzati dal menu client.

Suggerimenti

  • Pianifica grandi sincronizzazioni durante le ore di bassa affluenza in modo che le sessioni attive non competano per la larghezza di banda.
  • Ricontrolla il percorso target prima di pubblicare. È la causa più comune di una sincronizzazione che sembra riuscire mentre nulla appare sul client.
  • Il server e i client devono essere sulla stessa LAN.

Pagine Correlate