27 lines
1.9 KiB
Markdown
27 lines
1.9 KiB
Markdown
# ads-client(Rust 本地连接守护程序)
|
||
|
||
入口:`src/main.rs`。根目录构建:`cargo build -p ads-client --release --locked`。
|
||
|
||
```powershell
|
||
$env:ADS_CLIENT_TOKEN = '<本地端令牌>'
|
||
.\ads-client.exe --server wss://devices.example.com --device home-phone
|
||
```
|
||
|
||
默认监听 `127.0.0.1:15555`,取得独占设备租约后自动调用本地 ADB 连接;本地普通 `adb devices` 将列出该地址。每 5 秒尝试恢复 ADB 连接。首次调试仍需在手机上授权本地电脑的密钥。
|
||
|
||
- `--listen 127.0.0.1:15556`:修改端口,仅允许回环地址。
|
||
- `--adb <完整路径>`:指定 ADB 可执行文件。
|
||
- `--no-auto-connect`:仅提供转发入口,由用户手动 `adb connect`。
|
||
- Ctrl+C 释放租约,并在启用自动连接时执行该端点的 `adb disconnect`。
|
||
|
||
使用本地 ADB 的正常通道,可配合 Android Studio 和 `scrcpy -s 127.0.0.1:15555`。不要将 `ADB_SERVER_SOCKET` 指向远程服务,否则其他终端可能查询到另一台 ADB Server。
|
||
|
||
- `--transport auto`(默认):WebRTC P2P 优先,超时后按控制中心节点顺序回退。
|
||
- `--transport relay`:跳过 P2P,仍自动选择健康中继并在建立失败时尝试下一节点。
|
||
- `--p2p-public-only`:诊断选项,只交换 STUN 公网候选地址,用于排除 LAN/VPN 直连。
|
||
- `--status-file <JSON路径>`:输出当前 p2p/relay/mixed/negotiating/idle、通道数和节点 ID,供桌面展示。
|
||
|
||
节点断线会中断现有 TCP 流;本地 ADB 在重试后创建新通道,重新选择路线,不支持将原 TCP 流无缝迁移。旧中心或旧 agent 会协商回 v1 模式。
|
||
|
||
可选 `--lease-status-file <路径>` 输出 true/false,供虚拟 USB 启动器等待租约,不包含票据。USB 模式需加 `--no-auto-connect`,由 ads-usb 使用本地原始 adbd 端点,不能把 USB/IP 接到 5037。见 docs/windows-usb.md。
|