Skip to content

Gestion des périphériques USB ​

WSL Dashboard s'intègre à usbipd-win, vous permettant de connecter facilement des périphériques USB locaux à vos instances WSL depuis l'interface graphique.

Préparation ​

Avant d'utiliser cette fonctionnalité, assurez-vous que :

  1. Vous avez installé usbipd-win sur Windows.
  2. Votre noyau WSL prend en charge l'USB (les noyaux par défaut de WSL 2 moderne le prennent généralement en charge).

Étapes d'utilisation ​

1. Analyser les périphériques ​

Entrez dans l'onglet « USB » ; l'application liste automatiquement tous les périphériques USB actuellement connectés à Windows (y compris les concentrateurs, souris, périphériques de stockage, etc.).

2. Lier le périphérique (Bind) ​

Avant de connecter un périphérique à une instance WSL spécifique, vous devez d'abord « lier » ce périphérique. La liaison nécessite des privilèges d'administrateur ; WSL Dashboard gère automatiquement la demande d'élévation.

Après la liaison, le périphérique sera prêt à être partagé avec WSL.

3. Connecter à l'instance (Attach) ​

Sélectionnez une instance WSL en cours d'exécution et cliquez sur « Connecter (Attach) ».

  • Une fois connecté, le périphérique USB disparaîtra de Windows et apparaîtra dans l'instance WSL sélectionnée.
  • Vous pouvez vérifier dans WSL avec la commande lsusb.

4. Déconnecter (Detach) ​

Une fois l'opération terminée, cliquez sur « Déconnecter (Detach) » ; le périphérique reviendra sous le contrôle de Windows.

Questions fréquentes ​

  • Périphérique introuvable ? : essayez d'actualiser la liste ou vérifiez que le périphérique est correctement branché sur l'hôte.
  • Échec de connexion ? : assurez-vous que l'instance WSL cible est en cours d'exécution et que vous disposez de permissions suffisantes.
  • Commande usbipd introuvable ? : vérifiez que usbipd-win est installé et ajouté à la variable d'environnement PATH du système.