HandyCafe Docs
it-admin

Como configurar los ajustes de red

Esta guia cubre la configuracion de red necesaria para que el servidor y los clientes de HandyCafe se comuniquen. Aprenderas a cambiar los puertos del servidor, configurar claves de conexion para autenticacion, configurar el Firewall de Windows, solucionar problemas de conectividad y manejar configuraciones con multiples VLANs.

Como cambiar los puertos del servidor

HandyCafe usa varios puertos para diferentes tipos de comunicacion. Los valores predeterminados funcionan para la mayoria de las configuraciones. Cambialos solo si hay un conflicto con otra aplicacion.

Lo que necesitaras

  • Servidor HandyCafe ejecutandose con acceso de administrador.
  • Conocimiento de que puertos ya estan en uso en tu red (usa netstat -an para verificar).
  • La posibilidad de reiniciar el servidor HandyCafe despues de hacer cambios.

Pasos

  1. Abre la aplicacion del servidor HandyCafe y navega a Ajustes en la barra lateral izquierda.
  2. Selecciona la pestana Red.
  3. Localiza el campo Puerto TCP. El predeterminado es 5001. Cambialo al numero de puerto que desees. Este puerto maneja la comunicacion principal de comandos y respuestas entre el servidor y los clientes.
  4. Localiza los campos Puerto de Transferencia de Archivos y Puerto UDP. Cambialos si es necesario. El puerto de transferencia de archivos maneja la sincronizacion de recursos (iconos, imagenes). El puerto UDP maneja la transmision de pantalla para escritorio remoto.
  5. Haz clic en Guardar para aplicar la nueva configuracion de puertos.
  6. Reinicia la aplicacion del servidor HandyCafe para que los cambios de puerto entren en vigor.
  7. Actualiza la configuracion 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 esta escuchando.

Resultado esperado

Despues 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 podran conectarse porque siguen intentando alcanzar el puerto anterior.
  • Elegir un puerto que ya esta en uso por otro servicio. El servidor no podra vincularse y no iniciara. Verifica con netstat -an | findstr :5001 (reemplazando 5001 con el puerto elegido) antes de confirmar un numero de puerto.
  • Olvidar reiniciar el servidor. Los cambios de puerto no entran en vigor hasta que se reinicia el proceso del servidor.

Como configurar la clave de conexion

La clave de conexion es un secreto compartido que autentica la comunicacion 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 necesitaras

  • Servidor HandyCafe ejecutandose.
  • Acceso a todos los PCs cliente para actualizar su configuracion.

Pasos

  1. Navega a Ajustes > Red en la aplicacion del servidor HandyCafe.
  2. Localiza el campo Clave de conexion.
  3. Ingresa un secreto compartido seguro. Usa una mezcla de letras, numeros y simbolos. 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 conexion. La clave debe coincidir caracter por caracter, incluyendo mayusculas 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 maquinas 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 caracter causa fallo de autenticacion. 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 debil proporciona poca seguridad.
  • Olvidar actualizar uno o dos PCs cliente despues de cambiar la clave. Esos clientes apareceran como desconectados hasta que se actualice su clave.

Como configurar el Firewall de Windows

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

Lo que necesitaras

  • Acceso de administrador en el PC servidor.
  • Los numeros 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 especificos y haz clic en Siguiente. Selecciona Permitir la conexion y haz clic en Siguiente. Marca todos los perfiles (Dominio, Privado, Publico) 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 mas. Esta vez selecciona UDP en lugar de TCP, ingresa 5004 para el puerto y sigue los mismos pasos. Nombrala "HandyCafe UDP 5004".
  8. Verifica que las cuatro reglas aparezcan en la lista de Reglas de entrada y muestren una marca de verificacion verde indicando que estan 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 traves 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 estan tipicamente permitidas de forma predeterminada.
  • Olvidar la regla UDP. Sin ella, la transmision de escritorio remoto no funcionara aunque la comunicacion de comandos (TCP) funcione normalmente.
  • Seleccionar solo el perfil "Dominio". Si tu red esta clasificada como Privada o Publica por Windows, la regla no aplicara. Marca los tres perfiles para estar seguro.

