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.
측정된 스타 증가
- in 24h
- +2
- in 7 days
- -4
- in 15 days
- 업데이트 지연
- in 1 month
- 업데이트 지연
서로 겹치는 기간의 순증가량이며 일별 합계가 아닙니다. 측정값이 없으면 비워 둡니다. 스타는 관심도를 나타내며 품질을 보장하지 않습니다.
docs/README_KO.md
OriginalUSBridge 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 Store |
| Android ARM64 | APK (자동 업데이트) | — | Google Play |
| iOS / iPadOS | — | — | App Store |
| 웹 브라우저 | — | 웹.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 Store에서 클라이언트 설치 (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.usbridge.io를 열어 즉시 연결하세요. (참고: 웹 클라이언트는 브라우저 보안 샌드박스 및 WebRTC 제약으로 인해 일부 기능 및 성능 제한이 있습니다. 완전한 경험을 원하시면 네이티브 앱을 사용하세요.) 웹 클라이언트는 신뢰할 수 있는 <label>.device.usbridge.io 이름을 통해 에이전트에 접근합니다: 에이전트는 브라우저가 처음 접근할 때 인증서를 받고, 사용자가 에이전트에서 USBridge 계정에 로그인하는 동안만 유효합니다 — 따라서 첫 시도는 몇 분이 걸릴 수 있습니다. 에이전트의 상태 → 인증서 행 또는 에이전트 문서에서 자세한 내용을 확인하세요. USBridge KVM은 https://<kvm>:9443/에서 웹 클라이언트 자체를 제공하며, 가능할 때 자신의 신뢰할 수 있는 이름으로 이동합니다.
에이전트
에이전트는 원격으로 접근하려는 대상 머신 — 서버 또는 PC에서 실행됩니다. 화면과 소리를 캡처하고, 키보드, 마우스 및 게임패드를 해당 머신으로 전달하며, Tailscale을 통해 연결합니다.
|
|
기능
하드웨어 가속 인코딩: NVIDIA NVENC · AMD AMF · Intel QSV · Linux VAAPI · GPU 인코더가 없는 VM 및 머신을 위한 소프트웨어 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가 없는 VM을 위한 소프트웨어 H.264 (OpenH264) ✓ PyroWave 저지연 웨이브렛 코덱 (Valve 제공) ✓ 헤드리스 가상 디스플레이 관리 ✓ 저지연 게임패드 컨트롤러 패스스루 ✓ 웹 브라우저 클라이언트 접근 (설치 필요 없음) ✓ Windows 로그인 전 접근 (안전한 자격 증명 입력) |
+ 기본 기능 + 무료 기능USBRIDGE PRO 전문 워크플로우 ✓ 압력 및 기울기를 지원하는 Wacom 태블릿 지원 (macOS에서도) ✓ 하드웨어 KVM 펌웨어 Radxa Zero 3W/3E, Radxa Cubie A7Z 및 Sipeed NanoKVM용: BIOS/UEFI 접근, ISO 가상 미디어, Btrfs 스냅샷 ($19 평생 장치당, 24시간 무료 평가) ✓ 하드웨어 Moonlight 스트리머 해당 보드에서: 모든 HDMI 소스 (PC, PS5, Xbox, Switch)를 Moonlight로 1080p 60 FPS로 스트리밍, 소스에 소프트웨어 없음 |
빠른 시작
에이전트를 설치합니다. 원격으로 접근하려는 머신에서 실행하세요. 연결 토큰과 Tailscale 주소가 표시됩니다. 인터넷을 통해 접근해야 하는 경우 Tailscale을 연결하세요.
클라이언트를 설치합니다. 워크스테이션, 노트북 또는 휴대폰에 설치하세요.
연결 추가 — 에이전트 창에 표시된 IP 또는 Tailscale 주소를 입력하세요. 그게 전부입니다.
하드웨어 통합
|
하드웨어 수준 BIOS 제어 USBridge Remote는 OS 부팅 전에 아웃 오브 밴드, 베어 메탈 관리를 위해 USBridge-KVM 2.0 장비와 네이티브로 통합됩니다. 또한 첫 번째 하드웨어 Moonlight 스트리머이기도 합니다: 기본 Moonlight 클라이언트가 KVM과 페어링되어 HDMI 소스 (PC 또는 게임 콘솔)를 소프트웨어 없이 스트리밍합니다. |
DIY IP-KVM 펌웨어 HDMI-to-USB 캡처 동글과 함께 호환되는 보드 (Radxa Zero 3W/3E, Radxa Cubie A7Z)에 공식 펌웨어를 플래시하여 자신의 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용 펌웨어는 하드웨어 에이전트 페이지에 있습니다.
FAQ
USBridge는 Moonlight 및 Sunshine과 함께 작동합니까?
예. 에이전트는 오픈 소스 Sunshine 스트리머를 제공하므로 기본 Moonlight 클라이언트가 연결됩니다. Vibepollo (내장된 Apollo가 있는 Sunshine 포크)와 punktfunk도 내장되어 있으며 클릭 한 번으로 전환할 수 있습니다.
하드웨어 Moonlight 스트리머가 있습니까?
예. USBridge KVM 2.0 또는 USBridge 펌웨어가 플래시된 Radxa Zero 3W/3E, Radxa Cubie A7Z 또는 Sipeed NanoKVM은 HDMI 입력에 있는 모든 것을 위한 Sunshine 호환 GameStream 호스트입니다: PC, PS5, Xbox 또는 Switch. 소스에 소프트웨어 없이 기본 Moonlight 클라이언트에 오디오와 함께 1080p 60 FPS로 스트리밍합니다. 하드웨어 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)를 사용합니다.
무료와 Pro의 차이는 무엇입니까?
4:4:4 색상, HDR10, PyroWave, 게임패드, 마이크, MIDI 및 원시 USB 패스스루는 무료입니다. 압력 및 기울기를 지원하는 Wacom 태블릿과 하드웨어 KVM 펌웨어 ($19 평생 장치당, 24시간 무료 평가)는 Pro입니다.
Sipeed NanoKVM 또는 Radxa 보드를 IP-KVM으로 변환할 수 있습니까?
예. 하드웨어 에이전트 페이지에서 USBridge 펌웨어를 플래시하세요. BIOS/UEFI 접근, ISO 및 IMG 가상 미디어, 불변 Btrfs 스냅샷, 60 FPS 비디오, 오디오 및 USB 패스스루를 제공합니다. Radxa 보드는 HDMI-to-USB 캡처 동글이 필요합니다.
포트 포워딩이 필요합니까?
아니요. 연결은 Tailscale P2P를 통해 이루어지며, 자동 NAT 트래버설이 가능합니다.
다른 사람과 컴퓨터 접근을 공유할 수 있습니까?
예. 역할과 종료 날짜를 가진 사람을 이메일로 초대하세요; 게스트는 USBridge를 통해 참여하며 Tailscale 계정이 필요하지 않습니다.
리소스 및 라이센스
|
개발 및 로드맵 모든 계획된 기능, 아키텍처 업데이트 및 릴리스 일정을 추적하기 위한 공개 대시보드를 유지합니다. 라이브 로드맵 보기 |
프로젝트 링크 |
라이센스 (GPLv3) 이 프로젝트는 GPLv3 라이센스 하에 있습니다. 다중 플랫폼 클라이언트는 moonlight-common-c (또한 GPLv3)에서 코드베이스를 통합합니다.라이센스 파일 보기 |
