В PVE доступны два способа проброса USB-устройств в ВМ:
динамический проброс через SPICE (SPICE USB Passthrough) — USB-устройство подключается к ВМ во время работы, если ВМ запущена и используется совместимый SPICE-клиент;
прямой проброс USB с хоста (Host USB Passthrough) — USB-устройство хоста передаётся в управление ВМ и становится недоступным для обычного использования на хосте.
В PVE также можно сопоставлять USB-устройства на уровне кластера. Сопоставление позволяет корректно выполнять миграцию ВМ в HA-кластере, автоматически обнаруживать изменения оборудования и предоставлять пользователям без прав root возможность управления устройствами. Подробнее см.
Сопоставление устройств.
Чтобы добавить USB-устройство в конфигурацию ВМ, выполните следующие действия:
Перейдите на вкладку Оборудование;
Нажмите кнопку → :
Выберите режим проброса:
Порт Spice — динамический проброс через SPICE-клиент (устройство выбирается в клиенте во время сеанса):
Использовать сопоставленное устройство — проброс устройства, зарегистрированного в кластере:
Использовать идентификатор производителя/устройства USB — проброс устройства по идентификаторам производителя и устройства (VID:PID):
Устройство можно выбрать в списке Выберите устройство или указать его идентификаторы вручную в формате <ID-производителя>:<ID-устройства> (идентификаторы можно получить из вывода команды lsusb).
Использовать USB-порт — проброс физического USB-порта (устройство, подключённое к этому порту, будет передаваться ВМ):
Порт можно выбрать в списке Выберите порт или указать вручную в формате <Номер_шины>:<Путь_к_порту> (информацию о шине и пути к порту можно получить с помощью команды lsusb -t).
Нажать кнопку Добавить.
Остановить и запустить ВМ, чтобы применить изменение конфигурации (обычная перезагрузка не применяет изменения конфигурации).
Примеры добавления 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-устройствах можно получить на вкладке
Монитор с помощью следующих команд:
info usb — информация об USB-устройствах, подключённых к гостевой системе;
info usbhost — информация об USB-устройствах, обнаруженных на хосте.
Если в конфигурации ВМ указан конкретный VID:PID или bus:port, а устройство отсутствует на хосте, ВМ может запуститься без этого устройства. Когда соответствующее устройство или порт станет доступен, PVE сможет передать его ВМ.
Прямой проброс USB-устройства с использованием host=VID:PID или host=bus:port привязывает устройство к текущему хосту и не позволяет выполнять онлайн-миграцию ВМ на другой узел с этим устройством. Для миграции необходимо учитывать доступность подходящего устройства на целевом узле и ограничения PVE.
Сопоставление USB-устройств позволяют выполнять оффлайн-миграцию ВМ на узлы, где зарегистрировано то же устройство.