Pular para o conteúdo
Documentação

Template de VM no Proxmox com o miniCP pronto

Como criar no Proxmox um template com Debian 13 mínimo e o miniCP já instalado, e como subir um servidor novo a partir dele em poucos segundos.

R Regis Manze 20/11/2026 4 min de leitura

Template de VM no Proxmox com o miniCP pronto

Com o template, um servidor novo fica pronto em segundos: você clona a VM, informa IP e senha, liga e o painel já responde na porta 5000. Só falta escolher a stack (Apache, Nginx, PHP, banco) no Setup Inicial.

O template é gerado pelo script tools/proxmox-template.sh, que acompanha o miniCP.

O que vem no template

  • Sistema mínimo: Debian 13 na imagem oficial genericcloud, com kernel próprio para VM e sem firmware nem drivers de hardware físico. São cerca de 350 pacotes e menos de 1 GB ocupado no disco.
  • miniCP instalado e habilitado: o painel sobe sozinho no primeiro boot.
  • Hardware virtual de desempenho:
    • disco virtio-scsi-single com iothread, discard e marcação de SSD;
    • rede virtio multiqueue;
    • memória fixa, sem balloon;
    • guest agent;
    • gerador de números aleatórios virtio;
    • console serial.
  • Ajustes do sistema:
    • controle de congestionamento BBR com fila fq;
    • journal limitado a 256 MB;
    • fstrim semanal;
    • boot sem espera no GRUB;
    • idioma pt_BR.UTF-8 e fuso de São Paulo.
  • Boot rápido: o cloud-init só consulta as fontes do Proxmox e não roda atualização de pacotes no primeiro boot, porque a imagem já sai atualizada.
  • Pronto para clonar: a imagem não leva dados, chave de sessão do painel, machine-id nem chaves SSH. Cada servidor gera os seus no primeiro boot.

O ajuste fino de rede e memória continua no painel, em Tuning, e prevalece sobre os valores do template.

Criar o template

No host Proxmox, como root:

bash proxmox-template.sh

O padrão cria o template 9000 no storage local-lvm, na bridge vmbr0, com 2 vCPUs, 4 GB de RAM e disco de 20 GB. Para mudar, passe variáveis antes do comando:

VMID=9100 STORAGE=ceph BRIDGE=vmbr1 CORES=4 MEMORY=8192 DISK=40G bash proxmox-template.sh
Variável Padrão Para que serve
VMID 9000 Número do template
NAME minicp-template Nome do template
STORAGE local-lvm Onde ficam o disco e o drive do cloud-init
BRIDGE / VLAN vmbr0 / sem tag Rede
CORES / MEMORY 2 / 4096 vCPUs e RAM (MB) padrão dos clones
DISK 20G Tamanho do disco; a partição cresce sozinha no boot
CPU host Tipo de CPU (veja abaixo)
TZ America/Sao_Paulo Fuso horário

O script baixa a imagem oficial do Debian, confere o SHA512 e baixa o miniCP pelo mesmo endereço usado em Configurações → Atualização. O IP do host Proxmox precisa estar liberado nesse repositório. Na primeira vez a montagem leva alguns minutos. A imagem do Debian fica em cache para as próximas.

Cluster com processadores diferentes: o padrão CPU=host é o mais rápido, mas impede a migração ao vivo entre hosts com CPUs diferentes. Nesse caso crie o template com CPU=x86-64-v3.

Subir um servidor novo

qm clone 9000 201 --name cliente1 --full
qm set 201 --cipassword 'SENHA_DO_ROOT' --sshkeys ~/.ssh/id_ed25519.pub \
           --ipconfig0 ip=203.0.113.50/24,gw=203.0.113.1 --nameserver 1.1.1.1
qm start 201

Também dá para fazer pela interface do Proxmox: Clone (modo Full Clone), depois a aba Cloud-Init para usuário, senha, chave SSH e IP.

Depois de ligar:

  1. Acesse http://IP-DO-SERVIDOR:5000.
  2. Entre com root e a senha definida no cloud-init.
  3. Vá em Configurações → Setup Inicial e escolha a stack.

Ao entrar por SSH, a mensagem de boas-vindas mostra a versão do miniCP, o endereço do painel e se o Setup Inicial ainda está pendente.

Mais CPU ou memória

qm set 201 --cores 4 --memory 8192

Ao aumentar as vCPUs, ajuste também as filas da placa de rede para o mesmo número. Por exemplo, para 4 vCPUs: qm set 201 --net0 virtio,bridge=vmbr0,queues=4. Mantenha o mesmo bridge e a tag de VLAN, se houver.

Atualizar o template

O miniCP de cada servidor se atualiza pelo painel normalmente. Para que os clones novos já nasçam com a versão mais recente, apague o template antigo e rode o script de novo.

Copiar para usar com IA

Este artigo foi útil?

Que bom! O que ajudou mais? O que faltou nesta página?

Opcional — seu voto já foi registrado.

Obrigado pelo seu feedback!