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
Baixe a imagem do CUBE OS
Visite este repositório para baixar a versão mais recente da imagem 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 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 precisar adicionar dispositivos Zigbee, prepare um Dongle Zigbee. Dongles Zigbee testados incluem:
Você pode encaminhar 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 e um nome para a VM, por exemplo CUBE OS.
SO - Escolha Não use nenhum mídia.
O CUBE OS é fornecido como uma imagem de disco pré‑construída. No Proxmox, você importará a imagem de disco e então irá inicializar a partir dela.
Sistema - Configurações recomendadas:
BIOS:
OVMF (UEFI)Disco EFI: adicione um disco EFI (o tamanho padrão está OK)
Chaves Pre-Enfoll: Desmarque
Assim como nos guias do VirtualBox/VMware, UEFI é obrigatório. Se você não conseguir inicializar, verifique se a BIOS está configurada para OVMF (UEFI).
Disco / CPU / Memória / Rede
Disco: não crie 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 de LAN)ModeloVirtIO (paravirtualizado):
Para descoberta na LAN e
cube.local funcionarem de forma confiável, evite redes em estilo NAT. Use uma conexão 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 concluir (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 inicialização.
Na VM do CUBE OS: Vá para
Hardware Selecione o
importado Adicionar →
Importar Disco Rígido
Então vá para Opções → Ordem de Inicialização e defina o disco importado como o primeiro dispositivo de inicialização.
4. Inicialize o CUBE OS
Clique para
a VM e abra o Console.
Aguarde alguns instantes para o CUBE OS inicializar.
Uma vez que a inicialização esteja completa, você deverá ver o endereço IP exibido no console.
Abra a UI Web do CUBE OS
Visite
http://<CUBE_OS_IP>/, ouTente: http://cube.local
Ao acessar com sucesso, um ID curto pode ser visto na página de configurações. Em seguida, acesse a página de gerenciamento Web do CUBE OS usando cube-{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/Device (mais estável do que por porta caso você mova as portas USB).
Se seu dongle expõe uma interface serial, ele também pode aparecer em Adicionar → Porta Serial dependendo da sua configuração.
Reinicie a VM (se necessário) e então adicione dispositivos Zigbee no CUBE OS.
Atualizado