Product SiteDocumentation Site

⁠30.6.4. Проброс USB

В PVE доступны два способа проброса USB-устройств в ВМ:
  • динамический проброс через SPICE (SPICE USB Passthrough) — USB-устройство подключается к ВМ во время работы, если ВМ запущена и используется совместимый SPICE-клиент;
  • прямой проброс USB с хоста (Host USB Passthrough) — USB-устройство хоста передаётся в управление ВМ и становится недоступным для обычного использования на хосте.
В PVE также можно сопоставлять USB-устройства на уровне кластера. Сопоставление позволяет корректно выполнять миграцию ВМ в HA-кластере, автоматически обнаруживать изменения оборудования и предоставлять пользователям без прав root возможность управления устройствами. Подробнее см. Сопоставление устройств.
Чтобы добавить USB-устройство в конфигурацию ВМ, выполните следующие действия:
  1. Перейдите на вкладку Оборудование;
  2. Нажмите кнопку Добавить → USB-устройство:
    Кнопка «Добавить» → «USB-устройство»
  3. Выберите режим проброса:
    • Порт Spice — динамический проброс через SPICE-клиент (устройство выбирается в клиенте во время сеанса):
      Порт Spice
    • Использовать сопоставленное устройство — проброс устройства, зарегистрированного в кластере:
      Проброс сопоставленного устройства
    • Использовать идентификатор производителя/устройства USB — проброс устройства по идентификаторам производителя и устройства (VID:PID):
      Проброс конкретного 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 Passthrough устройство можно подключать и отключать динамически через меню SPICE-клиента:
Выбор USB-устройства в SPICE-клиенте

Примечание

Сведения об USB-устройствах можно получить на вкладке Монитор с помощью следующих команд:
  • info usb — информация об USB-устройствах, подключённых к гостевой системе;
  • info usbhost — информация об USB-устройствах, обнаруженных на хосте.
Список USB-устройств гостевой системы и хоста
Если в конфигурации ВМ указан конкретный VID:PID или bus:port, а устройство отсутствует на хосте, ВМ может запуститься без этого устройства. Когда соответствующее устройство или порт станет доступен, PVE сможет передать его ВМ.

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

Прямой проброс USB-устройства с использованием host=VID:PID или host=bus:port привязывает устройство к текущему хосту и не позволяет выполнять онлайн-миграцию ВМ на другой узел с этим устройством. Для миграции необходимо учитывать доступность подходящего устройства на целевом узле и ограничения PVE.
Сопоставление USB-устройств позволяют выполнять оффлайн-миграцию ВМ на узлы, где зарегистрировано то же устройство.