~/conhecimento/migracao-do-virtualbox-para-kvmqemu-com-cockpit

Migração do VirtualBox para KVM/QEMU com Cockpit

publicado em 21/08/2026 às 09:03 atualizado em 25/08/2026 às 09:59

Guia Definitivo: Migração do VirtualBox para KVM/QEMU com Cockpit

Este documento é um manual completo para administradores de sistemas que desejam substituir o VirtualBox pelo hipervisor nativo do Linux (KVM/QEMU), gerenciando tudo através da moderna interface web Cockpit. O ambiente base deste guia é focado em distribuições baseadas em Debian/Ubuntu (como o Linux Mint).


1. Desinstalação Completa do VirtualBox

Antes de instalar o novo sistema de virtualização, é recomendável remover o VirtualBox e todos os seus vestígios do servidor para evitar conflitos de rede ou de hipervisor.

Nota: Este processo remove o programa, mas não apaga os seus discos rígidos virtuais (.vdi), permitindo que você os migre posteriormente.

No terminal do servidor, execute:

# 1. Parar serviços ativos do VirtualBox (se houver)
sudo systemctl stop vboxdrv

# 2. Remover o VirtualBox e todas as extensões associadas
sudo apt-get purge "^virtualbox-.*" -y

# 3. Limpar dependências órfãs
sudo apt-get autoremove -y

# 4. Opcional: Remover pastas de configuração globais
sudo rm -rf /etc/virtualbox
sudo rm -rf /usr/lib/virtualbox

2. Instalação do KVM/QEMU e Cockpit

O KVM é o hipervisor de Tipo 1 (embutido no kernel) do Linux.

No terminal do servidor, execute:

# 1. Atualizar pacotes e instalar KVM, Cockpit e dependências essenciais
sudo apt update
sudo apt install cockpit cockpit-machines qemu-kvm libvirt-daemon-system virtiofsd -y

# 2. Ativar o serviço do Cockpit
sudo systemctl enable --now cockpit.socket

Acesse o painel abrindo o navegador e digitando: https://IP_DO_SERVIDOR:9090.


3. Configurando a Rede Bridge (Interface Gráfica)

Para que suas VMs recebam IPs da rede local como se fossem máquinas físicas, precisamos criar uma ponte (Bridge).

Requisito: Acesso físico ao servidor ou via localhost.

  1. No menu lateral do Cockpit, acesse Rede.
  2. Clique no botão azul Adicionar Ponte.
  3. Em Nome, digite bridge0.
  4. Na lista Portas, marque a caixinha da sua placa de rede principal (ex: enp3s0).
  5. Clique em Adicionar.

4. Entendendo Opções Avançadas de Rede: Direct Attachment (Macvtap)

Ao configurar a rede de uma máquina virtual, você pode usar a opção Direct attachment.

  • Como funciona: Acopla a placa da VM diretamente à interface física do host, sem passar pela ponte virtual.
  • A Grande Diferença: O host e a máquina virtual ficam isolados entre si. A VM acessa a rede local e a internet, mas não consegue se comunicar com o servidor hospedeiro.
  • Quando usar: Ideal para hospedar serviços expostos, garantindo que invasores não tenham acesso direto ao sistema hospedeiro em caso de comprometimento da VM.

5. Criando Máquinas Virtuais (Linux e Windows)

5.1 Criando uma VM Linux

  1. No Cockpit, vá em Virtual Machines -> Create VM.
  2. Defina o Nome, Memória e Disco.
  3. Em Installation source, aponte para a ISO local (não é necessário mover o arquivo, o Cockpit gerenciará a permissão).
  4. Expanda a seção de rede, selecione Interface type: Bridge to LAN e Source: bridge0.
  5. Clique em Create and run.

5.2 Criando uma VM Windows (Uso de VirtIO)

Sistemas Windows precisam de drivers nativos injetados.

Passo A: Baixar o CD VirtIO

sudo wget -O /var/lib/libvirt/images/virtio-win.iso https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win.iso

