Si ZimaClient en macOS permanece en «Conectando», cierra sesión en el cliente y vuelve a iniciarla antes de reinstalar la aplicación o cambiar tu servidor ZimaOS. Esa acción exacta restauró el caso de origen verificado 2.1.0 después de permanecer bloqueado durante varias horas.
Sin embargo, no consideres cerrar sesión y volver a iniciarla una solución universal para la causa raíz. El mismo hilo incluía síntomas de conexión tanto en Mac como en Android después de actualizar ZimaOS, e IceWhale preguntó específicamente por firewalls, VPN, proxies, cambios de ISP y configuración de red. Un buen proceso de diagnóstico separa el estado de la cuenta o la sesión de la accesibilidad de la red.
Paso 1: Confirma que el servidor funciona localmente
Abre el panel de ZimaOS directamente mediante la IP de la LAN en un navegador. Si el servidor funciona localmente, pero ZimaClient no puede conectarse, centra la atención en la capa del cliente, la sesión o el acceso remoto.
Paso 2: Cierra sesión y vuelve a iniciarla
El usuario original ya había reinstalado ZimaClient y reiniciado ZimaOS sin éxito. Cerrar sesión en ZimaClient y volver a autenticarse restableció la conexión.
Esto sugiere que intervino un estado obsoleto del cliente o de la sesión, pero el hilo no demostró exactamente qué token o estado de red cambió.
Paso 3: Comprueba el acceso remoto en ZimaOS
La guía actual de acceso remoto de ZimaOS indica que el acceso remoto puede activarse o desactivarse en Ajustes → Red.
Asegúrate de que esté activado si esperas que ZimaClient funcione fuera de casa.
Paso 4: Prueba en la misma LAN
Las instrucciones actuales de configuración inicial de ZimaOS recomiendan realizar la primera conexión en la misma red. Si ZimaClient no puede conectarse ni siquiera localmente, la traducción de NAT remota no es el primer problema que debes investigar.
Paso 5: Comprueba la VPN, el proxy, el firewall y los cambios de red
El equipo de soporte de IceWhale preguntó específicamente si el usuario había cambiado el firewall, la VPN o el proxy, el ISP o la administración de la red antes de que apareciera el fallo.
Desactiva temporalmente los clientes de VPN o proxy que puedan causar conflictos durante el diagnóstico y confirma que el permiso de red local de macOS permite a ZimaClient descubrir dispositivos.
Paso 6: Reinicia los procesos bloqueados de ZimaClient
La guía de instalación de ZimaClient recomienda usar Monitor de Actividad para cerrar los procesos relacionados con Zima cuando la aplicación parece estar ejecutándose, pero no funciona correctamente.
Paso 7: Recopila los registros antes de volver a reinstalar
La documentación actual indica que los registros de ZimaClient en macOS se encuentran en:
~/Library/Application Support/Zima/logs
Recógelos inmediatamente después de reproducir el problema para que el equipo de soporte pueda distinguir entre fallos de descubrimiento, autenticación y red remota.
Usa herramientas VPN estándar como alternativa
El ZimaOS actual también admite Tailscale, WireGuard Easy, Firefly y NetBird como opciones alternativas de red remota. No sustituyen la integración de copias de seguridad o del Finder de ZimaClient, pero pueden proporcionar una ruta de red privada independiente.
La guía de conexión remota ayuda a comparar esas capas.
Distingue la autenticación de la conectividad
Si el Mac puede descubrir el servidor, pero la autenticación falla, comprueba la misma cuenta de ZimaOS en la interfaz web local. Si la cuenta funciona en el navegador, pero no en ZimaClient, es probable que el problema esté en el estado del cliente o de la sesión, y no en la contraseña.
Si ni el navegador ni el cliente pueden acceder al servidor mediante su IP, soluciona primero el problema del servidor o de la LAN.
Comprueba el permiso de red local de macOS
macOS puede restringir la capacidad de una aplicación para descubrir dispositivos en la red local. Si ZimaClient no muestra un dispositivo ZimaOS cercano, revisa el permiso de red local de la aplicación en los ajustes de Privacidad y seguridad de macOS y reinicia el cliente después de cambiarlo.
Restablece solo la capa que está dañada
No restablezcas el servidor ZimaOS, el Remote ID, la contraseña y la instalación del cliente al mismo tiempo. Cambia una sola capa cada vez para saber qué solucionó realmente el problema.
El caso de origen es un buen ejemplo: reiniciar el servidor y reinstalar el cliente no ayudó; cerrar sesión y volver a iniciarla sí. Esta evidencia apunta al estado de la sesión y no a una instalación dañada del servidor.
Cuándo usar una ruta remota alternativa
Si ZimaClient sigue sin estar disponible, pero el servidor funciona correctamente, una ruta de Tailscale o WireGuard configurada por separado puede mantener disponible la administración mientras recopilas los registros. Úsala como una ruta de red independiente, no como prueba de que el problema de ZimaClient se haya solucionado.
Preguntas frecuentes
¿Por qué no ayudó reinstalar ZimaClient?
Una reinstalación puede dejar sin cambios las condiciones de la cuenta, la sesión o la red. En el caso de origen verificado, la acción que restableció el servicio fue cerrar sesión y volver a iniciarla.
¿Por qué puede funcionar SMB mientras ZimaClient falla?
SMB en la LAN y la conectividad remota o de sesión de ZimaClient pertenecen a capas diferentes. Una puede funcionar mientras la otra está averiada.
¿Dónde están los registros de ZimaClient para Mac?
La documentación oficial actual indica ~/Library/Application Support/Zima/logs.
¿Debo restablecer mi contraseña de ZimaOS?
No solo porque ZimaClient muestre «Conectando». Primero verifica el inicio de sesión directo, cierra sesión y vuelve a iniciarla, comprueba el estado de la red y revisa los registros.
