docs/configuration/service/usbip-client.zh.md
!!! question "自 sing-box 1.14.0 起"
USB/IP Client 服务通过 USB/IP 导入由 USB/IP Server 导出的远程 USB 设备。
可用于 Linux、Windows 和 macOS(macOS 需要使用 CGO 构建)。不支持 iOS。
服务端必须是 sing-box(或 sing-usbip)服务端。
{
"type": "usbip-client",
... // 拨号字段
"server": "",
"server_port": 0,
"devices": []
}
!!! info "与官方 USB/IP 协议的区别"
sing-box 使用 [sing-usbip](https://github.com/SagerNet/sing-usbip),它使用一套附加协议来支持热插拔等增强功能,但仍然可以与标准 USB/IP 互操作。
参阅 拨号字段 了解详情。
仅 detour 生效。
==必填==
远程 usbip-server 地址。
远程 usbip-server 端口。默认为 3240。
设备匹配列表,用于选择要导入的远程设备。如果为空,则导入所有已导出的设备。
对象格式:
{
"bus_id": "",
"vendor_id": 0,
"product_id": 0,
"serial": ""
}
对象字段:
bus_id:USB 总线 ID,例如 1-2。vendor_id:USB 供应商 ID,为数字。product_id:USB 产品 ID,为数字。serial:设备序列号。在一个对象内,所有指定的字段都必须匹配;多个对象之间取并集。至少需要一个字段。