Solução da comunidade

Porque é que o apt não está disponível no ZimaOS: Buildroot, ficheiros de sistema só de leitura e aplicações Docker

An October 2024 beginner thread where apt commands failed even from root/ttydBridge. The community correctly explained that ZimaOS is an appliance OS rather than Ubuntu/Debian and does not support installing host packages with apt. Current official documentation now explicitly describes ZimaOS as Buildroot-based, mostly read-only, and container-oriented.

apt: command not found no ZimaOS não significa que o sudo esteja avariado. Significa que o ZimaOS não é Ubuntu nem Debian e não inclui o fluxo de gestão de pacotes APT utilizado por essas distribuições. O utilizador da fonte, em outubro de 2024, estava autenticado como root e através do ttydBridge, mas continuava sem conseguir atualizar ou instalar pacotes no sistema anfitrião, porque não é assim que o ZimaOS foi concebido.

A documentação atual da IceWhale torna a arquitetura mais clara: o ZimaOS é baseado no Buildroot, a maioria das pastas do sistema é só de leitura mesmo para o root e espera-se que as aplicações sejam executadas através de contentores, em vez de serem instaladas no sistema operativo anfitrião com apt, yum ou ferramentas semelhantes.

O sudo não era o problema

O utilizador original pensou que os “comandos sudo” estavam a falhar porque comandos como sudo apt ... devolviam erros de comando não encontrado.

O sudo apenas altera o contexto de privilégios. Não pode criar um gestor de pacotes que não esteja instalado no sistema operativo.

O ZimaOS é baseado no Buildroot

Os guias atuais da IceWhale descrevem o ZimaOS como um sistema Buildroot ao estilo de um appliance. O Buildroot produz uma imagem Linux compacta para sistemas incorporados, em vez de uma distribuição de uso geral com uma base de dados de pacotes mutável e repositórios APT normais.

É por isso que tentar seguir tutoriais de gestão de pacotes para Debian/Ubuntu no anfitrião ZimaOS falha frequentemente, apesar de muitos comandos Linux conhecidos estarem disponíveis.

A maioria dos diretórios do sistema é intencionalmente só de leitura

As orientações atuais da CLI do ZimaOS indicam que a maioria das pastas do sistema permanece só de leitura mesmo quando o utilizador inicia sessão como root. Os dados de utilizador e das aplicações que precisam de escrita devem ficar em /DATA.

Consulte o modelo atual do sistema de ficheiros da CLI do ZimaOS antes de tentar modificar o sistema operativo base.

Utilize o Docker para aplicações de servidor

Se um tutorial disser “instale este daemon com apt”, verifique primeiro se a mesma aplicação tem uma imagem Docker mantida ou uma stack Compose. Esse é o modelo nativo de aplicações do ZimaOS e mantém as dependências separadas do anfitrião imutável.

Isto aplica-se a servidores multimédia, ferramentas de monitorização, bases de dados, clientes VPN, plataformas de automatização, serviços de documentos e muitas outras aplicações de homelab.

Utilize o ZVM quando o software precisar realmente de um anfitrião Debian/Ubuntu completo

Algumas aplicações esperam encontrar systemd, um gestor de pacotes, módulos do kernel ou vários serviços ao nível do sistema operativo. Nesse caso, uma VM Debian ou Ubuntu é uma opção mais adequada do que tentar obrigar o anfitrião ZimaOS a comportar-se como um desses sistemas.

Dentro da VM, a gestão normal de pacotes com apt funciona porque o sistema operativo convidado é efetivamente Debian/Ubuntu.

O SSH e o ttydBridge continuam a ter utilidade

O facto de a instalação de pacotes não ser suportada não torna a linha de comandos inútil. O SSH e o terminal Web continuam a ser úteis para inspeção, registos, comandos Docker, operações de ficheiros no armazenamento com escrita e resolução avançada de problemas.

As orientações atuais da IceWhale suportam tanto SSH como um terminal no navegador através do Modo de Programador.

O problema do Jellyfin do utilizador da fonte não estava relacionado com o apt

O autor original mencionou posteriormente que alguns vídeos eram reproduzidos em Ficheiros, mas não no Jellyfin. As respostas da IceWhale/comunidade encaminharam-no para a configuração dos caminhos de multimédia do Docker.

Essa é a separação correta: um problema de reprodução ou de biblioteca no Jellyfin deve ser investigado através dos mapeamentos de volumes, codecs, transcodificação e registos da aplicação — não através da instalação de pacotes aleatórios no anfitrião com APT.

Perguntas frequentes sobre o apt no ZimaOS

Posso instalar o apt no anfitrião ZimaOS?

O ZimaOS não foi concebido em torno da gestão de pacotes APT; utilize contentores ou uma VM em vez de tratar o anfitrião como Debian.

O acesso root torna as pastas do sistema editáveis?

Não. O ZimaOS mantém intencionalmente a maioria das pastas do sistema só de leitura, mesmo para o root.

Onde devem ficar os scripts personalizados e os ficheiros com escrita?

Utilize uma localização com escrita em /DATA ou outro caminho de armazenamento de dados gerido.