HandyCafe Docs
it-admin

Primeros pasos: Administrador de TI

Esta guía cubre la configuración técnica de HandyCafe. Al finalizar, tendrá el servidor y los clientes instalados, la red configurada, los menús de aplicaciones construidos y la gestión remota probada.

Tiempo estimado: 5 minutos (más tiempo de despliegue de clientes)

Paso 1: Instalar el servidor y los clientes

Instalación del servidor:

  1. Verifique que su PC servidor cumple los requisitos del sistema.
  2. Descargue e instale HandyCafe Server en su PC de gestión.
  3. Inicie el servidor y complete el Asistente de configuración inicial para crear la cuenta de administrador.
  4. Anote la dirección IP local del PC servidor. Los clientes la necesitarán para conectarse.

Instalación del cliente (repita para cada PC):

  1. Descargue HandyCafe Client en cada PC de uso público.
  2. Instale e inicie el cliente.
  3. El cliente busca el servidor en la red local usando detección mDNS.
  4. Si el servidor no se encuentra automáticamente, ingrese la dirección IP del servidor manualmente en la configuración del cliente.
  5. Una vez conectado, el cliente aparece en el Panel de administración del servidor.

Consejo: Use la función de nombres automáticos del servidor (Configuración > Clientes) para nombrar automáticamente los clientes con un prefijo como "PC #1", "PC #2", etc. Puede personalizar los nombres visibles más adelante.

Consulte Instalación del servidor e Instalación del cliente para pasos detallados.

Paso 2: Configurar los ajustes de red

Navegue a Configuración > Red en el servidor.

HandyCafe usa cuatro puertos para la comunicación:

Puerto Predeterminado Propósito
Puerto TCP 5001 Comunicación de comandos y respuestas
Puerto de archivos 5002 Transferencia de archivos entre servidor y clientes
Puerto de gestión remota 5003 Control de transmisión de escritorio remoto
Puerto UDP 5004 Datos de transmisión de pantalla

Configuración:

  1. Establezca los puertos (los valores predeterminados funcionan para la mayoría de configuraciones).
  2. Establezca la Clave de conexión. Este es un secreto compartido usado para autenticación HMAC-SHA256. Todos los clientes deben usar la misma clave.
  3. Haga clic en Guardar.

Reglas de firewall:

Asegúrese de que estos puertos estén 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 transmisión de pantalla)

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

Consulte Configuración de red para todas las opciones de red.

Paso 3: Configurar el menú del cliente

El menú del cliente es el lanzador de aplicaciones que los clientes ven en su escritorio. Navegue a Configuración > Clientes > pestaña Contenido.

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

Los cambios se envían a todos los clientes conectados automáticamente en tiempo real vía TCP.

Consejo: Use la integración IGDB para buscar metadatos e iconos de juegos automáticamente.

Consulte Menú del cliente para la documentación completa del constructor de menús.

Paso 4: Configurar la pantalla de espera y la apariencia

Pantalla de espera (Configuración > Clientes > pestaña Pantalla de espera):

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

  1. Habilite la presentación de la pantalla de espera.
  2. Agregue imágenes o videos (PNG, JPG, WebP, GIF, MP4, WebM).
  3. Establezca la duración por elemento y el efecto de transición (fundido, deslizamiento, zoom).
  4. Opcionalmente habilite la superposición del reloj y la visualización del nombre del café con colores personalizados.
  5. Haga clic en Guardar.

Apariencia (Configuración > Clientes > pestaña Apariencia):

Configure el aspecto del escritorio en línea que los clientes usan durante las sesiones.

  1. Seleccione un tema: Neon Arena, Crimson Pulse o Emerald Depth.
  2. Elija una disposición predefinida: Split Classic, Hero Wide Top, Catalog Wide Bottom o Compact Focus.
  3. Configure el fondo: color sólido, degradado, imagen o video con ajustes de superposición 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 gestión remota funcione:

Capturas de pantalla:

  1. En el Panel de administración, seleccione cualquier tarjeta de cliente en línea.
  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 línea y haga clic en Escritorio remoto.
  2. Se abre una ventana de escritorio remoto con transmisión H.264 en vivo.
  3. Puede controlar el ratón y el teclado en el PC remoto.
  4. La sincronización del portapapeles funciona entre servidor y cliente.

Nota: El escritorio remoto usa transmisión UDP. Si el video está lento, verifique el ancho de banda de su red y asegúrese de que el puerto UDP 5004 no esté bloqueado. También puede ajustar la tasa de bits en la configuración de transmisión (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
    +-- ...

Qué hacer a continuación