Passo B: Criação Segura (Evitando bloqueios de AppArmor)

  1. Clique em Create VM, aponte para a ISO do Windows na sua pasta de Downloads.
  2. Importante: Clique em Create and edit (NÃO inicie a VM ainda).
  3. Na visão geral, vá em Disks -> Add disk. Tipo: CD-ROM, selecione a ISO do VirtIO. Mude o Bus para sata.
  4. Vá em Network interfaces, edite a placa e mude o Model type para virtio.
  5. Inicie a VM. Na tela de instalação do Windows, carregue o driver em: CD VirtIO -> viostor -> w10 -> amd64.
  6. No Windows instalado, instale o virtio-win-guest-tools.exe (dentro do CD VirtIO) para ativar o Agente QEMU, vídeo e rede de alta velocidade (mostrando o IP no Cockpit).

6. Compartilhamento de Pastas (Linux Host para Windows VM)

O KVM utiliza VirtIO-FS para compartilhar pastas com altíssimo desempenho.

Passo A: Preparação no Linux (Host) Crie uma pasta dedicada e dê permissão total para evitar bloqueios de segurança do KVM:

mkdir /home/SEU_USUARIO/Compartilhada
sudo chmod 777 /home/SEU_USUARIO/Compartilhada

Passo B: Adicionando no Cockpit

  1. Na VM desligada, vá em Shared directories -> Add shared directory.
  2. Source path: /home/SEU_USUARIO/Compartilhada
  3. Mount tag: hostshare (ou outro nome de identificação). Salve e inicie a VM.

Passo C: Configuração no Windows

  1. O Windows precisa de um tradutor para esse sistema de arquivos. Baixe e instale o WinFSP.
  2. Abra o menu Iniciar e digite Serviços.
  3. Localize o Virtio-FS Service.
  4. Mude o Tipo de Inicialização para Automático e clique em Iniciar.
  5. Abra o Meu Computador e a pasta aparecerá como uma unidade mapeada (Z:).

7. Importando VMs Existentes (Migração)

Passo A: Converter o disco (com a VM do VirtualBox desligada)

qemu-img convert -f vdi -O qcow2 disco-antigo.vdi novo-disco.qcow2

Passo B: Importar via Cockpit Na aba Virtual Machines, clique em Import VM no canto superior direito. Aponte para o arquivo .qcow2 criado.


8. Acesso Remoto de Alta Performance (Remote Viewer)

Para usar recursos como copiar e colar para a VM e redimensionamento dinâmico via protocolo SPICE.

  • Linux Mint/Ubuntu: sudo apt install virt-viewer
  • Windows: Baixe o MSI em virt-manager.org/download
  • Uso: No Cockpit, clique em Launch remote viewer. Renomeie o arquivo baixado para download.vv (se vier sem extensão) e abra-o.

9. Gerenciamento Avançado com Virt-Manager (A Alternativa Robusta)

O Cockpit pode apresentar problemas de "Permission denied" ao criar discos ou inicializar VMs UEFI (Windows 11). Isso ocorre porque ele cria arquivos como root, mas o hipervisor precisa acessá-los como um usuário restrito (libvirt-qemu), causando conflitos com o AppArmor. Para contornar isso e obter uma experiência desktop fluida, utilize o Virt-Manager conectando-se remotamente.

9.1 Instalação na Máquina Local Para sistemas baseados em Debian/Ubuntu (com interfaces GTK como GNOME ou Cinnamon):

sudo apt update && sudo apt install virt-manager ssh-askpass-gnome

Dica para Windows: Como o Virt-Manager é exclusivo para Linux, usuários de Windows podem utilizá-arlo instalando o WSL (Windows Subsystem for Linux) com o recurso gráfico WSLg.

9.2 Configurando a Conexão Remota via SSH

  1. Abra o Virtual Machine Manager (Gerenciador de Máquinas Virtuais).
  2. Vá em Arquivo > Adicionar Conexão.
  3. Hipervisor: QEMU/KVM. Marque Conectar a um host remoto sobre SSH.
  4. Insira seu usuário (ex: henrique.fagundes) e o Hostname (IP ou domínio do servidor).
  5. O pacote ssh-askpass-gnome garantirá uma janela gráfica nativa para digitar a senha.

