USBridge-Technologies/USBridge-Remote
USBridge-Technologies/USBridge-Remote has 671 GitHub stars and 39 forks. GitHot measured +2 stars in 24 hours and -4 in 7 days. Last checked 2026-11-10 01:11 UTC. Last push 2026-10-30.
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.
实测星标增长
- 24小时
- +2
- 7天
- -4
- 15天
- 更新延迟
- 1个月
- 更新延迟
各周期内的星标净变化，周期相互重叠，并非每日新增。缺失的测量保持空白。星标代表关注度，不代表软件质量。
docs/README_ZH.md
原文USBridge Remote
English | Deutsch | Français | Italiano | Español | Português (Brasil) | Українська | Polski | 日本語 | 한국어 | 简体中文
USBridge Remote 是一个低延迟的 远程桌面 和 KVM-over-IP 生态系统：一个适用于 Windows、macOS、Linux、Android、iOS 和浏览器的客户端，一个内置 Sunshine / Moonlight 游戏流媒体的主机代理，以及适用于 Radxa Zero 3W/3E、Radxa Cubie A7Z 和 Sipeed NanoKVM 板的 IP-KVM 固件。它将 硬件级 BIOS 访问 和 软件远程桌面 集成在一个界面中，支持游戏手柄、Wacom 平板、MIDI 和麦克风的 USB 直通，以及无需端口转发的 Tailscale P2P 网络。
下载
一体化安装程序（客户端 + 代理，安装时选择其中一个或两个）： Windows 安装程序 (.exe) · macOS 磁盘映像 (.dmg)
所有文件均在 最新发布。
客户端
客户端是控制界面 — 安装在您的工作站或笔记本电脑上（或直接在浏览器中运行）。它管理连接、实时远程桌面、虚拟设备直通和快照注册。
| 平台 | 安装程序 | 便携版 | 包/商店 |
|---|---|---|---|
| Windows x86_64 | 安装程序 (.exe) | 便携版 (.zip) | — |
| macOS Apple Silicon | 磁盘映像 (.dmg) | — | — |
| Linux x86_64 | Debian / Ubuntu (.deb) · Fedora / RHEL (.rpm) · Arch (.pkg.tar.zst) | AppImage | APT · DNF · pacman 仓库 · Snap 商店 |
| Android ARM64 | APK（自我更新） | — | Google Play |
| iOS / iPadOS | — | — | App Store |
| Web 浏览器 | — | 打开 web.usbridge.io | — |
从终端安装
一个命令安装客户端和代理。在 Linux 上，它选择适合您发行版的本地软件包（Debian/Ubuntu 上的 apt，Fedora/RHEL 上的 dnf，Arch 上的 pacman），并且该软件包会添加签名的 USBridge 仓库，因此应用程序会与系统的其他部分一起更新：
# Linux 和 macOS
curl -fsSL https://www.usbridge.io/install.sh | sh
# 仅代理（仅通过远程访问的机器）
curl -fsSL https://www.usbridge.io/install.sh | sh -s -- --agent
# Windows（PowerShell）
irm https://www.usbridge.io/install.ps1 | iex
# 从 Snap 商店安装客户端（Ubuntu，以及从 AUR 安装 snapd 的 Arch）
sudo snap install usbridge-client
手动添加 APT 仓库（Debian / Ubuntu）
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
下载的 .deb、.rpm 或 Arch 包在安装时会设置相同的仓库。
🌐 零安装 Web 客户端：无需安装。只需打开 web.usbridge.io 即可立即连接。(注意：由于浏览器安全沙箱和 WebRTC 限制，Web 客户端的某些功能和性能有限。要获得完整的无妥协体验，请使用本地应用程序。) Web 客户端通过其受信任的 <label>.device.usbridge.io 名称访问代理：代理在浏览器首次访问时获取该证书，并且仅在您登录到代理的 USBridge 帐户时有效 — 因此第一次尝试可能需要几分钟。请查看代理的 状态 → 证书 行，或查看 代理文档 以获取详细信息。USBridge KVM 还在 https://<kvm>:9443/ 提供 Web 客户端本身，并在可以时转到其自己的受信任名称。
代理
代理在目标机器上运行 — 您想要远程访问的服务器或 PC。它捕获屏幕和声音，将您的键盘、鼠标和游戏手柄传递到该机器，并通过 Tailscale 连接。
|
|
功能
硬件加速编码： NVIDIA NVENC · AMD AMF · Intel QSV · Linux VAAPI · 以及用于没有 GPU 编码器的虚拟机和机器的软件 H.264 (OpenH264)
基本功能SUNSHINE 开源 标准游戏流媒体 ✓ 内置开源 Sunshine 流媒体 ✓ 替代流媒体：Vibepollo（内置 Apollo 的 Sunshine 分支，Windows）和 punktfunk（兼容 Moonlight，Windows 和 Linux），一键切换 ✓ 内置基准测试以比较 Sunshine、RustShine、Vibepollo 和 punktfunk 在您自己的硬件和网络上的表现 ✓ 低延迟桌面和游戏访问 ✓ 双向文件和文本剪贴板 ✓ 多显示器切换 ✓ 集成 Tailscale P2P 网络 ✓ 客户访问：通过电子邮件邀请人，指定角色和结束日期 ✓ 原生 Wayland 支持（无提示捕获） |
+ 基本功能USBRIDGE 免费版 基于 Rust 的流媒体引擎 ✓ 即时连接自定义远程协议 ✓ 原始 USB 外设直通 ✓ 针对 Wi-Fi 稳定性优化的自适应流媒体 ✓ HDR10 ✓ 无损 4:4:4 色度准确度 ✓ 麦克风直通（客户端 → 主机） ✓ MIDI 设备直通（客户端 → 主机） ✓ GPU 编码：NVENC、AMF、QSV、VAAPI ✓ 对于没有 GPU 的虚拟机，使用软件 H.264 (OpenH264) ✓ PyroWave 低延迟小波编码器（由 Valve 提供） ✓ 无头虚拟显示管理 ✓ 低延迟游戏手柄控制器直通 ✓ Web 浏览器客户端访问（无需安装） ✓ Windows 预登录访问（安全凭证输入） |
+ 基本功能 + 免费功能USBRIDGE 专业版 专业工作流程 ✓ 支持带压力和倾斜的 Wacom 平板（macOS 也支持） ✓ Radxa Zero 3W/3E、Radxa Cubie A7Z 和 Sipeed NanoKVM 的硬件 KVM 固件：BIOS/UEFI 访问、ISO 虚拟媒体、Btrfs 快照（每个设备 $19 终身，24 小时免费评估） ✓ 这些板上的硬件 Moonlight 流媒体：任何 HDMI 源（PC、PS5、Xbox、Switch）以 1080p 60 FPS 流式传输，无需源端软件 |
快速开始
在您想要远程访问的机器上安装代理。启动它 — 它将显示连接令牌和 Tailscale 地址。如果您需要通过互联网访问，请连接 Tailscale。
在您的工作站、笔记本电脑或手机上安装客户端。
添加连接 — 输入代理窗口中显示的 IP 或 Tailscale 地址。就这样。
硬件集成
|
硬件级 BIOS 控制 USBridge Remote 原生集成 USBridge-KVM 2.0 设备，用于操作系统启动前的带外、裸金属管理。它也是第一个硬件 Moonlight 流媒体：标准 Moonlight 客户端与 KVM 配对，并流式传输任何 HDMI 源（PC 或游戏机），无需在其上安装软件。 
|
DIY IP-KVM 固件 在兼容板（Radxa Zero 3W/3E、Radxa Cubie A7Z）上闪存官方固件，并使用 HDMI 转 USB 捕获适配器构建自己的 IP-KVM。在 Sipeed NanoKVM 上，它替换了标准固件：流畅的 60 FPS 而不是卡顿的画面，音频和麦克风、游戏手柄、USB 直通和 Moonlight 支持（下载固件）。 
|
USB/IP 硬件适配器 (ESP32-S3) 软件 USB 直通在 macOS 上遇到瓶颈：没有 VHCI 驱动程序可供连接，因此远程 Wacom 平板（或其他 USB 设备）无法作为真实硬件呈现。该适配器插入 Mac，并在硬件中执行 vhci-hcd 在其他地方的软件功能 — 导出的设备以其自己的 VID/PID 枚举，由 macOS 自己的驱动程序绑定。
|
使用 USBridge 固件的 NanoKVM：60 FPS 而不是延迟
一段 2 分钟的视频：在家庭实验室中，Sipeed NanoKVM 的延迟很高，闪存 USBridge 固件后变成了几乎没有输入延迟的 60 FPS KVM over IP，足够快以使用游戏手柄玩游戏。Tailscale 在板上本身工作，因此可以从任何地方访问，无需端口转发；音频双向播放，FEC（前向错误修正）重建丢失的数据包，因此在 Wi-Fi 和互联网连接上图像保持清晰。NanoKVM、Radxa Zero 3W 和 Radxa Cubie A7Z 的固件在 硬件代理页面 上。
常见问题
USBridge 是否与 Moonlight 和 Sunshine 兼容？
是的。代理提供开源 Sunshine 流媒体，因此标准 Moonlight 客户端可以连接到它。Vibepollo（内置 Apollo 的 Sunshine 分支）和 punktfunk 也内置，并且可以一键切换。
是否有硬件 Moonlight 流媒体？
是的。USBridge KVM 2.0，或闪存 USBridge 固件的 Radxa Zero 3W/3E、Radxa Cubie A7Z 或 Sipeed NanoKVM，是 Sunshine 兼容的 GameStream 主机，适用于其 HDMI 输入上的任何内容：PC、PS5、Xbox 或 Switch。它以 1080p 60 FPS 的音频流式传输到标准 Moonlight 客户端，无需源端软件。请参见 硬件 Moonlight 流媒体。
哪个流媒体在我的 PC 上最快？
这取决于 GPU、驱动程序和网络。内置基准测试在您自己的硬件和网络上运行 Sunshine、RustShine、Vibepollo 和 punktfunk，并进行比较。请参见 Sunshine vs Apollo vs Vibepollo vs Punktfunk。
支持哪些 GPU 进行编码？
NVIDIA NVENC、AMD AMF、Intel QSV 和 Linux 上的 VAAPI。没有 GPU 编码器的虚拟机和 PC 使用软件 H.264 (OpenH264)。
什么是免费的，什么需要专业版？
4:4:4 色彩、HDR10、PyroWave、游戏手柄、麦克风、MIDI 和原始 USB 直通是免费的。带压力和倾斜的 Wacom 平板，以及硬件 KVM 固件（每个设备 $19 终身，24 小时免费评估）是专业版。
我可以将 Sipeed NanoKVM 或 Radxa 板变成 IP-KVM 吗？
是的。从 硬件代理页面 闪存 USBridge 固件。您将获得 BIOS/UEFI 访问、ISO 和 IMG 虚拟媒体、不变的 Btrfs 快照、60 FPS 视频、音频和 USB 直通。Radxa 板需要 HDMI 转 USB 捕获适配器。
我需要端口转发吗？
不需要。连接通过 Tailscale 点对点，自动进行 NAT 穿透。
我可以与其他人共享计算机访问权限吗？
可以。通过电子邮件邀请人，指定角色和结束日期；来宾通过 USBridge 加入，无需 Tailscale 帐户。
资源与许可证
|
开发与路线图 我维护一个公共仪表板，以跟踪所有计划功能、架构更新和发布日程。 查看实时路线图 |
项目链接 |
许可证 (GPLv3) 本项目根据 GPLv3 许可证发布。多平台客户端包含来自 moonlight-common-c（同样是 GPLv3）的代码库。查看许可证文件 |