让AI操控真iPhone:开源工具iphone-control部署实战,免Mac免开发者账号

简介: iphone-control 是开源 Rust 工具,让 AI(如 Claude Code)通过 USB 直控真 iPhone:免 Mac、免付费开发者账号、免越狱。iOS 27+ 原生支持,零签名;iOS 17–26 自动重签 WDA。含 17 个 MCP 工具、浏览器控制页与完善安全机制。(239 字)

AI Agent 现在能开浏览器、能操作桌面电脑,但到了真机 iPhone 这里一直是个短板:Apple 官方的自动化方案要求 Mac + Xcode + 付费开发者账号(99 美元/年),开源路线(WebDriverAgent 等)又是一堆需要各自配置、签名、维护的碎片。本文介绍的开源工具 iphone-control 把这一切收进一个 Rust 二进制:在 Linux 或 macOS 上一条命令装好,免 Mac、免付费开发者账号、免越狱,升级到 iOS 27 之后连 Apple ID 都不需要,就能让 Claude Code、Codex 等 AI 客户端通过 MCP 直接操控一台 USB 连接的真 iPhone。下面从安装、配置到接入实战完整跑一遍。

一、项目是什么:三层架构 + 两条控制路线

iphone-control 是 GitHub 用户 Derrors 开源的项目(MIT 协议),定位一句话:让 AI 稳定、快速地操作一台插在 Linux/Mac 电脑上的真 iPhone 或 iPad。它由三层组成:

层 作用 依赖控制页吗
设备控制(核心) 常驻守护进程独占管理手机,提供全部 MCP 工具;断线重连、重启自恢复,支持暂停/接管/确认 AI 任务 否
接入层 本机 AI 客户端走 stdio;其他机器走 HTTP MCP(/mcp)或 mcp --url 本机不需要;远程需要 viewer
控制页(可选) 浏览器里看实时屏幕、直接操作、给 AI 派任务 它就是控制页

设备控制按 iOS 版本分两条路线:

  1. iOS 27 及以上(默认,推荐):原生控制。屏幕经系统辅助功能服务读取,点击、滑动、按键走 HID 注入,应用启动走 CoreDevice。手机上什么都不装——不要 Apple ID、不要签名,几秒就绪。
  2. iOS 17~26:WebDriverAgent 路线。用免费 Apple ID 签名装到手机上,7 天描述文件到期前自动重签,该路线持续维护。

结论很直接:能升 iOS 27 就升,省掉签名、过期、重启后输密码开「UI 自动化」这一整串麻烦。

二、安装:一条命令或包管理器

环境要求先对齐:

  • 一台 Linux(需 usbmuxd)或 Apple Silicon Mac(Intel Mac 需源码编译);
  • 一根数据线(不是只能充电的线);
  • iPhone/iPad 系统 iOS 17 起,27+ 体验最好;
  • iOS 26 及以下额外需要一个 Apple ID(建议注册一个专用小号,只用于签名)。

脚本安装(会校验 Ed25519 签名的发布清单与 SHA-256,装到 ~/.local/bin,并注册开机自启的用户级服务):

curl -fsSLo iphone-control-install.sh https://github.com/Derrors/iphone-control/releases/latest/download/install.sh && sh iphone-control-install.sh

包管理器安装:

# macOS / Linux(Homebrew)
brew install derrors/tap/iphone-control && brew services start iphone-control

# Debian 12+ / Ubuntu 22.04+:用 Releases 里的 .deb(自带 usbmuxd 依赖)
sudo apt install ./iphone-control_<version>_amd64.deb
sudo systemctl --user enable --now iphone-control

三、首次配置:终端引导式 setup

插上手机,直接运行:

iphone-control          # 首次运行进入引导式配置,之后显示状态
iphone-control doctor   # 分层体检:USB → 配对 → 控制路线逐项检查并给修复建议
iphone-control status   # 守护进程状态、签名剩余天数、最近日志

