Skip to content

Управление USB-устройствами ​

WSL Dashboard интегрирован с usbipd-win, что позволяет легко подключать локальные USB-устройства к экземплярам WSL прямо в графическом интерфейсе.

Предварительная подготовка ​

Перед использованием этой функции убедитесь, что:

  1. На Windows установлен usbipd-win.
  2. Ядро вашего WSL поддерживает USB (современные ядра WSL 2 по умолчанию обычно уже поддерживают).

Шаги использования ​

1. Сканирование устройств ​

Откройте вкладку «USB» — приложение автоматически перечислит все USB-устройства, подключённые к Windows (включая концентраторы, мыши, накопители и т.д.).

2. Привязка устройства (Bind) ​

Перед подключением устройства к конкретному экземпляру WSL его необходимо «привязать». Привязка требует прав администратора — WSL Dashboard автоматически обработает запрос на повышение прав.

После привязки устройство будет готово к совместному использованию с WSL.

3. Подключение к экземпляру (Attach) ​

Выберите работающий экземпляр WSL и нажмите «Подключить (Attach)».

  • После успешного подключения USB-устройство исчезнет из Windows и появится в выбранном экземпляре WSL.
  • Проверить можно командой lsusb внутри WSL.

4. Отключение (Detach) ​

После завершения работы нажмите «Отключить (Detach)» — устройство снова вернётся под управление Windows.

Частые вопросы ​

  • Устройство не найдено?: попробуйте обновить список или проверьте, правильно ли устройство подключено к хост-системе.
  • Не удаётся подключить?: убедитесь, что целевой экземпляр WSL работает и у вас достаточно прав.
  • Команда usbipd не найдена?: убедитесь, что usbipd-win установлен и добавлен в переменную окружения PATH системы.