Files
AndroidDeviceStreaming/docs/linux-usb.md
T

3.7 KiB
Raw Blame History

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)。

# 无需 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 可读;本次没有验证该机的公网客户端数据链路。

当前主机操作

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 配置示例;安装前按实际账号和路径修改,并拒绝覆盖不属于本项目的同名服务。