• Início
  • Blog
  • Passagem de dongle USB no VirtualBox: configuração e correções

Passagem de dongle USB no VirtualBox: configuração e correções

avatar
Escrito por
Atualizado em: August 12, 2026
Tempo para leitura: 10 minutos

Um dongle USB conectado a um host do VirtualBox nem sempre aparece automaticamente dentro do convidado. O VirtualBox só faz o passthrough do dongle depois de a VM ter um controlador USB ativado e de um filtro USB indicar-lhe qual dispositivo capturar. Até lá, o sistema operativo do host costuma assumir o controlo do dongle primeiro, mais frequentemente após atualizações de drivers, atualizações do VirtualBox ou avisos de segurança do macOS.

Abaixo está a configuração nativa de passthrough para hosts Windows, macOS e Linux, as verificações a executar quando o dongle ainda se recusa a anexar e o ponto em que Donglify passa a ser a melhor opção para aceder a um dongle de licença noutra máquina física.

Índice

Escolhendo entre Passthrough Nativo e Donglify

Escolha passthrough nativo quando o dongle e o VirtualBox partilham a mesma máquina. Escolha Donglify quando o dongle está noutro lugar na rede.

Situação Melhor opção
O dongle está ligado à mesma máquina física que o VirtualBox Passagem nativa. Não é necessário software adicional nem ligação à internet.
O dongle está noutro computador, noutro escritório ou num bastidor de servidores Donglify via LAN ou internet. Ambos os lados necessitam de acesso à internet para autenticação da conta.
Você utiliza o VirtualBox 7.x A passagem nativa de USB 2.0 e 3.0 funciona sem o Extension Pack.
Várias VMs precisam do mesmo dongle em simultâneo Donglify, mas apenas para dongles multi-conexão suportados e quando a licença do software permite utilização simultânea.

Configurando o passthrough USB nativo

O passthrough nativo precisa de duas coisas: um controlador USB ativado na VM e um filtro USB para capturar o dongle.

No VirtualBox 7.0 e posteriores, o suporte a controladores USB 2.0 e USB 3.0 vem no pacote base — não é necessário Extension Pack. No 6.x e anteriores, instale o Extension Pack que corresponda exatamente à sua versão do VirtualBox. Nota: alguns metadados do Extension Pack (VBoxManage list extpacks) ainda listam “USB 2.0 and USB 3.0 Host Controller” como um recurso em builds 7.x — isso é uma string de descrição remanescente, não um requisito real. No 7.x, o Extension Pack só é necessário para VRDP, passthrough de webcam, criptografia de disco e ROM de boot PXE.

Ativar o Controlador USB

  1. Desligue a VM.
  2. Abra Configurações da VM > USB, ative o controlador USB.
  3. Selecione USB 3.0 (xHCI) para convidados modernos ou USB 2.0(EHCI) se o convidado for mais antigo ou se o dongle ficar instável sob xHCI.
  4. Salvar.

 

Criar um Filtro USB

  1. Conecte o dongle ao host.
  2. Abra Configurações da VM > USB, clique em Adicionar Filtro USB e selecione o dongle.
  3. Mantenha apenas Nome, ID do fornecedor e ID do produto, a menos que você precise diferenciar dongles idênticos.
  4. Desconecte o dongle, inicie a VM, aguarde o convidado terminar a inicialização e então conecte o dongle novamente. O VirtualBox o captura e o encaminha para o convidado.

 

Encontrando ID do Fornecedor/Produto: Windows — Gerenciador de Dispositivos > Propriedades > Detalhes > IDs de hardware (VID_xxxx/PID_xxxx). macOS — Menu Apple > Sobre Este Mac > Relatório do Sistema > USB (aprove o prompt de acessório no Apple silicon). Linux — lsusb; também adicione seu usuário ao grupo vboxusers e faça log out/in antes de testar.

Por que o dongle ainda não se conecta

Sintoma Causa Correção
Filtro definido, mas o dongle ainda não é capturado; erro como UUID está ocupado com uma solicitação anterior ou E_INVALIDARG (0x80070057) O SO do host, o gerenciador de licenças ou outro app já assumiu o dongle Execute VBoxManage list usbhost no host. Se mostrar Ocupado/Indisponível, feche o software que o está mantendo — ejete dispositivos de armazenamento ou feche o serviço de licenças do fornecedor para dongles HID/smart-card/específicos do fornecedor. Desconecte, inicie a VM e reconecte apenas após o boot.
O host detecta o dongle, mas o VirtualBox não o vê (Linux) Usuário não está no grupo vboxusers Adicione o usuário a vboxusers, depois faça logoff/login ou reinicie.
O próprio VirtualBox não inicia, ou o USB falha silenciosamente (macOS) A segurança do sistema bloqueou o driver/componente do VirtualBox No 6.x, um erro Kernel driver not installed (rc=-1908) impede a VM de iniciar por completo quando o kext de suporte não é aprovado — é um problema da VM inteira, não específico de USB, mas elimine isso primeiro se o guest não inicializar. No 7.x, o macOS não usa extensões de kernel, então este erro não se aplica mais; um componente bloqueado falha de outra forma, geralmente na instalação ou na primeira execução. Reinstale de forma limpa, aprove os prompts em Ajustes do Sistema > Privacidade & Segurança e teste novamente com um dispositivo USB simples.
Dispositivo USB 2.0/3.0 não é capturado de forma alguma (apenas 6.x) Extension Pack ausente ou incompatível Arquivo > Preferências > Extensões — confirme que a versão do Extension Pack corresponde exatamente à sua versão do VirtualBox. Não se aplica no 7.x, onde o suporte USB básico não precisa de Extension Pack.
Nota: Os filtros nativos só detectam dispositivos no mesmo computador físico a executar o VirtualBox — um dongle no portátil de um colega, num bastidor de servidores ou noutro escritório fica fora de alcance. O VirtualBox tem, de facto, uma funcionalidade de USB remoto através de VRDE, mas requer o Extension Pack e um cliente RDP que suporte especificamente o redirecionamento USB — a maioria, incluindo o mstsc.exe integrado do Windows, não suporta. Para partilhar um dongle de licença através de uma rede normal, o Donglify é a opção mais geral.

