Configure pastas compartilhadas do VirtualBox para o sistema operacional convidado Linux

Instruções passo a passo para configuração de pastas compartilhadas no VirtualBox

Conteúdo da página

Para configurar pastas compartilhadas do VirtualBox no sistema operacional Linux Guest, siga estas etapas:

janela de configuração de pastas compartilhadas do VirtualBox

1. Instale o VirtualBox Guest Additions

O Guest Additions deve ser instalado no sistema operacional convidado para habilitar o suporte a pastas compartilhadas:

  • Inicie o convidado.
  • No menu do VirtualBox, selecione:
Dispositivos > Inserir Imagem do CD do Guest Additions

captura de tela da opção Inserir Imagem do CD do Guest Additions

  • Abra um terminal no convidado, monte o CD se necessário e execute o instalador:
sudo sh /media/$USER/VBox_GAs_*/VBoxLinuxAdditions.run

  • Reinicie o convidado após a instalação.

  • Adicione seu usuário ao grupo vboxsf no convidado (isso é crucial para as permissões de acesso):

sudo usermod -aG vboxsf $(whoami)

` Reinicie ou saia/entre novamente para que as alterações do grupo sejam aplicadas.

2. Configure a Pasta Compartilhada no VirtualBox Manager no Host

  • Clique com o botão direito no seu VM e vá para:
Configurações > Pastas Compartilhadas
  • Clique no botão Adicionar Pasta Compartilhada.
  • Defina os seguintes parâmetros:
    • Caminho da Pasta: A pasta no seu host Linux a ser compartilhada.
    • Nome da Pasta: O nome para referência no convidado (por exemplo, share).
    • Marque opcionalmente Auto-montar para que seja montado automaticamente no boot.
    • Marque opcionalmente Tornar Permanente para uma compartilhamento persistente.

3. Montar a Pasta Compartilhada no Linux Guest

Se Auto-mount foi ativado, o VirtualBox montará a pasta compartilhada automaticamente, normalmente em /media/sf_ (por exemplo, /media/sf_share) e com acesso de grupo para vboxsf.

Se quiser montar manualmente ou em um local personalizado:

  • Crie um ponto de montagem:
mkdir ~/host_share
  • Monte usando:
sudo mount -t vboxsf  ~/host_share

Montar a Pasta Compartilhada automaticamente no boot

No convidado Linux, a abordagem recomendada é adicionar uma entrada para a pasta compartilhada no /etc/fstab do convidado. Isso garante que a pasta seja montada cada vez que o sistema iniciar.

Abra /etc/fstab com um editor de texto como root:

sudo nano /etc/fstab

Adicione uma linha como esta, substituindo sharename e /home/youruser/host_share pelo caminho desejado (por exemplo, /mnt/shared):

sharename   /home/youruser/host_share   vboxsf  defaults  0   0

O sharename é como definido nas configurações de Pastas Compartilhadas do VirtualBox.

Crie o ponto de montagem (se não existir):

mkdir -p /home/youruser/host_share

Monte todos os sistemas de arquivos ou reinicie para testar:

sudo mount -a

Verifique se sua pasta compartilhada agora está acessível.

Acesso, Permissões & Solução de Problemas

  • A pasta compartilhada será propriedade de root:vboxsf dentro do convidado.
  • Certifique-se de que seu usuário do convidado está no grupo vboxsf (id $USER para verificar).
  • Se você experimentar problemas de permissão, certifique-se de que está no grupo vboxsf e que saia/entre novamente (ou reinicie) após adicionar-se ao grupo.
  • Para necessidades mais complexas ou para montagem dinâmica/condicional, você também pode utilizar uma unidade de automontagem do systemd, mas /etc/fstab é a mais direta e robusta para pastas compartilhadas do VirtualBox no Linux.

Essa abordagem garantirá que sua pasta compartilhada do VirtualBox seja montada automaticamente em cada início do sistema.

O VirtualBox não pode operar no modo raiz VMX.

Se você receber o seguinte erro que culpa o módulo do kernel KVM:

VBoxManage: error:
VirtualBox can't operate in VMX root mode.
Please disable the KVM kernel extension, recompile your kernel and reboot
(VERR_VMX_IN_VMX_ROOT_MODE)

VBoxManage: error:
Details:
code NS_ERROR_FAILURE (0x80004005),
component ConsoleWrap, interface IConsole

Faça o seguinte por sua própria conta e risco. Você pode tentar superar esse erro no Ubuntu 24.04 desativando-o temporariamente, desde que ninguém esteja usando o kvm no momento:

lsmod | grep kvm
lsof | grep kvm
sudo modprobe -r kvm_intel

Você pode tentar desativar e recompilar se quiser, e se usar o VirtualBox com frequência.

Verifique se o kvm está carregado (deveria ser o caso ao obter o erro do VirtualBox):

lsmod | grep kvm

Para verificar se o kvm está sendo usado atualmente:

lsof | grep kvm

Se não houver saída, o kvm não está sendo usado e o módulo do kernel pode ser desativado com segurança:

sudo rmmod kvm_intel # ou kvm_amd em CPUs AMD
sudo rmmod kvm

Isso desmontará apenas o módulo do kernel para a sessão atual. Para desativar o kvm no boot, você precisa adicioná-lo à blacklist e atualizar o initramfs. Adicione isso a /etc/modprobe.d/blacklist-kvm.conf:

blacklist kvm
blacklist kvm_intel   # ou kvm_amd

Atualize o initramfs e reinicie:

sudo update-initramfs -u
sudo reboot