vphone-cli 是一套在 Apple Silicon Mac 上创建并运行虚拟 iPhone 的工具，当前版本 2.0.8。它基于苹果的虚拟化框架与 PCC 研究用 VM 基础设施，让开发者在 Mac 上获得可启动的 iOS 虚拟机环境。
一、项目简介
vphone-cli 由作者 Lakr233 维护，2.x 版本应用完整固件补丁集，由自包含的 VPhone.bundle 负责固件准备、恢复与虚拟机控制。仓库地址 https://github.com/Lakr233/vphone-cli 。
二、项目功能
1. 创建与启动虚拟机
通过图形化启动器选择固件配对，一步步创建并运行虚拟 iPhone。
2. 固件准备与恢复
内置固件下载、校验与恢复流程，减少手工操作。
3. 研究级主机配置
提供主机安全配置指引，并使用特权助手让经验证的虚拟机二进制通过安全校验。
三、项目亮点
vphone-cli 把虚拟 iPhone 的搭建流程标准化，适配 Apple Silicon。对 iOS 兼容性测试与研究团队较实用。
对比 vphone-aio
对比 vphone-cli 和 Corellium 等方案的区别，差异在维护与流程规范。vphone-cli 提供启动器与完整固件流程并持续更新，脚本方案更偏一次性搭建。
| 对比项 | vphone-cli | 脚本方案 |
|---|---|---|
| 操作方式 | 图形启动器 | 命令行脚本 |
| 固件管理 | 内置下载校验 | 手动下载合并 |
| 维护 | 持续更新 | 较少更新 |
四、项目结构
项目以启动器应用与核心 bundle 为主，Documents 目录提供多语言文档与主机配置指南，发布包为已公证的可执行文件。
五、技术栈
- 基于 Apple Virtualization.framework
- 运行需 Apple Silicon Mac 与 macOS 15 及以上
- 发布包已公证，运行无需额外依赖
- 未附带 MIT 或 Apache 许可证声明，作者信息以仓库主页为准
项目由作者 Lakr233 维护，最后更新 2026 年，版本持续迭代，更新日志见 GitHub Releases。仓库地址 https://github.com/Lakr233/vphone-cli 。
六、本地快速部署启动
方式一 主机配置
在 macOS 恢复模式执行 csrutil enable –without debug 与 csrutil allow-research-guests enable，然后重启。
方式二 安装启动器
下载已公证的 vphone-launchpad 安装包解压打开，完成主机设置与特权助手安装。
方式三 创建虚拟机
在 Core Bundle 下载并安装最新固件包，再到 Machines 新建机器并选择固件配对创建。
适用场景与建议
适用场景方面，它适合 iOS 应用的多版本兼容测试、界面研究与安全实验。创建虚拟机会下载固件并需要较大磁盘空间，建议在网络稳定的环境操作。项目涉及放宽调试限制，务必在专用 Mac 上使用，并在实验结束后评估是否恢复系统设置，避免影响日常开发环境。
国内加速与备份
国内访问较慢时可用 ghfast.top 等镜像加速前缀，更详细的部署说明可扫码获取本站备份。备份包版本 v2.0.8，文件校验 sha256 f6b8b1e75adde71bb3789e6b17064177ef0eef440ff6c69c6bf9c4816cf763e8 。
七、项目代码地址
项目代码地址 https://github.com/Lakr233/vphone-cli 。
常见问题
问. vphone-cli 是做什么的
它是一套在 Apple Silicon Mac 上创建并运行虚拟 iPhone 的工具。
问. 怎么快速上手使用
先按指引配置主机安全设置，再安装启动器下载固件并新建虚拟机。
问. 和脚本方案有什么区别
对比脚本方案，vphone-cli 提供图形启动器与完整固件流程并持续更新。
问. 是否开源免费
项目公开，未附带 MIT 或 Apache 许可证声明，可免费使用。
