Solução da comunidade

Como instalar o ZimaOS numa VM do Proxmox para testes

A May 2025 community tutorial documented a simple Proxmox test installation using UEFI and USB passthrough. Later replies added a third-party automation script and clarified that QEMU Guest Agent is not straightforward on stock ZimaOS.

O ZimaOS pode ser instalado numa máquina virtual Proxmox para testes, e um tutorial da IceWhale Community de maio de 2025 documentou um método simples que utiliza firmware UEFI e passagem direta de USB. O autor original criou uma VM normal, selecionou OVMF/UEFI, encaminhou um instalador USB para a VM, colocou esse USB em primeiro lugar na ordem de arranque e iniciou o instalador do ZimaOS a partir da consola do Proxmox.

Isto deve ser encarado como um fluxo de trabalho de teste da comunidade, e não como uma garantia de que todas as funcionalidades do ZimaOS são oficialmente suportadas em virtualização. Publicações posteriores da comunidade observaram explicitamente que o ZimaOS foi concebido como um sistema operativo autónomo e que as implementações virtualizadas podem introduzir limitações relacionadas com virtualização aninhada, passagem direta de dispositivos, armazenamento e agentes convidados. Em 2026, outro utilizador também relatou dificuldades em reproduzir o processo antigo do Proxmox com instaladores mais recentes do ZimaOS; por isso, utilize as capturas de ecrã históricas para compreender a arquitetura, sem presumir que todos os passos exatos de 2025 permanecem inalterados.

Passo 1: Criar a VM Proxmox com UEFI

A definição de VM mais importante do tutorial de origem era o tipo de firmware. Durante a criação da VM, selecione uma BIOS OVMF/UEFI em vez de SeaBIOS.

Configuração de uma VM Proxmox a mostrar a opção de BIOS UEFI necessária para a instalação de teste do ZimaOS
O tutorial original da comunidade utilizava OVMF/UEFI para a máquina virtual ZimaOS.

Se a VM já tiver sido criada com o firmware incorreto, o autor original indicou que este poderia ser alterado a partir de:

VM → Hardware → BIOS → OVMF (UEFI)

A publicação histórica indicava que não era necessário um disco EFI para essa configuração de teste específica. Um script Proxmox-ZimaOS de terceiros mais recente cria agora armazenamento EFI no seu fluxo de trabalho manual; encare isto como uma diferença de versão/ferramenta e não como uma contradição.

Exemplo de definição de VM do tópico original

Exemplo de definição de hardware de uma máquina virtual Proxmox utilizada para testar o ZimaOS
A publicação de origem fornecia esta definição de VM como exemplo, e não como um perfil obrigatório de recursos.

A CPU, a memória, o tamanho do disco virtual e as definições de rede podem ser ajustados para corresponder à carga de trabalho de teste. Não utilize uma VM pequena para avaliar o desempenho de armazenamento, Docker, transcodificação ou ZVM que será posteriormente executado em hardware real.

Passo 2: Utilizar o instalador atual do ZimaOS

O tutorial de 2025 indicava aos leitores que deveriam transferir a imagem mais recente do instalador do ZimaOS.

Página de transferência do ZimaOS apresentada no tutorial original de instalação do ZimaOS numa VM Proxmox
A versão exata apresentada nesta captura de ecrã é histórica; para um novo teste, utilize o instalador atual do ZimaOS.

O modelo de lançamento e distribuição do instalador do ZimaOS mudou desde este tópico de 2025. Evite codificar os nomes antigos das imagens beta 1.4.0 ou 1.4.1 num fluxo de trabalho atual.

Passo 3: Gravar o instalador numa unidade USB

O autor original gravou o instalador numa unidade USB física com o Balena Etcher e, em seguida, ligou esse dispositivo USB ao anfitrião Proxmox físico.

Este método é simples porque reproduz um percurso normal de instalação em hardware físico dentro da máquina virtual. Requer, no entanto, um dispositivo USB disponível e a transmissão USB do Proxmox.

Passo 4: Transmitir o USB instalador para a máquina virtual

No Proxmox:

Máquina virtual → Hardware → Adicionar → Dispositivo USB

Selecione Utilizar porta USB e escolha a porta que contém a unidade de instalação do ZimaOS.

Caixa de diálogo Adicionar dispositivo USB do Proxmox utilizada para transmitir o instalador do ZimaOS para a máquina virtual
O fluxo de trabalho original associava diretamente o USB físico de instalação à máquina virtual do ZimaOS.

Passo 5: Colocar o USB em primeiro na ordem de arranque

Abra:

Máquina virtual → Opções → Ordem de arranque

Ative o dispositivo USB transmitido e mova-o para cima do disco de sistema da máquina virtual.

Ordem de arranque do Proxmox com o USB instalador do ZimaOS ativado como primeiro dispositivo de arranque
A máquina virtual tem de arrancar o instalador antes do disco de destino vazio.

Passo 6: Iniciar a máquina virtual e executar o instalador

Abra a Consola do Proxmox e inicie a máquina virtual. Deverá aparecer o instalador do ZimaOS. Instale o ZimaOS no disco virtual pretendido e, depois de concluir a instalação, remova ou despromova o suporte de instalação.

O autor original relatou que o ZimaOS 1.4.0 e o 1.4.1-beta2 arrancaram nesta configuração, enquanto o 1.4.1-beta1 não arrancou. Estes resultados específicos de versões são históricos e não devem ser utilizados para escolher uma versão atual.

