HandyCafe Docs
it-admin

Cómo configurar los ajustes de red

Esta guía cubre la configuración de red necesaria para que el servidor y los clientes de HandyCafe se comuniquen. Aprenderás a cambiar los puertos del servidor, configurar claves de conexión para autenticación, configurar el Firewall de Windows, solucionar problemas de conectividad y manejar configuraciones con múltiples VLANs.

Cómo cambiar los puertos del servidor

HandyCafe usa varios puertos para diferentes tipos de comunicación. Los valores predeterminados funcionan para la mayoría de las configuraciones. Cámbialos solo si hay un conflicto con otra aplicación.

Lo que necesitarás

  • Servidor HandyCafe ejecutándose con acceso de administrador.
  • Conocimiento de qué puertos ya están en uso en tu red (usa netstat -an para verificar).
  • La posibilidad de reiniciar el servidor HandyCafe después de hacer cambios.

Pasos

  1. Abre la aplicación del servidor HandyCafe y navega a Ajustes en la barra lateral izquierda.
  2. Selecciona la pestaña Red.
  3. Localiza el campo Puerto TCP. El predeterminado es 5001. Cámbialo al número de puerto que desees. Este puerto maneja la comunicación principal de comandos y respuestas entre el servidor y los clientes.
  4. Localiza los campos Puerto de Transferencia de Archivos y Puerto UDP. Cámbialos si es necesario. El puerto de transferencia de archivos maneja la sincronización de recursos (iconos, imágenes). El puerto UDP maneja la transmisión de pantalla para escritorio remoto.
  5. Haz clic en Guardar para aplicar la nueva configuración de puertos.
  6. Reinicia la aplicación del servidor HandyCafe para que los cambios de puerto entren en vigor.
  7. Actualiza la configuración de puertos en cada cliente HandyCafe para que coincida con los nuevos puertos del servidor. Cada cliente debe estar configurado para conectarse en los mismos puertos en los que el servidor está escuchando.

Resultado esperado

Después de reiniciar, el servidor escucha en los nuevos puertos. Los clientes configurados con los puertos coincidentes se conectan exitosamente.

Errores comunes

  • Cambiar el puerto del servidor sin actualizar los clientes. Los clientes no podrán conectarse porque siguen intentando alcanzar el puerto anterior.
  • Elegir un puerto que ya está en uso por otro servicio. El servidor no podrá vincularse y no iniciará. Verifica con netstat -an | findstr :5001 (reemplazando 5001 con el puerto elegido) antes de confirmar un número de puerto.
  • Olvidar reiniciar el servidor. Los cambios de puerto no entran en vigor hasta que se reinicia el proceso del servidor.

Cómo configurar la clave de conexión

La clave de conexión es un secreto compartido que autentica la comunicación entre el servidor y los clientes. Cada mensaje TCP se autentica usando HMAC-SHA256 con esta clave. Sin una clave que coincida, los clientes no pueden conectarse.

Lo que necesitarás

  • Servidor HandyCafe ejecutándose.
  • Acceso a todos los PCs cliente para actualizar su configuración.

Pasos

  1. Navega a Ajustes > Red en la aplicación del servidor HandyCafe.
  2. Localiza el campo Clave de conexión.
  3. Ingresa un secreto compartido seguro. Usa una mezcla de letras, números y símbolos. La clave debe tener al menos 16 caracteres. Por ejemplo: hC!2026$NetCafe#Secure.
  4. Haz clic en Guardar.
  5. En cada PC cliente de HandyCafe, abre los ajustes del cliente e ingresa exactamente la misma clave de conexión. La clave debe coincidir carácter por carácter, incluyendo mayúsculas y caracteres especiales.

Resultado esperado

Todos los clientes con la clave correcta se conectan exitosamente. Cualquier dispositivo sin la clave correcta es rechazado por el servidor. Esto evita que máquinas no autorizadas se unan a tu red.