首次运行会一步步带你走完:语言与代理 → 后台服务 → 设备配对 → 开发者模式 →(iOS 26 及以下:Apple ID 登录、签名并安装 WebDriverAgent)→ 可选的自动解锁与 Telegram/Bark 通知 → 自动注册到 Claude Code / Codex。需要你在手机上操作的环节会明确提示;已经完成的步骤自动跳过。

四、接入 Claude Code:17 个 MCP 工具

配置完成后,新开一个 Claude Code(或 Codex)会话,直接说人话即可,比如「打开时钟,切到秒表并启动」。核心工具一览:

工具 用途
iphone_status 连接状态、锁屏状态、前台应用、屏幕尺寸
iphone_screenshot 截图,可传 x/y/width/height 局部放大
iphone_list_elements 读取元素树,按文本/类型过滤
iphone_tap / iphone_tap_element 坐标点击 / 按元素文本点击
iphone_swipe / iphone_long_press 滑动(列表停止时才返回)/ 长按
iphone_type_text 向焦点输入框输入(支持中文),输入后回读并纠正丢字
iphone_press_button home、音量、锁屏等实体键
iphone_list_apps / iphone_launch_app / iphone_terminate_app 按名称或 bundle ID 管理应用
iphone_open_url 打开 URL 或 URL Scheme
iphone_wait_for 等待指定文本出现,代替反复截图轮询
iphone_batch 单次调用最多串 20 步,出错即停
iphone_list_devices / iphone_select_device 多设备列表与切换

几个提升效率的细节:

  1. 动作类工具支持 then: "elements" | "screenshot",一步动作直接带回操作后的屏幕状态,少一次往返;
  2. 截图像素即点击坐标,游戏、地图、视频播放器这类自绘 UI 没有元素树,直接看图点坐标;
  3. 设 IPHONE_CONTROL_DEV_TOOLS=1 可额外开启 6 个开发者工具(日志、崩溃报告、装卸应用、Web Inspector 里执行 JS),默认关闭。

Claude Code 调用 iphone_launch_app 与 iphone_tap_element 启动秒表的演示

五、浏览器控制页 viewer(可选但好用)

iphone-control viewer        # 控制页,默认 http://127.0.0.1:8200
iphone-control viewer token  # 打印登录令牌与一键登录链接

浏览器打开后可以看到手机实时画面(iOS 27+ 走手机自身视频流,约 60 fps;低带宽模式可切换),鼠标点按、拖拽等同手指操作;还能直接给本机的 Claude Code/Codex 派任务,边看边随时接管。加 --lan 可开放到局域网(HTTPS + 登录令牌,支持只读令牌),同一端口的 /mcp 路径就是 HTTP MCP,供其他机器的 AI 客户端远程使用这台手机(mcp --url / task --url)。

六、安全机制:人始终在环

这类「AI 全权操控手机」的工具,安全设计是第一位的,几道保险值得单独一节:

  • 敏感操作人工确认:支付、删除、发送类操作默认等待你的确认,且 AI 不能自己批准自己的任务;
  • 可随时暂停/接管/终止:任何 AI 任务进行中都能介入;
  • 自动解锁很克制:密码逐位校验,输错一次立即禁用自动解锁,需 unlock-reset 恢复;
  • 离线告警:手机掉线、重启后需要密码、重签失败等事件推送 Telegram/Bark;
  • 数据隔离:Apple ID 会话、签名密钥、自动解锁密码都在 ~/.local/share/iphone-control,官方明确要求备份且绝不外传;建议在 MCP 客户端里保持工具调用确认开启。

七、适用场景与局限

适合:真机 UI 自动化测试(免掉 Mac + 付费账号的重门槛)、重复性手机操作流水线(签到、备份、批量检查)、远程看护自己的设备、给无障碍场景搭自动化。

