Implement authenticated public relay and Rust device daemons
This commit is contained in:
1 parent
f96c1aa109
commit
e1c152a657
29 files changed
+3244
-39
No files matched your search
@@ -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
|
||||
@@ -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` 安装。
|
||||
@@ -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(())
|
||||
}
|
||||
Reference in new issue
Block a user