中文版

vphone-cli（GitHub：https://github.com/Lakr233/vphone-cli ，2026-02-26 创建，已 16,051★）能在 Apple Silicon Mac 上跑起一台虚拟 iPhone。它借助苹果的 Virtualization.framework 与 PCC 研究虚拟机机制，启动的是完整的真实 iOS 固件，项目定位写得很明确：安全研究、逆向工程与调试。

和 Xcode 模拟器的根本区别

• 模拟器是”仿真”：跑在 macOS 内核上，应用要专门编译成模拟器版本，系统服务和安全芯片都是仿造的；装不了 App Store 的应用，没有真实启动链
• vphone-cli 是”虚拟化”：真实 IPSW、真实 iOS 内核、真实启动链装进虚拟机，和真机是同一套系统；能装真实 IPA，固件预先打好补丁，还能安装软件包环境

一句话：模拟器是给开发者调自己 App 的摄影棚布景，vphone 是把整台 iPhone 搬进了 Mac。

主要能力

• 图形窗口直接操作虚拟 iPhone 的屏幕，可浏览应用与文件、截图、录屏
• 固件预打补丁，可再装包管理器，接近一台软件形态的研究用”越狱机”
• 虚拟机可导出、导入、克隆，支持快照存档与回滚
• 提供本地 HTTP / WebSocket 自动化接口，脚本乃至 AI Agent 都能操控它
• 运行时不依赖 Xcode、Python 或 Homebrew，开箱即用
• 新增虚拟机默认使用开源启动 ROM（OpenAVB / OpenSEP）替代苹果闭源版本，连安全处理器那一段都不跑苹果的闭源代码
• 除了 iOS，也能跑 iPadOS（iPad mini A17 Pro）

使用门槛

• 必须是实体 Apple Silicon Mac、macOS 15 或更新版本，在 macOS 虚拟机里跑不了
• 需要进 macOS 恢复模式调整 SIP 设置：保留 SIP 开启，只放宽调试限制并允许研究虚拟机
• 每台虚拟机默认占 64GB 磁盘，固件本身还要额外空间；恢复系统时需联网获取签名票据
• 命令行齐全（vphone-cli vm list / launch / export），虚拟机存在 ~/.vphone/ 下

提醒

这是面向研究者的工具，安装步骤涉及恢复模式与系统安全设置，新手先读完官方文档再动手。另外项目方特意声明：该项目从未发行或授权任何加密货币/代币，凡是打着这个项目名义发币收款的都是骗局，别上当。

English Version

vphone-cli (GitHub: https://github.com/Lakr233/vphone-cli , created 2026-02-26, now 16,051★) runs a virtual iPhone on an Apple Silicon Mac. Built on Apple’s Virtualization.framework and PCC research virtual machines, it boots the complete, genuine iOS firmware, and its stated purpose is security research, reverse engineering, and debugging.

How it fundamentally differs from the Xcode Simulator

• The Simulator is a simulation: it runs on the macOS kernel, apps must be compiled specifically for it, and system services and the secure hardware are imitations. It cannot install App Store apps and has no real boot chain
• vphone-cli is virtualization: a real IPSW, the real iOS kernel, and the real boot chain inside a VM — the same system that runs on hardware. It can install real IPAs, the firmware comes pre-patched, and a package environment can be installed

In short: the Simulator is a stage set for rehearsing your own app; vphone moves an entire iPhone into your Mac.

Key capabilities

• A graphical window to operate the virtual iPhone’s screen, browse apps and files, and take screenshots and screen recordings
• Pre-patched firmware with an installable package manager — close to a software-form research “jailbroken device”
• VMs can be exported, imported, and cloned, with snapshot save and rollback
• A local HTTP / WebSocket automation API, so scripts and even AI agents can drive it
• No Xcode, Python, or Homebrew needed at runtime
• New VMs boot from open-source ROMs (OpenAVB / OpenSEP) instead of Apple’s closed ones, so nothing Apple wrote runs before iBoot and SEPOS
• Besides iOS, it can also run iPadOS (iPad mini A17 Pro)

Requirements

• A physical Apple Silicon Mac running macOS 15 or newer; it does not work inside a macOS VM
• SIP settings must be adjusted from macOS Recovery: SIP stays enabled, with only debugging restrictions relaxed and research guests allowed
• Each VM takes a 64 GB virtual disk by default, plus more space for firmware; restoring fetches signing tickets online
• A full command line is available (vphone-cli vm list / launch / export), with VMs stored under ~/.vphone/

A word of caution

This is a tool for researchers; setup involves Recovery mode and system security settings, so read the official documentation first. The project also explicitly warns that it has never issued or authorized any cryptocurrency or token — anything raising money under this project’s name is a scam.