Solução da comunidade

Executar o Roon Server no ZimaOS: Docker Compose, rede de anfitrião e resolução de problemas de descoberta

A January-April 2026 thread where a community Docker Compose setup worked for the original poster. Zima-Jerry also shared a native-install script, while later connectivity problems were resolved after network checks and a router reboot. The Docker project remains maintained.

O Roon Server pode ser executado no ZimaOS, embora o utilizador da fonte não o tenha encontrado como pacote normal de aplicação na App Store. O primeiro método funcional no tópico utilizou o projeto mantido elgeeko/roon-server uma imagem Docker com dados persistentes do Roon, um mapeamento de música só de leitura e a rede do anfitrião, para que o Roon Remote e os dispositivos RAAT pudessem descobrir o servidor.

O autor da publicação original confirmou que este método Docker funcionava. Um mês mais tarde, o próprio Roon Server foi atualizado e os clientes deixaram de conseguir ligar-se, embora o processo do servidor continuasse em execução. Seguir as verificações de rede da comunidade — incluindo reiniciar o router — restaurou o acesso, o que tornou uma explicação relacionada com a descoberta/estado da rede mais provável do que uma instalação do ZimaOS danificada.

O método Docker da comunidade foi confirmado como funcional

A configuração de origem armazenava o estado do Roon em AppData persistente do ZimaOS, mapeava a biblioteca de música como só de leitura e utilizava network_mode: hoste reiniciava o contentor, exceto se este fosse parado manualmente.

O autor da publicação original respondeu no dia seguinte que o Roon estava a funcionar e podia ser acedido a partir dos seus computadores e dispositivos móveis.

Utilize o projeto Docker mantido do Roon, não a etiqueta antiga fixada

A resposta de 2026 fixou uma etiqueta de imagem antiga. O projeto atual documenta agora elgeeko/roon-server, transfere o Roon Server atual na primeira inicialização e mantém as atualizações subsequentes efetuadas na aplicação.

Consulte o projeto Docker mantido do Roon Server antes de copiar o fragmento histórico do Compose sem alterações.

Persistir os dados e a cache do Roon

O projeto atual separa os dados do Roon Server em /opt/RoonServer e a cache/estado em /var/roon. A sua biblioteca de música é outro volume e pode ser mapeada como só de leitura.

Manter a base de dados do Roon num armazenamento SSD/NVMe rápido pode melhorar a capacidade de resposta para bibliotecas grandes, enquanto a música pode ficar num armazenamento de maior capacidade e mais lento.

Porque é comum usar a rede do anfitrião com o Roon

O Roon utiliza intensivamente multicast e descoberta local. O projeto Docker mantido afirma explicitamente que a rede bridge normal não encaminha todo o tráfego de descoberta RAAT de forma fiável sem configuração adicional de encaminhamento/reflexão.

Ao utilizar o ZimaCube como servidor

A rede do anfitrião é o modo de implementação mais simples, embora o projeto também documente o macvlan como alternativa mais isolada numa rede Ethernet com fios.

Os DAC USB requerem acesso adicional a dispositivos Se o servidor apenas enviar áudio para dispositivos RAAT ligados à rede, o contentor básico com rede do anfitrião poderá ser suficiente. Se o próprio Roon Server tiver de utilizar um DAC USB ou um dispositivo de som local, o projeto atual documenta o acesso a, /dev/bus/usb/dev/snd

Não adicione esses mapeamentos de dispositivos se não for necessário utilizar hardware de áudio local.

Zima-Jerry também partilhou um script de instalação nativa

Um membro da equipa da IceWhale partilhou um script que modificava a instalação oficial do Roon para Linux, de modo que os dados fossem armazenados no AppData do ZimaOS e a aplicação principal em /opt/roon.

Essas eram as orientações do fórum oficial para o período em questão, mas mais tarde um utilizador disse que a instalação através do script não tinha funcionado consigo. A abordagem Docker tem a confirmação mais clara do autor original e um projeto comunitário upstream mantido.

O caso posterior “O Roon está a funcionar, mas nada se liga” estava relacionado com a rede

