Solução da comunidade

Nome de anfitrião personalizado de aplicações no ZimaOS 1.7 Beta: o que mudou

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.

A versão beta do ZimaOS 1.7 alterou a forma como o URL Web de um mosaico de aplicação podia ser editado: os utilizadores podiam alterar o protocolo, a porta e o caminho, mas o nome do anfitrião estava associado ao endereço do painel do ZimaOS. Isto não impedia o Nginx Proxy Manager ou o DNS local de disponibilizarem um domínio personalizado de forma independente.

Na altura, uma resposta da equipa da IceWhale confirmou que a edição do nome do anfitrião não estava disponível no editor visual e indicou que a equipa planeava repô-la. A versão atual do ZimaOS 1.7.1 melhora as definições de portas dos URLs Web do Docker e o tratamento de URLs, mas o registo de alterações publicado não indica explicitamente que a edição arbitrária do nome do anfitrião no formulário visual tenha sido restaurada.

O que a versão beta 1.7 alterou realmente

Campo de URL Web de uma aplicação na versão beta do ZimaOS 1.7, com nome do anfitrião fixo
O editor de aplicações da versão beta apresentava o nome do anfitrião como fixo, enquanto o protocolo, a porta e o caminho continuavam editáveis. Fonte: Fórum da Comunidade IceWhale.

O utilizador tinha uma configuração de DNS local e proxy inverso, como https://app.example.net/. No editor da versão beta, já não era possível configurar o próprio mosaico da aplicação para abrir esse nome de anfitrião personalizado.

Uma reprodução feita pela comunidade mostrou que a definição manual de x-casaos.hostname podia permanecer no YAML, enquanto o formulário e o mosaico da aplicação continuavam a utilizar o IP do painel. Posteriormente, a equipa da IceWhale confirmou que o campo visual do nome do anfitrião estava temporariamente indisponível.

O seu proxy inverso pode continuar a utilizar o domínio personalizado

A limitação descrita no tópico dizia respeito ao URL aberto pelo mosaico da aplicação do ZimaOS, e não à possibilidade de o Nginx Proxy Manager, o AdGuard Home ou outra infraestrutura de DNS/proxy inverso encaminhar um nome de anfitrião personalizado para a porta publicada da aplicação.

Se o seu proxy já encaminha um domínio para o IP correto do ZimaOS e para a porta da aplicação, mantenha esse percurso do proxy separado da definição do mosaico do painel. O guia de proxy inverso HTTPS do ZimaOS explica essa arquitetura.

O que o ZimaOS 1.7.1 confirma

O registo de alterações do ZimaOS 1.7.1 lista uma configuração mais flexível das portas dos URLs Web e um tratamento melhorado dos URLs do Docker. Não documenta especificamente a restauração do antigo editor do nome do anfitrião.

A atual referência de metadados das aplicações do ZimaOS documenta port_map, scheme e index para URLs de entrada das aplicações. Teste o editor estável atual antes de reconstruir uma configuração de proxy existente com base num comportamento antigo da versão beta.

É necessário reverter a versão beta?

Para este problema específico, o conselho no fórum foi não avançar imediatamente para uma reversão, porque os próprios domínios personalizados continuavam a funcionar através do proxy inverso. Atualmente, o melhor primeiro passo é atualizar para a versão estável atual do ZimaOS, fazer uma cópia de segurança da configuração das aplicações e verificar aí o comportamento dos mosaicos.

Se importar ou reparar YAML de aplicações, o guia de Docker Compose personalizado é uma referência mais segura do que copiar sem alterações uma solução alternativa da época da versão beta.