Solução da comunidade

Porque é que o apt e o yum não funcionam no ZimaOS: Buildroot, módulos zpkg, contentores e WebDAV

A November 2024-July 2025 thread where apt, apt-get, and yum failed because ZimaOS is Buildroot-based rather than Debian/Ubuntu. A later user wanted davfs2 for a host-level WebDAV mount so it would appear in Files. IceWhale did not provide an apt-style package-manager solution and instead explored container alternatives.

apt install, apt-get update, yum install falham no ZimaOS porque o ZimaOS não é uma distribuição generalista ao estilo de Debian, Ubuntu, Fedora ou RHEL. É criado com Buildroot como sistema operativo de appliance e mantém a maioria das pastas do sistema só de leitura.

O ZimaOS atual dispõe de mecanismos semelhantes a gestores de pacotes para fins específicos — sobretudo módulos zpkg, e alguma documentação de desenvolvimento utiliza Entware/opkg para ferramentas especializadas. Istonão transforma o sistema operativo base numa distribuição Linux normal e mutável, onde seja possível instalar e integrar pacotes arbitrários no sistema anfitrião como pacotes Debian.

O utilizador de origem tentou apt, apt-get e yum

A publicação original de 2024 relatava que as três abordagens de gestores de pacotes falharam através de SSH. Uma resposta da comunidade explicou que o ZimaOS é criado com Buildroot e combina componentes Linux, glibc, systemd, Docker e virtualização sem uma base de dados de pacotes ao estilo Debian.

Essa explicação arquitetural continua correta.

O ZimaOS atual mantém a maioria dos caminhos do sistema só de leitura

A orientação atual da IceWhale para a CLI afirma explicitamente que a maioria das pastas do sistema permanece só de leitura, mesmo como root. Os dados do utilizador e os dados das aplicações devem ficar em /DATA.

Consulte o modelo atual do sistema de ficheiros CLI do ZimaOS.

Para aplicações, o Docker é o principal modelo de extensões

Se o software existir como uma imagem Docker mantida ou uma stack Compose, essa é normalmente a forma de implementação mais nativa do ZimaOS. As dependências permanecem dentro do contentor e não modificam o sistema operativo base.

É por isso que a resposta da IceWhale ao pedido posterior sobre WebDAV explorou uma aplicação baseada em Docker, em vez de dizer ao utilizador para instalar davfs2 com o APT.

zpkg é um gestor de módulos do ZimaOS, não o apt

O ZimaOS atual utiliza zpkg para módulos de sistema instaláveis, como extensões de IA/pesquisa e módulos da comunidade/oficiais. Um módulo é criado para o mecanismo de extensões do ZimaOS e pode incluir a sua própria política de serviço.

Não é um substituto genérico para nomes arbitrários de pacotes Debian, como davfs2 pode ser instalado.

A IceWhale também documenta o opkg para ambientes de desenvolvimento especializados

A orientação atual da IceWhale para Python/desenvolvimento indica a instalação do Entware em /opt e depois utilizar opkg para utilitários de desenvolvimento, como git-http.

Este é um padrão avançado suportado nesse guia específico, não uma autorização para presumir que todos os daemons Linux instalados a partir do Entware serão integrados de forma segura no arranque, nos Ficheiros, na rede ou nos serviços de armazenamento do ZimaOS.

Utilize o fluxo de trabalho atual de desenvolvimento com Entware/opkg apenas quando corresponder ao caso de utilização pretendido.

O Pedido Posterior de WebDAV Precisava de Integração ao Nível do Anfitrião

O utilizador de 2025 queria que uma unidade de nuvem WebDAV fosse montada ao nível do sistema operativo, para que se tornasse acessível através da experiência do ZimaOS Files e a outras aplicações. Especificou explicitamente que uma aplicação separada ao estilo AList não era equivalente.

Esse requisito é mais difícil do que “executar um contentor de cliente WebDAV”, porque uma montagem do contentor não se torna automaticamente numa montagem nativa do anfitrião, visível no Files e em todos os outros contentores.

Um Contentor Também Pode Resolver Alguns Fluxos de Trabalho WebDAV

Se o objetivo real for navegar, sincronizar ou copiar dados para um fornecedor WebDAV, uma ferramenta em contentor pode ser mais segura do que alterar o anfitrião. Entre os exemplos incluem-se clientes de sincronização, gestores de ficheiros ou ferramentas de cópia de segurança que suportem diretamente WebDAV.

Mapeie apenas as pastas do ZimaOS de que o contentor necessita e mantenha as credenciais do fornecedor numa configuração protegida da aplicação.

Utilize uma VM Quando o Software Exigir um Anfitrião Linux Normal e Mutável

Se um fluxo de trabalho precisar realmente de apt install davfs2, pacotes do sistema, comportamento do FUSE/kernel ou serviços de arranque personalizados, uma VM Debian/Ubuntu pode constituir uma fronteira mais limpa. Dentro do convidado, a gestão normal de pacotes é suportada porque o convidado é efetivamente Debian/Ubuntu.

Em seguida, disponibilize os dados montados novamente ao ZimaOS ou a outros clientes através de um protocolo deliberado de rede/armazenamento, se necessário.

As Modificações do Anfitrião Têm de Sobreviver ao Ciclo de Vida Imutável

Mesmo quando uma solução avançada permite disponibilizar um binário em /opt ou /DATA, verifique:

  • o serviço é iniciado após um reinício;
  • sobrevive a atualizações OTA;
  • as credenciais persistem de forma segura;
  • a montagem existe antes de as aplicações dependentes serem iniciadas;
  • a falha não faz com que as aplicações escrevam num ponto de montagem local vazio.

Uma Montagem do Anfitrião Não É Automaticamente uma Integração com o Files

O ZimaOS Files é um serviço nativo com o seu próprio modelo de armazenamento e de localizações de rede. Criar uma montagem FUSE/WebDAV personalizada a partir de uma shell não garante que esta apareça como uma localização de primeira classe no Files, nem que receba as mesmas permissões e gestão do ciclo de vida.

Perguntas frequentes sobre o Gestor de Pacotes do ZimaOS

Porque é que o apt não funciona no ZimaOS?

O ZimaOS baseia-se no Buildroot e não utiliza a arquitetura de gestão de pacotes APT do Debian/Ubuntu.

O zpkg é um substituto geral do apt?

Não. O zpkg instala módulos do ZimaOS criados para o sistema de módulos da plataforma.

A IceWhale alguma vez documenta o opkg?

Sim, numa configuração especializada de desenvolvimento/Python que utilize o Entware em /opt. Isso não transforma o sistema operativo base numa distribuição normal e mutável.

E se eu precisar especificamente do davfs2 ou de outro daemon do anfitrião?

Prefira um contentor/módulo suportado, quando disponível, ou execute uma VM Linux de uso geral quando o fluxo de trabalho depender realmente de uma gestão normal de pacotes e de serviços do anfitrião.