Conclusão: não faça o ZimaOS depender de um contentor AdGuard executado no mesmo anfitrião ZimaOS como único resolvedor DNS
A atualização falhou por um motivo previsível: o ZimaOS precisava de DNS para obter a nova imagem do AdGuard, mas o único servidor DNS configurado era o contentor AdGuard que estava a ser reiniciado/substituído. Isto cria uma dependência circular. Um segundo campo DNS melhoraria a resiliência, mas a arquitetura não deve depender do serviço que está a ser atualizado para resolver o servidor de atualização.
A documentação atual do ZimaOS continua a descrever um único campo manual de servidor DNS
O guia de configuração de rede do ZimaOS de setembro de 2026 descreve o modo manual como endereço IP, máscara de sub-rede, gateway e servidor DNS no singular. O guia público não documenta atualmente várias entradas DNS na interface gráfica, por isso não assuma que o pedido de funcionalidades de 2025 tenha sido implementado.
Utilize um resolvedor independente para o anfitrião ZimaOS
Um design adequado é:
- Anfitrião ZimaOS → router/ISP/Cloudflare/outro resolvedor independente.
- Clientes da LAN → AdGuard Home para filtragem.
- Servidor upstream do AdGuard → os resolvedores em que confia.
Isto permite que o AdGuard seja reiniciado ou atualizado sem retirar ao anfitrião a capacidade de resolver registos Docker e serviços remotos.
O guia de hardware do AdGuard Home aborda a função da aplicação, enquanto o guia DNS do Pi-hole reforça a mesma separação entre a filtragem DNS dos clientes e as dependências da infraestrutura do anfitrião.
O DNS secundário nem sempre proporciona uma comutação automática rigorosa
Muitos sistemas operativos e resolvedores podem consultar vários servidores DNS configurados, em vez de tratarem o segundo como “apenas se o primeiro estiver indisponível”. Assim, se todos os clientes tiverem de ser filtrados, atribuir-lhes um resolvedor público como secundário pode permitir que algumas consultas contornem o AdGuard. Coloque a redundância atrás da camada de filtragem ou mantenha o resolvedor independente apenas nos anfitriões da infraestrutura.
Referências de resolvedores públicos
A Cloudflare documenta os seus endereços do resolvedor 1.1.1.1, e a Google documenta a configuração do Google Public DNS. Utilize o serviço que melhor corresponda aos seus requisitos de privacidade, filtragem e disponibilidade.
Teste rápido antes de atualizar um contentor DNS local
nslookup registry-1.docker.io
nslookup github.comEm seguida, pare temporariamente o contentor AdGuard e repita a consulta a partir do anfitrião ZimaOS. Se o DNS deixar de funcionar, o anfitrião continua a ter uma dependência circular que pode interromper a próxima atualização do contentor DNS.
