USB 映射

通过网络把远程 USB 设备映射到本地，像插在自己电脑上一样使用。适合远程访问串口设备、加密狗、打印机、摄像头等。

方案速查

跨平台，开箱即用，有 GUI 和 CLI 两种客户端。免费版无设备数量限制，商业用途需购买授权。少量设备场景最方便。

下载

工具	下载入口
VirtualHere 服务端	https://virtualhere.com/oem\_server\_downloads
VirtualHere 客户端 (GUI)	https://virtualhere.com/client\_downloads
VirtualHere 客户端 (CLI)	https://virtualhere.com/command\_line\_client
USB/IP (Linux)	https://github.com/usbip/implementations
USB/IP (Windows)	https://github.com/cezanne/usbip-win/releases
USB/IP (macOS 服务端)	https://github.com/beriberikix/usbipd-mac

VirtualHere

原理

服务端运行 vhusbd 自动共享所有 USB 设备 → 客户端选中设备 Use → 本地出现虚拟 USB 设备。

服务端

下载对应平台的服务端，直接运行即可，无需安装。

Linux

chmod +x vhusbdx86_64
sudo ./vhusbdx86_64 -b

Windows

# 双击运行 vhusbd64.exe 即可
# 或命令行
.\vhusbd64.exe -b

-b 后台运行。默认监听 TCP 7578，防火墙需放行。

服务端配置（可选）

在服务端同目录创建 config.ini：

ServerName = Fit-USB-Server
Password =   # 客户端连接密码，留空不设密码
MaxConnections = 10
Port = 7578

客户端

VirtualHere 提供 GUI 和 CLI 两种客户端，功能相同，按场景选用。

GUI 客户端 — 有界面，右键操作，适合桌面环境。

GUI 客户端 — 有界面，右键操作，适合桌面环境。

Linux

chmod +x vhui64
./vhui64

Windows

# 双击运行 vhui64.exe 即可

macOS

chmod +x vhui64.app/Contents/MacOS/vhui64
./vhui64.app/Contents/MacOS/vhui64

GUI 操作步骤：

1. 左侧列出发现的 USB 服务器。
2. 展开服务器，看到所有 USB 设备。
3. 右键要使用的设备 → Use this device。
4. 本地出现虚拟 USB 设备，可直接使用。
5. 不再使用时右键 → Stop using this device。

CLI 客户端 — 无界面，命令行操作，适合无 GUI 的服务器或脚本自动化。

Linux

chmod +x vhuc
./vhuc

Windows

.\vhuc.exe

CLI 操作：

# 列出服务端设备
./vhuc <服务端IP>

# 使用指定设备（序号从 0 开始）
./vhuc <服务端IP> use 0

# 断开设备
./vhuc <服务端IP> stop 0

# 查看帮助
./vhuc help

串口设备示例

# 客户端 Use 设备后，本地出现串口设备
dmesg | grep ttyUSB
# [  xxx] usb 1-1: FTDI USB Serial Device converter now attached to ttyUSB0

# 直接使用
minicom -D /dev/ttyUSB0 -b 115200
# 或
picocom /dev/ttyUSB0 -b 115200
# 或
python3 -c "import serial; s=serial.Serial('/dev/ttyUSB0',115200); print(s.read(100))"

持久化

开机自启

Linux 服务端 — systemd service：

# /etc/systemd/system/virtualhere.service
[Unit]
Description=VirtualHere USB Server
After=network.target

[Service]
ExecStart=/usr/local/bin/vhusbdx86_64 -b -c /etc/virtualhere/config.ini
Restart=on-failure

[Install]
WantedBy=multi-user.target

sudo cp vhusbdx86_64 /usr/local/bin/
sudo mkdir -p /etc/virtualhere
sudo cp config.ini /etc/virtualhere/
sudo systemctl daemon-reload
sudo systemctl enable --now virtualhere

Linux 客户端 — 同理写 systemd service 或放 ~/.config/autostart/。

Windows — 服务端/客户端快捷方式放入启动文件夹 shell:startup。

授权

用途	说明
个人/非商业	免费，无设备数量限制
商业用途	需购买授权，约 $29 起

少量设备（1~2 个串口/加密狗）用免费版足够，开箱即用不需要折腾内核模块。

USB/IP

原理

