ScrcpyOverWebRTC

<p align="center">
  <a href="https://github.com/hqw700/ScrcpyOverWebRTC">
    <img src="logo.svg" width="130" height="130" alt="ScrcpyOverWebRTC Logo" />
  </a>
</p>

<h1 align="center">Scrcpy over WebRTC (穿云投屏)</h1>

<p align="center">
  <a href="https://hub.docker.com/r/buutuu/scrcpy-over-webrtc"><img src="https://img.shields.io/docker/pulls/buutuu/scrcpy-over-webrtc?style=flat-square&logo=docker" alt="Docker Pulls" /></a>
  <a href="https://hub.docker.com/r/buutuu/scrcpy-over-webrtc"><img src="https://img.shields.io/docker/image-size/buutuu/scrcpy-over-webrtc/latest?style=flat-square&logo=docker" alt="Docker Image Size" /></a>
  <a href="https://hub.docker.com/r/buutuu/scrcpy-over-webrtc"><img src="https://img.shields.io/badge/arch-amd64%20%7C%20arm64-blue?style=flat-square&logo=linux" alt="Architectures" /></a>
  <a href="https://github.com/hqw700/ScrcpyOverWebRTC"><img src="https://img.shields.io/github/stars/hqw700/ScrcpyOverWebRTC?style=flat-square&logo=github" alt="GitHub Stars" /></a>
  <a href="https://github.com/hqw700/ScrcpyOverWebRTC/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-green?style=flat-square" alt="License" /></a>
</p>

<p align="center">
  <b>中文</b> | <a href="README.en.md">English</a>
</p>

📖 **官方技术文档与保姆级部署指南**：👉 [https://webrtc-phone.com/docs/](https://webrtc-phone.com/docs/)  
📱 **官方原生 Android 控制端 App**：👉 [WebrtcPhone-Android](https://github.com/hqw700/WebrtcPhone-Android)（基于 Kotlin + Compose + WebRTC 全新重构开源，支持多机直控、P2P文件分发与终端运维）  
☁️ **PVE 原生云手机运行镜像**：👉 [redroid-pve](https://github.com/hqw700/redroid-pve)（支持 Proxmox VE 8.x 原生非特权 LXC 容器、秒级 Thin-Clone 开通与 GPU 硬件满血直通）

基于 WebRTC 和 Scrcpy 的高性能、低延迟云手机解决方案，无需客户端，可以通过网页直接连接。
采用 **Fat Agent (直连模式)** 架构，结合 **硬件级 PTS 透传** 技术，实现媲美原生 Scrcpy 的丝滑体验。

<p align="center">
  <img src="screenshot/screenshot-pc.png" width="70%" />
  <img src="screenshot/screenshot-phone.jpg" width="20%" />
</p>

## 1. 核心特性

- **多机自由多悬浮窗口与设备抽屉 (v0.4.4)**：彻底重构多机直连交互为原生自由多悬浮窗口体系，支持窗口自由拖拽漫游、八向缩放、各窗口独立侧边栏控制及任务托盘收纳；侧边栏新增二级可固定/滑动的设备抽屉面板，集成实时模糊搜索与状态过滤，默认 WebRTC 直连并支持一键 WS 投屏。
- **推流生命周期优化与停流死锁根治 (v0.4.4)**：重构流媒体启停策略，彻底消除直控断开时的状态死锁，退出直控后大盘缩略图即时平稳更新；缺少硬件 Opus 编码器机型平滑降级纯视频推流，杜绝服务闪退。
- **PVE 编排器企业级 VPC 出口网关与双网卡 (v0.4.4)**：引入独立 VPC 出口网关系统，支持多节点隔离子网分配、网关镜像自动分发及多协议出口代理（Trojan/Vmess/Socks5/HTTP）；支持移动蜂窝双网卡（`rmnet0`）与无线 Wi-Fi（`wlan0`）直通。
- **极致流畅与超低延迟**: 零拷贝裸流解析 + 硬件级 PTS 时间戳透传，提供 WebCodecs 锁相显存直通硬件渲染（延迟对标原生 Scrcpy）与标准 HTML5 视频双引擎。
- **免客户端浏览器直连**: 无需在控制端安装任何 App、驱动或投屏软件，任何现代浏览器（PC / Mac / iOS / Android）即开即控。
- **全新重构的 Android 原生 App (v0.4.2)**: 官方手机客户端基于 Kotlin + Jetpack Compose + WebRTC 全面重构并独立开源（[WebrtcPhone-Android](https://github.com/hqw700/WebrtcPhone-Android)），提供原生交互、极低延迟音视频直控与 Root/Shizuku 脱机自启保活。
- **PVE 原生 LXC 云手机调度编排 (v0.4.2)**: 深度集成 Proxmox VE 8.x，结合开源 [redroid-pve](https://github.com/hqw700/redroid-pve) 原生容器镜像，实现非特权模式 (`unprivileged: 1`) 满血运行、Thin-Clone 差异指针秒级开通、Intel/AMD GPU 硬件满血直通、2 秒出厂快照瞬时回滚与 Web 交互终端直连。
- **快捷文本即时输入与短语库 (v0.4.2)**: 侧边栏浮层新增即时文本输入框，输入文字直接落屏发送至手机，支持 Enter 发送与自