Errores comunes

  • Escribir la clave de forma diferente en el servidor y en un cliente. Incluso una diferencia de un carácter causa fallo de autenticación. Copia y pega la clave para evitar errores de escritura.
  • Usar una clave muy corta o simple como "1234" o "password". Aunque el sistema acepta cualquier cadena, una clave débil proporciona poca seguridad.
  • Olvidar actualizar uno o dos PCs cliente después de cambiar la clave. Esos clientes aparecerán como desconectados hasta que se actualice su clave.

Cómo configurar el Firewall de Windows

El Firewall de Windows bloquea las conexiones entrantes de forma predeterminada. Debes crear reglas para permitir el tráfico de HandyCafe.

Lo que necesitarás

  • Acceso de administrador en el PC servidor.
  • Los números de puerto que usa tu servidor HandyCafe (predeterminados: TCP 5001, 5002, 5003 y UDP 5004).

Pasos

  1. Abre Firewall de Windows con Seguridad Avanzada. Presiona Win+R, escribe wf.msc y presiona Enter.
  2. En el panel izquierdo, haz clic en Reglas de entrada.
  3. En el panel derecho, haz clic en Nueva regla.
  4. Selecciona Puerto como tipo de regla y haz clic en Siguiente.
  5. Selecciona TCP, ingresa 5001 en el campo de puertos locales específicos y haz clic en Siguiente. Selecciona Permitir la conexión y haz clic en Siguiente. Marca todos los perfiles (Dominio, Privado, Público) y haz clic en Siguiente. Nombra la regla "HandyCafe TCP 5001" y haz clic en Finalizar.
  6. Repite los pasos 3 a 5 para el puerto TCP 5002 (transferencia de archivos) y TCP 5003. Crea cada una como una regla separada con un nombre descriptivo.
  7. Crea una regla más. Esta vez selecciona UDP en lugar de TCP, ingresa 5004 para el puerto y sigue los mismos pasos. Nómbrala "HandyCafe UDP 5004".
  8. Verifica que las cuatro reglas aparezcan en la lista de Reglas de entrada y muestren una marca de verificación verde indicando que están habilitadas.

Resultado esperado

El Firewall de Windows permite conexiones entrantes en todos los puertos de HandyCafe. Los PCs cliente ahora pueden alcanzar el servidor a través del firewall.

Errores comunes

  • Crear reglas de salida en lugar de reglas de entrada. El servidor necesita reglas de entrada para aceptar conexiones de los clientes. Las conexiones salientes están típicamente permitidas de forma predeterminada.
  • Olvidar la regla UDP. Sin ella, la transmisión de escritorio remoto no funcionará aunque la comunicación de comandos (TCP) funcione normalmente.
  • Seleccionar solo el perfil "Dominio". Si tu red está clasificada como Privada o Pública por Windows, la regla no aplicará. Marca los tres perfiles para estar seguro.

Cómo solucionar problemas de conectividad de clientes

Sigue este proceso sistemático cuando un cliente no pueda conectarse al servidor.

Lo que necesitarás

  • Acceso tanto al PC servidor como al PC cliente afectado.
  • Un símbolo del sistema o terminal en ambas máquinas.

