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

Текущая версия от 18: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-устройств через xfreerdp. Все дальнейшие действия выполняются под рутом '''su-'''.
+Данный компонент пробрасывает широкий спектр устройств, начиная от USB-веб-камер, до USB-токенов и смарт-карт.
+{{Attention|Проброс будет работать только в рамках локальной сети, так как требует доступность клиентского компьютера с сервера}}
-Перед началом работы, необходимо обновить систему. Обновить систему необходимо как на терминальном сервере (Альт 8 СП), так и на клиентском сервере (в моем случае это Альт Образование)
+В данной статье рассмотрена процедура настройки подключения USB-устройств через [[Xrdp]].
- apt-get update
-На терминальном сервере (Альт 8 СП) устанавливаем xrdp-usb-session:
+*'''Терминальный сервер (сервер)''' — хост, на котором запущен [[Xrdp]].
- apt-repo test 285162 xrdp-usb-session
+*'''Терминальный клиент (клиент)''' — хост, к которому подключены USB-устройства, экспортируемые на клиент.
+== Настройка сервера ==
+Обновить систему:
+<syntaxhighlight lang="bash"># apt-get update && apt-get dist-upgrade</syntaxhighlight>
+Установить пакет {{pkg|xrdp-usb-session}}:
+<syntaxhighlight lang="bash"># apt-get install xrdp-usb-session</syntaxhighlight>
 xrdp-usb-session для сеанса xrdp-sesman добавляет запуск автоподключения всех USB-устройств с клиента.
-Далее, после установки xrdp-usb-session необходимо перезапустить службу xrdp-sesman.
-[[Файл:Systemctl restart.png]]
+Далее, после установки xrdp-usb-session необходимо перезапустить службу xrdp-sesman:
+<syntaxhighlight lang="bash"># systemctl restart xrdp-sesman.service</syntaxhighlight>
-Теперь, переходим к терминальному клиенту (В моем случае, Альт Образование). Устанавливаем xrdp-usb-terminal:
+== Настройка клиента ==
- apt-repo test 285162 xrdp-usb-terminal
-А так же, после установки xrdp-usb-terminal, нам необходимо добавить нашего пользователя в группу disk:
+Обновить систему:
- usermod -a -G disk alt-1       (там где alt-1, необходимо ваше имя пользователя)
+<syntaxhighlight lang="bash"># apt-get update && apt-get dist-upgrade</syntaxhighlight>
-Далее, после успешной установки xrdp-usb-terminal и после того, как мы добавили нашего пользователя в группу disk, нам необходимо перезагрузить систему (чтобы все модули загрузились) и служба usbipd запустилась. По умолчанию никакие устройства не передаются.  Чтобы они передавались, в терминале запускается lsusb и смотрятся идентификаторы.
+Установить пакет {{pkg|xrdp-usb-terminal}}:
+<syntaxhighlight lang="bash"># apt-get install xrdp-usb-terminal</syntaxhighlight>
+После установки {{pkg|xrdp-usb-terminal}}, добавить пользователя в группу disk:
-[[Файл:Lsusb.png]]
+<syntaxhighlight lang="bash"># gpasswd -a alt-1 disk</syntaxhighlight>
+где ''alt-1'' — имя пользователя.
+После успешной установки {{pkg|xrdp-usb-terminal}} и добавления пользователя в группу disk, необходимо перезагрузить систему (чтобы загрузились все модули и запустилась служба usbipd).
+По умолчанию никакие устройства не передаются. Чтобы они передавались, необходимо отредактировать файл {{path|/etc/xrdp-usb}}:
+# В терминале с помощью команды {{cmd|lsusb}} просмотреть идентификаторы устройств.
+#: [[Файл:Lsusb.png]]
+# Из полученного вывода следует выбрать ID-устройства, которое необходимо пробрасывать, и добавить нужный идентификатор (в примере это ''13fe:4300'') в файл {{path|/etc/xrdp-usb}}:
+#:[[Файл:Etc-xrdp-usb.png]]
-Необходимые для нас данные на скриншоте сверху это идентификатор (в нашем случае это ID 13fe:4300). Теперь нам нужно отредактировать файл в /etc/xrdp-usb
+Можно указать сколько угодно идентификаторов, но необходимо быть осторожным с идентификаторами мыши и клавиатуры. Если они будут проброшены, то они не будут доступны на локальной системе.
- vim /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>
-Далее, необходимо установить openuds-client на терминальный сервер (Альт 8 СП). Openuds при подключение самостоятельно экспортирует указанные устройства.
-Для того, чтобы обратиться к терминальному серверу (через Remmina или xfreerdp), то перед подключением необходимо запустить программу usbip-export (на клиенте).
+Далее, со стороны клиента подключаемся к терминальному серверу, например:
-Далее, со стороны клиента подключаемся к терминальному серверу:
+<syntaxhighlight lang="bash">$ xfreerdp /v:192.168.0.104 /u:user /p:password</syntaxhighlight>
- usbip attach -r 192.168.0.1 -b 3-2
+Окно подключения к удаленному рабочему столу с проброшенным USB-устройством:
--r Является ip адресом терминального сервера
+[[Файл:Freerdp-usb.png|FreeRDP. Подключение к удаленному рабочему столу]]
--b Является идентификатор устройства, который мы отредактировали в файле /etc/xrdp-usb , а так же, который был подтвержден посредством команды usbip-export
+При ошибках связанных с подключением, рекомендуется проверить настройки брандмауэра и проверить соответствие версий приложения {{pkg|usbip}}.
+[[VDI/OpenUDS|Openuds]] при подключении самостоятельно экспортирует указанные устройства. На терминальном сервере при этом должен быть установлен пакет {{pkg|openuds-client}}.
 {{Category navigation|title=Терминальный сервер|category=Терминальный сервер|sortkey={{SUBPAGENAME}}}}