局限也要说清:平台仅 Linux/macOS,Windows 暂不支持;Intel Mac 需从源码编译;iOS 17~26 路线的签名 7 天一周期(工具会自动重签);游戏等自绘界面只能靠截图坐标;工具对手机有完全控制权,只建议用于自己的设备。

总结

  • iphone-control 用一个 Rust 二进制打通「AI 操控真 iPhone」全链路,免 Mac、免付费开发者账号、免越狱;
  • iOS 27+ 原生路线零安装零签名,iOS 17~26 走 WebDriverAgent 到期自动重签;
  • 17 个 MCP 工具覆盖截图、点击、输入(含中文)、应用管理、批量任务,then 参数与 iphone_batch 大幅减少往返;
  • 浏览器控制页可实时看屏、操作、派任务,支持局域网/远程与只读令牌;
  • 安全上有敏感操作确认、任务接管、离线告警与数据隔离,人始终在环。

FAQ

Q1:真的完全不用 Mac?
A:iOS 27+ 原生路线在 Linux 上即可,连 Apple ID 都不需要;iOS 17~26 需要 Apple ID 签名,但同样不需要 Mac。

Q2:需要越狱吗?
A:不需要,也不往手机里装任何东西(iOS 27 原生路线)。

Q3:Windows 能用吗?
A:目前不支持,仅 Linux 与 macOS;Intel Mac 需从源码编译。

Q4:免费 Apple ID 签名 7 天过期怎么办?
A:工具到期前自动重签,也可手动执行 iphone-control resign --force;建议用专用 Apple ID。

Q5:能同时控制多台设备吗?
A:支持多台 iPhone/iPad 在线,用 iphone_select_device 切换控制对象。

Q6:第一次配置要多久?
A:iOS 27+ 设备几分钟搞定;老系统多一步 Apple ID 签名装 WDA。卡住就跑 iphone-control doctor,逐层给修复建议。

参考资料

写在最后

这个项目最打动我的是「把碎片拼成一个二进制」的工程判断:屏幕读取、点击注入、签名管理、守护进程、MCP 服务原本是五件要分别伺候的事,现在一条命令全部就位,把「真机自动化」的门槛从「Mac + 付费账号 + 折腾签名」拉到了「一根数据线 + 一条命令」。如果你也想让 AI 替你操作手机,欢迎评论区聊聊你的场景。

