Product SiteDocumentation Site

30.6.4. Проброс USB

В PVE есть два способа пробросить USB-устройства в ВМ:
  • динамический проброс через SPICE (SPICE USB Passthrough) — устройство подключается только когда ВМ запущена и SPICE-клиент активен;
  • прямой проброс USB с хоста (Host USB Passthrough) — устройство физически отключается от хоста и полностью передаётся ВМ.
Можно также сопоставлять устройства на уровне кластера, чтобы их можно было правильно использовать с HA, а изменения оборудования обнаруживались, и пользователи без прав root могли их настраивать. Подробнее см. Сопоставление устройств.
Для проброса USB-устройства в ВМ необходимо:
  1. Перейти на вкладку Оборудование;
  2. Нажать кнопку Добавить и выбрать в выпадающем списке пункт USB-устройство:
    Кнопка «Добавить» → «USB-устройство»
  3. Откроется окно добавления устройства, в котором можно выбрать режим проброса:
    • Порт Spice — сквозная передача SPICE USB (позволяет пробросить USB-устройство с клиента SPICE):
      Порт Spice
    • Использовать сопоставленное устройство — проброс в ВМ сопоставленного USB-устройства:
      Проброс сопоставленного устройства
    • Использовать идентификатор производителя/устройства USB — проброс в ВМ конкретного USB-устройства:
      Проброс конкретного USB-устройства
      USB-устройство можно выбрать в выпадающем списке Выберите устройство или указать вручную, указав <ID-производителя>:<ID-устройства> (можно получить из вывода команды lsusb).
    • Использовать USB-порт — проброс конкретного порта (в ВМ будет проброшено любое устройство, вставленное в этот порт):
      Использовать USB-порт
      USB-порт можно выбрать в выпадающем списке Выберите порт или указать вручную, указав <Номер_шины>:<Путь_к_порту> (можно получить из вывода команды lsusb -t).
  4. Нажать кнопку Добавить.
  5. Остановить и запустить ВМ (перезагрузки недостаточно).
Примеры добавления USB-устройств в консоли:
  • порт Spice:
    # qm set 100 --usb3 spice
    update VM 100: -usb3 spice
    
  • проброс конкретного USB-устройства:
    # qm set 100 --usb4 host=346d:5678
    update VM 100: -usb4 host=346d:5678
    

Примечание

Если выбран режим проброса Порт Spice, в клиенте можно динамически подключать/отключать USB:
Выбор USB-устройсва в SPICE клиенте

Примечание

Список подключенных к ВМ и хосту USB-устройств можно получить, введя на вкладке Монитор соответственно команды info usb и info usbhost:
Список подключенных к ВМ и хосту USB-устройств
Если напрямую проброшенное USB-устройство присутствует в конфигурации ВМ при запуске ВМ, но отсутствует на хосте, ВМ будет загружена без проблем. Как только устройство/порт станет доступным на хосте, оно будет проброшено в ВМ.

Предупреждение

Использование прямого проброса не позволит переместить ВМ на другой хост, поскольку оборудование доступно только на хосте, на котором в данный момент находится ВМ.
Если в конфигурации ВМ присутствует USB-устройство для которого указано Использовать сопоставленное устройство, то такую ВМ можно будет переместить (в оффлайн режиме) на хост, у которого есть сопоставление данного устройства.