Files
AndroidDeviceStreaming/docs/local-bridge.md
T

78 lines
3.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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>` 服务。