USBridge-Remote

USBridge-TechnologiesGPL-3.0活跃维护

低延迟远程桌面与 IP-KVM 方案,支持 Sunshine/Moonlight 游戏串流、USB 设备透传和 NanoKVM/Radxa 固件,跨 Windows、macOS、Linux、Android、iOS 及网页使用。

Low-latency remote desktop and KVM-over-IP: Sunshine/Moonlight game streaming, USB passthrough (gamepads, Wacom, MIDI), NanoKVM & Radxa IP-KVM firmware, Tailscale P2P. Windows, macOS, Linux, Android, iOS, web.

release-v3.2.40发布于 2026-11-09 15:19 UTC672star +3 / 7 天39fork同步于 2026-11-10 11:56 UTC

怎么上手

从 README 代码块原样提取,可能是其中一种安装方式
curl -fsSL https://www.usbridge.io/install.sh | sh
curl -fsSL https://www.usbridge.io/install.sh | sh -s -- --agent
curl -fsSL https://raw.githubusercontent.com/USBridge-Technologies/USBridge-Remote/main/scripts/deb/usbridge-archive-keyring.gpg \
硬件要求按 README 关键词推断
纯 CPU 可运行支持 Apple Silicon
下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

这个项目的说明还在生成中,先参考下面「最近发版」和 README。

最近发版

