# usbip-web

**Repository Path**: maplerian/usbip-web

## Basic Information

- **Project Name**: usbip-web
- **Description**: Linux 环境下的简易USBIP管理页面
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-03-21
- **Last Updated**: 2025-08-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## Linux环境下的 USB/IP 管理页面
### 依赖命令: usbip, usbipd, nmap, whereis, killall, modprobe, sudo
#### 注意: 需要普通用户 & sudo 权限, 每次执行时都需要先执行sudo -v 获取终端权限
![界面预览图](preview/1.png)
- 上半部分是本地USB设备列表
- 下半部分是局域网内分享的USB设备列表

## nodejs 服务
### 依赖 nodejs环境, pkg打包工具, pkg对应环境的nodexx- win/linux/mac -x64 工具包

## 克隆项目后, 运行以下命令:
```shell
npm install     # 安装web依赖包
npm run dev     # 运行web
cd server       # 进入服务端目录
npm install     # 安装 server 依赖包
npm run dev     # 运行页面服务端
```

## 打包项目, 运行以下命令:
```shell
npm run build       # 打包 web 文件
cd server           # 进入服务端目录
npm run pack        # 打包 linux 环境 文件
npm run pack-win    # 打包 windows 环境 文件
```

## 已知问题
- 服务器为 win11 的 usbipd , 共享的USB设备连接一定时间后会断开( win11 的 usbipd 异常中断)
- 相同的 Linux 环境下目前没有问题

## 问题反馈渠道
邮箱: amqqfkhk@qq.com
<br/>
微信:<br/>
<img src="preview/2.jpg" alt="img" width="200"/><br/>

## 打赏
<img src="preview/3.jpg" alt="img" width="200"/>