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

1

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.

2

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

3

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

Para obter mais informações sobre configurações e compatibilidade do Zigbee, consulte este guia.

Você pode passar o dongle para a VM no Proxmox (veja a seção opcional abaixo).

2. Crie uma Máquina Virtual (Proxmox)

1

Na UI Web do Proxmox, clique em Criar VM.

2

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

3

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

O CUBE OS é fornecido como uma imagem de disco pré‑construída. No Proxmox, você irá importar a imagem de disco e então inicializar a partir dela.

4

Sistema - Configurações recomendadas:

  • BIOS: OVMF (UEFI)

  • Disco EFI: adicione um disco EFI (o tamanho padrão é suficiente)

  • Chaves Pre‑Enfoll: Desmarcar

Assim como nos guias do VirtualBox/VMware, UEFI é obrigatório. Se você não conseguir inicializar, verifique novamente se a BIOS está definida para OVMF (UEFI).

5

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) Rede

  • Memória: 4096 MB (4 GB) ou mais

  • Bridge:

    • vmbr0: (ou sua bridge LAN) Modelo

    • VirtIO (paravirtualizado): Para descoberta na LAN e

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 (

1

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).

2

para .vmdk Clique em , não

  1. Importar Selecione a imagem de disco extraída no seu computador, por exemplo:

  2. sdcard.vmdk

    • Aguarde o upload ser concluído (800+ MB pode demorar um pouco)

  3. Depois que terminar, você deverá ver o arquivo na

Lista de Conteúdo .

3

Anexe o disco importado e defina‑o como disco de boot. Na VM do CUBE OS:

  1. Vá para Hardware

  2. Selecione o importado Adicionar

  1. 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.

1

4. Inicializar o CUBE OS Clique para na VM e abra o.

2

Console

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

3

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.

1

5. (Opcional) Encaminhamento de Dongle USB Zigbee (Proxmox)

2

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

3

dependendo da sua configuração.

Last updated