A partir desse ponto, o Virt-Manager gerencia discos e permissões automaticamente de forma segura, comunicando-se nativamente com o servidor.


10. Dicas Práticas no Virt-Manager e KVM
  • Configuração de BIOS vs UEFI: Diferente do Cockpit, o Virt-Manager permite configurar o firmware (UEFI) com facilidade. No passo final de criação da VM, marque a caixa "Personalizar configuração antes de instalar". Na aba Visão Geral (Overview), mude o campo Firmware para UEFI. Nota: Isso só pode ser feito durante a criação, e não após o sistema ser instalado.
  • Erro "O caminho para um armazenamento deve ser especificado": Se este alerta de erro de entrada aparecer, você esqueceu de selecionar o caminho do arquivo ISO (no passo 2) ou de apontar o disco existente corretamente (no passo 4 de criação).
  • Organização de Snapshots e Pools de Armazenamento: O Virt-Manager utiliza snapshots internos. Isso significa que os dados de backup são salvos dentro do próprio arquivo .qcow2 da máquina, e ele cresce automaticamente. Portanto, não é possível criar uma "Pool" separada apenas para snapshots através da interface gráfica; utilize as pools apenas para separar ISOs e discos principais.
  • Autostart: Ative o Autostart (Run when host boots) para que a VM ligue automaticamente após quedas de energia.

11. Troubleshooting (Solução de Problemas)

11.1 Removendo Snapshots "Fantasmas" no Virt-Manager

Se um snapshot não for excluído pela interface e ficar travado na lista, o arquivo de configuração (metadado) corrompeu. Antes de forçar a exclusão no terminal, é fundamental listar as Máquinas Virtuais (VMs) e seus respectivos snapshots para garantir que você está apontando para o item correto.

Primeiro, liste todas as instâncias (ligadas e desligadas) para descobrir o nome exato da VM:

virsh list --all

Em seguida, liste todos os snapshots vinculados a essa VM específica. Utilizar o parâmetro --tree ajuda a visualizar a hierarquia e evitar a quebra acidental de uma cadeia de snapshots:

virsh snapshot-list --domain NomeDaVM
virsh snapshot-list --domain NomeDaVM --tree

Com os nomes exatos identificados, acesse o terminal do servidor e force a exclusão:

# Tente o modo padrão primeiro. 
# Ele remove o registro do snapshot e também mescla/exclui os dados no disco.
virsh snapshot-delete --domain NomeDaVM --snapshotname NomeDoSnapshot

# Se falhar, force a exclusão apenas dos metadados. 
# Isso remove apenas o registro no libvirt, ignorando os dados reais no disco.
virsh snapshot-delete --domain NomeDaVM --snapshotname NomeDoSnapshot --metadata

Após isso, certifique-se de apagar os arquivos físicos residuais soltos na pasta /var/lib/libvirt/images/ para liberar espaço.

11.2 Erro Unable to find a satisfying virtiofsd (Compartilhamento de Pasta falha) Ocorreu porque o pacote não estava instalado no servidor. Para resolver:

sudo apt install virtiofsd
sudo systemctl restart libvirtd

11.3 Limpando Alertas Vermelhos de Serviços no Cockpit (vboxwebsrv, casper, sssd-pac) Se existirem serviços obsoletos falhando na aba Serviços do painel:

# Apagar serviço do VirtualBox
sudo systemctl disable vboxwebsrv-custom
sudo rm /etc/systemd/system/vboxwebsrv-custom.service
sudo systemctl daemon-reload

# Mascarar serviços inúteis ou secundários
sudo systemctl mask casper-md5check sssd-pac sssd-nss.socket sssd-pam-priv.socket

# Limpar painel do Cockpit
sudo systemctl reset-failed

Isso é tudo!

Precisa disso implementado na sua empresa?

Eu faço o trabalho para você, com segurança e documentação.

>_ SOLICITAR ORÇAMENTO