ads-client(Rust 本地连接守护程序)
入口:src/main.rs。根目录构建:cargo build -p ads-client --release --locked。
$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。