Xrdp-usb: различия между версиями

Текущая версия от 15:45, 6 февраля 2023

Данный компонент пробрасывает широкий спектр устройств, начиная от USB-веб-камер, до USB-токенов и смарт-карт.

Внимание! Проброс будет работать только в рамках локальной сети, так как требует доступность клиентского компьютера с сервера

В данной статье рассмотрена процедура настройки подключения USB-устройств через Xrdp.

Терминальный сервер (сервер) — хост, на котором запущен Xrdp.
Терминальный клиент (клиент) — хост, к которому подключены USB-устройства, экспортируемые на клиент.

Настройка сервера

Обновить систему:

# apt-get update && apt-get dist-upgrade

Установить пакет xrdp-usb-session:

# apt-get install xrdp-usb-session

xrdp-usb-session для сеанса xrdp-sesman добавляет запуск автоподключения всех USB-устройств с клиента.

Далее, после установки xrdp-usb-session необходимо перезапустить службу xrdp-sesman:

# systemctl restart xrdp-sesman.service

Настройка клиента

Обновить систему:

# apt-get update && apt-get dist-upgrade

Установить пакет xrdp-usb-terminal:

# apt-get install xrdp-usb-terminal

После установки xrdp-usb-terminal, добавить пользователя в группу disk:

# gpasswd -a alt-1 disk

где alt-1 — имя пользователя.

После успешной установки xrdp-usb-terminal и добавления пользователя в группу disk, необходимо перезагрузить систему (чтобы загрузились все модули и запустилась служба usbipd).

По умолчанию никакие устройства не передаются. Чтобы они передавались, необходимо отредактировать файл /etc/xrdp-usb:

В терминале с помощью команды lsusb просмотреть идентификаторы устройств.
Из полученного вывода следует выбрать ID-устройства, которое необходимо пробрасывать, и добавить нужный идентификатор (в примере это 13fe:4300) в файл /etc/xrdp-usb:

Можно указать сколько угодно идентификаторов, но необходимо быть осторожным с идентификаторами мыши и клавиатуры. Если они будут проброшены, то они не будут доступны на локальной системе.

Проброс

Для подключения к серверу, на клиентском компьютере должен быть установлен клиент удаленного доступа. Для подключения к серверу терминалов можно использовать программы удаленного доступа xfreerdp, Remmina, Connector и т.д. Перед подключением необходимо на клиенте выполнить команду usbip-export:

$ usbip-export
EXPORT USB 13fe:4300 (3-2)
usbip: info: unbind device on busid 3-2: complete
usbip: info: bind device on busid 3-2: complete

Далее, со стороны клиента подключаемся к терминальному серверу, например:

$ xfreerdp /v:192.168.0.104 /u:user /p:password

Окно подключения к удаленному рабочему столу с проброшенным USB-устройством:

При ошибках связанных с подключением, рекомендуется проверить настройки брандмауэра и проверить соответствие версий приложения usbip.

Openuds при подключении самостоятельно экспортирует указанные устройства. На терминальном сервере при этом должен быть установлен пакет openuds-client.

Терминальный сервер

FreeNX • X2Go • Xrdp • Xrdp-usb • Терминальный сервер NoMachine в KVM

