Este tutorial da comunidade documenta uma forma de executar o AzuraCast no ZimaOS importando uma configuração Docker Compose modificada como uma aplicação personalizada. A publicação original, de dezembro de 2025, foi testada num ZimaBoard com ZimaOS 1.5.3 Plus e destinava-se sobretudo a utilização privada ou doméstica através da rede local ou do Tailscale.
Importante: o autor atualizou posteriormente o tópico, a 5 de janeiro de 2026, e afirmou que testes adicionais demonstraram que este método de instalação era, por vezes, instável ou não funcionava, e que a atualização automática através da Web do AzuraCast também apresentava problemas com esta configuração. Esta correção posterior é mais importante do que a afirmação original de que a configuração funcionava na perfeição.
O que a configuração original do ZimaOS utilizava
O ambiente de origem era um ZimaBoard com um Intel Celeron N3450, 8 GB de memória, Intel HD Graphics 500 e ZimaOS 1.5.3 Plus. O autor importou uma definição Compose personalizada do AzuraCast através da interface de aplicações personalizadas do ZimaOS.
O processo era o seguinte:
- Abrir o painel do ZimaOS e escolher Instalar uma aplicação personalizada.
- Utilizar Importar e submeter a definição Docker Compose.
- Rever as definições geradas de web e updater antes da instalação.
- Ajustar as portas no anfitrião e os caminhos dos volumes no ZimaOS sem alterar os caminhos correspondentes dos contentores do AzuraCast.
- Instalar a aplicação e abrir o AzuraCast utilizando o endereço do servidor e a porta configurada da interface Web.
A documentação atual do ZimaOS continua a suportar a importação de YAML Docker Compose para aplicações personalizadas. Consulte a documentação atual das funcionalidades do ZimaOS.
Mapear as portas do anfitrião sem alterar as portas dos contentores
Na configuração de origem, o autor destacou os mapeamentos no anfitrião correspondentes às portas 80, 443 e 8000 dos contentores do AzuraCast. A recomendação era alterar os valores do lado do anfitrião para portas adequadas à instalação local do ZimaOS, mantendo inalterados os valores do lado dos contentores.
O separador do atualizador também incluía o endereço da interface Web. O guia indica que esta porta da interface Web deve corresponder à porta do lado do anfitrião mapeada para a porta 80 do contentor.
Manter estáveis os caminhos dos contentores do AzuraCast
O autor também remapeou o armazenamento persistente do lado do ZimaOS, mantendo inalterados os caminhos do lado do AzuraCast. A pilha publicada incluía armazenamento para estações, cópias de segurança, dados do MySQL, carregamentos, componentes opcionais e um diretório de música separado.
O guia recomendava não alterar as variáveis de ambiente, exceto se o administrador compreendesse a sua finalidade. Isto é especialmente importante porque as credenciais da aplicação e as definições da base de dados podem estar incluídas nos dados de ambiente do Compose.
Não trate o ficheiro Compose publicado como um modelo reutilizável de credenciais secretas
O YAML original do fórum contém valores de ambiente relacionados com a base de dados. Uma página da comunidade não deve transformar esses valores publicados num modelo reutilizável de credenciais. Se reconstruir esta pilha, utilize credenciais adequadas à sua própria instalação e siga as orientações atuais de configuração do AzuraCast.
Para obter informações atuais sobre a instalação e configuração a montante, utilize o guia oficial de instalação do AzuraCast com Docker.
O autor comunicou posteriormente problemas de estabilidade e atualização
Nove dias depois de publicar o guia, o mesmo autor publicou uma correção importante: experiências adicionais demonstraram que este método, por vezes, não funcionava e podia ser instável. O autor também comunicou problemas com o processo de atualização automática através da Web do AzuraCast ao utilizar este método de instalação.
O autor afirmou que estava a experimentar uma instalação baseada em SSH e que planeava um guia de acompanhamento mais detalhado, mas não foi publicado qualquer procedimento de substituição neste tópico. Por esse motivo, esta página deve ser lida como uma experiência documentada da comunidade com limitações conhecidas, e não como um método de instalação atual e oficialmente suportado do AzuraCast no ZimaOS.
Compare o método da comunidade com as orientações atuais do AzuraCast
A documentação atual do AzuraCast recomenda o Docker para a maioria das instalações autoalojadas e mantém o seu próprio fluxo de instalação e atualização com Docker. Também aconselha os utilizadores a fazerem cópias de segurança antes das atualizações, uma vez que pode ocorrer indisponibilidade da estação ou perda de dados se uma atualização falhar.
Consulte a documentação oficial de atualização do AzuraCast antes de confiar no comportamento do atualizador desta pilha histórica do ZimaOS Compose.
O guia de origem destinava-se a utilização numa rede privada
O autor apresentou explicitamente o tutorial como destinado ao acesso doméstico ou privado através da rede local ou do Tailscale. A exposição à Internet pública pode exigir decisões adicionais relativas a redes, TLS, firewall, autenticação e segurança da transmissão, que estavam fora do âmbito da publicação da comunidade.
Não assuma que uma interface Web local funcional é preparação suficiente para um serviço de rádio público.
Perguntas frequentes sobre o AzuraCast no ZimaOS
O autor da comunidade confirmou que este método é estável?
Não. A publicação original era otimista, mas o acompanhamento de 5 de janeiro de 2026 afirmou explicitamente que o método podia ser instável ou falhar em alguns testes.
Que versão do ZimaOS foi utilizada?
O guia original utilizava o ZimaOS 1.5.3 Plus num ZimaBoard. Considere as capturas de ecrã e as definições da aplicação geradas como exemplos históricos, e não como instruções exatas para todas as versões mais recentes.
Devo alterar os caminhos dos volumes do lado dos contentores do AzuraCast?
O guia de origem indica que se devem alterar, conforme necessário, os caminhos do lado do anfitrião no ZimaOS, mantendo inalterados os caminhos do lado dos contentores do AzuraCast.
Por que motivo a porta da interface Web do atualizador tem de corresponder ao mapeamento do serviço Web?
Na configuração de origem, a entrada da interface Web do atualizador apontava para a porta do anfitrião mapeada para a porta 80 do contentor. Utilizar um valor diferente faria com que o atalho do ZimaOS encaminhasse para a porta errada.
A atualização automática do AzuraCast funciona de forma fiável com esta pilha da comunidade?
O autor comunicou especificamente problemas com a atualização automática através da Web após testes adicionais. Utilize a documentação atual de atualização do AzuraCast e mantenha cópias de segurança, em vez de presumir que o contentor histórico do atualizador é fiável.
