Как установить клиент DistKontrolUSB в Proxmox VE и Другие системы виртуализации?
Настройка подключения DistKontrolUSB к Proxmox
В этой статье описан порядок настройки консольного клиента DistKontrolUSB на узле Proxmox VE для подключения USB-устройств с концентратора DistKontrol по SSL с авторизацией по логину и паролю и автоматическим подключением устройств при перезагрузке сервера.
- При настройке необходимо иметь доступ к CLI Proxmox VE с правами администратора.
Настройка
1. Загрузка клиента с концентратора
На узле Proxmox выполните:
wget --no-check-certificate http://<IP-адрес концентратора>/client/dkclientx86_64
2. Загрузка сертификата
Сертификат необходимо предварительно скачать из WEB-интерфейса концентратора: "Система" > "Сертификаты" > "USB". Выберите нужный сертификат и нажмите "Загрузить".
Будет загружен файл .pem.
3. Перенос сертификата на Proxmox
Передайте сертификат на Proxmox в каталог /etc/ssl/certs/:
4. Установка клиента
mv dkclientx86_64 /usr/sbin/dkclientx86_64
5. Загрузка USB/IP-модулей
Загрузите модули и сделайте их постоянными:
modprobe vhci-hcd
cat >/etc/modules-load.d/distkontrol-usbip.conf <<'EOF'
usbip-core
vhci-hcd
EOF
Проверьте, что модули загрузились:
6. Создание systemd-сервиса
[Unit]
Description=DistKontrolUSB Client
Wants=network-online.target
After=network-online.target
RequiresMountsFor=/usr/sbin
[Service]
Type=simple
ExecStartPre=/sbin/modprobe usbip-core
ExecStartPre=/sbin/modprobe vhci-hcd
ExecStartPre=/bin/sleep 3
ExecStart=/usr/sbin/dkclientx86_64
Restart=always
RestartSec=5
KillSignal=SIGTERM
[Install]
WantedBy=multi-user.target
EOF
7. Включение автозапуска
systemctl enable --now dkclient
systemctl status dkclient
8. Подключение группы портов концентратора
9. Настройка конфигурации клиента
Откройте файл конфигурации:
Добавьте:
SSLCAFile=/etc/ssl/certs/distkontrolusb20260522-143032.pem
SSLPort=7577
PresavedPasswords=220c3e6f0c4c.5142,Логин\\Пароль
10. Включение автоматического подключения устройств
DKUSB64-Gr-07 — имя подключаемого концентратора. Его можно узнать командой:
Проверьте конфигурацию:
Файл должен выглядеть так:
ManualHubs=192.168.1.41:7577
[General]
SSLCAFile=/etc/ssl/certs/distkontrolusb20260522-143032.pem
SSLPort=7577
PresavedPasswords=220c3e6f0c4c.5142,Логин\\Пароль,220c3e6f0c4c.5143,Логин\\Пароль,220c3e6f0c4c.5144,Логин\\Пароль
[AutoShare]
220c3e6f0c4c=1
All=0
220c3e6f0c4c.4096.34148.5142=0
220c3e6f0c4c.4096.34148=0
220c3e6f0c4c.5142=0
- ManualHubs — IP-адрес подключаемого концентратора и порт группы портов.
- SSLCAFile — путь до сертификата. Используется, если необходимо шифрование трафика.
- SSLPort — порт шифрованного соединения. Используется, если необходимо шифрование трафика.
- PresavedPasswords — устройство, порт, логин, пароль. Используется, если необходимо автоподключение устройств. Если нужно автоподключение нескольких портов, конфигурация для каждого порта указывается в той же строке через запятую: PresavedPasswords=220c3e6f0c4c.5142,Логин\\Пароль,220c3e6f0c4c.5143,Логин\\Пароль
Проверка
11. Проверка автоподключения
Остановите работу клиента:
Остановите службу клиента:
Проверьте, что больше нет процессов клиента:
При необходимости завершите оставшиеся процессы:
Запустите сервис:
Проверьте статус службы:
Если в выводе указано "Active: active (running)", служба работает корректно.
Проверьте статус клиента:
Пример корректного вывода:
(Value in brackets = address, * = Auto-Use)
DKUSB64-Gr-07 (DKUSB64-Gr-07:7577)*
*--> USB 3.16 (DKUSB64-Gr-07.5144) (In-use by you)
*--> USB 3.15 (DKUSB64-Gr-07.5143) (In-use by you)
*--> USB 3.14 (DKUSB64-Gr-07.5142) (In-use by you)
Auto-Find currently on
Auto-Use All currently off
Reverse Lookup currently off
Reverse SSL Lookup currently off
DistKontrolUSB Client not running as a service
- (In-use by you) — устройство подключилось и используется этим хостом.
- * напротив имени концентратора — автозапуск установлен на все порты подключённой группы.
12. Проверка появления устройств в системе
Проверьте, что USB-устройства появились в системе:
Также убедитесь, что устройства видны в интерфейсе Proxmox VE.
Настройка завершена. Далее администратор Proxmox VE с нужными правами создаёт "Resource Mappings" и подключает туда необходимые устройства, проброшенные через DistKontrol.
Действия, аналогичные описанным в инструкции, наиболее вероятно будут корректно работать с такими системами, как: KVM + libvirt, установленный на Linux, oVirt, а также zVirt, РЕД Виртуализация, Альт Виртуализация, Брест и ROSA Virtualization, так как они созданы на базе KVM и используют Linux в качестве хостовой ОС.
Другие наиболее популярные системы виртуализации, такие как VMware, Hyper-V и Xen, не поддерживают описанный в инструкции или аналогичный способ подключения на уровне гипервизора.