Em fevereiro, o autor original disse que o Roon tinha sido atualizado, que o servidor continuava a funcionar, mas que os clientes para PC/iPhone/iPad não conseguiam ligar-se. A comunidade verificou o estado do contentor, a rede do anfitrião, os registos e o estado do router.

Mais tarde, o utilizador disse que as verificações rápidas da rede resolveram o problema e considerou que reiniciar o router tinha sido decisivo. Os registos mostraram Ligação reiniciada pelo par, consistente com uma ligação de rede interrompida.

A fixação do contentor e as atualizações na aplicação do Roon são separadas

Fixar a imagem Docker controla a versão do contentor intermediário. O software Roon Server dentro deste projeto pode ser atualizado e persistir os dados de forma independente. Faça uma cópia de segurança do volume de dados do Roon antes de alterações importantes, para que a recriação de um contentor não se transforme numa recuperação da base de dados.

O script nativo do fórum oficial deu resultados variados aos utilizadores

Zima-Jerry disse que o seu script apenas alterava as localizações de instalação do instalador oficial do Roon para Linux: os dados da aplicação eram guardados no AppData do ZimaOS e a instalação principal do Roon ficava em /opt/roon. Também disse que tinha testado o script de instalação várias vezes no ZimaOS.

No entanto, outro utilizador relatou mais tarde que o script foi interrompido e deixou a instalação do servidor Roon a funcionar num ciclo infinito. Isto significa que o script não deve ser apresentado como universalmente mais fiável do que o método Docker simplesmente por ter sido publicado pela equipa.

A instalação nativa também tinha um procedimento de desinstalação confirmado

Quando esse utilizador posterior perguntou como limpar a instalação nativa que tinha falhado, Zima-Jerry forneceu o mesmo script com um desinstalar argumento. O utilizador respondeu que a limpeza funcionou.

Isto constitui uma evidência útil da fonte, porque a instalação nativa altera o anfitrião ZimaOS em vez de um contentor Docker descartável. Se experimentar o script da equipa, registe o procedimento de desinstalação antes de o implementar num servidor de produção.

Por que motivo o Docker continua a ser a opção predefinida mais simples para a maioria dos utilizadores do ZimaOS

A opção Docker mantém o ambiente de execução do Roon separado do sistema operativo do appliance, torna explícitos os caminhos persistentes e é suportada por um projeto público mantido, cuja definição do Compose pode ser analisada antes da implementação. Se o contentor avariar, a imagem pode ser recriada sem reinstalar o sistema operativo base.

A instalação nativa pode continuar a ser útil para utilizadores que pretendam especificamente utilizar o Roon fora do Docker, mas aumenta a superfície de manutenção ao nível do anfitrião.

Teste a descoberta após cada alteração de rede

A interrupção posterior do Roon no tópico original ocorreu depois de uma atualização, enquanto o processo do servidor permanecia ativo. Isto é um forte lembrete de que “serviço em execução” e “o Roon Remote consegue descobri-lo” são testes diferentes.

Depois de alterar o router, as VLAN, a VPN, o modo de rede do Docker ou a interface do servidor, confirme a descoberta a partir de pelo menos um cliente Roon Remote antes de presumir que a base de dados ou o software do servidor estão danificados.

Proteja a base de dados do Roon, não apenas a música

A biblioteca de música pode muitas vezes ser novamente analisada a partir dos ficheiros de origem, mas a base de dados do Roon contém edições, decisões de metadados, listas de reprodução, histórico e outros dados de estado. Faça uma cópia de segurança independente do volume persistente do Roon, separada da pasta de música.

Perguntas frequentes sobre o Roon no ZimaOS

O método Docker foi confirmado pelo autor da publicação original?

Sim. Relataram que o Roon funcionava depois de seguirem a configuração baseada em Compose.

Porquê utilizar a rede do anfitrião?

Simplifica a descoberta do Roon/RAAT na LAN.

Uma interrupção posterior da ligação exigiu reinstalar o Roon?

Não. O utilizador original recuperou após resolver problemas de rede e reiniciar o router.