跳到正文
阿里雲開發者社區 AI·· 37 分鐘前AI 評分71

iphone-control 部署實戰:讓 AI 操控真 iPhone,免 Mac 及付費開發者帳號

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

AI 導讀

iphone-control 是開源 Rust 工具,可讓 Claude Code、Codex 等 AI 客戶端透過 MCP 操控 USB 連接的真 iPhone,並支援 Linux 與 macOS。

正文

2026-11-22 9

版权

版权声明:

本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写 侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

简介: 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 替你操作手机,欢迎评论区聊聊你的场景。

來源:阿里雲開發者社區 AI · developer.aliyun.com