内核级 USB 设备转发，开源免费，支持同时映射多个设备。

安装

服务端 (Debian/Ubuntu)

apt install usbip
modprobe usbip-core
modprobe usbip-host

服务端 (RHEL/CentOS)

yum install usbip
modprobe usbip-core
modprobe usbip-host

客户端 (Debian/Ubuntu)

apt install usbip
modprobe vhci-hcd

客户端 (RHEL/CentOS)

yum install usbip
modprobe vhci-hcd

客户端 (Arch Linux)

pacman -S linux-tools-usbip
modprobe vhci-hcd

客户端 (Windows)

# 下载 USB/IP Windows 客户端
# https://github.com/cezanne/usbip-win/releases
# 安装驱动后重启

服务端 (macOS)

# 下载 usbipd-mac
# https://github.com/beriberikix/usbipd-mac
make
sudo ./usbipd

macOS USB/IP 说明

Linux 和 Windows 的 USB/IP 由内核原生支持，macOS 没有内核级实现。usbipd-mac 是社区实现的 macOS USB/IP 服务端，可用于从 Mac 导出 USB 设备。

限制：

• 仅支持服务端（导出设备），macOS 作为客户端导入设备仍无成熟方案。
• 需要从源码编译。
• 稳定性不如 Linux 内核方案，建议优先用 VirtualHere 替代。

如果 macOS 只需使用远程 USB 设备，推荐直接用 VirtualHere 客户端。

服务端操作

导出 USB 设备

# 查看可用的 USB 设备
usbip list -l

# 绑定要导出的设备（例如 1-1）
usbip bind -b 1-1

# 启动 usbip 守护进程
usbipd -D

# 查看已导出的设备
usbip list -l

设备编号 1-1 通过 usbip list -l 或 lsusb -t 查看。

解除绑定（不再导出）：

usbip unbind -b 1-1

客户端操作

导入远程 USB 设备

# 查看服务端导出的设备
usbip list -r <服务端IP>

# 导入设备
usbip attach -r <服务端IP> -b 1-1

# 查看已导入的设备
usbip port

# 本地验证
dmesg | tail
lsusb

断开映射：

# 查看端口编号
usbip port

# 断开
usbip detach -p 0

Windows 客户端导入

# 安装 USB/IP Windows 客户端后
# 查看服务端设备
usbip.exe list -r <服务端IP>

# 导入设备
usbip.exe attach -r <服务端IP> -b 1-1

# 断开
usbip.exe detach -p 0

串口设备示例

# 服务端绑定串口 USB 设备
usbip list -l
usbip bind -b 1-2
usbipd -D

# 客户端导入
usbip attach -r 10.21.21.118 -b 1-2

# 导入成功后本地出现 /dev/ttyUSB0
dmesg | grep ttyUSB
# [  xxx] usb 1-1: FTDI USB Serial Device converter now attached to ttyUSB0

# 直接使用
minicom -D /dev/ttyUSB0 -b 115200
# 或
picocom /dev/ttyUSB0 -b 115200
# 或
python3 -c "import serial; s=serial.Serial('/dev/ttyUSB0',115200); print(s.read(100))"

持久化

开机自动导出 / 导入

服务端 — 开机自动加载内核模块并导出设备：

# /etc/modules-load.d/usbip.conf
usbip-core
usbip-host

# /etc/rc.local 或 systemd service
usbip bind -b 1-1
usbipd -D

客户端 — 开机自动加载内核模块并导入：

# /etc/modules-load.d/vhci-hcd.conf
vhci-hcd

# /etc/rc.local 或 systemd service
usbip attach -r <服务端IP> -b 1-1

注意

• 映射期间设备不能在服务端本地使用。
• 延迟取决于网络质量，高延迟网络下 USB 设备可能不稳定（尤其是存储设备）。
• 大容量存储（U盘、硬盘）不建议走 USB 映射，优先用 NFS/SMB/SSHFS。
• VirtualHere 个人/非商业免费，商业用途需购买授权。
• USB/IP 默认使用 TCP 3240 端口，VirtualHere 默认 TCP 7578，防火墙需放行。
• USB/IP usbip bind 后重启服务端需重新绑定，除非做了持久化。
• USB/IP Windows 客户端需要安装签名驱动，部分版本可能需禁用驱动签名强制。