HandyCafe Docs
it-admin

Primeros pasos: Administrador de TI

Esta guia cubre la configuracion tecnica de HandyCafe. Al finalizar, tendra el servidor y los clientes instalados, la red configurada, los menus de aplicaciones construidos y la gestion remota probada.

Tiempo estimado: 5 minutos (mas tiempo de despliegue de clientes)

Paso 1: Instalar el servidor y los clientes

Instalacion del servidor:

  1. Verifique que su PC servidor cumple los requisitos del sistema.
  2. Descargue e instale HandyCafe Server en su PC de gestion.
  3. Inicie el servidor y complete el Asistente de configuracion inicial para crear la cuenta de administrador.
  4. Anote la direccion IP local del PC servidor. Los clientes la necesitaran para conectarse.

Instalacion del cliente (repita para cada PC):

  1. Descargue HandyCafe Client en cada PC de uso publico.
  2. Instale e inicie el cliente.
  3. El cliente busca el servidor en la red local usando deteccion mDNS.
  4. Si el servidor no se encuentra automaticamente, ingrese la direccion IP del servidor manualmente en la configuracion del cliente.
  5. Una vez conectado, el cliente aparece en el Panel de administracion del servidor.

Consejo: Use la funcion de nombres automaticos del servidor (Configuracion > Clientes) para nombrar automaticamente los clientes con un prefijo como "PC #1", "PC #2", etc. Puede personalizar los nombres visibles mas adelante.

Consulte Instalacion del servidor e Instalacion del cliente para pasos detallados.

Paso 2: Configurar los ajustes de red

Navegue a Configuracion > Red en el servidor.

HandyCafe usa cuatro puertos para la comunicacion:

Puerto Predeterminado Proposito
Puerto TCP 5001 Comunicacion de comandos y respuestas
Puerto de archivos 5002 Transferencia de archivos entre servidor y clientes
Puerto de gestion remota 5003 Control de transmision de escritorio remoto
Puerto UDP 5004 Datos de transmision de pantalla

Configuracion:

  1. Establezca los puertos (los valores predeterminados funcionan para la mayoria de configuraciones).
  2. Establezca la Clave de conexion. Este es un secreto compartido usado para autenticacion HMAC-SHA256. Todos los clientes deben usar la misma clave.
  3. Haga clic en Guardar.

Reglas de firewall:

Asegurese de que estos puertos esten abiertos tanto en el servidor como en los PCs cliente:

  • TCP: 5001, 5002, 5003 (entrante en el servidor, saliente en los clientes)
  • UDP: 5004 (bidireccional para transmision de pantalla)

Importante: Todos los PCs deben estar en la misma red local (subred). HandyCafe usa mDNS para la deteccion de clientes, lo que requiere conectividad LAN.

Consulte Configuracion de red para todas las opciones de red.

Paso 3: Configurar el menu del cliente

El menu del cliente es el lanzador de aplicaciones que los clientes ven en su escritorio. Navegue a Configuracion > Clientes > pestana Contenido.

  1. Cree categorias. Agrupe aplicaciones por tipo (por ejemplo, Juegos, Navegadores, Redes sociales, Herramientas).
  2. Agregue aplicaciones a cada categoria:
    • Establezca el nombre y la descripcion de la aplicacion.
    • Elija el tipo de aplicacion: Juego, Navegador, Enlace, Archivo o Aplicacion.
    • Establezca la ruta del ejecutable o URI de lanzamiento.
    • Suba un icono y opcionalmente una imagen de poster para la tarjeta de la aplicacion.
  3. Reordene categorias y aplicaciones usando los controles de arrastre.
  4. Alterne la visibilidad para mostrar u ocultar elementos.
  5. Haga clic en Guardar.

Los cambios se envian a todos los clientes conectados automaticamente en tiempo real via TCP.

Consejo: Use la integracion IGDB para buscar metadatos e iconos de juegos automaticamente.

Consulte Menu del cliente para la documentacion completa del constructor de menus.

Paso 4: Configurar la pantalla de espera y la apariencia

Pantalla de espera (Configuracion > Clientes > pestana Pantalla de espera):

La pantalla de espera es lo que los clientes ven cuando no hay sesion activa (la pantalla de bloqueo).

  1. Habilite la presentacion de la pantalla de espera.
  2. Agregue imagenes o videos (PNG, JPG, WebP, GIF, MP4, WebM).
  3. Establezca la duracion por elemento y el efecto de transicion (fundido, deslizamiento, zoom).
  4. Opcionalmente habilite la superposicion del reloj y la visualizacion del nombre del cafe con colores personalizados.
  5. Haga clic en Guardar.

Apariencia (Configuracion > Clientes > pestana Apariencia):

Configure el aspecto del escritorio en linea que los clientes usan durante las sesiones.

  1. Seleccione un tema: Neon Arena, Crimson Pulse o Emerald Depth.
  2. Elija una disposicion predefinida: Split Classic, Hero Wide Top, Catalog Wide Bottom o Compact Focus.
  3. Configure el fondo: color solido, degradado, imagen o video con ajustes de superposicion y desenfoque.
  4. Ajuste la densidad de tarjetas (Grande, Mediana, Compacta) y los efectos de hover.
  5. Haga clic en Guardar.

Consulte Pantalla de espera del cliente y Apariencia del cliente para todas las opciones.

Paso 5: Probar escritorio remoto y capturas de pantalla

Verifique que la gestion remota funcione:

Capturas de pantalla:

  1. En el Panel de administracion, seleccione cualquier tarjeta de cliente en linea.
  2. Haga clic en Captura de pantalla en la tarjeta del cliente.
  3. Una captura de la pantalla del cliente aparece en el visor.
  4. Puede descargar o actualizar la captura.

Escritorio remoto:

  1. Seleccione una tarjeta de cliente en linea y haga clic en Escritorio remoto.
  2. Se abre una ventana de escritorio remoto con transmision H.264 en vivo.
  3. Puede controlar el raton y el teclado en el PC remoto.
  4. La sincronizacion del portapapeles funciona entre servidor y cliente.

Nota: El escritorio remoto usa transmision UDP. Si el video esta lento, verifique el ancho de banda de su red y asegurese de que el puerto UDP 5004 no este bloqueado. Tambien puede ajustar la tasa de bits en la configuracion de transmision (350-25,000 kbps).

Consulte Escritorio remoto y Capturas de pantalla para todas las funciones remotas.

Vista general de la arquitectura de red

PC Servidor (Gestion)
    |
    |--- TCP (5001) --- Comando/Respuesta (bincode + HMAC-SHA256)
    |--- TCP (5002) --- Transferencia de archivos
    |--- TCP (5003) --- Control de gestion remota
    |--- UDP (5004) --- Transmision de pantalla (H.264)
    |--- mDNS ------- Deteccion de clientes (automatica)
    |
    +-- PC Cliente 1
    +-- PC Cliente 2
    +-- PC Cliente 3
    +-- ...

Que hacer a continuacion