Proxmox
Este é um guia genérico para instalar o CUBE OS no Proxmox; o host pode ser um PC antigo ou um Mini PC.
1. Preparação
Faça o download da imagem CUBE OS
Visite este repositório para baixar a imagem mais recente do CUBE OS e extraí‑la após o download.
Para Proxmox VE 9, baixe o arquivo de imagem de disco (comumente sdcard.vmdk.xz).
Extraia-o para obter o .vmdk arquivo.
Prepare um host Proxmox VE
Um Proxmox VE host com acesso de administrador (UI Web + Shell/SSH)
Se você ainda não instalou o Proxmox VE, siga o guia.
Recursos recomendados para a VM:
CPU: 2 núcleos
Memória: 4096 MB (4 GB) ou mais
Adaptador Zigbee (Opcional)
Se você precisar adicionar dispositivos Zigbee, prepare um Dongle Zigbee. Dongles Zigbee testados incluem:
SONOFF ZBDongle-MAX SONOFF ZBDongle-PMG24 SONOFF ZBDongle-LMG21 SONOFF ZBDongle-E SONOFF ZBDongle-P Outros listados pelo desenvolvedor @darkxst
Você pode passar o dongle para a VM no Proxmox (veja a seção opcional abaixo).
2. Crie uma Máquina Virtual (Proxmox)
Na UI Web do Proxmox, clique em Criar VM.

Geral - Defina um ID de VM e um nome, por exemplo CUBE OS.

Sistema operacional - Escolha Não use nenhuma mídia.

Sistema - Configurações recomendadas:
BIOS:
OVMF (UEFI)Disco EFI: adicione um disco EFI (o tamanho padrão é suficiente)
Chaves Pre‑Enfoll: Desmarcar

Disco / CPU / Memória / Rede
Disco: não faça criar um novo disco vazio. Você importará a imagem de disco do CUBE OS na próxima seção. : 2 núcleos (tipo de CPU
CPUhost
recomendado)RedeMemória: 4096 MB (4 GB) ou mais
Bridge:
vmbr0:
(ou sua bridge LAN)ModeloVirtIO (paravirtualizado):
Para descoberta na LAN e

cube.local funcionarem de forma confiável, evite redes no estilo NAT. Use uma rede em bridge conectada à sua LAN doméstica/escritório. 3. Importe a imagem de disco do CUBE OS para o Proxmox
Você importará a imagem extraída do CUBE OS (por exemplo
CUBE-OS.vmdk ) e a anexará como o disco de inicialização da VM.Encontre o armazenamento correto (
local, nãolocal-lvm Na barra lateral esquerda da UI Web do Proxmox, clique em). (não , não Envie o Na barra lateral esquerda da UI Web do Proxmox, clique em).

para .vmdk Clique em , não
Importar Selecione a imagem de disco extraída no seu computador, por exemplo:
sdcard.vmdk
Aguarde o upload ser concluído (800+ MB pode demorar um pouco)
Depois que terminar, você deverá ver o arquivo na

Lista de Conteúdo .

Anexe o disco importado e defina‑o como disco de boot. Na VM do CUBE OS:
Vá para Hardware
Selecione o importado Adicionar
→

Importar Disco Rígido Em seguida, vá para Opções → Ordem de Inicialização

e defina o disco importado como o primeiro dispositivo de inicialização.
4. Inicializar o CUBE OS
Clique para na VM e abra o.

Console
Aguarde alguns instantes para o CUBE OS inicializar. Quando a inicialização for concluída, você deverá ver o endereço IP

exibido no console.
Abra a UI Web do CUBE OS
Visitehttp://<CUBE_OS_IP>/, ou Tente:

http://cube.local Após o acesso bem‑sucedido, um ID curto pode ser visualizado na página de configurações. Posteriormente, acesse a página de gerenciamento Web do CUBE OS usandocube-{short id}.local

, o que é útil para diferenciar várias instâncias do CUBE OS na mesma rede local.
5. (Opcional) Encaminhamento de Dongle USB Zigbee (Proxmox)
Conecte o dongle Zigbee ao host Proxmox. Na VM, vá para.
Hardware → Adicionar → Dispositivo USB Prefira selecionar por ID do Vendor/Dispositivo
(mais estável do que por porta se você trocar as portas USB). Se o seu dongle expuser uma interface serial, ele também pode aparecer em Adicionar → Porta Serial

dependendo da sua configuração.
Last updated