HandyCafe Docs
it-admin

Sincronização de Arquivos

A Sincronização de Arquivos distribui arquivos do HandyCafe Server para PCs clientes na rede. Use-a para enviar atualizações de jogos, arquivos de configuração, instaladores de software e ativos do menu do cliente sem precisar visitar cada máquina.

Ela utiliza uma abordagem baseada em manifesto para que apenas arquivos alterados ou novos sejam transferidos, o que torna as sincronizações repetidas rápidas.

A página está em Configurações > Sincronização de Arquivos.

Ativar Sincronização do Cliente

Um botão no canto superior direito da página controla toda a funcionalidade. Enquanto Ativar Sincronização do Cliente estiver desativado, a página informa que a sincronização do cliente está pausada e tanto as ações de publicação quanto de exclusão estão bloqueadas. Ative-a antes de publicar qualquer coisa.

Publicar uma Fonte de Sincronização

A seção Publicar Fonte de Sincronização é onde uma sincronização é criada. Ela requer dois valores:

Campo O que é
Caminho da Fonte O arquivo ou pasta no servidor que você deseja distribuir. Use Escolher Arquivo ou Escolher Pasta para selecioná-lo, ou digite o caminho diretamente.
Caminho de Destino nos Clientes O caminho absoluto onde o conteúdo deve ser colocado em cada cliente. Isso não é opcional. Exemplo: C:\Games\SteamLibrary\common\Game ou /opt/apps/game.

O caminho de destino deve ser válido nas máquinas clientes, não no servidor. Se seus clientes mantêm seus jogos em D: e você inserir um caminho C:, a sincronização será feita no lugar errado.

Selecione Publicar Sincronização assim que ambos os campos estiverem preenchidos. O conteúdo é servido aos clientes diretamente do caminho da fonte. O servidor não mantém uma segunda cópia.

Como Funciona a Sincronização

Comparação Baseada em Manifesto

Quando uma sincronização começa, o servidor gera um manifesto de arquivos: uma lista de cada arquivo a ser sincronizado junto com seu checksum. Cada cliente compara esse manifesto com seus próprios arquivos locais.

  • Arquivos que não existem no cliente são marcados para download.
  • Arquivos cujos checksums diferem (significando que foram modificados) são marcados para download.
  • Arquivos que correspondem são completamente ignorados.

Apenas o delta entre o servidor e o cliente é transferido, o que torna as sincronizações repetidas rápidas.

Transferência Baseada em Fragmentos

Arquivos grandes são divididos em fragmentos menores para transferência via TCP:

  • Confiabilidade. Se um fragmento falha, apenas aquele fragmento é retransmitido, em vez do arquivo inteiro.
  • Acompanhamento de progresso. O progresso da transferência é reportado no nível do fragmento.
  • Eficiência de rede. Os tamanhos dos fragmentos são ajustados para condições típicas de LAN.

As transferências usam a Porta de Arquivos dedicada nas Configurações de Rede, 5002 por padrão. Se essa porta estiver bloqueada por um firewall, nenhum arquivo chegará aos clientes.

Pastas Sincronizadas

A lista de Pastas Sincronizadas mostra uma linha por caminho de destino, cada uma com sua versão mais recente publicada. Uma linha informa a contagem de versões, a contagem de arquivos e o tamanho total. Use Atualizar para recarregar a lista.

Selecione uma linha para abrir seus detalhes à direita. O painel de detalhes lista cada entrada naquela fonte com seu caminho, tipo (arquivo ou diretório), tamanho e checksum, junto com o caminho raiz da fonte, caminho de destino e hora de publicação. A caixa de busca filtra entradas por caminho relativo ou de destino.

Removendo uma Sincronização

Existem duas ações de exclusão diferentes. Elas fazem coisas diferentes:

  • Remover Pasta Sincronizada retira o caminho de destino da lista de sincronização. Seus arquivos de origem no servidor não são tocados.
  • Excluir Entrada remove um item do caminho de origem original no servidor. Isso é permanente e também é enviado aos clientes. O HandyCafe pede confirmação primeiro.

Ambas as ações requerem que Ativar Sincronização do Cliente esteja ativado.

Casos de Uso

  • Implantação de atualizações de jogos. Envie patches de jogos para todos os PCs de jogos de uma vez para que todas as máquinas executem a mesma versão.
  • Envio de arquivos de configuração. Distribua configurações de rede atualizadas ou preferências de aplicativos em todos os clientes.
  • Distribuição de software. Instale aplicativos nos PCs clientes sincronizando pacotes de instaladores ou aplicativos portáteis.
  • Atualização de ativos do menu do cliente. Sincronize novos ícones, pôsteres ou arquivos de mídia usados pelo menu do cliente.

Dicas

  • Agende grandes sincronizações durante horários de menor movimento para que sessões ativas não compitam por largura de banda.
  • Verifique duas vezes o caminho de destino antes de publicar. É a causa mais comum de uma sincronização que parece ter sucesso enquanto nada aparece no cliente.
  • O servidor e os clientes devem estar na mesma LAN.

Páginas Relacionadas