@@ Строка 1: / Строка 1: @@
-Краткая схема работы подключения usb устройств через Xrdp.
+Данный компонент пробрасывает широкий спектр устройств, начиная от USB-веб-камер, до USB-токенов и смарт-карт.
-'''Все действия выполняются под рутом, т.е. после команды su-'''
+{{Attention|Проброс будет работать только в рамках локальной сети, так как требует доступность клиентского компьютера с сервера}}
-В этой статье действия будут выполняться как со стороны сервера '''(server1)''', так и со стороны клиента '''(client1)'''
-Для начала, установим необходимую инфраструктуру:
+В данной статье рассмотрена процедура настройки подключения USB-устройств через [[Xrdp]].
-'''server1'''
+*'''Терминальный сервер (сервер)''' — хост, на котором запущен [[Xrdp]].
-  apt-repo test 285162 xrdp-usb-session
+*'''Терминальный клиент (клиент)''' — хост, к которому подключены USB-устройства, экспортируемые на клиент.
-'''client1'''
+== Настройка сервера ==
- apt-repo test 285162 xrdp-usb-terminal
+Обновить систему:
- apt-repo test 285162 openuds-client
-Так же, нам необходимо добавить устройства, которые мы хотим пробросить. Для этого нам необходимо знать идентификатор устройства 14d3:56c9 или только с первой частью 14d3:* (как пример), а так же добавить этот идентификатор
+<syntaxhighlight lang="bash"># apt-get update && apt-get dist-upgrade</syntaxhighlight>
-в файл /etc/xrdp-usb
-Далее, нам необходимо внести пользователя в группу 'disk'
+Установить пакет {{pkg|xrdp-usb-session}}:
-  usermod -a -G disk alt-1          (alt-1 - здесь необходим ваше имя пользователя)
+<syntaxhighlight lang="bash"># apt-get install xrdp-usb-session</syntaxhighlight>
-Теперь, устанавливаем usbip
+xrdp-usb-session для сеанса xrdp-sesman добавляет запуск автоподключения всех USB-устройств с клиента.
- apt-get install usbip
-Так же, ставим kernel модуль:
- modprobe vhci-hcd
-Чтобы модуль загружался автоматически, когда вы запускаете систему необходимо добавить его в /etc/modules
+Далее, после установки xrdp-usb-session необходимо перезапустить службу xrdp-sesman:
- nano /etc/modules
+<syntaxhighlight lang="bash"># systemctl restart xrdp-sesman.service</syntaxhighlight>
- vhci-hcd
-Далее, нам необходимо присоединиться к usbip серверу через команду:
+== Настройка клиента ==
- usbip list -l 192.168.0.100            (192.168.0.100 является адресом usbip сервера)
-После выполнения последней команды, вы должны увидеть те USB устройства, которые у вас имеются (устройства ниже, являются примером. У вас устройства будут отличаться):
+Обновить систему:
- - busid 3-1 (80ee:0021)
+<syntaxhighlight lang="bash"># apt-get update && apt-get dist-upgrade</syntaxhighlight>
-   VirtualBox : USB Tablet (80ee:0021)
-Чтобы подсоединиться к устройству необходимо ввести команду:
+Установить пакет {{pkg|xrdp-usb-terminal}}:
- usbip attach -r 192.168.0.100 -b 3-1        (-r - Remote, -b busid)
+<syntaxhighlight lang="bash"># apt-get install xrdp-usb-terminal</syntaxhighlight>
-Далее, необходимо ввести команду lsusb, чтобы найти удаленное USB-устройство в выводе на клиенте:
+После установки {{pkg|xrdp-usb-terminal}}, добавить пользователя в группу disk:
- lsusb
+<syntaxhighlight lang="bash"># gpasswd -a alt-1 disk</syntaxhighlight>
+где ''alt-1'' — имя пользователя.
-'''server1'''
+После успешной установки {{pkg|xrdp-usb-terminal}} и добавления пользователя в группу disk, необходимо перезагрузить систему (чтобы загрузились все модули и запустилась служба usbipd).
-Нам необходимо забиндить, но уже со стороны сервера usbid:
- usbip bind -b 3-1
+По умолчанию никакие устройства не передаются. Чтобы они передавались, необходимо отредактировать файл {{path|/etc/xrdp-usb}}:
+# В терминале с помощью команды {{cmd|lsusb}} просмотреть идентификаторы устройств.
+#: [[Файл:Lsusb.png]]
+# Из полученного вывода следует выбрать ID-устройства, которое необходимо пробрасывать, и добавить нужный идентификатор (в примере это ''13fe:4300'') в файл {{path|/etc/xrdp-usb}}:
+#:[[Файл:Etc-xrdp-usb.png]]
+Можно указать сколько угодно идентификаторов, но необходимо быть осторожным с идентификаторами мыши и клавиатуры. Если они будут проброшены, то они не будут доступны на локальной системе.
+== Проброс ==
+Для подключения к серверу, на клиентском компьютере должен быть установлен клиент удаленного доступа. Для подключения к серверу терминалов можно использовать программы удаленного доступа xfreerdp, Remmina, Connector и т.д. Перед подключением необходимо на клиенте выполнить команду {{cmd|usbip-export}}:
+<syntaxhighlight lang="bash">$ usbip-export
+EXPORT USB 13fe:4300 (3-2)
+usbip: info: unbind device on busid 3-2: complete
+usbip: info: bind device on busid 3-2: complete</syntaxhighlight>
+Далее, со стороны клиента подключаемся к терминальному серверу, например:
+<syntaxhighlight lang="bash">$ xfreerdp /v:192.168.0.104 /u:user /p:password</syntaxhighlight>
+Окно подключения к удаленному рабочему столу с проброшенным USB-устройством:
+[[Файл:Freerdp-usb.png|FreeRDP. Подключение к удаленному рабочему столу]]
+При ошибках связанных с подключением, рекомендуется проверить настройки брандмауэра и проверить соответствие версий приложения {{pkg|usbip}}.
+[[VDI/OpenUDS|Openuds]] при подключении самостоятельно экспортирует указанные устройства. На терминальном сервере при этом должен быть установлен пакет {{pkg|openuds-client}}.
 {{Category navigation|title=Терминальный сервер|category=Терминальный сервер|sortkey={{SUBPAGENAME}}}}