1. Por que Proxmox?
Proxmox VE combina KVM (VMs completas) com LXC (containers leves), interface web moderna e gratuito. Ideal para homelab próximo de produção.
- VMs com KVM + QEMU
- Containers LXC
- Storage local (ZFS, LVM) e remoto (NFS, Ceph)
- Cluster e backups nativos
2. Hardware e instalação
x86_64 com VT-x/AMD-V. Ideal: 16 GB+ RAM, SSD/NVMe, dois discos para mirror ZFS.
$ # baixe a ISO oficial e grave no pendrive
- Boot pelo pendrive
- Escolha disco (ou ZFS no root)
- Hostname, IP estático, gateway, DNS
- Senha root + e-mail de notificações
warn · A instalação apaga o disco escolhido. Backup antes.
3. Pós-instalação
Acesse https://SEU-IP:8006.
apt update && apt full-upgrade -y
# repositório no-subscription (sem enterprise)
echo "deb http://download.proxmox.com/debian/pve bookworm pve-no-subscription" \
> /etc/apt/sources.list.d/pve-no-subscription.list
# comente a linha do enterprise em pve-enterprise.list
apt update && apt full-upgrade -y
tip · Configure SSH com chave e desabilite login root por senha.
4. Storage com ZFS
zpool create -f tank mirror /dev/sdb /dev/sdc
zfs set compression=lz4 tank
zfs set atime=off tank
zfs create tank/vms
Depois adicione o storage no Proxmox apontando para tank/vms.
5. VMs e LXC
VM (KVM)
- Create VM → ID, nome, ISO
- CPU, memória, disco no pool ZFS
- Rede: bridge vmbr0
- Inicie e instale o SO
Container LXC
- Baixe template (CT Templates)
- Create CT → template, hostname, recursos
- Ideal para serviços isolados leves
tip · LXC para serviços sem kernel próprio; VM quando precisar isolamento total.
6. Rede
auto vmbr0
iface vmbr0 inet static
address endereco interno omitido/24
gateway endereco interno omitido
bridge-ports enp3s0
bridge-stp off
bridge-fd 0
7. Backups
Datacenter → Backup → Add. Defina horário, storage de destino, retenção e VMs/CTs.
- Mode: Snapshot (se o storage suportar)
- Compression: zstd
- Retention: diários + semanais
warn · Teste o restore periodicamente. Backup que não restaura não é backup.
8. Dicas
- Separe storage de sistema e de dados
- Tags e notas nas VMs/CTs
- Monitore com Prometheus + Grafana
- Considere Proxmox Backup Server (PBS)
- Documente IPs e o que cada VM faz
9. Comandos e configurações explicados
Pós-instalação
| Comando | O que faz |
|---|---|
apt update && apt full-upgrade -y | Atualiza a lista de pacotes e instala todas as atualizações. |
echo "deb http://download.proxmox.com/debian/pve bookworm pve-no-subscription" > /etc/apt/sources.list.d/pve-no-subscription.list | Cria o arquivo do repositório gratuito. O > sobrescreve o arquivo, e o nome da suíte (bookworm) precisa corresponder ao Debian que serve de base à sua versão do Proxmox. |
comentar a linha de pve-enterprise.list | Sem assinatura, o repositório enterprise devolve erro de acesso no apt update. |
ZFS
| Comando | O que faz |
|---|---|
zpool create -f tank mirror /dev/sdb /dev/sdc | Cria o pool tank em espelho com dois discos. O -f força a criação e apaga o que houver nos discos. |
zfs set compression=lz4 tank | Liga a compressão lz4, leve e rápida. |
zfs set atime=off tank | Deixa de gravar o horário de acesso a cada leitura, o que poupa escrita. |
zfs create tank/vms | Cria um dataset para guardar os discos das VMs. |
No espelho, os dois discos guardam os mesmos dados. A capacidade útil é a de um disco, e o pool sobrevive à falha de um deles.
Rede (bridge vmbr0)
| Linha | O que faz |
|---|---|
auto vmbr0 | Sobe a bridge no boot. |
iface vmbr0 inet static | Usa IP fixo. |
address e gateway | Endereço do host e saída para a rede. |
bridge-ports enp3s0 | Liga a placa de rede física à bridge, para que as VMs usem a mesma rede. |
bridge-stp off e bridge-fd 0 | Desativa o spanning tree e o atraso de encaminhamento, o padrão em redes simples. |
10. VM ou container LXC?
| Critério | VM (KVM) | Container LXC |
|---|---|---|
| Kernel | próprio, independente do host | compartilha o kernel do host |
| Isolamento | total | menor |
| Consumo | maior (sistema completo) | baixo |
| Bom para | Windows, outros sistemas e serviços críticos | serviços Linux leves |
11. Erros comuns e como resolver
| Sintoma | Causa provável | Solução |
|---|---|---|
Erro de acesso ao rodar apt update | O repositório enterprise está ativo sem assinatura. | Comente a linha em pve-enterprise.list e mantenha o pve-no-subscription. |
O apt não acha pacotes do Proxmox | A suíte do repositório não corresponde à versão do Debian base. | Confira a versão do seu Proxmox e use o nome de suíte correspondente. |
| O pool ZFS não aparece para as VMs | Faltou cadastrar o storage. | Adicione em Datacenter → Storage, apontando para o dataset tank/vms. |
| Perdeu a rede depois de editar a bridge | Nome da placa ou endereço errado. | Corrija pelo console local e reaplique a rede com ifreload -a. |
| Aparece um aviso "No valid subscription" no login | É esperado ao usar o repositório gratuito. | É apenas informativo, o sistema funciona normalmente. |