feat: add control center, multiple relay nodes and P2P-first transport
This commit is contained in:
1 parent
0988e9c363
commit
2abfb63da9
44 files changed
+3477
-67
No files matched your search
@@ -1,15 +1,17 @@
|
||||
# Android Device Streaming
|
||||
|
||||
公网中继 + 远程设备守护程序 + 本地连接守护程序。两端主动出站连接服务器,无需 VPN 或路由器端口映射。连接后,普通本地 `adb devices` 可以显示远程手机,Android Studio / scrcpy 使用本地 ADB 的正常设备通道。
|
||||
一个控制中心 + 多个中继节点 + P2P 优先。两端连接控制中心取得设备租约、交换信令,优先通过 WebRTC DataChannel 直连;直连失败时自动选择独立 WSS 中继。普通本地 `adb devices` 显示本地映射地址,Android Studio / scrcpy 使用同一通道。
|
||||
|
||||
```text
|
||||
本地 ADB → 127.0.0.1:15555 → ads-client (Rust)
|
||||
│ WSS
|
||||
ads-server (Go)
|
||||
│ WSS
|
||||
ads-agent (Rust) → 手机 adbd TCP:5555
|
||||
ads-server 控制中心(注册、租约、信令、节点健康)
|
||||
↙ WSS WSS ↘
|
||||
本地 ADB → ads-client ═══════ WebRTC P2P ═══════ ads-agent → 手机 adbd
|
||||
╲ 失败则 WSS 中继 ╱
|
||||
relay-1 / relay-2 / …
|
||||
```
|
||||
|
||||
已部署的集群和使用方法见 [集群部署与协议](docs/cluster.md)。不配置集群时保留原有 v1 单中继模式,供兼容旧客户端;以下原有单机启动命令也仍可使用。
|
||||
|
||||
## 目录说明
|
||||
|
||||
下表覆盖项目根目录及主要自有子项目;第三方源码的内部目录由其自身文档说明。语言列为主要语言或文件格式,产物目录不视为源码模块。
|
||||
@@ -18,9 +20,11 @@
|
||||
| --- | --- | --- |
|
||||
| `agent/` | 远程设备守护程序 ads-agent,注册设备、连接手机 ADB、建立转发并重连;源码在 `src/` | Rust、TOML |
|
||||
| `client/` | 本地守护程序 ads-client,维护设备租约、监听本地端口并自动调用 adb connect;源码在 `src/` | Rust、TOML |
|
||||
| `server/` | 公网中继 ads-server,负责认证、设备注册、独占租约、会话配对及数据转发 | Go |
|
||||
| `server/` | ads-server 控制中心、旧协议兼容转发及独立 ads-relay 中继节点 | Go |
|
||||
| `server/cmd/ads-relay/` | 独立中继入口,提供短期票据认证、WSS 数据配对及可选 STUN | Go |
|
||||
| `server/internal/relay/` | 中继票据、数据通道、租约撤销、STUN 与测试 | Go |
|
||||
| `crates/` | Rust 工作区共享库容器 | Rust、TOML |
|
||||
| `crates/ads-core/` | 共用网络与协议代码,包括 WSS、ADB smart socket 和流式转发;源码在 `src/` | Rust、TOML |
|
||||
| `crates/ads-core/` | 共用网络与协议代码,包括 WSS、WebRTC P2P、节点回退、ADB smart socket 和流式转发;源码在 `src/` | Rust、TOML |
|
||||
| `desktop/` | 跨平台桌面客户端及其测试项目、.NET SDK 配置与使用说明 | C#、Avalonia XAML(AXAML)、JSON、Markdown |
|
||||
| `desktop/Ads.Desktop/` | Avalonia 桌面应用,管理配置、设备列表、连接、托盘及 scrcpy 子进程;`Assets/` 保存图标资源 | C#、AXAML、XML(csproj)、PNG |
|
||||
| `desktop/Ads.Desktop.Tests/` | 桌面客户端单元测试 | C#、XML(csproj) |
|
||||
@@ -48,13 +52,13 @@
|
||||
|
||||
| 目录 | 输出 | 职责 |
|
||||
|---|---|---|
|
||||
| `server/` | `ads-server` | 角色认证、网关注册、设备独占、会话配对、二进制转发 |
|
||||
| `server/` | `ads-server` / `ads-relay` | 控制中心:认证、注册、设备独占、信令、健康检查;独立中继:数据转发 |
|
||||
| `agent/` | `ads-agent` | 远程电脑后台进程,主动注册设备、接通手机、断线重连 |
|
||||
| `client/` | `ads-client` | 本地后台进程,保持设备租约,提供本地端口,自动调用 `adb connect` |
|
||||
| `crates/ads-core/` | 共用 Rust 库 | WSS、协议、ADB smart socket、流式转发 |
|
||||
| `deploy/` | 部署示例 | Caddy、systemd、launchd 示例 |
|
||||
|
||||
三个程序均为独立可执行文件。没有 UI,不依赖 Python 运行正式程序。两端守护程序当前作为前台长运行进程,启动安装交给各平台进程管理器;尚未实现原生 Windows Service 安装器。
|
||||
四个后端程序均为独立可执行文件;另有 Avalonia 桌面工作台,不依赖 Python 运行正式程序。两端守护程序当前作为前台长运行进程,启动安装交给各平台进程管理器;尚未实现原生 Windows Service 安装器。
|
||||
|
||||
## 编译
|
||||
|
||||
@@ -73,7 +77,7 @@ Linux / macOS:
|
||||
sh scripts/build.sh
|
||||
```
|
||||
|
||||
产物在 `bin/`,Windows 是三个 `.exe`。Go 服务器和 Rust 核心使用跨平台 API;当前实际编译和集成测试平台为 Windows x64,Linux/macOS 仍需在对应平台验证构建、进程托管和 ADB 权限。
|
||||
产物在 `bin/`,Windows 是四个后端 `.exe`。Go 服务器和 Rust 核心使用跨平台 API;Rust 两端和桌面在 Windows x64 验证,Go 控制中心与中继已部署到 Linux amd64;其余平台仍需验证构建、进程托管和 ADB 权限。
|
||||
|
||||
## 1. 公网服务器
|
||||
|
||||
|
||||
Reference in new issue
Block a user