Pasos

  1. Verifica que el servidor esté funcionando. En el PC servidor, confirma que la aplicación del servidor HandyCafe está abierta y la página principal muestra el Panel de Administración. Si el servidor no está funcionando, inícialo.

  2. Haz ping al servidor desde el cliente. En el PC cliente, abre un símbolo del sistema y ejecuta ping [ip-del-servidor] (reemplaza con la dirección IP real de tu servidor). Si el ping falla, el problema está en la capa de red. Verifica cables, switches y configuración de IP. El cliente y el servidor deben estar en la misma red o tener una ruta entre ellos.

  3. Verifica que los puertos del servidor estén escuchando. En el PC servidor, abre un símbolo del sistema y ejecuta netstat -an | findstr :5001 (reemplaza 5001 con tu puerto TCP configurado). Deberías ver una línea mostrando LISTENING en ese puerto. Si no, el servidor no logró vincularse al puerto. Verifica si hay conflictos de puerto.

  4. Verifica las reglas de firewall. En el PC servidor, verifica que las reglas del Firewall de Windows de la sección anterior estén presentes y habilitadas. Deshabilitar temporalmente el firewall (y luego rehabilitarlo) puede confirmar si el firewall es el problema.

  5. Verifica que la clave de conexión coincida. En el PC cliente, abre los ajustes del cliente HandyCafe y confirma que la clave de conexión sea idéntica a la del servidor. Una clave que no coincide hace que el cliente parezca no poder conectarse en absoluto. El servidor rechaza la autenticación silenciosamente.

  6. Verifica el descubrimiento mDNS. Los clientes de HandyCafe usan mDNS para encontrar automáticamente el servidor en la red local. Si mDNS está bloqueado (algunas redes administradas deshabilitan multicast), el cliente no puede descubrir el servidor automáticamente. En este caso, ingresa la dirección IP del servidor manualmente en la configuración del cliente.

Resultado esperado

Siguiendo estos pasos en orden, aíslas el problema a una capa específica: red, puerto, firewall, autenticación o descubrimiento. La mayoría de los problemas de conectividad se resuelven en el paso 2 (red) o el paso 4 (firewall).

Errores comunes

  • Saltarse el paso 1. Si la aplicación del servidor no está funcionando, nada más importa.
  • Asumir que el firewall no es el problema porque "funcionaba ayer". Las actualizaciones de Windows a veces restablecen las reglas de firewall o reclasifican el perfil de red.

Cómo configurar HandyCafe entre VLANs

En redes más grandes, los servidores y clientes pueden estar en diferentes VLANs (redes de área local virtuales). Dado que las transmisiones mDNS no cruzan los límites de VLAN, el descubrimiento automático no funcionará.

Lo que necesitarás

  • La dirección IP estática del servidor.
  • Enrutamiento configurado entre VLANs en tu switch o router de red.
  • Reglas de firewall que permitan el tráfico de HandyCafe entre VLANs.

Pasos

  1. Asigna una dirección IP estática al PC del servidor HandyCafe. Las direcciones asignadas por DHCP pueden cambiar, rompiendo las configuraciones de los clientes. Configura la IP estática a través de los Ajustes de Red de Windows o la función de reserva de tu servidor DHCP.

  2. En cada cliente HandyCafe, abre la configuración del cliente e ingresa la dirección IP del servidor manualmente en lugar de depender del descubrimiento automático.

  3. Ingresa el puerto TCP correcto y la clave de conexión en la configuración de cada cliente.

  4. En el router de red o switch de capa 3, asegúrate de que el tráfico en los puertos de HandyCafe (TCP 5001-5003, UDP 5004 por defecto) tenga permitido enrutar entre la VLAN del servidor y la VLAN del cliente.

  5. Prueba la conectividad desde un cliente en la VLAN remota haciendo ping a la IP del servidor. Luego verifica que el cliente HandyCafe se conecte y aparezca en el Panel de Administración del servidor.

Resultado esperado

Los PCs cliente en diferentes VLANs se conectan al servidor usando la dirección IP configurada manualmente. Todas las funciones operan igual que en una red de subred única.

Errores comunes

  • Usar DHCP para el servidor sin una reserva. Si la IP del servidor cambia, cada cliente pierde su conexión.
  • Olvidar permitir el tráfico UDP entre VLANs. Las conexiones TCP pueden funcionar (los comandos tienen éxito) mientras el tráfico UDP está bloqueado (la transmisión de escritorio remoto falla).
  • No considerar las reglas de firewall entre VLANs en switches administrados. Los switches empresariales a menudo bloquean el tráfico entre VLANs de forma predeterminada.