Como usar o USB Passthrough no Proxmox VE para VMs e LXCs?

O USB passthrough permite que os usuários do Proxmox VE conectem dispositivos físicos às máquinas virtuais ou aos contêineres. Este artigo explica os conceitos básicos, as etapas de configuração, as opções avançadas e as soluções para problemas comuns. Continue lendo para dominar o USB passthrough no seu ambiente.

Descarregar Gratuitamente
para VM, SO, DB, Ficheiro, NAS, etc.
joao

Updated by João on 2025/08/22

Índice
  • Qu'est-ce que le passage USB PVE et pourquoi en avez-vous besoin ?

  • Prérequis pour le passage USB dans Proxmox VE

  • Comment PVE gère-t-il le passage USB en interne ?

  • Méthode 1 : Transférer un périphérique USB à une machine virtuelle via l'interface web

  • Méthode 2 : Passage des périphériques aux conteneurs LXC

  • Méthode 3 : Passage complet du contrôleur via l'assignation PCIe

  • Meilleures pratiques pour le passage USB en Proxmox VE

  • Résolution des problèmes courants liés au passage USB sous PVE

  • Protection des machines virtuelles Proxmox avec Vinchin

  • PVE USB Passthrough FAQs

  • Conclusion

Le passage USB est une fonction essentielle pour de nombreux utilisateurs de Proxmox VE . Il permet de connecter des périphériques USB physiques, tels que des clés de licence ou des lecteurs de carte à puce, aux machines virtuelles ou conteneurs comme s'ils étaient directement branchés. Mais qu'advient-il réellement en arrière-plan ? Et comment assurer un fonctionnement fiable à travers différents environnements ?

Dans ce guide, nous allons renforcer votre compréhension pas à pas – depuis le mappage basique des périphériques jusqu'au pass-through avancé des contrôleurs – tout en explorant des solutions pratiques aux défis courants. Que vous exécutiez un labo domestique ou que vous gériez une infrastructure d'entreprise, maîtriser le pass-through USB peut ouvrir de nouvelles possibilités dans votre environnement virtuel.

Qu'est-ce que le passage USB PVE et pourquoi en avez-vous besoin ?

En son cœur, le passage USB permet à une machine virtuelle (VM) ou à un conteneur LXC d'accéder à un périphérique USB physique connecté à votre hôte Proxmox. Cela signifie que les logiciels à l'intérieur de votre système invité peuvent utiliser des clés matérielles, des disques de stockage, des clés Zigbee ou d'autres périphériques exactement comme sur une machine physique.

Comment cela fonctionne-t-il ? Pour les machines virtuelles, Proxmox utilise la prise en charge intégrée de QEMU pour rediriger le trafic USB de l'hôte vers le système d'exploitation invité. Pour les conteneurs (LXC), il s'appuie sur des fonctionnalités du noyau Linux telles que les cgroups et les namespaces afin d'exposer les nœuds de périphérique en toute sécurité.

Pourquoi est-ce important ? De nombreuses applications professionnelles nécessitent un accès direct au matériel, par exemple :

  • Utiliser une clé de sécurité matérielle pour l'authentification à deux facteurs

  • Connexion de disques externes pour le transfert de données

  • Installation de lecteurs de cartes à puce pour une connexion sécurisée

  • Intégration des appareils IoT via des clés Zigbee ou Z-Wave

Sans une configuration appropriée du passthrough, ces périphériques restent invisibles dans vos machines invitées. Comprendre le fonctionnement du passthrough – et ses limites – vous aide à éviter les frustrations futures.

Prérequis pour le passage USB dans Proxmox VE

Avant de configurer le passage USB dans Proxmox VE, vérifiez quelques exigences de base :

Assurez-vous d'abord que la virtualisation est activée dans le BIOS/UEFI de votre serveur (Intel VT-d ou AMD-Vi). Pour le passage direct du contrôleur PCIe (cas d'utilisation avancés), activez le support IOMMU en ajoutant intel_iommu=on ou amd_iommu=on aux paramètres de démarrage de votre noyau.

Ensuite, identifiez le type de contrôleur USB que vous possédez — EHCI (USB 2.0) ou xHCI (USB 3.x) — car cela influence la compatibilité et la stabilité lors du passage de contrôleurs entiers.

Enfin, gardez à l’esprit que les nouvelles versions de Proxmox peuvent gérer les permissions des périphériques différemment en raison des modifications des règles udev ou des mises à jour du noyau. Vérifiez toujours les notes de compatibilité avant de mettre à niveau des systèmes de production.

Comment PVE gère-t-il le passage USB en interne ?

Lorsque vous attribuez un périphérique USB physique à une machine virtuelle à l’aide de Proxmox VE :

1. L'hôte détecte le périphérique via son ID fabricant unique (idVendor) et son ID produit (idProduct).

2. QEMU crée une représentation virtuelle de ce périphérique à l'intérieur de la machine virtuelle.

