HandyCafe Docs
it-admin

Sincronización de Archivos

La Sincronización de Archivos distribuye archivos desde el Servidor HandyCafe a las PCs cliente a través de la red. Úsalo para enviar actualizaciones de juegos, archivos de configuración, instaladores de software y recursos del menú del cliente sin visitar cada máquina.

Utiliza un enfoque basado en manifiestos para que solo los archivos modificados o nuevos viajen por la red, lo que hace que las sincronizaciones repetidas sean rápidas.

La página se encuentra en Configuración > Sincronización de Archivos.

Habilitar Sincronización de Clientes

Un interruptor en la parte superior derecha de la página controla toda la función. Mientras Habilitar Sincronización de Clientes está desactivado, la página informa que la sincronización de clientes está pausada y tanto las acciones de publicación como de eliminación están bloqueadas. Actívalo antes de publicar cualquier cosa.

Publicar una Fuente de Sincronización

La sección Publicar Fuente de Sincronización es donde se crea una sincronización. Requiere dos valores:

Campo Qué es
Ruta de Origen El archivo o carpeta en el servidor que deseas distribuir. Usa Seleccionar Archivo o Seleccionar Carpeta para elegirlo, o escribe la ruta directamente.
Ruta de Destino en Clientes La ruta absoluta donde el contenido debe ubicarse en cada cliente. Esto no es opcional. Ejemplo: C:\Games\SteamLibrary\common\Game o /opt/apps/game.

La ruta de destino debe ser válida en las máquinas cliente, no en el servidor. Si tus clientes guardan sus juegos en D: y tú ingresas una ruta C:, la sincronización se ubicará en el lugar incorrecto.

Selecciona Publicar Sincronización una vez que ambos campos estén completos. El contenido se sirve a los clientes directamente desde la ruta de origen. El servidor no guarda una segunda copia.

Cómo Funciona la Sincronización

Comparación Basada en Manifiestos

Cuando comienza una sincronización, el servidor genera un manifiesto de archivos: una lista de cada archivo a sincronizar junto con su suma de verificación. Cada cliente compara este manifiesto con sus propios archivos locales.

  • Los archivos que no existen en el cliente se marcan para descarga.
  • Los archivos cuyas sumas de verificación difieren (lo que significa que fueron modificados) se marcan para descarga.
  • Los archivos que coinciden se omiten por completo.

Solo se transfiere la diferencia entre el servidor y el cliente, lo que hace que las sincronizaciones repetidas sean rápidas.

Transferencia Basada en Fragmentos

Los archivos grandes se dividen en fragmentos más pequeños para transferirse a través de TCP:

  • Confiabilidad. Si un fragmento falla, solo ese fragmento se reintenta en lugar de todo el archivo.
  • Seguimiento del progreso. El progreso de la transferencia se informa a nivel de fragmento.
  • Eficiencia de red. Los tamaños de los fragmentos están ajustados para condiciones típicas de LAN.

Las transferencias utilizan el Puerto de Archivos dedicado de Configuración de Red, 5002 por defecto. Si ese puerto está bloqueado por un firewall, ningún archivo llegará a los clientes.

Carpetas Sincronizadas

La lista de Carpetas Sincronizadas muestra una fila por cada ruta de destino, cada una con su versión publicada más reciente. Una fila informa el conteo de versiones, el conteo de archivos y el tamaño total. Usa Actualizar para recargar la lista.

Selecciona una fila para abrir sus detalles a la derecha. El panel de detalles lista cada entrada en esa fuente con su ruta, tipo (archivo o directorio), tamaño y suma de verificación, junto con la ruta raíz de origen, ruta de destino y hora de publicación. El cuadro de búsqueda filtra las entradas por ruta relativa o de destino.

Eliminar una Sincronización

Existen dos acciones de eliminación diferentes. Hacen cosas distintas:

  • Eliminar Carpeta Sincronizada quita la ruta de destino de la lista de sincronización. Tus archivos de origen en el servidor no se tocan.
  • Eliminar Entrada elimina un elemento de la ruta de origen original en el servidor. Esto es permanente y también se envía a los clientes. HandyCafe solicita confirmación primero.

Ambas acciones requieren que Habilitar Sincronización de Clientes esté activado.

Casos de Uso

  • Desplegar actualizaciones de juegos. Envía parches de juegos a todas las PCs de juego a la vez para que cada máquina ejecute la misma versión.
  • Enviar archivos de configuración. Distribuye configuraciones de red actualizadas o preferencias de aplicaciones a todos los clientes.
  • Distribuir software. Instala aplicaciones en las PCs cliente sincronizando paquetes de instalación o aplicaciones portátiles.
  • Actualizar recursos del menú del cliente. Sincroniza nuevos íconos, carteles o archivos multimedia utilizados por el menú del cliente.

Consejos

  • Programa sincronizaciones grandes durante horas de menor actividad para que las sesiones activas no compitan por el ancho de banda.
  • Verifica dos veces la ruta de destino antes de publicar. Es la causa más común de una sincronización que parece tener éxito mientras nada aparece en el cliente.
  • El servidor y los clientes deben estar en la misma LAN.

Páginas Relacionadas