![](https://developer.qcloudimg.com/http-save/yehe-6490225/97278d6eeb9ad9115e7973c3fc1f3317.png)

最近我在 GitHub 上翻到一个项目：`Droidline`，挺有意思，分享给大家。

这个项目，先记住几个关键信息即可：

- `Droidline`，一个用代码驱动真实 Android 手机的自动化工具，Go 写 PC 端、Kotlin 写手机端，MIT 协议
- 2026 年 10 月 7 日开源，作者 KnifeLemon，韩国开发者，之前那个离线文件转换器 Filee 已经攒了 22.8K Star
- 官网 droidline.dev，App、报错信息、文档都是中英韩三语

它干的事很简单，一句话概括：**不用 ADB、不用数据线、不用 root，手机上装一个 App 扫码配对，PC 端就能用 Python、Node.js、命令行、HTTP 或 MCP 驱动这台真机。**

![](https://developer.qcloudimg.com/http-save/yehe-6490225/2a2150e7b5a03347f8e2b9b183f42b4b.jpg)

## 先说它绕开了什么

Appium、uiautomator2 这套生态跑了这么多年，好用也确实好用，但使用限制还是挺多的，开发者选项、USB 调试、数据线，一个都不能少。测试真机一多，工位上就是一排排插，线松了、驱动抽风了、手机休眠了，脚本半夜挂掉的理由五花八门。想不带线，就得去云真机平台按时长掏钱。

Droidline 把这套全免了。手机端只装一个普通 App，开无障碍服务和自带的 Droidline 键盘，扫码跟 PC 配对，之后手机自己往外连，PC 一个端口都不用开。同 Wi-Fi 直接通，人在外面手机跑流量，走隧道或自建中继照样控，通信全程端到端加密，中继手里只有密文。

![](https://developer.qcloudimg.com/http-save/yehe-6490225/ed774252d8a1fcd2d65565b14a79c23e.png)

## 都能派什么活

- 真机自动化测试。`dump()` 把屏幕拉成元素树，每条命令按 `text`、`id` 定位元素，不靠坐标，等待逻辑内置，失败时报错直接告诉你当前停在哪个页面，比如 `NOT_FOUND: Could not find text 'Log in' within 10s`。注册登录这种要跨 App 收短信验证码的流程，能整条跑完
- 一台 PC 带一排手机。不同手机并行跑、每台有名字，还能给每台单独配 socks5 或 http 代理，全程免 root。配合 `cuts_network`，飞行模式换 IP 之后任务接着跑，要多 IP 的采集和造数场景直接用
- 给 AI Agent 装上手机之手。`droidline mcp` 一起，Claude、Cursor 就能看真机屏幕、点按钮，还能用 `--read-only` 把它限制成只看不动
- 顺手的小自动化。PC 端收手机通知、回复、转发 webhook，定时从 App 里收个数、晚上关 Wi-Fi 这类杂活，写两句脚本就解决

![](https://developer.qcloudimg.com/http-save/yehe-6490225/1dee41d0d3ade9c5e53dd930480a6810.webp)

## 两行命令，手机隔空连上电脑

PC 端 Windows、macOS、Linux 都有发布包，手机要 Android 9 及以上。手边没真机也没关系，发布包里带个 `droidline-fakephone` 模拟器，官方教程就是对着它写完第一个脚本的。

PC 端从 Releases 下载对应系统的包放进 PATH，手机装 `droidline-agent.apk`，然后两条命令

```bash
droidline serve
droidline pair
```

第一条起服务，第二条弹二维码，手机 App 扫一下就配对完成。没摄像头就点 App 里的「在此 Wi-Fi 下配对」，输它显示的 6 位码一样能连。连上就能点真机，先拿设置页练手

```bash
droidline launch com.android.settings
droidline touch text "Network & internet"
```

写 Python 的 `pip install droidline`，照着仓库自带的演示 App 跑一遍登录

```python
from droidline import connect

d = connect()
d.launch("dev.droidline.demo")
if d.exists("text", "Close ad"):
    d.touch("text", "Close ad")
d.input("id", "email", "knife")
d.touch("text", "Log in")
print(d.get_text("id", "greeting"))
```

给 Claude Code 接 MCP 也只要一行

```bash
claude mcp add droidline -- droidline mcp
```

组件记三个就够上手。`droidline serve` 是常驻服务，所有入口都连它的 8780 端口；`droidline pair` 管配对；`droidline mcp` 是给 Agent 用的适配器。`inspect`（录脚本、荐选择器）、`webdriver`（让 Appium 客户端直接用）这些按需再开，不开就不占资源。

![](https://developer.qcloudimg.com/http-save/yehe-6490225/e5a2199654b6f1a2dc1dd60642478046.png)

## 里面几个巧设计

一套规格生成五个入口。仓库根目录的 `spec/commands.json` 定义了全部命令和三语错误文案，Python、Node.js、.NET 三个 SDK 和 MCP 工具清单都由它生成，CI 里跑校验，SDK 方法跟规格不一致直接挂。所以 `touch` 在五个入口里都叫 `touch`，文档也只维护一份。做多端 SDK 的团队可以直接抄这个思路。

手机主动外连，PC 不开端口。方向反过来之后，安全模型也顺了，配对决定谁能控这台手机，握手之后每行通信都端到端加密，隧道和自建中继只是搬运密文。手机断网重连后从断点接着跑，执行中的命令由手机侧缓存应答，不会重跑一遍。

权限边界很克制。手机端只用无障碍服务和自装键盘，也就是普通 App 能拿到的权限，代价 README 里直接列了清单，解不开 PIN 锁，没有强停、清数据的单命令，打不开别的 App 没导出的页面。做工具先把「做不到什么」讲明白，这个比只是简单列功能列表有价值。

## 短板也得说清

版本还在 0.1，作者在 Status 页写明，服务端和 SDK 的测试目前都是对着手机模拟器跑的，跨品牌真机验证还在进行中，真要上生产，先拿自己的机器趟一遍。

游戏和自绘界面的 App 没有元素可拿，只能退回坐标点击加颜色判断。Android 15 起系统把一次性验证码从通知里藏起来了，只能知道码到了、去 App 里读。这些是无障碍权限路线的天然上限，不是修一版能解决的。

## 写在最后

工具本身可用可不用。Appium 生态成熟，团队的脚本资产都在那，没必要为了免一根线搬家。但思路值得学走。单源规格生成多端 SDK，省掉的是五端接口不一致的维护成本。手机主动外连加端到端加密，给远程控真机这件事立了一个安全上站得住的样板。把权限边界和做不到的事先写进 README，用户少踩坑，信任也来得快。

对测试开发来说，它最实际的价值有两个。真机回归的门槛降下来了，不插线不 root，短信验证码流程都能整条跑。MCP 一接，AI Agent 就能在真机上做探索性测试，这比在模拟器里点来点去接近真实得多。

项目地址：`https://github.com/KnifeLemon/Droidline`

---

最近我在 GitHub 上翻到一个项目：Droidline，挺有意思，分享给大家。

太牛了，不插线不 root，两行命令就能隔空操控 Android 真机

开发工具

测试

客户端

Droidline是一款免ADB、免root的Android真机自动化工具，通过扫码配对实现PC与手机无线连接，支持Python、Node.js、CLI、HTTP及MCP驱动，内置端到端加密与多设备并行控制，兼容Appium生态，面向真机测试、AI Agent操作及多IP采集场景，开源MIT协议。

代码解释

验证码

Windows

Android

Python

短信

Kotlin

GitHub

Linux

MacOS

Agent

JSON

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

太牛了，不插线不 root，两行命令就能隔空操控 Android 真机-腾讯云开发者社区-腾讯云

太牛了，不插线不 root，两行命令就能隔空操控 Android 真机

太牛了，不插线不 root，两行命令就能隔空操控 Android 真机

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