feat: validate native Linux virtual USB and add recovery services

This commit is contained in:
tongtong committed 2026-11-13 03:28:52 +08:00
1 parent 6490665af8
commit ac8eb72319
8 files changed
+105 -4

No files matched your search

+49
View File
@@ -0,0 +1,49 @@
# Linux 原生虚拟 ADB USB(CLI)
2026-11-13 已在 192.168.5.224(Ubuntu 24.04、x86_64、6.8.0-147-generic)验证。无法直连 SSH 时通过 192.168.5.222 的 direct-tcpip 中转,实际 USB/IP 导出始终只监听目标 Linux 本机回环。不是把 Windows 驱动安装到 Linux,也不是将 adb connect 当作 USB 枚举。
## 部署结构
- `/home/tt/ads-linux-usb/ads-usb`:Rust 原生 Linux USB/IP 导出,使用仓库代码编译,含 APK 双向流控修复。
- `ads-usb-upstream.service`:TT 身份运行 socat,将手机 192.168.100.141:5555 映射到 127.0.0.1:15557。
- `ads-usb-export.service`:TT 身份运行 ads-usb,监听 127.0.0.1:3241,上游 127.0.0.1:15557,序列号 ADS-home-phone。
- `ads-linux-usb-monitor.service`:root 运行 USB/IP 挂载监控,只挂载指定回环端口。启动前加载系统签名的 vhci_hcd;每三秒检查本次导入,缺失时重挂载。
- `deploy/linux-usb-monitor.sh` 是监控源码,安装为 root 所有、0755 的 `/usr/local/libexec/ads-linux-usb-monitor`;不能从普通用户可修改的脚本路径以 root 启动。systemd 示例见 `deploy/ads-linux-usb-monitor.service`。
导出服务与监控已启用开机启动;上游作为导出服务的 Requires 依赖启动。没有重启目标电脑验证开机流程。
## 通用手工启动
需要原生 ads-usb、usbip、ADB、内核 vhci_hcd。先建立本机 raw adbd 上游,例如 ads-client 的回环映射,或局域网验证用 socat 转发(原始 ADB TCP 不是 ADB server 5037)。
```sh
# 无需 root,保持前台运行
./ads-usb --listen 127.0.0.1:3241 --upstream 127.0.0.1:15557 --serial ADS-home-phone
# 另一终端,仅内核挂载操作需要 root
sudo modprobe vhci_hcd
sudo usbip --tcp-port 3241 attach --remote 127.0.0.1 --busid 1-1
adb devices -l
adb -s ADS-home-phone get-devpath
adb -d shell getprop ro.product.model
```
首次显示 unauthorized 时,在手机允许该 Linux ADB 主机的调试密钥;不复制其他电脑的私钥,不绕过授权。普通用户访问 USB 使用发行版 android-sdk-platform-tools-common 的 udev 配置。`sudo usbip port` 可读 root 创建的导入来源记录;普通用户运行该命令可能显示 unknown host,不代表 ADB 不可用。
本次源站为局域网手机,未将手机原有 Windows 连接迁移或抢占租约。连接公网集群时,用 ads-client 替代 socat,向同一回环上游输出原始 adbd 数据;设备仍受集群独占租约约束。TT 的 client.env 经用户明确授权部署,权限 0600,仅 TT/root 可读;本次没有验证该机的公网客户端数据链路。
## 当前主机操作
```sh
systemctl status ads-usb-export ads-linux-usb-monitor
sudo usbip port
adb -d get-state
adb -s ADS-home-phone shell getprop ro.product.model
# 停止监控和导出,关闭导出连接使本次 USB 设备移除
sudo systemctl stop ads-linux-usb-monitor ads-usb-export
# 再启动:导出启动上游,监控负责导入
sudo systemctl start ads-linux-usb-monitor
```
已验证原生 `usb:3-1` 枚举、普通 TT 的 adb -d、远程 shell、8 MiB push 的 SHA-256 完整性。目标机原有三个模拟器保持运行。Linux 桌面 UI 的 USB 开关尚未接入,此版本通过 CLI/systemd 使用;MTP、fastboot 和整机 USB 透传不在范围内。目标机既有第三方 APT 源存在 404,部署使用已更新的 Ubuntu 索引,没有改写该源。
重挂载测试也已通过:核对来源后仅 detach 本次虚拟端口,监控自动重新导入,adb 重新恢复 device。仓库 deploy/ 下附 export、upstream 和 monitor 三份 systemd 配置示例;安装前按实际账号和路径修改,并拒绝覆盖不属于本项目的同名服务。