Files

52 lines
4.2 KiB
Markdown
Raw Permalink 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.
# 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 完整性。目标机原有三个模拟器保持运行。Avalonia 桌面已接入 Linux USB 开关,通过 pkexec 请求系统挂载授权;Flutter Linux 宿主仍未接入。CLI/systemd 路径仍可使用;MTP、fastboot 和整机 USB 透传不在范围内。目标机既有第三方 APT 源存在 404,部署使用已更新的 Ubuntu 索引,没有改写该源。
重挂载测试也已通过:核对来源后仅 detach 本次虚拟端口,监控自动重新导入,adb 重新恢复 device。仓库 deploy/ 下附 export、upstream 和 monitor 三份 systemd 配置示例;安装前按实际账号和路径修改,并拒绝覆盖不属于本项目的同名服务。
2026-11-13 桌面接入更新:.224 已部署自包含 Avalonia 至指定工程,官方 scrcpy 5.0.1 归档校验后安装于发行目录 tools/scrcpy。固定 USB 验证服务已停用,避免与桌面按需创建的同序列号设备冲突;通过桌面连接时再申请 pkexec 授权。当前 .NET runtime 不缺,源码构建缺少 global.json 指定的 8.0.428 SDK。GUI 进程启动已验证,尚未通过桌面授权对话框完成整条 USB 挂载验收。