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,77 @@
|
||||
# Android 远程设备桥接
|
||||
|
||||
让本机普通 `adb devices` 显示远程手机,同时保留本地 ADB 服务及其他本地设备。
|
||||
|
||||
```text
|
||||
本地 adb → 127.0.0.1:15555(本程序)
|
||||
→ 192.168.5.222:5037(远程 ADB 服务)
|
||||
→ 已连接的 192.168.100.141:5555
|
||||
→ 手机自身 localhost:5555(adbd)
|
||||
```
|
||||
|
||||
本地无需能访问手机网段。远程电脑必须能访问手机,手机必须已开启 TCP ADB 5555;仅 USB 或 TLS 无线调试设备不能直接套用本方案。
|
||||
|
||||
## 远程电脑
|
||||
|
||||
保持下面的服务运行(停止旧服务会中断已有调试连接):
|
||||
|
||||
```powershell
|
||||
adb kill-server
|
||||
adb -a -P 5037 nodaemon server start
|
||||
```
|
||||
|
||||
另开窗口:
|
||||
|
||||
```powershell
|
||||
adb connect 192.168.100.141:5555
|
||||
adb devices
|
||||
```
|
||||
|
||||
只允许可信 VPN 客户端访问远程 TCP 5037。ADB smart socket 没有客户端认证和加密,不应直接暴露公网。以后走公网时,把 `--remote-host` 和 `--remote-port` 改成 SSH 等认证加密隧道的本地入口。
|
||||
|
||||
## 本地电脑
|
||||
|
||||
需要 Python 3、ADB;画面操作另外需要 scrcpy。
|
||||
|
||||
在项目目录执行并保持窗口运行:
|
||||
|
||||
```powershell
|
||||
python .\adb_bridge.py
|
||||
```
|
||||
|
||||
另开 PowerShell,清除之前指向远程服务的环境变量,仅影响当前窗口:
|
||||
|
||||
```powershell
|
||||
Remove-Item Env:ADB_SERVER_SOCKET -ErrorAction SilentlyContinue
|
||||
Remove-Item Env:ANDROID_ADB_SERVER_ADDRESS -ErrorAction SilentlyContinue
|
||||
Remove-Item Env:ANDROID_ADB_SERVER_PORT -ErrorAction SilentlyContinue
|
||||
adb connect 127.0.0.1:15555
|
||||
adb devices -l
|
||||
adb -s 127.0.0.1:15555 shell getprop ro.product.model
|
||||
```
|
||||
|
||||
应出现 `127.0.0.1:15555 device`。首次可能是 `unauthorized`,需要在手机上批准本地电脑的 RSA 调试密钥;远程电脑的授权不会自动授予本地电脑。
|
||||
|
||||
画面及鼠标操作:
|
||||
|
||||
```powershell
|
||||
scrcpy -s 127.0.0.1:15555
|
||||
```
|
||||
|
||||
这是真正注册到本地 ADB 服务的 TCP 设备,Android Studio 应能发现它(需使用同一个本地 ADB 服务)。安装、shell、logcat、forward/reverse 均走本地 ADB 的正常设备通道;实际设备上的兼容性仍需验证。断点调试要求目标应用可调试。
|
||||
|
||||
## 参数、诊断及停止
|
||||
|
||||
```powershell
|
||||
python .\adb_bridge.py --check
|
||||
python .\adb_bridge.py --remote-host 192.168.5.222 --remote-port 5037 --serial 192.168.100.141:5555 --device-port 5555 --listen-port 15555
|
||||
python -m unittest discover -s tests -v
|
||||
```
|
||||
|
||||
- `--check` 只检查远程设备选择和手机 TCP 端口,不验证本地 RSA 授权、投屏或 IDE。
|
||||
- 找不到设备:在远程电脑重新 `adb connect`,检查设备序列号。
|
||||
- `tcp:5555` 失败:手机必须监听自身 TCP 5555;某些系统可能限制回环访问。
|
||||
- 远程链路断开后:恢复远程设备连接,再在本地重跑 `adb connect 127.0.0.1:15555`。当前版本不主动自动重连。
|
||||
- 停止:本地执行 `adb disconnect 127.0.0.1:15555`,再在桥接窗口按 Ctrl+C。
|
||||
|
||||
协议依据:本项目自带的 `adb/docs/dev/services.md` 中 `host:transport:<serial-number>` 及设备 `tcp:<port>` 服务。
|
||||
Reference in new issue
Block a user