Linux►Drivers

安全、性能、调试与 RK3588 适用性

安全、性能、调试与 RK3588 适用性

1. 安全模型

USB/IP等价于允许远端向本机热插USB设备。攻击面包括：

  • USB Core descriptor和Hub枚举解析；
  • HID、Storage、Audio、Video、网络等class driver；
  • 文件系统和SCSI协议；
  • Gadget function setup/data处理；
  • USB/IP PDU长度、ISO和unlink状态机；
  • usbipd管理协议与sysfs fd移交。

网络来源可信并不代表USB设备内容可信。

2. 协议不提供的能力

本树USB/IP没有：

  • 对端身份认证；
  • PDU加密；
  • 消息完整性MAC；
  • 细粒度设备访问授权；
  • 有效的CRYPKEY协商实现。

TCP 3240不应暴露到互联网或普通办公网。可通过WireGuard/IPsec/VPN提供加密和双方身份认证，但隧道不能修复USB class parser漏洞。

另外，数据面transfer_buffer_length没有统一的协议级上限。Stub会据远端长度尝试分配buffer或SG；异常的大值通常以分配失败和连接拆除结束，但仍可造成内存压力/拒绝服务，因此网络访问控制不能由内核字段校验替代。

3. 权限控制

建议：

  • 默认不构建USBIP_HOST/VHCI/VUDC；
  • 仅特定管理镜像按模块提供；
  • usbipd只监听专用管理接口；
  • firewall采用源地址allowlist；
  • 只允许固定VID/PID/serial/busid导出；
  • 禁止导出键盘、网卡、可写存储等高风险class；
  • 限制谁能写usbip sysfs和加载模块；
  • SELinux/AppArmor限制usbipd、configfs和设备节点；
  • 客户端结合USB authorization或USBGuard再做本地策略。

busid本身会随拓扑变化，不能作为强设备身份。

4. 性能路径

一次传输包含：

1
2
3
4
5
6
class buffer
 -> VHCI PDU/网络发送
 -> TCP/IP
 -> Stub接收/URB buffer
 -> 真实HCD DMA
 -> 反向完成

主要开销：

  • TCP往返时延；
  • 两端线程调度；
  • payload拷贝和SG转换；
  • 网络拥塞和重传；
  • 单连接TCP队头阻塞；
  • 服务端真实USB总线带宽。

TCP_NODELAY降低小控制包等待，但可能增加包率。Jumbo frame、offload和更快CPU可改善吞吐，不能消除RTT。

5. 传输类型

  • Control：枚举大量串行往返，长RTT明显拖慢probe；
  • Bulk：适合存储/打印，但吞吐受TCP窗口和拷贝限制；
  • Interrupt：功能可用，轮询完成延迟受网络抖动影响；
  • Isochronous：Stub路径支持descriptor，但TCP重传和队头阻塞不适合低抖动实时音视频；VUDC当前直接以-EXDEV拒绝ISO传输；
  • USB3 streams：VHCI暴露相关ops，但不应假设与真实xHCI完全等价。

6. RK3588

本树Rockchip defconfig没有CONFIG_USBIP_*。若需要：

1
2
3
4
5
6
7
CONFIG_NET=y
CONFIG_USB=y
CONFIG_USBIP_CORE=m
CONFIG_USBIP_HOST=m          # 服务端物理设备
CONFIG_USBIP_VHCI_HCD=m      # 客户端
CONFIG_USB_GADGET=y
CONFIG_USBIP_VUDC=m          # 仅软件Gadget导出

RK3588有足够CPU和高速网络能力，但实际结果取决于GMAC/PCIe网卡、IRQ亲和、CPU频率、内存压力及USB端口拓扑。USB/IP客户端使用VHCI，不经过本机DWC3 PHY；物理设备服务端才受DWC3/EHCI/OHCI及VBUS影响。

7. 基础排障

1
2
3
4
5
6
7
8
zcat /proc/config.gz | grep USBIP
lsmod | grep -E 'usbip|vhci'
ss -tnlp | grep 3240
usbip list -l
usbip list -r SERVER
usbip port
lsusb -t
dmesg -w

服务端确认目标设备driver为usbip-host，客户端确认设备位于vhci_hcd总线。

8. Sysfs与调试位

查看VHCI：

1
2
cat /sys/devices/platform/vhci_hcd.0/status
cat /sys/devices/platform/vhci_hcd.0/nports

usbip_debug_flag位定义在usbip_common.h，覆盖xmit、sysfs、URB、EH以及Stub/VHCI RX/TX。可写模块参数或设备usbip_debug属性；详细日志可能包含设备行为和大量数据元信息，量产不要持续开启。

编译CONFIG_USBIP_DEBUG=y会启用更多pr_debug，仍可能需要dynamic debug：

1
echo 'file drivers/usb/usbip/* +p' > /sys/kernel/debug/dynamic_debug/control

9. 抓包

可用tcpdump/Wireshark观察TCP 3240：

1
tcpdump -i eth0 -s 0 -w usbip.pcap tcp port 3240

由于协议明文，抓包能看到descriptor、control request和payload，这本身说明网络与pcap文件必须按敏感数据保护。

配合usbmon可以分别观察服务端真实USB URB和客户端VHCI侧行为，但时间戳来自不同主机，需先同步时钟。

10. 故障映射

现象 优先检查
remote list为空 usbipd、firewall、bind、match_busid
attach失败 VHCI空闲port、版本、socket、speed
枚举到一半断开 RTT、TCP reset、descriptor/control错误
服务端设备消失 正常：已被usbip-host接管
存储很慢 RTT、TCP窗口、网络丢包、BOT串行语义
音视频卡顿 ISO实时性与TCP队头阻塞
detach后URB挂起 RX/TX线程、EH、pending unlink列表

11. 产品结论

USB/IP适合受控网络中的实验室、远程维护、测试农场和低实时性外设共享。它不适合默认开放在量产RK3588设备上，也不应作为硬实时USB、可信启动输入设备或高安全域跨网桥接方案。

文章互动

阅读 --

留言

0 条留言

正在加载留言…