Soluzione della community

Nome host personalizzato per le app in ZimaOS 1.7 Beta: cosa è cambiato

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 ha modificato il modo in cui era possibile modificare l’URL Web del riquadro di un’app: gli utenti potevano cambiare il protocollo, la porta e il percorso, ma il nome host era legato all’indirizzo della dashboard di ZimaOS. Ciò non impediva a Nginx Proxy Manager o al DNS locale di gestire autonomamente un dominio personalizzato.

All’epoca, una risposta del team IceWhale confermò che la modifica del nome host non era disponibile nell’editor visuale e che il team prevedeva di ripristinarla. L’attuale ZimaOS 1.7.1 migliora le impostazioni della porta dell’URL Web Docker e la gestione degli URL, ma il changelog pubblicato non dichiara esplicitamente che la modifica arbitraria del nome host nel modulo visuale sia stata ripristinata.

Cosa ha effettivamente cambiato la beta 1.7

Campo dell’URL Web dell’app nella beta di ZimaOS 1.7 con nome host fisso
L’editor delle app nella beta mostrava il nome host come fisso, mentre protocollo, porta e percorso restavano modificabili. Fonte: forum della community IceWhale.

L’utente disponeva di una configurazione DNS locale e reverse proxy, ad esempio https://app.example.net/. Nell’editor della beta, non era più possibile configurare il riquadro dell’app affinché aprisse quel nome host personalizzato.

Una riproduzione nella community mostrò che l’impostazione manuale di x-casaos.hostname poteva rimanere nel file YAML, mentre il modulo e il riquadro dell’app continuavano a utilizzare l’IP della dashboard. Lo staff di IceWhale confermò quindi che il campo visivo del nome host era temporaneamente non disponibile.

Il reverse proxy può continuare a utilizzare il dominio personalizzato

La limitazione descritta nella discussione riguardava l’URL aperto dal riquadro dell’app di ZimaOS, non la possibilità per Nginx Proxy Manager, AdGuard Home o un altro stack DNS/reverse proxy di instradare un nome host personalizzato verso la porta pubblicata dell’app.

Se il proxy inoltra già un dominio all’IP corretto di ZimaOS e alla porta dell’app, mantieni separato il percorso del proxy dall’impostazione del riquadro della dashboard. La guida al reverse proxy HTTPS di ZimaOS illustra questa architettura.

Cosa conferma ZimaOS 1.7.1

Il changelog di ZimaOS 1.7.1 elenca una configurazione più flessibile della porta dell’URL Web e una gestione migliorata degli URL Docker. Non documenta nello specifico il ripristino del precedente editor del nome host.

L’attuale riferimento ai metadati delle app di ZimaOS documenta port_map, scheme e index per gli URL di accesso alle app. Prova l’editor della versione stabile attuale prima di ricostruire una configurazione proxy esistente basandoti sul comportamento di una vecchia beta.

Devi effettuare il downgrade dalla beta?

Per questo problema specifico, il consiglio del forum era di non affrettarsi a eseguire un rollback, poiché i domini personalizzati continuavano a funzionare tramite il reverse proxy. Oggi, il primo passo consigliato è passare alla versione stabile corrente di ZimaOS, eseguire il backup della configurazione delle app e verificare lì il comportamento del riquadro dell’app.

Se importi o ripristini file YAML delle app, la guida a Docker Compose personalizzato è un riferimento più sicuro rispetto a copiare senza modifiche una soluzione alternativa dell’epoca della beta.