linux add usbip

在 Linux 系统中添加和使用 USB/IP 的步骤如下：

1. 安装必要组件

# Debian/Ubuntu 系统
sudo apt update
sudo apt install linux-tools-generic usbip hwdata -y

# RHEL/CentOS/Fedora 系统
sudo dnf install usbip kernel-tools -y    # Fedora/CentOS 8+
sudo yum install usbip usbutils -y        # CentOS 7

2. 加载内核模块

# 加载 USB/IP 内核模块
sudo modprobe usbip-core
sudo modprobe usbip-host       # 服务端：共享本地 USB 设备
sudo modprobe vhci-hcd         # 客户端：连接远程 USB 设备

# 确保开机自动加载模块（可选）
echo "usbip-core" | sudo tee -a /etc/modules
echo "usbip-host" | sudo tee -a /etc/modules  # 服务端
echo "vhci-hcd" | sudo tee -a /etc/modules    # 客户端

3. 服务端操作（共享 USB 设备）

3.1 查看 USB 设备信息

sudo usbip list -l

输出示例：

Bus 001 Device 003: ID 1234:5678 My USB Device

3.2 绑定要共享的设备

sudo usbip bind -b 1-3  # 替换为你的设备总线 ID（如 1-3）

3.3 启动 USB/IP 守护进程

sudo usbipd -D  # 后台运行守护进程

4. 客户端操作（连接远程 USB 设备）

4.1 查看服务器共享的设备

sudo usbip list -r <服务器IP>

示例：

sudo usbip list -r 192.168.1.100

4.2 连接远程设备

sudo usbip attach -r <服务器IP> -b <设备总线ID>

示例：

sudo usbip attach -r 192.168.1.100 -b 1-3

5. 验证连接

# 客户端检查设备
lsusb                    # 查看是否出现新设备
dmesg | tail             # 检查内核日志
sudo usbip port          # 查看已连接的 USB/IP 端口

6. 断开设备

# 客户端断开
sudo usbip detach -p <端口号>   # 端口号通过 `usbip port` 查看

# 服务端解除绑定
sudo usbip unbind -b <设备总线ID>

7. 设置系统服务（可选）

服务端自动启动守护进程（创建 systemd 服务）：

sudo nano /etc/systemd/system/usbipd.service

内容：

[Unit]
Description=USB/IP Daemon

[Service]
ExecStart=/usr/sbin/usbipd -D
Restart=always

[Install]
WantedBy=multi-user.target

启动服务：

sudo systemctl enable --now usbipd

常见问题解决

权限问题：
确保用户有权限操作 USB 设备（将用户加入 plugdev 组）：
```
sudo usermod -aG plugdev $USER
```
防火墙：
开放 USB/IP 默认端口 3240/TCP：
```
sudo ufw allow 3240/tcp
```
模块未加载：
检查模块加载状态：
```
lsmod | grep usbip
```