Este texto tiene un resultado final sencillo: cambiar la interfaz web de ZimaOS de los puertos 80/443 interrumpió la conectividad de Zima App 2.3.0 en el ZimaBoard 2 del usuario, pero después de actualizar ZimaOS a la versión 1.5, el usuario regresó para informar que el problema se había solucionado.
Esto significa que la página no debe enseñar a los usuarios actuales a configurar manualmente un «puerto de ZimaClient» oculto basándose en el fallo de 2025. Fue un problema histórico de compatibilidad entre el cliente y un puerto personalizado de la interfaz web, y la propia fuente establece que la recuperación se produjo a partir de la versión 1.5.
El usuario cambió los puertos para Nginx Proxy Manager
Nginx Proxy Manager normalmente necesita los puertos 80 y 443 del host para el tráfico de entrada HTTP/HTTPS. Por ello, el usuario cambió ZimaOS a:
[gateway]
port = 8080
[ssl]
enabled = true
port = 30443y reinició el servicio de puerta de enlace de CasaOS/ZimaOS.
La aplicación Zima para Windows no pudo conectarse
El entorno de origen era:
- ZimaBoard 2 1664;
- kernel de ZimaOS 6.12.25;
- Zima App 2.3.0 en Windows 11.
Después de cambiar el puerto de la interfaz web, reiniciar la aplicación de Windows e intentar volver a conectarse no funcionó.
IceWhale solicitó detalles reproducibles en lugar de adivinar una configuración de puerto
Zima-Giorgio pidió al usuario que proporcionara una descripción exacta del problema, los pasos para reproducirlo, los cambios realizados anteriormente, las soluciones intentadas, el hardware, la versión del sistema operativo y la versión del cliente. Este es un buen método para recopilar evidencias, ya que el mismo fallo de conexión visible puede deberse a problemas de descubrimiento, acceso remoto, TLS, puertos o versión del cliente.
La actualización a ZimaOS 1.5 solucionó el caso de la fuente
Tres días después, ThomasSpi publicó: «Después de actualizar a Zima OS 1.5, funciona. Problema solucionado».
Esta es la conclusión más sólida de la fuente y debe sustituir las especulaciones sobre enseñar manualmente a Zima App a usar un puerto personalizado.
ZimaClient sigue evolucionando
La documentación actual de IceWhale describe ZimaClient como una herramienta que encuentra automáticamente la conexión utilizable más rápida a la interfaz web a través de la red local, la red externa, un punto de acceso y otras rutas compatibles.
Consulta el modelo actual de instalación y conexión de ZimaClient antes de reproducir una solución de la era de la versión 2.3.0.
ZimaOS 1.7.1 mejoró aún más las URL web de Docker y la gestión dinámica de redes
El registro de cambios de la versión 1.7.1 incluye una configuración más flexible de los puertos de las URL web de Docker y una gestión mejorada de las URL en entornos de red dinámicos. Estos cambios se relacionan con las URL de las aplicaciones y no demuestran nada específico sobre el antiguo error de ZimaClient, pero muestran que la gestión de puertos y URL de la plataforma ha seguido evolucionando.
El proxy inverso y ZimaClient son rutas de acceso independientes
Nginx Proxy Manager puede proporcionar dominios HTTPS fáciles de usar para las aplicaciones o incluso para el panel de ZimaOS. ZimaClient utiliza su propia lógica de descubrimiento y acceso remoto. No debe suponerse que un cambio en el proxy inverso reconfigure automáticamente ZimaClient en todas las versiones.
Si configuras el panel de ZimaOS mediante un proxy, conserva los WebSockets
Un caso posterior de la comunidad en 2026 mostró que el panel podía cargarse visualmente a través de Nginx Proxy Manager, mientras que los widgets en tiempo real y los diálogos de las aplicaciones fallaban hasta activar la compatibilidad con WebSocket. El conflicto de puertos y la configuración del proxy para WebSocket son capas independientes.
Una forma más segura de cambiar el puerto de la interfaz web
- Registra el puerto original.
- Cambia el puerto de la interfaz web mediante la interfaz compatible cuando esté disponible.
- Verifica el acceso directo desde el navegador en la nueva IP:puerto.
- Reinicia o actualiza ZimaClient y confirma el descubrimiento.
- Solo entonces asigna los puertos 80/443 al proxy inverso.
- Mantén una vía de recuperación local por si fallan tanto el proxy como el cliente.
Preguntas frecuentes sobre el cambio de puerto de ZimaClient
¿El usuario de la fuente encontró una configuración manual de puerto personalizado en Zima App?
No. El hilo terminó cuando la actualización del sistema operativo solucionó el problema.
¿Qué versión solucionó el caso de la fuente?
El usuario informó explícitamente que ZimaOS 1.5 lo solucionó.
¿Deben los usuarios actuales asumir que sigue siendo válido el comportamiento de ZimaClient 2.3.0?
No. La gestión de conexiones de ZimaClient y ZimaOS actuales es considerablemente más reciente.