相关文章
|
8天前
|
Linux Go 开发工具
手机上跑 DeepSeek 智能体:开源安卓客户端 DSH Go 安装与使用指南
DSH Go 是一款开源安卓客户端,将 DeepSeek Harness 智能体引擎装进手机:免 Root、免 Termux,一键安装即用;支持本机运行(内置 Ubuntu+Node.js)或远程接管电脑会话;具备插话打断、过程折叠、屏幕操控、端到端加密分享等特色功能,真正实现智能体“口袋化”。
9577 25
|
8天前
|
弹性计算 人工智能 API
Codex超详细入门指南(下载·安装·登录·上手,全版本覆盖,2026最新版)
建议收藏本教程,2026 全年各版本更新随时回来查阅。如果你在搭建过程中遇到任何问题,欢迎结合 阿里云工单系统 提交技术支持请求,或在 阿里云开发者社区 搜索 Codex 相关话题交流。 祝你编码愉快,效率翻倍!
2749 14
|
3天前
|
人工智能 安全 应用服务中间件
NGINX 爆出两处高危漏洞 可导致未经身份验证的远程代码执行
NGINX曝出两个高危漏洞(CVE-2026-123633和CVE-2026-123007),CVSS 9.2分,均属HTTP/2内存安全缺陷,无需认证即可远程执行代码。影响自2015年起的多个版本,静态站点亦受威胁。修复版本为开源版1.30.7/1.31.9。(239字)
1314 1
NGINX 爆出两处高危漏洞 可导致未经身份验证的远程代码执行
|
6天前
|
传感器 安全 区块链
Windows 电脑运行安卓应用教程:开源工具 ApkStart 双击 APK 即装、独立窗口运行
ApkStart 是一款开源Windows工具,让安卓APP像原生软件一样运行:双击APK即安装、生成真实图标、独立窗口启动、开始菜单可搜索。无需传统模拟器,内置QEMU运行时,支持数据互通、ARM兼容与命令行操作。(239字)
|
11天前
|
人工智能 前端开发 API
阿里云Qwen4-Max 大模型详解:定位、特征、能力、适用场景与相对Qwen3-Max差异解析
2026年11月11日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问AI平台Token Plan并接入千问办公、Qoder等入口。该版本聚焦知识理解、世界感知、编程与Agentic四项升级,主打复杂编程、专业办公、前端设计与专业软件操作等真实任务。预览期为11月11日10:00至11月25日24:00,仅支持Token Plan调用,到期后模型标识下线;限时2折、新用户再享5折,最低1折可体验。
|
11天前
|
JSON 前端开发 API
阿里云最新Qwen4-Max大模型介绍:模型定位、特征、能力、适用场景解析
2026 年 11 月 11 日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问 AI 平台 Token Plan,并同步接入千问办公、Qoder 等入口。该版本聚焦知识理解、世界感知、编程与 Agentic 四项升级,主打复杂编程、专业办公、前端设计与专业软件操作。预览期至 11 月 25 日 24:00,到期后模型标识下线;限时 2 折、新用户再享 5 折,最低 1 折可体验。
|
24天前
|
Linux 开发工具 iOS开发
Codex保姆级教程(下载+安装+登录+使用,含所有版本,2026最新)
Codex是OpenAI推出的开源AI编程智能体,本地运行,可理解整个代码库,支持自然语言指令改代码、执行命令、跑测试、修Bug,兼容Win/macOS/Linux。(239字)
11541 59
|
7天前
|
人工智能 弹性计算 开发工具
零成本玩各大模型!DeepSeek Harness dsh-our-free-model 插件,13 个厂商模型直接用
总结一下:装这个插件,你不用注册、不用绑卡、不用填一个 Key,就能在 DeepSeek Harness 里用上 DeepSeek V4.1 Flash、Kimi K3 这一批前沿模型,而且是白嫖的、还不限量。三步搞定:下载插件,复制包含 `package.json` 的插件目录路径,在「添加插件」里粘贴路径安装并重启。无论是在阿里云 ECS 上通过命令行部署的 Web 版,还是本地的 Electron 桌面端,都能顺利跑通,快速搭建一套零成本的免费模型使用环境。
1390 1
|
4天前
|
人工智能 弹性计算 IDE
Codex超详细入门指南(下载·安装·登录·上手,全版本覆盖,2026最新版)
适合团队落地代码规范,每次提交自动生成评审报告,降低人工CR工作量。同时支持自定义技能脚本,接入团队内部SDK说明文档,让Codex生成符合团队编码规范的代码。Codex三大客户端覆盖本地开发、服务器远程编码、自动化流水线场景,搭配阿里云百炼的Token Plan、Coding Plan,能够低成本搭建稳定可控的AI编码助手。新手建议先从IDE插件入手,熟悉交互逻辑,再尝试CLI版本部署在阿里云ECS,实现云上项目远程编码、批量脚本处理。只要按照步骤完成环境准备、版本选型、密钥对接、项目初始化,就可以把Codex融入日常开发流程,大幅提升代码编写、问题排查、项目重构的效率。
957 0
|
10天前
|
Linux API iOS开发
【DSH】DeepSeek Harness新手保姆教程(下载+安装+配置+使用,2026最新实测)
DeepSeek Harness(dsh)是DeepSeek AI开源的智能体框架,秉持“一切皆插件”理念,支持读文件、改代码、跑命令、处理表格、联网搜索等操作。免费开源,兼容Windows/macOS/Linux,提供桌面端与网页端,可灵活安装插件扩展能力。