3. Toute communication entre le logiciel invité et le matériel transite par ce canal, contournant l'émulation pour une vitesse proche de celle du natif.

Pour les conteneurs LXC :

1. L'hôte expose des nœuds /dev spécifiques en utilisant des montages liés.

2. Les autorisations du groupe de contrôle (cgroup) déterminent quels périphériques sont visibles à l'intérieur de chaque conteneur.

3. Les liens symboliques persistants sous /dev/serial/by-id permettent de maintenir des chemins stables même si les périphériques sont débranchés/rebranchés.

Cette approche directe offre des performances élevées, mais nécessite une configuration soignée, en particulier concernant les autorisations et les limites d'isolation.

Méthode 1 : Transférer un périphérique USB à une machine virtuelle via l'interface web

La façon la plus simple de transférer un périphérique USB à une machine virtuelle est d'utiliser l'interface web de Proxmox. Cette méthode convient à la plupart des utilisateurs exécutant des systèmes invités Linux ou Windows.

  1. Branchez le périphérique USB souhaité sur n'importe quel port disponible de votre serveur hôte.

  2. Dans l'interface web, sélectionnez la machine virtuelle cible.

  3. Cliquez sur Hardware, puis sur Add > USB Device.

  4. Choisissez l'une des options suivantes :

  5. Use USB Vendor/Device ID: Pour un appareil spécifique dont l'ID reste fixe.

  6. Use USB Port: Pour des configurations flexibles où n’importe quel périphérique branché sur un port spécifique est transmis directement.

  7. Enregistrez les modifications et redémarrez la machine virtuelle. Depuis votre système d'exploitation invité, exécutez lsusb (Linux) ou vérifiez le Gestionnaire de périphériques (Windows) pour confirmer que le périphérique est correctement passé en pass-through.

Méthode 2 : Passage des périphériques aux conteneurs LXC

Le passage des périphériques physiques aux conteneurs LXC est plus délicat en raison d'une isolation plus stricte, mais cela reste réalisable.

Conseil 1 : Utiliser les chemins d'appareils persistants

Les chemins persistants situés sous /dev/serial/by-id fournissent des liens d'appareils stables même après avoir débranché et rebranché les appareils. Pour utiliser cette méthode :

  1. Sur l'hôte, exécutez :
    ls -l /dev/serial/by-id
    Exemple de sortie :

    lrwxrwxrwx 1 root root 13 Sep 9 10:54 usb-Silicon_Labs_CP210x-if00-port0 -> ../../ttyUSB0
  2. Dans l'interface web, sélectionnez le conteneur cible et cliquez sur Resources.

  3. Cliquez sur Add > Device Passthrough et saisissez le chemin complet du périphérique (par exemple, /dev/serial/by-id/...).

  4. Enregistrer les modifications et redémarrer le conteneur.

Conseil 2 : Modification manuelle du fichier de configuration LXC

Si les chemins persistants ne sont pas disponibles, ou si vous avez besoin d'un contrôle plus fin des autorisations :

  1. Modifiez le fichier de configuration du conteneur à l'emplacement /etc/pve/lxc/<CTID>.conf et ajoutez :

    lxc.cgroup2.devices.allow: c 188:* rwm
    lxc.mount.entry: /dev/ttyUSB0 dev/ttyUSB0 none bind,optional,create=file
  2. Redémarrez le conteneur pour appliquer les modifications.

Gestion des autorisations et des événements de déconnexion/reconnexion

Parfois, la déconnexion et la reconnexion des périphériques provoquent une réinitialisation des autorisations ou un changement dans l'attribution des nœuds /dev. Pour gérer cela :

  1. Créer des règles UDEV persistantes :
    Créez une règle UDEV personnalisée pour automatiser les corrections de permissions et la création de liens symboliques :

    SUBSYSTEM=="tty", ATTRS{idVendor}=="10c4", ATTRS{idProduct}=="ea60", SYMLINK+="mydevice", GROUP="lxcuser", MODE="0660"

    Recharger les règles UDEV avec :

    udevadm control --reload && udevadm trigger
  2. Automatiser les redémarrages des conteneurs après les événements de rebranchement :
    Associez des déclencheurs UDEV à des scripts pour redémarrer automatiquement les conteneurs après des événements de rebranchement des périphériques :

    pct restart <CTID>

Méthode 3 : Passage complet du contrôleur via l'assignation PCIe

Pour des performances maximales, vous pouvez souhaiter transférer un contrôleur USB entier plutôt que des périphériques individuels. Cela s'avère particulièrement utile pour les périphériques à haut débit comme les SSD externes.

  1. Activer l'IOMMU dans le BIOS et le chargeur d'amorçage (intel_iommu=on ou amd_iommu=on).

  2. Trouvez l'adresse du contrôleur en utilisant :
    lspci | grep -i usb

  3. Connecter le pilote du contrôleur à l'aide des outils VFIO si nécessaire :

    echo "8086:a36d" > /sys/bus/pci/drivers/vfio-pci/new_id
  4. Dans l'interface web, sélectionnez la machine virtuelle cible, cliquez sur Hardware, puis sur

     Add > PCI Device.

    Sélectionnez l'adresse du contrôleur appropriée et confirmez.