Como solucionar problemas de conectividad de clientes

Sigue este proceso sistematico cuando un cliente no pueda conectarse al servidor.

Lo que necesitaras

  • Acceso tanto al PC servidor como al PC cliente afectado.
  • Un simbolo del sistema o terminal en ambas maquinas.

Pasos

  1. Verifica que el servidor este funcionando. En el PC servidor, confirma que la aplicacion del servidor HandyCafe esta abierta y la pagina principal muestra el Panel de Administracion. Si el servidor no esta funcionando, inicialo.

  2. Haz ping al servidor desde el cliente. En el PC cliente, abre un simbolo del sistema y ejecuta ping [ip-del-servidor] (reemplaza con la direccion IP real de tu servidor). Si el ping falla, el problema esta en la capa de red. Verifica cables, switches y configuracion 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 esten escuchando. En el PC servidor, abre un simbolo del sistema y ejecuta netstat -an | findstr :5001 (reemplaza 5001 con tu puerto TCP configurado). Deberias ver una linea mostrando LISTENING en ese puerto. Si no, el servidor no logro 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 seccion anterior esten presentes y habilitadas. Deshabilitar temporalmente el firewall (y luego rehabilitarlo) puede confirmar si el firewall es el problema.

  5. Verifica que la clave de conexion coincida. En el PC cliente, abre los ajustes del cliente HandyCafe y confirma que la clave de conexion sea identica a la del servidor. Una clave que no coincide hace que el cliente parezca no poder conectarse en absoluto. El servidor rechaza la autenticacion silenciosamente.

  6. Verifica el descubrimiento mDNS. Los clientes de HandyCafe usan mDNS para encontrar automaticamente el servidor en la red local. Si mDNS esta bloqueado (algunas redes administradas deshabilitan multicast), el cliente no puede descubrir el servidor automaticamente. En este caso, ingresa la direccion IP del servidor manualmente en la configuracion del cliente.

Resultado esperado

Siguiendo estos pasos en orden, aislas el problema a una capa especifica: red, puerto, firewall, autenticacion o descubrimiento. La mayoria 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 aplicacion del servidor no esta funcionando, nada mas 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.

Como configurar HandyCafe entre VLANs

En redes mas grandes, los servidores y clientes pueden estar en diferentes VLANs (redes de area local virtuales). Dado que las transmisiones mDNS no cruzan los limites de VLAN, el descubrimiento automatico no funcionara.

Lo que necesitaras

  • La direccion IP estatica del servidor.
  • Enrutamiento configurado entre VLANs en tu switch o router de red.
  • Reglas de firewall que permitan el trafico de HandyCafe entre VLANs.

Pasos

  1. Asigna una direccion IP estatica al PC del servidor HandyCafe. Las direcciones asignadas por DHCP pueden cambiar, rompiendo las configuraciones de los clientes. Configura la IP estatica a traves de los Ajustes de Red de Windows o la funcion de reserva de tu servidor DHCP.

  2. En cada cliente HandyCafe, abre la configuracion del cliente e ingresa la direccion IP del servidor manualmente en lugar de depender del descubrimiento automatico.

  3. Ingresa el puerto TCP correcto y la clave de conexion en la configuracion de cada cliente.

  4. En el router de red o switch de capa 3, asegurate de que el trafico 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 Administracion del servidor.

Resultado esperado

Los PCs cliente en diferentes VLANs se conectan al servidor usando la direccion IP configurada manualmente. Todas las funciones operan igual que en una red de subred unica.

Errores comunes

  • Usar DHCP para el servidor sin una reserva. Si la IP del servidor cambia, cada cliente pierde su conexion.
  • Olvidar permitir el trafico UDP entre VLANs. Las conexiones TCP pueden funcionar (los comandos tienen exito) mientras el trafico UDP esta bloqueado (la transmision de escritorio remoto falla).
  • No considerar las reglas de firewall entre VLANs en switches administrados. Los switches empresariales a menudo bloquean el trafico entre VLANs de forma predeterminada.