Implement authenticated public relay and Rust device daemons

This commit is contained in:
tongtong committed 2026-11-12 12:33:39 +08:00
1 parent f96c1aa109
commit e1c152a657
29 files changed
+3244 -39

No files matched your search

+12
View File
@@ -0,0 +1,12 @@
[package]
name = "ads-agent"
version.workspace = true
edition.workspace = true
license.workspace = true
[dependencies]
ads-core = { path = "../crates/ads-core" }
anyhow.workspace = true
clap.workspace = true
tokio.workspace = true
tracing.workspace = true
+14
View File
@@ -0,0 +1,14 @@
# ads-agent(Rust 远程设备守护程序)
入口:`src/main.rs`。根目录构建:`cargo build -p ads-agent --release --locked`。
```powershell
$env:ADS_AGENT_TOKEN = '<设备端令牌>'
.\ads-agent.exe --server wss://devices.example.com --device home-phone --target 192.168.100.141:5555
```
默认主动出站,不需要对远程电脑开放入站端口。网络故障后以 1–30 秒退避重连,控制连接断开时结束旧数据连接。一个进程对应一台手机,多设备启动多个进程。
也可用 `--adb-server 127.0.0.1:5037 --adb-serial <序列号>` 替代 `--target`。该模式仍要求手机开启 TCP adbd(默认 5555,可用 `--device-port` 修改),不是通用的 USB-only 接入。
Windows 可由任务计划程序在登录后启动;Linux/macOS 可使用 `deploy/` 示例托管。当前二进制不是原生 Windows Service,不能直接用 `sc.exe create` 安装。
+126
View File
@@ -0,0 +1,126 @@
use ads_core::{
adb_tcp_connect, dial, init_logging, next_control, relay, tcp_connect, valid_device_id,
validate_token, NetworkArgs,
};
use anyhow::{bail, Context, Result};
use clap::Parser;
use std::{sync::Arc, time::Duration};
use tokio::{net::TcpStream, task::JoinSet, time::sleep};
use tracing::{info, warn};
#[derive(Parser)]
#[command(
version,
about = "Remote device gateway: outbound-only connection to the ADS relay"
)]
struct Args {
#[command(flatten)]
network: NetworkArgs,
#[arg(long, env = "ADS_AGENT_TOKEN", hide_env_values = true)]
token: String,
/// Stable public device alias, e.g. home-phone
#[arg(long)]
device: String,
/// Direct phone adbd address reachable from this gateway, e.g. 192.168.100.141:5555
#[arg(
long,
required_unless_present = "adb_serial",
conflicts_with = "adb_serial"
)]
target: Option<String>,
/// Alternative: choose a transport from an existing ADB server (phone must have TCP adbd enabled)
#[arg(long)]
adb_serial: Option<String>,
#[arg(long, default_value = "127.0.0.1:5037")]
adb_server: String,
#[arg(long, default_value_t = 5555)]
device_port: u16,
}
async fn upstream(args: &Args) -> Result<TcpStream> {
match &args.target {
Some(address) => tcp_connect(address).await,
None => {
adb_tcp_connect(
&args.adb_server,
args.adb_serial.as_deref().context("missing serial")?,
args.device_port,
)
.await
}
}
}
async fn serve_session(args: Arc<Args>, session: String) -> Result<()> {
let tcp = upstream(&args).await.context("cannot reach phone adbd")?;
let ws = dial(
args.network.url(
"/v1/data",
&[("device", &args.device), ("session", &session)],
)?,
&args.token,
)
.await?;
relay(tcp, ws).await
}
async fn online(args: Arc<Args>) -> Result<()> {
let mut ws = dial(
args.network.url("/v1/agent", &[("device", &args.device)])?,
&args.token,
)
.await?;
let hello = next_control(&mut ws).await?;
if hello.kind != "registered" {
bail!("expected registered response");
}
info!(device = %args.device, "gateway registered");
let mut tasks = JoinSet::new();
loop {
tokio::select! {
message = next_control(&mut ws) => {
let message = message?;
if message.kind != "open" { bail!("unexpected gateway control message"); }
let session = message.session.context("missing session ticket")?;
if tasks.len() >= 32 { warn!("gateway stream limit reached"); continue; }
let args = args.clone();
tasks.spawn(async move {
if let Err(error) = serve_session(args, session).await { warn!(%error, "device stream ended"); }
});
},
_ = tasks.join_next(), if !tasks.is_empty() => {},
}
}
// JoinSet drop aborts all streams when the control connection is lost.
}
async fn run(args: Arc<Args>) {
let mut delay = 1;
loop {
let started = std::time::Instant::now();
if let Err(error) = online(args.clone()).await {
warn!(%error, "gateway offline; reconnecting");
}
if started.elapsed() > Duration::from_secs(30) {
delay = 1;
}
sleep(Duration::from_secs(delay)).await;
delay = (delay * 2).min(30);
}
}
#[tokio::main]
async fn main() -> Result<()> {
init_logging();
let args = Args::parse();
validate_token(&args.token)?;
if !valid_device_id(&args.device) {
bail!("invalid device ID (use letters, digits, -, _, .; max 128 bytes)");
}
args.network.url("/v1/agent", &[])?;
tokio::select! {
_ = run(Arc::new(args)) => {},
result = tokio::signal::ctrl_c() => { result?; info!("gateway stopping"); },
}
Ok(())
}