• Accueil
  • Blog
  • Transfert de clé USB VirtualBox : configuration et corrections

Transfert de clé USB VirtualBox : configuration et corrections

avatar
Rédigé par
Mis à jour le: August 12, 2026
Temps de lecture: 10 minutes

Un dongle USB branché sur un hôte VirtualBox n’apparaît pas toujours automatiquement dans l’invité. VirtualBox ne transmet le dongle qu’après activation d’un contrôleur USB sur la VM et la définition d’un filtre USB indiquant quel périphérique capturer. Jusque-là, le système d’exploitation hôte récupère souvent le dongle en premier, le plus souvent après des mises à jour de pilotes, des mises à niveau de VirtualBox ou des invites de sécurité macOS.

Ci-dessous figurent la configuration de passthrough native pour les hôtes Windows, macOS et Linux, les vérifications à effectuer lorsque le dongle refuse toujours de se connecter, ainsi que le moment où Donglify devient la meilleure option pour accéder à un dongle de licence sur une autre machine physique.

Table des matières

Choisir entre le passthrough natif et Donglify

Choisissez le passthrough natif lorsque le dongle et VirtualBox partagent la même machine. Choisissez Donglify lorsque le dongle se trouve ailleurs sur le réseau.

Situation Meilleure option
Le dongle est branché sur la même machine physique que VirtualBox Passage direct natif. Aucun logiciel supplémentaire ni connexion internet requis.
Le dongle se trouve sur un autre ordinateur, dans un autre bureau ou dans une baie serveur Donglify via le LAN ou internet. Les deux côtés nécessitent un accès à internet pour l’authentification du compte.
Vous utilisez VirtualBox 7.x Le passage direct natif USB 2.0 et 3.0 fonctionne sans le pack d’extension.
Plusieurs VM ont besoin du même dongle simultanément Donglify, mais uniquement pour les dongles multi-connexion pris en charge et lorsque la licence logicielle autorise une utilisation simultanée.

Configuration du passthrough USB natif

Le passthrough natif nécessite deux choses : un contrôleur USB activé sur la VM, et un filtre USB pour intercepter le dongle.

Dans VirtualBox 7.0 et versions ultérieures, la prise en charge des contrôleurs USB 2.0 et USB 3.0 est incluse dans le paquet de base — aucun Pack d’extension requis. Sur la branche 6.x et plus ancien, installez le Pack d’extension correspondant exactement à votre version de VirtualBox. Remarque : certaines métadonnées du Pack d’extension (VBoxManage list extpacks) listent encore « USB 2.0 and USB 3.0 Host Controller » comme fonctionnalité sur les builds 7.x — c’est une chaîne de description résiduelle, pas une exigence réelle. En 7.x, le Pack d’extension n’est nécessaire que pour VRDP, le passthrough de webcam, le chiffrement de disque et la ROM de démarrage PXE.

Activer le contrôleur USB

  1. Éteignez la VM.
  2. Ouvrez Paramètres de la VM > USB, activez le contrôleur USB.
  3. Sélectionnez USB 3.0 (xHCI) pour les invités modernes, ou USB 2.0 (EHCI) si l’invité est plus ancien ou si le dongle est instable sous xHCI.
  4. Enregistrez.

 

Créer un filtre USB

  1. Connectez le dongle à l’hôte.
  2. Ouvrez Paramètres de la VM > USB, cliquez sur Ajouter un filtre USB, puis sélectionnez le dongle.
  3. Ne conservez que Nom, ID fournisseur et ID produit, sauf si vous devez distinguer des dongles identiques.
  4. Débranchez le dongle, démarrez la VM, attendez que l’invité ait fini de démarrer, puis rebranchez le dongle. VirtualBox le capture et le transmet à l’invité.

 

Trouver l’ID fournisseur/produit : Windows — Gestionnaire de périphériques > Propriétés > Détails > ID de matériel (VID_xxxx/PID_xxxx). macOS — menu Apple > À propos de ce Mac > Rapport système > USB (approuvez l’invite d’accessoire sur Apple silicon). Linux — lsusb ; ajoutez également votre utilisateur au groupe vboxusers et déconnectez-vous/reconnectez-vous avant de tester.

