oscarlosu-lab/USBAnywhere

选用指南

AI 根据 README 整理 · 2026/10/25 01:26:17

适用场景

适用于需要通过网络连接远程 USB 设备的场景，如云游戏（Moonlight/Sunshine）、模拟赛车（HOTAS/VR）、3D 打印（Klipper/OctoPrint）和家庭实验室（Proxmox）等。

查看 README 依据

| **Native VPN Integration** | ✅ **Built-in Tailscale, ZeroTier & WireGuard** | 💰 Extra / Manual | ❌ Manual | --- ## 🎯 Built for the Communities Left Behind by Paywalls 1. 🎮 **Cloud Gaming, Moonlight / Sunshine & Steam Deck** Pass Xbox/DualSense controllers (with full rumble, adaptive triggers, and audio), wireless headset dongles, and keyboards from your living room Raspberry Pi or handheld directly to your gaming rig. 2. 🏎️ **SimRacing & Flight Simulators (HOTAS / VR)**

Connect steering wheels, load-cell pedals, shifters, button boxes, and VR trackers simultaneously over Ethernet using **Low-Latency WSK mode** without hitting a 1-device paywall. 3. 🖨️ **3D Printing (Klipper, Mainsail, OctoPrint, CrealityBox)** Bridge multiple USB webcams, ADXL345 resonance accelerometers, and printer mainboards effortlessly. 4. 🖥️ **HomeLab, Proxmox & Self-Hosted** Attach Zigbee/Z-Wave coordinators, hardware security keys, and license dongles (AutoCAD, iLok, eToken) over LAN or Tailscale VPN. --- ## 🎬 Video Tutorials (English & Spanish - YouTube Edition)

目标用户

面向受付费墙限制的社区用户，包括游戏玩家、仿真爱好者、3D 打印用户和自托管爱好者。

查看 README 依据

| **Native VPN Integration** | ✅ **Built-in Tailscale, ZeroTier & WireGuard** | 💰 Extra / Manual | ❌ Manual | --- ## 🎯 Built for the Communities Left Behind by Paywalls 1. 🎮 **Cloud Gaming, Moonlight / Sunshine & Steam Deck** Pass Xbox/DualSense controllers (with full rumble, adaptive triggers, and audio), wireless headset dongles, and keyboards from your living room Raspberry Pi or handheld directly to your gaming rig. 2. 🏎️ **SimRacing & Flight Simulators (HOTAS / VR)**

使用方式

Windows 客户端通过 GUI 操作，支持一键扫描、连接/断开设备，并提供命令行自动化接口。Linux 服务器可通过一键 SSH 设置或安装脚本部署。

查看 README 依据

1. Download `USBAnywhere_Setup_v3.0.0.exe` from [Releases](https://github.com/oscarlosu-lab/USBAnywhere/releases/latest) 2. Run the installer as Administrator 3. Follow the installation wizard ### ⚠️ ARM64 Users ARM64 drivers are **test-signed**. See `README_ARM64.md` in the ZIP for instructions to enable Windows Test Mode. --- ## 🚀 Quick Start 1. **Scan** - Click `🔍 Scan` to find servers on your network 2. **List** - Click `📋 List` to see available USB devices 3. **Connect** - Double-click a device or right-click → Connect 4. **Disconnect** - Right-click → Disconnect

### ⚡ 1-Click Linux / Raspberry Pi Server Setup 1. Click `🔗 SSH` in the top toolbar 2. Enter your Raspberry Pi / Linux username (e.g. `pi` or `root`) and IP 3. Click **`⚡ 1-Click Auto-Setup`** — it automatically installs `usbip`, loads kernel modules persistently, starts the daemon, and lists your USB ports! **Or run our 1-Line Plug & Play Installer on Linux / Raspberry Pi:** ```bash curl -sSL https://raw.githubusercontent.com/oscarlosu-lab/USBAnywhere/main/scripts/install-server.sh | sudo bash ```

``` ### 🎮 Moonlight / Sunshine / Playnite CLI Automation Automate controller, wheel, or headset attachment when starting a game stream: ```powershell USBAnywhere.exe --minimized --connect 192.168.1.50 1-1.4 ``` ### 🌐 Internet Connection (VPN) 1. Install **[Tailscale](https://tailscale.com/download)** on Windows and your server 2. Click `● VPN` to scan peers with active USB/IP (port 3240) 3. Select remote server(s) and click Connect See [docs/VPN_INTERNET_EN.md](docs/VPN_INTERNET_EN.md) for the complete guide. --- ## 🐧 Manual Linux Server Setup (Optional)

部署要求

Windows 10/11 x64 或 ARM64，需要管理员权限。Linux 服务器需支持 USB/IP 内核模块，安装 usbip 工具，并可能需要系统服务配置。

查看 README 依据

- 🔄 **Secure Auto-Update** - Verifies GitHub releases with mandatory SHA-256 cryptographic checks (`SHA256SUMS.txt`) --- ## 📦 Installation ### Option 1: Portable (No installation required) 1. Download from [Releases](https://github.com/oscarlosu-lab/USBAnywhere/releases/latest): - **Windows x64**: `USBAnywhere-v3.0.0-x64.zip` - **Windows ARM64**: `USBAnywhere-v3.0.0-arm64.zip` (Surface Pro X, Snapdragon X Elite, etc.) 2. Extract the ZIP to any folder 3. Run `USBAnywhere.exe` as Administrator 4. Done! ### Option 2: Installer (x64 Recommended)

Works on **any Linux device** with USB ports (Raspberry Pi, Orange Pi, Banana Pi, OpenWRT, CrealityBox, Debian/Ubuntu x86/ARM): **Debian / Ubuntu / Raspberry Pi OS:** ```bash sudo apt update && sudo apt install -y usbip hwdata usbutils sudo modprobe usbip_host sudo usbipd -D sudo usbip list -l sudo usbip bind -b 1-1.4 # Replace with your bus-id ``` **OpenWRT:** ```bash opkg update && opkg install usbip-server kmod-usb-ohci usbipd -D ``` See [docs/RASPBERRY_PI_SERVER_EN.md](docs/RASPBERRY_PI_SERVER_EN.md) for complete instructions. --- ## 📁 Structure ```text USBAnywhere/

已知限制

ARM64 驱动为测试签署，需要启用 Windows 测试模式。

查看 README 依据

1. Download `USBAnywhere_Setup_v3.0.0.exe` from [Releases](https://github.com/oscarlosu-lab/USBAnywhere/releases/latest) 2. Run the installer as Administrator 3. Follow the installation wizard ### ⚠️ ARM64 Users ARM64 drivers are **test-signed**. See `README_ARM64.md` in the ZIP for instructions to enable Windows Test Mode. --- ## 🚀 Quick Start 1. **Scan** - Click `🔍 Scan` to find servers on your network 2. **List** - Click `📋 List` to see available USB devices 3. **Connect** - Double-click a device or right-click → Connect 4. **Disconnect** - Right-click → Disconnect