广东
项目概述
vphone-cli 是一款基于 Apple Virtualization.framework 开发的命令行工具，旨在利用 PCC 研究的虚拟机基础设施，在 macOS 上启动虚拟 iPhone。该工具支持从下载固件、修补引导链到安装自定义固件（CFW）的全流程自动化，并为开发者提供了多种安全绕过分级的变体选项。
系统要求与依赖
主机环境：
- 硬件：Apple Silicon（苹果自研芯片）Mac
- 系统：macOS 15 (Sequoia) 或更高版本
- 开发工具：Xcode 及 iOS SDK（用于交叉编译客户机守护进程）
- 权限配置：需放宽 SIP（系统完整性保护）或 AMFI（Apple 移动文件完整性）限制，以允许未签名二进制文件使用私有 PV=3 权限
软件依赖：
用户可通过 Homebrew 安装必要组件，包括 python@3.13、aria2、wget、gnu-tar、openssl@3、ldid-procursus、sshpass、keystone、cmake、libusb、ipsw 及 zstd。
安装与构建
快速安装：
brew install zqxwce/tap/vphone-cli
源码构建：
克隆仓库并初始化子模块后，运行设置脚本以安装依赖、构建工具链及创建 Python 虚拟环境，随后执行构建脚本生成 .app 包并交叉编译 vphoned。
git clone --recurse-submodules https://github.com/Lakr233/vphone-cli.gitcd vphone-cli./scripts/setup_tools.sh./scripts/build.sh
核心功能与使用
一键部署
vphone-cli 支持端到端自动化流程，单条命令即可完成虚拟机创建、固件下载、修补、DFU 恢复、CFW 安装及首次启动。
# 创建名为 myphone 的越狱版虚拟机vphone-cli vm create myphone -V jb# 启动虚拟机vphone-cli vm launch myphone
虚拟机管理
工具提供完整的生命周期管理命令，包括列出、查看信息、新建、配置资源（CPU/内存）、克隆（APFS 快速克隆）、导出/导入（支持 zstd/xz 压缩）、重命名及删除虚拟机。
固件变体选择
通过 参数，用户可选择五种不同安全绕过程度的变体：
--variant
- ：最小化修补，保留 iOS 缓解措施
- less
- ：绕过 AMFI/SSV/Img4/TXM
- regular
- ：增加 TXM 权限及调试绕过
- dev
- ：完整越狱，自动安装 Sileo 和 TrollStore
- jb
- ：实验性超集，包含反虚拟机检测研究补丁
- exp
连接与交互
- SSH 访问：越狱版默认用户为 mobile（密码 alpine），常规/开发版为 root，端口均为 22222。
- VNC 访问：通过 vnc://
- :5901 连接图形界面。
数据存储结构
所有虚拟机数据默认存储于 目录下，确保应用包的可移植性。用户可通过环境变量 重定向根目录，或使用 单独指定虚拟机库位置。目录结构包括 VMs（虚拟机包）、ipsws（固件缓存）、tools（APFS 工件）、debs（越狱包缓存）及 venv（Python 环境）。
~/.vphone/
$VPHONE_ROOT
$VPHONE_LIBRARY_ROOT
常见问题与排查
- 进程被杀（Killed）：通常因 AMFI/调试限制未绕过导致，需检查启动参数 或使用 amfidont 白名单。
- amfi_get_out_of_my_way=1
- 虚拟化不可用：宿主 Mac 不能是虚拟机，PV=3 不支持嵌套虚拟化。
- 卡在“按 Home 键”：通过 VNC 连接后，右键（或双指点击）模拟 Home 键操作。
- 地区限制：初始化时避免选择日本或欧盟地区，以防监管检查失败，建议选择美国。
- EXC_GUARD 崩溃：iOS 18 基础版本启用此保护，需使用 重新修补固件。
- --force-exc-guard
- ldid 内存泄旧版 ldid-procursus 存在已知 Bug，建议从源码重建最新版本（）。
- brew install --HEAD ldid-procursus
自动化支持
vphone-cli 暴露主机控制套接字（vphone.sock），支持程序化控制截图、触摸、滑动、硬件按键及剪贴板操作，每个操作均返回内联截图，适用于 AI 驱动的端到端自动化测试场景。
【星途科讯 图文丨略略 首发于ZAKER科技，转载请注明出处】
特别声明：以上内容(如有图片或视频亦包括在内)为自媒体平台“网易号”用户上传并发布，本平台仅提供信息存储服务。
Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.