Pourquoi le dongle ne se fixe toujours pas

Symptôme Cause Correctif
Filtre défini, mais la clé n’est toujours pas capturée ; erreur du type UUID is busy with a previous request or E_INVALIDARG (0x80070057) L’OS hôte, le gestionnaire de licences ou une autre application a déjà pris le contrôle de la clé Exécutez VBoxManage list usbhost sur l’hôte. S’il indique Busy/Unavailable, fermez le logiciel qui la monopolise — éjectez les périphériques de stockage, ou arrêtez le service de licence du fournisseur pour les clés HID/carte à puce/spécifiques au fournisseur. Débranchez, démarrez la VM, reconnectez uniquement après le démarrage.
L’hôte détecte la clé, mais VirtualBox ne la voit pas (Linux) Utilisateur non membre du groupe vboxusers Ajoutez l’utilisateur à vboxusers, puis déconnectez-vous/reconnectez-vous ou redémarrez.
VirtualBox ne démarre pas, ou l’USB échoue silencieusement (macOS) La sécurité du système a bloqué le pilote/composant VirtualBox Sur la 6.x, une erreur Kernel driver not installed (rc=-1908) empêche la VM de démarrer lorsque le kext de support n’est pas approuvé — c’est un problème de VM entière, pas spécifique à l’USB, mais commencez par l’exclure si l’invité ne démarre pas. Sur la 7.x, macOS n’utilise plus d’extensions de noyau, donc cette erreur ne s’applique plus ; un composant bloqué échoue autrement, généralement à l’installation ou au premier lancement. Réinstallez proprement, approuvez les invites dans Réglages système > Confidentialité et sécurité, puis retestez avec un périphérique USB simple.
Périphérique USB 2.0/3.0 non capturé du tout (6.x uniquement) Extension Pack manquant ou non correspondant Fichier > Préférences > Extensions — confirmez que la version de l’Extension Pack correspond exactement à votre version de VirtualBox. Non applicable en 7.x, où la prise en charge USB de base ne nécessite pas d’Extension Pack.
Remarque : Les filtres natifs ne détectent que les périphériques sur le même ordinateur physique exécutant VirtualBox — un dongle sur l’ordinateur portable d’un collègue, dans un rack de serveurs ou dans un autre bureau reste hors de portée. VirtualBox dispose bien d’une fonctionnalité d’USB distant via VRDE, mais elle nécessite l’Extension Pack et un client RDP qui prend spécifiquement en charge la redirection USB — la plupart, y compris le mstsc.exe intégré de Windows, ne le font pas. Pour partager un dongle de licence sur un réseau classique, Donglify est l’option la plus générale.

Partage d’un dongle avec une VM distante avec Donglify

Donglify déporte le dongle via TCP/IP, ce qui contourne la limite « même machine » du passthrough natif. Le système invité voit la clé comme un périphérique connecté localement, même lorsque le dongle physique se trouve sur un autre hôte.

Donglify s’installe aux deux extrémités : la machine qui héberge le dongle et chaque invité VirtualBox qui s’y connecte. Une version d’essai de sept jours couvre l’ensemble des fonctionnalités, ce qui suffit pour vérifier que votre modèle de dongle fonctionne sur le réseau avant de vous engager.

Comment rediriger une clé USB vers VirtualBox

  1. Créez un compte Donglify.

2.  Installez Donglify sur l’hôte auquel le dongle est physiquement connecté (le serveur) et sur chaque invité VirtualBox s’y connectant (les clients).

Installer Donglify

3.  Sur le serveur, lancez Donglify et connectez-vous.

Connectez-vous à Donglify

4.  Cliquez sur + pour ouvrir la liste des clés USB connectées, sélectionnez le bouton radio à côté de votre dongle, puis cliquez sur Partager.

Partager le dongle

5.  Sur le client, lancez Donglify, connectez-vous au même compte, trouvez le dongle partagé dans la liste et cliquez sur Connecter.