5 个版本release-v3.2.40
  1. release-v3.2.40USBridge release-v3.2.40最新正式版2026-11-09 · 2026-11-09 15:19 UTC

    What's new in 3.2.40

    Changes since 3.2.31, the last full release.

    Android client

    • Double tap opens, double tap and hold drags. With the touchpad cursor, two short taps are now a double-click even if the second tap is slow or your finger wobbles. Double tap and keep your finger down to grab what's under the cursor, then move it as long as you like: it stays grabbed until you lift your finger. Holding a grab no longer vibrates as if a right click were coming.
    • A mouse button that could stay pressed. A slightly shaky second tap could leave the left button held down on the host. It's now released.
    • One side effect: a single tap now releases the click about 150 ms later than before, and if you start moving your finger within 300 ms of a tap, that counts as a drag rather than moving the cursor.

    Mac hosts

    • Double-clicks work. Every click used to reach macOS as a single one, however quickly they came, so a double-click from a client never opened a folder. This needs USBridge Streamer 0.4.1.
    • Command is a real modifier. Cmd+V pastes instead of typing "v". This needs USBridge Streamer 0.4.0 or later.

    Lower latency: Sync frames to this display

    • New client setting, on by default. The host times each frame to arrive just before your screen refreshes. The client reports its timing on native Wayland, macOS and Windows, but not on Linux X11 or with VSync off.
    • The host needs a source faster than the stream, such as a high-refresh virtual monitor. In one test (1080p60, Windows host with a 1000 Hz source, Linux client), latency went from 30.4 ms to 25.6 ms. The gain was much smaller at 120 Hz on the same machine, and settling can take longer than it should.
    • Virtual monitor at 240, 480 and 1000 Hz on Windows, Linux and macOS. On macOS the rate depends on what the system accepts: an M1 on macOS 26.5 takes 480 Hz, and 1000 Hz runs at 488 Hz.

    Windows

    • Client no longer closes on sign-in or passphrase. Saving account files could crash it.
    • Capture waits for the pinned monitor instead of failing the session. This needs USBridge Streamer 0.4.0 or later.

    Linux client on native Wayland

    • Absolute mouse is accurate on scaled displays. The host's cursor used to sit up and to the left of the client's.
    • Typing fixed. Digits 1-8 were typed twice in Characters mode, and keys came out shifted in Keys mode (G typed [).

    Benchmark

    • Latency figures. Results now show latency, including p50 and p95, measured from a time barcode in the built-in test window.
    • Clearer results. Cards no longer overlap, a streamer that reports no encode time shows n/a instead of a winning 0.0 ms, and a run decoded at a different size is flagged and doesn't compete for best.

    Full Changelog: https://github.com/USBridge-Technologies/USBridge-Remote/compare/release-v3.2.31...release-v3.2.40

  2. release-v3.2.39USBridge release-v3.2.39pre-release2026-11-09 · 2026-11-09 12:32 UTC
    查看更新说明
  3. release-v3.2.37USBridge release-v3.2.37pre-release2026-11-08 · 2026-11-08 22:52 UTC
    查看更新说明
  4. release-v3.2.32USBridge release-v3.2.32pre-release2026-11-08 · 2026-11-08 16:23 UTC
    查看更新说明
  5. release-v3.2.31USBridge release-v3.2.312026-11-08 · 2026-11-08 13:04 UTC
    查看更新说明

    What's new in 3.2.31

    Changes since 3.2.30.

    Android and iOS client

    • Crash on launch fixed. The Android client could close a second or two after it opened, often on nearly every launch, in versions 3.2.29 and 3.2.30. While the main window was being built, background startup work was laying out the interface at the same time, and the two collided inside the UI toolkit. That work now waits until the window is ready. The iOS client starts up the same way and gets the same fix. We tested it with 40 launches in a row on an Android phone, with no crashes.

    iOS client

    • No update options. Tapping the version number no longer offers a manual update or the Release/Test switch, since iOS apps update through the App Store. What's new still opens. If Test was selected on your iPhone, the app goes back to Release.

    If your Android client keeps closing on launch: the in-app update may not get a chance to run. Install the new version over the old one: download USBridgeClient-Android-arm64-selfupdate.apk below, or update from Google Play if you installed it from there. Your settings are kept.

    Full Changelog: https://github.com/USBridge-Technologies/USBridge-Remote/compare/release-v3.2.30...release-v3.2.31

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    USBridge Remote

    English | Deutsch | Français | Italiano | Español | Português (Brasil) | Українська | Polski | 日本語 | 한국어 | 简体中文

    Windows macOS Linux Android iOS Discord


    USBridge Remote is a low-latency remote desktop and KVM-over-IP ecosystem: one client for Windows, macOS, Linux, Android, iOS and the browser, a host agent with a built-in Sunshine / Moonlight game streamer, and IP-KVM firmware for Radxa Zero 3W/3E, Radxa Cubie A7Z and Sipeed NanoKVM boards. It combines hardware-level BIOS access and software remote desktop in a single interface, with USB passthrough for gamepads, Wacom tablets, MIDI and microphones, and Tailscale P2P networking with no port forwarding.

    Download

    All-in-one installer (Client + Agent, pick either or both during setup): Windows Setup (.exe) · macOS disk image (.dmg)

    On Windows the Agent's virtual display driver (streaming with no monitor attached) is its own checkbox: ticked by default, unticked in a virtual machine without a real GPU, where the VM's own screen is streamed. Details in the Agent docs.

    All files are on the latest release.

    Client

    The Client is the control interface — installed on your workstation or laptop (or run directly in your browser). It manages connections, live remote desktop, virtual device passthrough, and snapshot registry.

    PlatformInstallerPortablePackages / Store
    Windows x86_64Setup (.exe)Portable (.zip)—
    macOS Apple SiliconDisk image (.dmg)——
    Linux x86_64Debian / Ubuntu (.deb) · Fedora / RHEL (.rpm) · Arch (.pkg.tar.zst)AppImageAPT · DNF · pacman · Flatpak repository · Snap Store
    Android ARM64APK (self-updating)—Google Play
    iOS / iPadOS——App Store
    Web browser—Open web.usbridge.io—

    Install from the terminal

    One command installs the Client and the Agent. On Linux it picks the native package for your distribution (apt on Debian/Ubuntu, dnf on Fedora/RHEL, pacman on Arch), and the package adds the signed USBridge repository, so the apps then update with the rest of the system:

    # Linux and macOS
    curl -fsSL https://www.usbridge.io/install.sh | sh
    # Agent only (a machine you only reach remotely)
    curl -fsSL https://www.usbridge.io/install.sh | sh -s -- --agent
    
    # Windows (PowerShell)
    irm https://www.usbridge.io/install.ps1 | iex
    
    # Client from the Snap Store (Ubuntu, and Arch with snapd from the AUR)
    sudo snap install usbridge-client
    # Microphone, MIDI, gamepads, webcam, USB, Wi-Fi tune, external drives
    for p in audio-record alsa joystick camera raw-usb network-manager network-observe hardware-observe removable-media; do sudo snap connect usbridge-client:$p; done
    
    # Client from the signed USBridge Flatpak repository, any distribution
    flatpak install --user https://raw.githubusercontent.com/USBridge-Technologies/USBridge-Remote/main/scripts/flatpak/io.usbridge.Client.flatpakref
    flatpak run io.usbridge.Client
    

    The repository is signed with the same key as the APT repository, and flatpak update brings new versions. The runtime comes from Flathub.

    flatpak remote-add --user --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
    flatpak remote-add --user --if-not-exists usbridge https://raw.githubusercontent.com/USBridge-Technologies/USBridge-Remote/main/scripts/flatpak/usbridge.flatpakrepo
    flatpak install --user usbridge io.usbridge.Client
    

    Passing this computer's own USB devices to the remote machine needs root and works from the .deb, .rpm or Arch package, not from the Flatpak.

    curl -fsSL https://raw.githubusercontent.com/USBridge-Technologies/USBridge-Remote/main/scripts/deb/usbridge-archive-keyring.gpg \
      | sudo tee /usr/share/keyrings/usbridge-archive-keyring.gpg >/dev/null
    echo "deb [arch=amd64 signed-by=/usr/share/keyrings/usbridge-archive-keyring.gpg] https://github.com/USBridge-Technologies/USBridge-Remote/releases/latest/download ./" \
      | sudo tee /etc/apt/sources.list.d/usbridge.list
    sudo apt update && sudo apt install usbridge-client usbridge-agent
    

    A downloaded .deb, .rpm or Arch package sets up the same repository when you install it.

    🌐 Zero-Install Web Client: No installation required. Just open web.usbridge.io to connect instantly. (Note: The web client operates with some feature and performance limitations due to browser security sandbox and WebRTC constraints. For the full uncompromised experience, use the native apps). The web client reaches an Agent through its trusted <label>.device.usbridge.io name: the Agent gets that certificate the first time a browser comes to it, and only while you're signed in to your USBridge account in the Agent — so the very first attempt can take a few minutes. See the Agent's Status → Certificate row, or the Agent docs for details. A USBridge KVM also serves the web client itself at https://<kvm>:9443/ and moves to its own trusted name when it can.

    Agent

    The Agent runs on the target machine — the server or PC you want to access remotely. It captures the screen and sound, passes your keyboard, mouse and gamepad through to that machine, and connects it over Tailscale.

    Features

    Hardware-accelerated encoding: NVIDIA NVENC · AMD AMF · Intel QSV · Linux VAAPI · plus software H.264 (OpenH264) for VMs and machines without a GPU encoder

    Quick Start

    1. Install the Agent on the machine you want to access remotely. Launch it — it will display a connection token and Tailscale address. Connect Tailscale if you need access over the internet.

    2. Install the Client on your workstation, laptop, or phone.

    3. Add a connection — enter the IP or Tailscale address shown in the Agent window. That's it.

    Hardware Integration

    NanoKVM with USBridge firmware: 60 FPS instead of lag

    A 2-minute video: a Sipeed NanoKVM with heavy lag in a home lab becomes a 60 FPS KVM over IP with almost no input lag after flashing USBridge firmware, fast enough to play games with a gamepad. Tailscale works on the board itself, so it is reachable from anywhere with no port forwarding; sound plays both ways, and FEC (forward error correction) rebuilds lost packets, so the picture stays clean on Wi-Fi and over the internet. Firmware for the NanoKVM, Radxa Zero 3W and Radxa Cubie A7Z is on the Hardware Agent page.

    FAQ

    Yes. The Agent ships the open-source Sunshine streamer, so the stock Moonlight client connects to it. Vibepollo (a Sunshine fork with Apollo built in) and punktfunk are built in too and switch in one click.

    Yes. A USBridge KVM 2.0, or a Radxa Zero 3W/3E, Radxa Cubie A7Z or Sipeed NanoKVM flashed with USBridge firmware, is a Sunshine-compatible GameStream host for whatever is on its HDMI input: a PC, PS5, Xbox or Switch. It streams 1080p 60 FPS with audio to the stock Moonlight client, with no software on the source. See Hardware Moonlight Streamer.

    It depends on the GPU, the driver and the network. The built-in benchmark runs Sunshine, RustShine, Vibepollo and punktfunk on your own hardware and network and compares them. See Sunshine vs Apollo vs Vibepollo vs Punktfunk.

    NVIDIA NVENC, AMD AMF, Intel QSV and VAAPI on Linux. Virtual machines and PCs without a GPU encoder use software H.264 (OpenH264).

    4:4:4 color, HDR10, PyroWave, gamepads, microphone, MIDI and raw USB passthrough are free. Wacom tablets with pressure and tilt, and the hardware KVM firmware ($19 lifetime per device, 24 h free evaluation), are Pro.

    Yes. Flash the USBridge firmware from the Hardware Agent page. You get BIOS/UEFI access, ISO and IMG virtual media, immutable Btrfs snapshots, 60 FPS video, audio and USB passthrough. Radxa boards need an HDMI-to-USB capture dongle.

    No. Connections go over Tailscale peer-to-peer, with automatic NAT traversal.

    Yes. Invite people by e-mail with a role and an end date; guests join through USBridge and need no Tailscale account.

    Resources & License