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.
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
- No Cockpit, vá em Virtual Machines -> Create VM.
- Defina o Nome, Memória e Disco.
- Em Installation source, aponte para a ISO local (não é necessário mover o arquivo, o Cockpit gerenciará a permissão).
- Expanda a seção de rede, selecione Interface type:
Bridge to LANe Source:bridge0. - 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)
- Clique em Create VM, aponte para a ISO do Windows na sua pasta de Downloads.
- Importante: Clique em Create and edit (NÃO inicie a VM ainda).
- Na visão geral, vá em Disks -> Add disk. Tipo:
CD-ROM, selecione a ISO do VirtIO. Mude o Bus parasata. - Vá em Network interfaces, edite a placa e mude o Model type para
virtio. - Inicie a VM. Na tela de instalação do Windows, carregue o driver em: CD VirtIO ->
viostor->w10->amd64. - 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
- Na VM desligada, vá em Shared directories -> Add shared directory.
- Source path:
/home/SEU_USUARIO/Compartilhada - Mount tag:
hostshare(ou outro nome de identificação). Salve e inicie a VM.
Passo C: Configuração no Windows
- O Windows precisa de um tradutor para esse sistema de arquivos. Baixe e instale o WinFSP.
- Abra o menu Iniciar e digite Serviços.
- Localize o Virtio-FS Service.
- Mude o Tipo de Inicialização para Automático e clique em Iniciar.
- 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
- Abra o Virtual Machine Manager (Gerenciador de Máquinas Virtuais).
- Vá em Arquivo > Adicionar Conexão.
- Hipervisor:
QEMU/KVM. Marque Conectar a um host remoto sobre SSH. - Insira seu usuário (ex:
henrique.fagundes) e o Hostname (IP ou domínio do servidor). - O pacote
ssh-askpass-gnomegarantirá 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
.qcow2da 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!