Partilhar um Dongle com uma VM remota com o Donglify

O Donglify move o dongle via TCP/IP, contornando assim o limite de mesma máquina do passthrough nativo. O convidado vê a chave como um dispositivo ligado localmente mesmo quando o dongle físico está noutro host.

O Donglify instala-se em ambas as extremidades: a máquina que contém o dongle e cada convidado do VirtualBox que se liga a ele. Uma avaliação de sete dias abrange o conjunto completo de funcionalidades, suficiente para confirmar que o seu modelo de dongle funciona pela rede antes de se comprometer.

Como redirecionar um dongle USB para o VirtualBox

  1. Criar uma conta Donglify.

2.  Instale o Donglify no host com o dongle fisicamente conectado (o servidor) e em cada convidado do VirtualBox que se conecte a ele (os clientes).

Instalar Donglify

3.  No servidor, inicie o Donglify e inicie sessão.

Inicie sessão no Donglify

4.  Clique em + para abrir a lista de chaves USB conectadas, selecione o botão de opção ao lado do seu dongle e clique em Compartilhar.

Partilhar dongle

5.  No cliente, inicie o Donglify, inicie sessão na mesma conta, encontre o dongle partilhado na lista e clique em Ligar.

Conexão Donglify

6.  O Gestor de Dispositivos dentro do convidado mostra o dongle como um dispositivo local, e a aplicação licenciada lê o token USB a partir da VM do VirtualBox.

O mesmo fluxo de trabalho aplica-se a outros hipervisores. Para o VMware, siga as etapas para usar um dongle USB dentro de máquinas virtuais VMware. Para o hipervisor da Microsoft, veja acesso a dongle USB em máquinas virtuais Hyper-V.

Benefícios da Donglify

O encaminhamento de USB nativo do VirtualBox é limitado a dispositivos USB fisicamente ligados ao anfitrião do VirtualBox. O Donglify remove essa limitação ao disponibilizar um dongle de segurança USB para uma máquina virtual através da rede, mesmo quando o dongle está ligado a outro computador.

Acesse dongles USB remotos

O dongle permanece ligado ao seu computador original enquanto aparece no convidado do VirtualBox como um dispositivo USB ligado localmente. Isto permite-lhe utilizar chaves de licença localizadas noutro escritório, sala de servidores ou estação de trabalho de um colega sem mover fisicamente o hardware.

Compatibilidade multiplataforma

O Donglify suporta o compartilhamento de dongles de segurança USB compatíveis entre sistemas Windows e macOS. Para implantações em Mac, instale a versão atual do Donglify tanto no computador que compartilha o dongle quanto na máquina que se conecta a ele.

Criado para Dongles de Licença

Ao contrário das ferramentas USB sobre rede de uso geral, o Donglify foi concebido especificamente para dongles de segurança USB. A compatibilidade de dispositivos centra-se em chaves de licença de hardware utilizadas por software comercial, em vez de abranger toda a gama de periféricos USB.

Requisito de Internet

Tanto o computador que partilha o dongle como o convidado do VirtualBox precisam de acesso à internet para autenticar na sua conta Donglify, mesmo quando ambos os sistemas estão ligados à mesma rede local.

FAQ

O sistema operativo anfitrião captura o dongle antes de o filtro o capturar, na maioria dos casos. Execute VBoxManage list usbhost e procure um estado Ocupado ou Indisponível, confirme que a VM terminou de arrancar antes de voltar a ligar o dongle e, em Macs Apple silicon, confirme que o VirtualBox está permitido em Privacidade & Segurança, Acessórios. Reduzir o filtro para ID do fornecedor e ID do produto resolve a maioria das falhas de deteção por si só.

Não. O passthrough padrão de USB 2.0 e USB 3.0 funciona a partir da instalação base no VirtualBox 7.0 e posteriores, já que o suporte a EHCI e xHCI vem incluído. O Extension Pack ainda abrange criptografia de disco, passthrough da webcam do host, ROM de boot PXE e exibição remota VRDP. Quem estiver em uma versão anterior à 7.0 precisa dele para qualquer suporte USB além de USB 1.1.

Sim, por meio de uma ferramenta de redirecionamento de rede como o Donglify. O passthrough nativo alcança apenas dispositivos na mesma máquina física. O Donglify é instalado no computador que está com o dongle e dentro do SO convidado, não apenas no host do VirtualBox, porque o host e o convidado contam como sistemas operacionais separados para USB. Quando a conexão está ativa, o convidado vê o dongle da mesma forma que vê um dispositivo capturado localmente.

Não por meio do passthrough nativo do VirtualBox. Ele bloqueia um dispositivo capturado para um único convidado ou para o host, nunca vários ao mesmo tempo. O Donglify oferece suporte a acesso simultâneo por várias VMs em modelos de dongle com suporte explícito a múltiplas conexões, listados em sua documentação de compatibilidade de dispositivos. Dongles fora da lista suportada permanecem de conexão única, independentemente de qual ferramenta gerencie o compartilhamento.