Releases: suifei/usbctl
Releases · suifei/usbctl
Release v1.0.9
🚀 usbctl v1.0.9
📦 Downloads
Choose the appropriate binary for your platform:
- Linux AMD64:
usbctl-v1.0.9-linux-amd64.tar.gz - Linux ARM64:
usbctl-v1.0.9-linux-arm64.tar.gz - Windows AMD64:
usbctl-v1.0.9-windows-amd64.zip - macOS AMD64:
usbctl-v1.0.9-darwin-amd64.tar.gz - macOS ARM64:
usbctl-v1.0.9-darwin-arm64.tar.gz
✅ Checksums
Verify your download with SHA256 checksums (see checksums.txt).
🔧 Installation
Linux / macOS
# Extract
tar xzf usbctl-*-linux-amd64.tar.gz
cd usbctl-*-linux-amd64
# Run
sudo ./usbctlWindows
# Extract ZIP file
# Run as Administrator
.\usbctl.exe📝 Usage
usbctl --help
usbctl -p 8080 -vVisit http://localhost:11980 in your browser.
🆕 What's New
See CHANGELOG.md for detailed changes.
Full Changelog: v1.0.0...v1.0.9
Release v1.0.8
🚀 usbctl v1.0.8
📦 Downloads
Choose the appropriate binary for your platform:
- Linux AMD64:
usbctl-v1.0.8-linux-amd64.tar.gz - Linux ARM64:
usbctl-v1.0.8-linux-arm64.tar.gz - Windows AMD64:
usbctl-v1.0.8-windows-amd64.zip - macOS AMD64:
usbctl-v1.0.8-darwin-amd64.tar.gz - macOS ARM64:
usbctl-v1.0.8-darwin-arm64.tar.gz
✅ Checksums
Verify your download with SHA256 checksums (see checksums.txt).
🔧 Installation
Linux / macOS
# Extract
tar xzf usbctl-*-linux-amd64.tar.gz
cd usbctl-*-linux-amd64
# Run
sudo ./usbctlWindows
# Extract ZIP file
# Run as Administrator
.\usbctl.exe📝 Usage
usbctl --help
usbctl -p 8080 -vVisit http://localhost:11980 in your browser.
🆕 What's New
See CHANGELOG.md for detailed changes.
Full Changelog: v1.0.0...v1.0.8
usbctl v1.0.4
🎉 USB透传工具 v1.0.4 发布
📦 支持的平台
Linux 架构支持：
| 架构 | 文件名 | 适用设备 |
|---|---|---|
| x86_64 | usbctl-linux-x86_64 |
PC服务器、普通电脑 |
| ARM64 | usbctl-linux-arm64 |
树莓派4、ARM64服务器 |
| ARMv7 | usbctl-linux-armv7 |
树莓派3、ARM32设备 |
| i386 | usbctl-linux-i386 |
32位x86系统 |
| MIPS | usbctl-linux-mips |
路由器、嵌入式设备 |
| MIPS64 | usbctl-linux-mips64 |
64位MIPS设备 |
| PowerPC64LE | usbctl-linux-ppc64le |
IBM Power服务器 |
| RISC-V64 | usbctl-linux-riscv64 |
RISC-V开发板 |
| s390x | usbctl-linux-s390x |
IBM Z系列大型机 |
Windows 支持：
| 架构 | 文件名 | 适用系统 |
|---|---|---|
| x86_64 | usbctl-windows-x86_64.exe |
64位Windows |
| i386 | usbctl-windows-i386.exe |
32位Windows |
打包下载：
usbctl-v1.0.4-linux.tar.gz- 所有Linux版本打包usbctl-v1.0.4-windows.zip- 所有Windows版本打包SHA256SUMS- 校验和文件
🚀 快速安装
方法1：自动安装（推荐 - 仅Linux）
# 1. 下载对应架构的二进制文件和安装脚本
# 根据您的系统选择，例如 ARM64:
wget https://github.com/suifei/usbctl/releases/download/v1.0.4/usbctl-linux-arm64
wget https://github.com/suifei/usbctl/releases/download/v1.0.4/install-service.sh
# 2. 准备安装
mkdir -p build
mv usbctl-linux-arm64 build/usbctl # 根据您的架构调整文件名
chmod +x build/usbctl
chmod +x install-service.sh
# 3. 一键安装服务
sudo ./install-service.sh install方法2：使用打包文件
# 下载Linux完整包
wget https://github.com/suifei/usbctl/releases/download/v1.0.4/usbctl-v1.0.4-linux.tar.gz
tar -xzf usbctl-v1.0.4-linux.tar.gz
# 选择对应架构的文件进行安装
chmod +x usbctl-linux-x86_64 # 示例：x86_64架构
sudo cp usbctl-linux-x86_64 /usr/local/bin/usbctl方法3：Windows 使用
# 下载 Windows 版本
# 下载 usbctl-windows-x86_64.exe
# 双击运行或在命令行中使用
usbctl-windows-x86_64.exe --help💡 功能特性
- 🔌 USB设备网络透传：让远程设备访问本地USB设备
- 🖱️ 无线化有线设备：将复杂的有线键鼠改为无线使用
- 🔧 嵌入式开发：在开发板上透传USB调试设备
- 🏠 智能家居：树莓派作为USB设备服务器
- 📱 Web管理界面：通过浏览器管理USB设备
- 🌐 跨平台支持：支持多种CPU架构和操作系统
📋 系统要求
Linux系统：
- 内核支持 usbip 模块
- 管理员权限
- 网络连接
Windows系统：
- Windows 7 及以上版本
- 管理员权限（访问USB设备）
🔧 依赖安装（Linux）
自动安装脚本会处理所有依赖，如需手动安装：
# Ubuntu/Debian
sudo apt-get update
sudo apt-get install usbip linux-tools-generic
# 加载内核模块
sudo modprobe usbip-host🔍 文件校验
所有文件的SHA256校验和请参考 SHA256SUMS 文件：
# 校验下载的文件
sha256sum -c SHA256SUMS🌐 使用说明
安装完成后，访问 Web 管理界面：
http://YOUR_DEVICE_IP:11980
📚 相关文档
⚠️ 注意事项
- Linux首次使用需要管理员权限安装 usbip 工具
- 确保防火墙开放 3240 和 11980 端口
- 某些USB设备可能需要特定的内核模块
- Windows版本需要安装对应的USB驱动
🙏 致谢
感谢所有贡献者和测试用户的支持！特别感谢嵌入式开发社区的反馈。
Full Changelog: v1.0.3...v1.0.4
usbctl v1.0.3
🎉 USB透传工具 v1.0.3 发布
📦 支持的平台
Linux 架构支持：
| 架构 | 文件名 | 适用设备 |
|---|---|---|
| x86_64 | usbctl-linux-x86_64 |
PC服务器、普通电脑 |
| ARM64 | usbctl-linux-arm64 |
树莓派4、ARM64服务器 |
| ARMv7 | usbctl-linux-armv7 |
树莓派3、ARM32设备 |
| i386 | usbctl-linux-i386 |
32位x86系统 |
| MIPS | usbctl-linux-mips |
路由器、嵌入式设备 |
| MIPS64 | usbctl-linux-mips64 |
64位MIPS设备 |
| PowerPC64LE | usbctl-linux-ppc64le |
IBM Power服务器 |
| RISC-V64 | usbctl-linux-riscv64 |
RISC-V开发板 |
| s390x | usbctl-linux-s390x |
IBM Z系列大型机 |
Windows 支持：
| 架构 | 文件名 | 适用系统 |
|---|---|---|
| x86_64 | usbctl-windows-x86_64.exe |
64位Windows |
| i386 | usbctl-windows-i386.exe |
32位Windows |
打包下载：
usbctl-v1.0.3-linux.tar.gz- 所有Linux版本打包usbctl-v1.0.3-windows.zip- 所有Windows版本打包SHA256SUMS- 校验和文件
🚀 快速安装
方法1：自动安装（推荐 - 仅Linux）
# 1. 下载对应架构的二进制文件和安装脚本
# 根据您的系统选择，例如 ARM64:
wget https://github.com/suifei/usbctl/releases/download/v1.0.3/usbctl-linux-arm64
wget https://github.com/suifei/usbctl/releases/download/v1.0.3/install-service.sh
# 2. 准备安装
mkdir -p build
mv usbctl-linux-arm64 build/usbctl # 根据您的架构调整文件名
chmod +x build/usbctl
chmod +x install-service.sh
# 3. 一键安装服务
sudo ./install-service.sh install方法2：使用打包文件
# 下载Linux完整包
wget https://github.com/suifei/usbctl/releases/download/v1.0.3/usbctl-v1.0.3-linux.tar.gz
tar -xzf usbctl-v1.0.3-linux.tar.gz
# 选择对应架构的文件进行安装
chmod +x usbctl-linux-x86_64 # 示例：x86_64架构
sudo cp usbctl-linux-x86_64 /usr/local/bin/usbctl方法3：Windows 使用
# 下载 Windows 版本
# 下载 usbctl-windows-x86_64.exe
# 双击运行或在命令行中使用
usbctl-windows-x86_64.exe --help💡 功能特性
- 🔌 USB设备网络透传：让远程设备访问本地USB设备
- 🖱️ 无线化有线设备：将复杂的有线键鼠改为无线使用
- 🔧 嵌入式开发：在开发板上透传USB调试设备
- 🏠 智能家居：树莓派作为USB设备服务器
- 📱 Web管理界面：通过浏览器管理USB设备
- 🌐 跨平台支持：支持多种CPU架构和操作系统
📋 系统要求
Linux系统：
- 内核支持 usbip 模块
- 管理员权限
- 网络连接
Windows系统：
- Windows 7 及以上版本
- 管理员权限（访问USB设备）
🔧 依赖安装（Linux）
自动安装脚本会处理所有依赖，如需手动安装：
# Ubuntu/Debian
sudo apt-get update
sudo apt-get install usbip linux-tools-generic
# 加载内核模块
sudo modprobe usbip-host🔍 文件校验
所有文件的SHA256校验和请参考 SHA256SUMS 文件：
# 校验下载的文件
sha256sum -c SHA256SUMS🌐 使用说明
安装完成后，访问 Web 管理界面：
http://YOUR_DEVICE_IP:11980
📚 相关文档
⚠️ 注意事项
- Linux首次使用需要管理员权限安装 usbip 工具
- 确保防火墙开放 3240 和 11980 端口
- 某些USB设备可能需要特定的内核模块
- Windows版本需要安装对应的USB驱动
🙏 致谢
感谢所有贡献者和测试用户的支持！特别感谢嵌入式开发社区的反馈。
Full Changelog: v1.0.2...v1.0.3