Solución de la comunidad

Nombre de host personalizado de la aplicación en ZimaOS 1.7 Beta: ¿qué cambió?

A ZimaOS 1.7 beta user found that the app installer no longer allowed a custom hostname in the Web URL field; IceWhale confirmed the visual hostname editor was temporarily unavailable.

ZimaOS 1.7 beta cambió la forma de editar la URL web del mosaico de una aplicación: los usuarios podían cambiar el protocolo, el puerto y la ruta, pero el nombre de host estaba vinculado a la dirección del panel de ZimaOS. Esto no impedía que Nginx Proxy Manager o el DNS local ofrecieran un dominio personalizado de forma independiente.

En aquel momento, una respuesta del equipo de IceWhale confirmó que la edición del nombre de host no estaba disponible en el editor visual y señaló que el equipo planeaba recuperarla. La versión actual ZimaOS 1.7.1 mejora la configuración del puerto de la URL web de Docker y el manejo de las URL, pero su registro de cambios publicado no indica explícitamente que se haya restaurado la edición de nombres de host arbitrarios en el formulario visual.

Qué cambió realmente en la beta 1.7

Campo de URL web de una aplicación en la beta de ZimaOS 1.7 que muestra un nombre de host fijo
El editor de aplicaciones de la beta mostraba el nombre de host como fijo, mientras que el protocolo, el puerto y la ruta seguían siendo editables. Fuente: foro de la comunidad de IceWhale.

El usuario tenía una configuración de DNS local y proxy inverso como https://app.example.net/. En el editor de la beta, el mosaico de la aplicación ya no podía configurarse para abrir ese nombre de host personalizado.

Una reproducción realizada por la comunidad mostró que configurar manualmente x-casaos.hostname podía conservarse en YAML, mientras que el formulario y el mosaico de la aplicación seguían utilizando la IP del panel. Posteriormente, el personal de IceWhale confirmó que el campo visual del nombre de host no estaba disponible temporalmente.

Tu proxy inverso todavía puede usar el dominio personalizado

La limitación descrita en el hilo se refería a la URL que abría el mosaico de aplicaciones de ZimaOS, no a si Nginx Proxy Manager, AdGuard Home u otra pila de DNS/proxy inverso podía dirigir un nombre de host personalizado al puerto publicado de la aplicación.

Si tu proxy ya reenvía un dominio a la IP correcta de ZimaOS y al puerto de la aplicación, mantén esa ruta del proxy separada de la configuración del mosaico del panel. La guía de proxy inverso HTTPS de ZimaOS explica esta arquitectura.

Qué confirma ZimaOS 1.7.1

El registro de cambios de ZimaOS 1.7.1 incluye una configuración más flexible del puerto de la URL web y mejoras en el manejo de las URL de Docker. No documenta específicamente la restauración del antiguo editor de nombres de host.

La referencia actual de metadatos de aplicaciones de ZimaOS documenta port_map, scheme e index para las URL de entrada de las aplicaciones. Prueba el editor estable actual antes de reconstruir una configuración de proxy existente basándote en el comportamiento de una beta anterior.

¿Necesitas volver a una versión anterior desde la beta?

Para este problema concreto, el consejo del foro era no apresurarse a revertir la versión, porque los dominios personalizados seguían funcionando mediante el proxy inverso. Hoy, el primer paso más recomendable es actualizar a la versión estable actual de ZimaOS, hacer una copia de seguridad de la configuración de las aplicaciones y verificar allí el comportamiento del mosaico.

Si importas o reparas YAML de aplicaciones, la guía de Docker Compose personalizado es una referencia más segura que copiar sin cambios una solución alternativa de la época de la beta.