帮助中心

vphone 文档

从环境准备到第一台虚拟 iPhone,再到固件补丁变体、集群与自动化——按主题查阅。

快速开始

  • 系统总体架构
    深入剖析 vphone-cli 的四层进程域、构建期与运行期两条主线,以及工程化设计
  • 创建你的第一台虚拟机
    用 vphone-cli vm create 一键完成固件准备、启动链补丁、DFU 刷机、CFW 安装与首启验证的完整建机流程。
  • 环境准备与安装
    第一次运行 vphone 前的完整准备流程:系统要求、工具链安装、构建签名与特权 helper 安装。

使用指南

  • CLI 命令参考
    vphone-cli 全部子命令速查:VM 生命周期、固件补丁、DFU 刷机、CFW 安装、guest 控制与端口转发。
  • vphone-manager 多 VM 管理 GUI
    图形化管理多台虚拟 iPhone:创建向导、实时屏幕、快照、文件与固件下载,本地与远程节点统一操作。

固件与补丁

集群与远程

  • 集群管理与 vphone-agent
    用 vphone-agent 把任意 Mac 变成集群节点,经 vphone-manager Cluster 面板远程管理 VM
  • 网络与代理
    VM 网络架构、SOCKS5/HTTP 透明代理 sidecar、流量遥测与运行时策略控制

对抗与伪装

进阶

  • 自动化
    用项目内 Python 自动化框架对虚拟 iPhone 做非侵入式 E2E 操作——venv 约定、vphone-auto CLI 与会话编程。
  • VM 运行时:窗口、输入与控制面
    虚拟 iPhone 启动后的日常操作指南——窗口交互、触摸/键盘/硬件键注入,以及经 vphone.sock 的一行 JSON 控制面用法。
  • guest 守护进程 vphoned
    运行在虚拟 iPhone 内部的控制执行端——能力概览、make vphoned 快速迭代流程与不重启 VM 的热更新。

排错

  • 日志与常见问题
    各组件日志位置速查、常见启动/安装失败的原因与修复办法,以及常用 make 目标清单。