USBIP-Win 安装与使用手册

USBIP-Win 安装与使用手册

项目地址:https://gitcode.com/gh_mirrors/usb/usbip-win

---

1. 项目目录结构及介绍

本开源项目 usbip-win 的仓库位于 GitHub，其目录结构精心设计以支持USB/IP功能在Windows平台上的实现。以下是典型的项目目录概览：

• 根目录:
  • 包含README.md，这是项目的入门指南。
  • src: 源代码存放区，包括驱动程序和用户空间工具的实现。
  • driver: 驱动相关的文件，分为不同版本的VHCI驱动（vhci(wdm) 和 vhci(ude)）。
  • userspace: 用户空间工具，如usbip.exe, usbipd.exe等可执行文件以及相关配置脚本或说明文件。
  • docs: 可能包含额外的文档或说明材料。
  • scripts: 辅助脚本或者安装、部署相关的自动化工具。

2. 项目的启动文件介绍

主要可执行文件

• usbip.exe

  • 功能: 用户空间的主要工具，用于列出远程主机上的USB设备、绑定本地USB设备至USB/IP服务、以及连接到远程设备等操作。

• usbipd.exe

  • 角色: 作为后台服务，管理USB/IP连接，处理设备的共享与接入请求。在安装过程中会设置为一个系统服务，称为“USBIP Device Host”。

启动流程示例

1. 使用usbip.exe install命令安装必要的客户端组件。
2. 通过usbipd.exe -4 -d命令启动服务，配置防火墙允许TCP端口3240的访问。

3. 项目的配置文件介绍

实际配置需求

• 动态配置: 对于usbip-win，配置主要依赖于命令行参数和系统的动态调整。
  • 分享或绑定USB设备时，通过命令指定-b BUSID来指定具体的USB设备。
  • 连接到远程USB/IP服务器时，使用-r <IP>指定服务器地址。

静态配置元素

虽然核心功能不直接关联传统意义上的配置文件，但在实际部署中，可能需要手动进行一些系统级别的配置：

• 驱动签名: 对于测试驱动，需要启用测试签名，这涉及bcdedit.exe命令和系统重启。
• 防火墙规则: 自动创建或手动配置允许TCP端口3240的规则，确保通信畅通。

特别说明

对于特定配置更改，如驱动安装路径、服务启动设置，这些通常通过系统自带的工具如设备管理器、服务控制管理器或防火墙设置界面完成，而非直接编辑文本配置文件。

---

以上内容提供了对usbip-win项目的基本导航和操作指导，确保用户能够理解如何开始使用这一工具，尽管它强调了命令行操作而缺乏传统的配置文件结构。

usbip-win 项目地址: https://gitcode.com/gh_mirrors/usb/usbip-win