vphone-cli Vibe 项目

项目简介

vphone-cli 是一款开源命令行工具，通过苹果官方的 Virtualization.framework，在 Apple Silicon Mac 上启动真实可运行的 iOS（iOS 26）虚拟机。项目由 Lakr233 开发维护，支持从固件下载、修补、DFU 恢复、越狱固件安装到首次开机的全流程自动化，一条命令即可完成。GitHub 今日 Trending 上榜，仅 13 分钟内获得大量关注。

核心功能

一键端到端虚拟机创建：单条命令完成下载 IPSW 固件、修补引导链、DFU 恢复、越狱固件安装及首次启动，无需手动干预多步骤流程。

完整的虚拟机生命周期管理：提供 list、info、new、config、clone、export、import、rename、delete 等子命令，覆盖虚拟机从创建到销毁的全部管理需求。

五种安全修补变体：通过 --variant 参数可选择 less（最小修补）、regular（38 补丁）、dev（47 补丁）、jb（完整越狱，114 补丁，预装 Sileo 和 TrollStore）、exp（141 补丁 + 反虚拟机检测研究补丁）五个级别，满足从安全测试到深度研究的不同需求。

多种连接方式：越狱版默认开启 SSH（端口 22222，移动端用户 mobile 密码 alpine）和 VNC（vnc://:5901）访问方式，可直接连接虚拟机进行交互操作。

数据存储与缓存机制：所有虚拟机数据默认存储于 ~/.vphone/ 目录，包含 VMs（虚拟机包）、ipsws（固件缓存）、tools（APFS 工件）、debs（越狱包缓存）和 venv（Python 环境），支持 $VPHONE_ROOT、$VPHONE_LIBRARY_ROOT 等环境变量重定向。

固件版本灵活切换：支持指定 --iphone-version 下载特定 iOS 版本，也可通过 --iphone-source 指向本地 IPSW 文件自行选择系统版本。

技术实现

vphone-cli 的底层依赖于苹果在 macOS 15+ 中引入的 Virtualization.framework（PV=3），这是苹果官方提供的虚拟化技术接口。项目采用 Python 作为顶层编排语言，交叉编译了一个运行在虚拟机内部的守护进程 vphoned，用于与宿主机通信和管理 iOS 客人系统的各项功能。

构建流程首先通过 ./scripts/setup_tools.sh 安装所有 Homebrew 依赖（python@3.13、aria2、wget、gnu-tar、openssl@3、ldid-procursus、sshpass、keystone、cmake、libusb、ipsw、zstd 等），同时初始化 git 子模块并创建 Python 虚拟环境。随后 ./scripts/build.sh 完成工具链构建、对 .app 包进行签名，并交叉编译 vphoned。整个过程高度自动化，极大降低了用户自行编译的门槛。

在存储格式上，导出的虚拟机包采用 .tzst（zstd）或 .txz（xz）压缩格式，默认使用 zstd 快速压缩（--max 参数可切换为 xz -9 极限压缩），导出的文件跳过恢复目录和临时文件，体积更小、传输更快。

快速上手

第一步：安装依赖。macOS 上确保已安装 Homebrew，执行 brew install zqxwce/tap/vphone-cli，或手动克隆仓库并初始化子模块：git clone --recurse-submodules https://github.com/Lakr233/vphone-cli.git。

第二步：运行设置脚本。执行 ./scripts/setup_tools.sh 安装所有构建依赖、构建工具链子模块并创建 Python 虚拟环境。

第三步：构建项目。执行 ./scripts/build.sh 完成 vphone-cli 的编译签名和 .app 打包，同时交叉编译 vphoned 守护进程。

第四步：创建并启动虚拟机。进入 .build/vphone-cli.app/Contents/MacOS/ 目录，执行 vphone-cli vm create myphone -V jb 创建一台越狱版 iOS 虚拟机，然后 vphone-cli vm launch myphone 启动即可。

首次启动后，Sileo 和 TrollStore 已预装在越狱版虚拟机中，可直接通过 SSH（ssh -p 22222 mobile@localhost，密码 alpine）或 VNC（vnc://:5901）连接使用。

适用人群

安全研究人员：利用五种不同安全等级的修补变体进行 iOS 安全研究和漏洞分析，无需实体设备即可开展深度研究。

iOS 开发者和测试工程师：通过命令行批量管理多个 iOS 版本虚拟机，快速进行 UI 检查、自动化视觉测试和 CI 流程集成。

越狱爱好者：开箱即用的越狱 iOS 环境，首次启动即预装 Sileo 和 TrollStore，方便探索 iOS 内部机制。

研究人员和极客玩家：在终端窗口中运行真实 iOS 系统的技术本身具有极高的极客趣味性，是展示虚拟化技术能力的优秀案例。