操作指南

运维指南

API 文档

文档中心 > 云服务器 > 最佳实践 > Linux 系统使用 USB/IP 远程共享 USB 设备

Linux 系统使用 USB/IP 远程共享 USB 设备

最近更新时间:2020-04-13 12:12:51

操作场景

USB/IP 是一个开源项目,已合入 Kernel,在 Linux 环境下可以通过使用 USB/IP 远程共享 USB 设备。本文档以如下环境版本为例,为您演示如何使用 USB/IP 远程共享 USB 设备:
USB Client:CentOS 7.6 操作系统的云服务器
USB Server:Debian 操作系统的本地计算机

注意事项

不同发行版的 Linux 操作系统安装 USB/IP 的方式,以及内核模块名称略有不同。请确认您当前使用的 Linux 系统是否支持 USB/IP 功能。

操作步骤

配置 USB Server

  1. 在本地计算机上,依次执行以下命令,安装 USB/IP 并加载相关的内核模块。
    sudo apt-get install usbip
    sudo modprobe usbip-core
    sudo modprobe vhci-hcd
    sudo modprobe usbip_host
  2. 插入 USB 设备,并执行以下命令,查询可用的 USB 设备。
    usbip list --local
    例如,在本地计算机上插入一个 Feitian 的优 Key,返回如下结果:
    busid 1-1.3(096e:031b)
    Feitian Technologies, Inc.: unknown product(096e:031b)
  3. 记录 busid 的值,并依次执行以下命令,启动监听服务,指定 USB/IP 端口号,共享 USB 设备。
    sudo usbipd -D [--tcp-port PORT]
    sudo usbip bind -b [busid]
    例如,USB/IP 指定端口号为3240端口(即 USB/IP 的默认端口),busid 为 1-1.3,则执行以下命令:
    sudo usbipd -D
    sudo usbip bind -b 1-1.3
  4. (可选)执行以下命令,创建 SSH 隧道,并使用端口监听。
    说明:

    没有公网 IP 的本地计算机,请执行此步骤。如您的本地计算机有公网 IP,请跳过此步骤。

    ssh -Nf -R USB/IP指定端口号:localhost:USB/IP指定端口号 root@your_host
    your_host 表示云服务器的 IP 地址。
    例如,USB/IP 的端口号为3240端口,云服务器的 IP 地址为192.168.15.24,则执行以下命令:
    ssh -Nf -R 3240:localhost:3240 root@192.168.15.24

配置 USB Client

说明:

以下操作步骤以本地计算机没有公网 IP 为例,如您的本地计算机有公网 IP,请将步骤中的127.0.0.1修改为本地计算机的公网 IP 地址。

  1. 使用标准登录方式登录 Linux 实例(推荐)
  2. 依次执行以下命令,下载 USB/IP 源。
    rpm --import https://www.elrepo.org/RPM-GPG-KEY-elrepo.org
    rpm -ivh http://www.elrepo.org/elrepo-release-7.0-3.el7.elrepo.noarch.rpm
  3. 依次执行以下命令,安装 USB/IP。
    yum -y install kmod-usbip usbip-utils
    modprobe usbip-core
    modprobe vhci-hcd
    modprobe usbip-host
  4. 执行以下命令,查询云服务器可用的 USB 设备。
    usbip list --remote 127.0.0.1
    例如,找到 Feitian 的优 Key 的信息,返回如下结果:
    Exportable USB devices
    ======================
    -127.0.0.1 1-1.3: Feitian Technologies, Inc.: unknown product(096e:031b):/sys/devices/platform/scb/fd500000.pcie/pci0000:00/0000:00:00.0/0000:01:00.0/usb1/1-1/1-1.3:(Defined at Interface level)(00/00/00)
  5. 执行以下命令,将 USB 设备绑定至服务器中。
    usbip attach --remote=127.0.0.1 --busid=1-1.3
  6. 执行以下命令,查看当前 USB 设备列表。
    lsusb
    返回类似如下信息,即表示共享成功。
    Bus 002 Device 002:ID096e:031b Feitian Technologies, Inc.
    Bus 002 Device 001:ID1d6b:0002 Linux Foundation 2.0 root hub
    Bus 001 Device 001:ID1d6b:0001 Linux Foundation 1.1 root hub
目录