Avertissement important : Évitez d'affecter le clavier/souris au hub/controller racine, sauf si vous disposez d'outils de gestion à distance, car cela pourrait vous empêcher d'accéder au système.

Meilleures pratiques pour le passage USB en Proxmox VE

Lors du transfert de périphériques physiques entre des hôtes et des invités, respectez toujours le principe du moindre privilège afin de réduire les risques de sécurité.

  • Ne jamais accorder un accès plus étendu que nécessaire. Ne transmettre que les identifiants de fournisseur/de produit requis.

  • Surveillez régulièrement les journaux d'activité à la recherche d'événements inhabituels, en particulier après des mises à niveau ou des remplacements matériels.

  • Dans les environnements multi-utilisateurs, envisagez d'utiliser des restrictions basées sur les groupes via des règles/scripts UDEV personnalisés pour limiter l'accès aux périphériques.

Résolution des problèmes courants liés au passage USB sous PVE

Si les périphériques ne sont pas reconnus ou si les autorisations échouent :

  1. Vérifier la détection USB :
    Exécutez lsusb sur l'hôte et sur la machine invitée pour vérifier la détection.

  2. Erreurs de permissions :
    Vérifiez les propriétaires (groupe/utilisateur) sous /dev et corrigez-les avec chown ou chmod.

  3. Pannes à chaud :
    Vérifiez que l'agent QEMU est activé dans les machines virtuelles, et utilisez des scripts pour automatiser le redémarrage des conteneurs pour les LXCs.

Protection des machines virtuelles Proxmox avec Vinchin

Après avoir configuré des environnements PVE fiables - y compris des fonctionnalités avancées telles que le passage USB - vous souhaiterez disposer d'une sauvegarde solide pour vous assurer la tranquillité d'esprit et la continuité de votre activité.

Vinchin Backup & Recovery  se démarque en tant que solution de sauvegarde de machines virtuelles de niveau entreprise, prenant en charge plus de quinze plateformes principales, notamment une prise en charge dédiée pour Proxmox VE ainsi que VMware, Hyper-V, oVirt, OLVM, RHV, XCP-ng, XenServer, OpenStack, ZStack et bien plus encore, le tout géré depuis une plateforme unifiée.

Les principales caractéristiques incluent la technologie de sauvegarde incrémentielle qui réduit l'utilisation du stockage ; la déduplication et la compression des données intégrées ; une migration V2V transparente entre des plateformes hétérogènes ; des capacités de restauration précises ; ainsi que des sauvegardes automatiques planifiées avec des politiques de rétention flexibles — le tout conçu pour optimiser l'efficacité à grande échelle, sans compromettre la fiabilité ni la rapidité.

La console web Vinchin intuitive rend la protection de toute machine virtuelle Proxmox simple et évidente :

1. Sélectionnez la machine virtuelle Proxmox à sauvegarder ;

Sélectionner la machine virtuelle Proxmox à sauvegarder

2. Choisissez le stockage de sauvegarde ;

Sélectionnez la sauvegarde de stockage

3. Configurer les stratégies de sauvegarde;

Configurer les stratégies de sauvegarde

4. Soumettre le travail.

Soumettre le travail

Des milliers de personnes font confiance à Vinchin dans le monde entier — avec des évaluations positives dans divers secteurs — et vous pouvez maintenant tester toutes les fonctionnalités gratuitement grâce à notre essai complet de 60 jours.

PVE USB Passthrough FAQs

Q1 : Puis-je brancher à chaud une nouvelle clé USB afin que mon Windows Server la reconnaisse instantanément ?

A1 : Oui — tant que la prise en charge du hotplug est activée dans les paramètres de QEMU et que les outils invités sont installés, la clé apparaît immédiatement sans redémarrage.

Q2 : Mon application LXC ne peut pas écrire des fichiers même si j'ai branché mon adaptateur série — pourquoi ?

A2 : Vérifiez les autorisations/groupes du dossier /dev ; ajustez-les via des règles udev personnalisées ou des commandes chmod/chown si nécessaire.

Conclusion

L'approche flexible de PVE permet aux administrateurs de connecter en toute sécurité et efficacement presque tout type de périphérique physique, allant des clés d'utilisation unique jusqu'aux contrôleurs haute vitesse complets, à leurs charges de travail virtualisées. Grâce à des sauvegardes fiables fournies par Vinchin, vos données critiques restent protégées, quel que soit le niveau de complexité des opérations. Essayez Vinchin dès aujourd'hui et alliez tranquillité d'esprit et performances optimales !


Partilhar em:

Categories: VM Backup