Connexion Donglify

6.  Le Gestionnaire de périphériques dans l’invité affiche la clé USB comme un périphérique local, et l’application sous licence lit le jeton USB depuis la machine virtuelle VirtualBox.

Le même flux de travail s’applique aux autres hyperviseurs. Pour VMware, suivez les étapes pour utiliser une clé USB à dongle dans des machines virtuelles VMware. Pour l’hyperviseur de Microsoft, consultez l’accès aux clés USB à dongle dans des machines virtuelles Hyper-V.

Avantages de Donglify

Le passthrough USB natif de VirtualBox est limité aux périphériques USB physiquement connectés à l’hôte VirtualBox. Donglify supprime cette limitation en rendant un dongle de sécurité USB disponible pour une machine virtuelle via le réseau, même lorsque le dongle est connecté à un autre ordinateur.

Accéder aux dongles USB distants

Le dongle reste branché à son ordinateur d’origine tout en apparaissant dans l’invité VirtualBox comme un périphérique USB connecté localement. Cela vous permet d’utiliser des clés de licence situées dans un autre bureau, une salle serveur ou le poste de travail d’un collègue sans déplacer physiquement le matériel.

Compatibilité multiplateforme

Donglify prend en charge le partage de dongles de sécurité USB compatibles entre des systèmes Windows et macOS. Pour les déploiements sur Mac, installez la version actuelle de Donglify à la fois sur l’ordinateur qui partage le dongle et sur la machine qui s’y connecte.

Conçu pour les dongles de licence

Contrairement aux outils USB-sur-réseau polyvalents, Donglify est conçu spécifiquement pour les dongles de sécurité USB. La compatibilité des appareils se concentre sur les clés de licence matérielles utilisées par les logiciels commerciaux plutôt que sur l’ensemble des périphériques USB.

Exigence d’accès à Internet

L’ordinateur qui partage le dongle et l’invité VirtualBox ont tous deux besoin d’un accès à Internet pour s’authentifier avec votre compte Donglify, même lorsque les deux systèmes sont connectés au même réseau local.

FAQ

Dans la plupart des cas, le système d’exploitation hôte récupère le dongle avant que le filtre ne le capture. Exécutez VBoxManage list usbhost et recherchez un état Occupé ou Indisponible, confirmez que la VM avait terminé de démarrer avant de rebrancher le dongle, et sur les Mac Apple silicon confirmez que VirtualBox est autorisé dans Confidentialité & sécurité, Accessoires. Réduire le filtre à l’ID fournisseur et à l’ID produit élimine à lui seul la plupart des échecs de détection.

Non. Le passthrough USB 2.0 standard et USB 3.0 fonctionne dès l’installation de base sur VirtualBox 7.0 et versions ultérieures, puisque la prise en charge EHCI et xHCI y est incluse. Le Pack d’extension couvre toujours le chiffrement de disque, le passthrough de la webcam de l’hôte, la ROM de démarrage PXE et l’affichage à distance VRDP. Toute personne utilisant une version antérieure à la 7.0 en a besoin pour toute prise en charge USB au-delà de l’USB 1.1.

Oui, via un outil de redirection réseau comme Donglify. Le passthrough natif n’atteint que les appareils sur la même machine physique. Donglify s’installe sur l’ordinateur qui héberge le dongle et dans l’OS invité, pas uniquement sur l’hôte VirtualBox, car l’hôte et l’invité sont considérés comme des systèmes d’exploitation distincts pour l’USB. Une fois la connexion active, l’invité voit le dongle de la même manière qu’il voit un périphérique capturé localement.

Pas via le passthrough natif de VirtualBox. Il verrouille un périphérique capturé sur un seul invité ou sur l’hôte, jamais sur plusieurs à la fois. Donglify prend en charge l’accès simultané multi-VM sur les modèles de dongles avec prise en charge explicite du multi-connect, listés dans sa documentation de compatibilité des appareils. Les dongles hors de la liste prise en charge restent à connexion unique, quel que soit l’outil qui gère le partage.