Uma resposta posterior da comunidade indicou um script de automatização do Proxmox

Em julho de 2025, outro participante afirmou ter instalado o ZimaOS no Proxmox com um script. Essa ligação aponta agora para o repositório R0GGER/proxmox-zimaos de terceiros.

Atualmente, o repositório suporta fluxos de instalação automáticos e manuais. A documentação própria indica uma limitação atual importante: a distribuição do ZimaOS passou de imagens publicadas diretamente para instaladores, pelo que o script automático pode instalar uma base mais antiga e, em seguida, exigir uma atualização dentro do ZimaOS.

O repositório também contém um vídeo de instalação separado, mas esse vídeo não estava incorporado na publicação original da IceWhale, pelo que é mantido como referência externa em vez de ser migrado como conteúdo de origem.

Reveja os scripts de instalação de terceiros antes de os executar

O repositório da comunidade fornece comandos que descarregam um script de shell e o executam diretamente no nó Proxmox. É conveniente, mas dá ao script controlo administrativo sobre a criação de máquinas virtuais, o armazenamento e a rede.

Reveja o código-fonte do script antes de o executar num anfitrião Proxmox que contenha máquinas virtuais ou discos importantes. Um anfitrião de virtualização é um sistema de alto impacto, e um destino de armazenamento incorreto pode destruir dados.

O QEMU Guest Agent é uma limitação conhecida no ZimaOS de origem

Uma resposta posterior perguntou como instalar qemu-guest-agentO membro da comunidade gelbuilding relatou que o ZimaOS de origem é um sistema imutável e bloqueado, sem um fluxo normal de gestor de pacotes para instalar o agente convidado.

Também tentaram executar o agente no Docker, mas o canal virtio do Proxmox:

/dev/virtio-ports/org.qemu.guest_agent.0

não funcionou corretamente através do contentor durante o teste.

Por conseguinte, o tópico de origem não fornece uma solução confirmada para o QEMU Guest Agent no ZimaOS de origem. Não prometa a funcionalidade normal do agente convidado apenas porque a VM arranca.

O ZimaOS virtualizado é útil para testes, mas tem limitações de suporte

Outra resposta do suporte da comunidade do ZimaOS, em dezembro de 2025, afirmou que o ZimaOS foi concebido como um sistema operativo autónomo e que os ambientes virtuais não são oficialmente suportados, embora os utilizadores tenham conseguido fazer funcionar o Proxmox e o VirtualBox.

Isto significa que uma VM Proxmox é excelente para:

  • avaliar a WebUI;
  • testar aplicações Docker;
  • aprender a utilizar a interface de armazenamento;
  • experimentar atualizações antes de as transferir para um sistema de teste separado.

É menos representativo para:

  • gestão direta dos discos;
  • passagem direta de USB;
  • passagem direta da GPU;
  • virtualização aninhada do ZVM;
  • suspensão e gestão de energia do hardware;
  • Integração do QEMU Guest Agent.

Nota sobre o acesso SMB no Windows 10 nas respostas

Um utilizador posterior relatou que o Windows 11 e o Linux Mint detetaram imediatamente a VM do ZimaOS, enquanto o Windows 10 exigiu o mapeamento manual de uma unidade de rede com Ligar com credenciais diferentes.

Este é um detalhe da autenticação SMB do cliente, não um requisito de rede do Proxmox. Se a WebUI do ZimaOS funcionar, mas o Windows não conseguir montar uma partilha, resolva as credenciais SMB separadamente do adaptador de rede básico da VM.

Lista de verificação do ZimaOS no Proxmox

  1. Crie uma VM com firmware UEFI/OVMF para testes.
  2. Atribua CPU, RAM, disco e rede em bridge suficientes para a carga de trabalho que pretende avaliar.
  3. Utilize o instalador atual do ZimaOS em vez de uma imagem beta antiga da publicação de 2025.
  4. Para o fluxo de trabalho original, grave o instalador numa pen USB e faça a passagem direta para a VM.
  5. Coloque o instalador em primeiro lugar na ordem de arranque.
  6. Instale no disco virtual e, em seguida, remova ou despromova o suporte de instalação.
  7. Não presuma que o QEMU Guest Agent está disponível no ZimaOS de origem.
  8. Analise os scripts de terceiros para Proxmox antes de os executar como root.
  9. Utilize uma VM para testes, não como prova de que todas as funções do ZimaOS específicas do hardware são oficialmente suportadas.

Perguntas frequentes sobre o ZimaOS no Proxmox

O ZimaOS pode ser executado no Proxmox?

Sim, utilizadores da comunidade conseguiram executá-lo com êxito para testes. O tutorial de origem utilizou UEFI e passagem direta de USB.

O Proxmox é uma implementação do ZimaOS oficialmente suportada?

As respostas do suporte da comunidade descreveram o ZimaOS virtualizado como não suportado, embora o Proxmox e o VirtualBox possam funcionar. Considere-o uma implementação comunitária/de teste.

Preciso de UEFI?

O tutorial original utilizou OVMF/UEFI e identificou-o como a definição crítica do firmware.

Posso instalar o qemu-guest-agent?

O tópico de origem não encontrou um método funcional com o ZimaOS de origem. O sistema imutável e o acesso ao canal virtio foram os obstáculos identificados.