Airhand:自建中继的 QUIC 远程桌面,硬件编码、最高 120 fps
Airhand 是开源自建远程桌面:GPU 硬编解码、QUIC 传输、最高 120 fps,中继用 Docker Compose 一条命令部署,会话端到端加密。
项目资料
GitHub Ecosystem- 许可证
- MIT
- 主语言
- Rust
- 星标
- 1,240
- 核查时间
- 2026-11-14
以上快照资料以核查当日为准,可能随版本或运营策略变化。
把远程桌面的画面搬到浏览器标签页之外,多数商业方案要你接受它的云中继和订阅。本条介绍的 Airhand 走的是自建路线:同一个程序既能当被控端(host)也能当控制端(controller),中继服务器由你自己部署——README 称 Docker Compose 一条命令即可拉起。GitHub API 在 2026 年 11 月 14 日显示它有 1,240 颗星。
核心功能
- 硬件编解码:被控端在 GPU 上低延迟编码(NVENC、Quick Sync、AMF、VideoToolbox、MediaCodec),无 B 帧;两端自动选最优格式,AV1 优先于 HEVC,再是 H.264;最高 120 fps。
- QUIC + BBR 传输:控制消息、音频、视频分开排队,鼠标输入不会被大帧堵住;弱网下主机限制在途字节并直接跳到最新帧,码率随实测带宽调整。除中继外,两端还会尝试 NAT 直连打洞,成功后音视频不再经过服务器,直连断开自动回落中继。
- 默认安全:会话端到端加密,中继只转发字节、看不到屏幕与键击;首次连接需要被控端托盘里的配对码(配对码不经过服务器),之后识别设备身份;控制码有防爆破保护,被控端随时能看到连接者并一键断开。
- 部署形态:中继服务器
airhand-server用 Docker Compose 部署,只负责登记控制码、配对会话与转发字节;控制端也可以跑在 Docker 里,从浏览器直接使用(Web console),被控机器上无需安装任何东西。 - 平台覆盖:Windows 10/11(被控端以系统服务运行,锁屏与 UAC 可控)、macOS 13+(需屏幕录制与辅助功能权限)、Linux(仅 X11,暂为软编码)、Android 7+(双向),另有浏览器控制端;界面与对方通知均支持中英文。
- 用完即走:被控端只是托盘图标,不启动 WebView;值得保留的配置只有一个
config.toml,卸载不留残留。
典型使用场景
- 替代商业远控的自建方案:不想把屏幕内容交给第三方云,或者要给家人、团队的机器做远程协助,自建中继后数据路径自己掌握。若只是安卓设备的投屏与轻量控制,更简单的现成路径见 escrcpy。
- 弱网与长距离连接:跨运营商或跨国场景下,BBR 拥塞控制加跳帧策略比常规 TCP 远控更稳;README 明确定位为低延迟优先。
- 多机管理:控制端提供多标签页与多屏总览,连接过的机器会保存并自动重连,适合同时照顾几台开发机或家里的电脑。
快速上手
README 的部署思路是三步:自建中继(airhand-server,Docker Compose 一条命令)、被控端与控制端各装同一程序、输入对方托盘里的 6 位控制码完成配对。两端都主动连接服务器,因此被控端不需要公网 IP 或端口映射;会话建立后两端自动尝试直连。
需要注意版本状态:项目自述为 work in progress(0.2.3),协议 v9 起客户端与服务器、host 与 controller 各自支持版本区间并通过能力位协商,旧于 v9 的版本不兼容(会检测并报错)。生产环境使用前建议先在自己设备间完整跑通。
小结
Airhand 把”自建远程桌面”的门槛拉到了 Docker Compose 一条命令的水平,功能表也覆盖了商业远控的常用项:硬编码、多平台、剪贴板、多屏、音频。它仍处于早期(0.2.3),平台矩阵里 Linux 被控端只有 X11 加软编码,Android 被控端在开启无障碍服务前只能观看。GitHub API 在 2026 年 11 月 14 日报告:Rust、MIT、1,240 颗星、未归档,最近推送 2026 年 11 月 12 日。
本条目基于 README 与文档整理,未实际安装或建立连接;延迟、画质与弱网表现以官方描述为准,采用前建议先在两台自己的设备上验证。