vphone-aio 使用教程（一步步指南）

简介

vphone-aio 提供一个“一键合并并运行 vphone CLI（iOS 镜像）”的脚本集合，适用于已经越狱并准备好环境的 macOS 主机。脚本会把仓库内的分片合并、解压并启动可通过 VNC 访问的 iOS 镜像。

注意：该流程涉及较高的系统权限操作（可能需要修改 SIP / amfi），并且占用大量磁盘空间和网络流量，请在测试机或可恢复环境下操作。

风险与准备

  • 强烈建议先备份重要数据。不要在生产主机上直接操作。
  • 确保有至少 128GB 可用磁盘空间（作者建议）。
  • 关闭或修改系统安全设置会降低系统安全性，操作前请确认能恢复。

依赖安装

在 macOS 上打开终端并执行：

# 安装常用工具
brew install git-lfs wget zstd libimobiledevice

如果未安装 Homebrew，请先按官方方法安装。

获取仓库与分片

  1. 克隆仓库：
git clone https://github.com/34306/vphone-aio.git
cd vphone-aio
  1. 仓库内包含若干分片（例如 vphone-cli.tar.zst.part_aa … part_ag）。如果缺少分片，脚本会尝试自动下载；你也可以手动下载：
for p in aa ab ac ad ae af ag; do
  wget -O "vphone-cli.tar.zst.part_${p}" \
    "https://github.com/34306/vphone-aio/raw/refs/heads/main/vphone-cli.tar.zst.part_${p}?download="
done
  1. 校验 SHA-256（推荐）：
shasum -a 256 vphone-cli.tar.zst.part_*
# 将输出与 README 中的 SHA-256 列表比对，确保无损坏

（可选/高风险）禁用 SIP 与设置 amfi 标志

作者在 README 中提到需要设置 amfi_get_out_of_my_way=1：这会降低系统安全。若你理解并接受风险，可在恢复模式下操作：

  • 进入恢复模式（重启并按住电源 → 选“恢复”），在终端运行：csrutil disable，然后重启。
  • 设置 amfi 标志（非常规）：sudo nvram boot-args="amfi_get_out_of_my_way=1"，重启生效。

完成测试后请务必还原：恢复模式执行 csrutil enable；如果设置了 boot-args，用 sudo nvram -d boot-args 删除并重启。

运行合并脚本

在仓库根目录运行：

bash vphone-aio.sh

脚本将：

  • 合并分片为 vphone-cli.tar.zst，并解压（过程可能需要较长时间）。
  • 如果缺少分片会自动下载（需联网）。
  • 解压完成后会生成镜像目录并启动对应服务（等待若干分钟）。

运行时请耐心等待，不要随意中断（中断可能需要重新合并/下载）。

启动服务

1. 自动启动

  • 脚本执行完成后，vphone-aio服务会自动启动
  • 启动过程可能需要3-5分钟，请耐心等待
  • 启动成功后，终端会显示服务运行状态和访问信息

2. 手动启动（如果自动启动失败）

如果服务未自动启动，可手动启动：

# 进入解压后的目录
cd vphone-cli

# 启动服务
./vphone-cli start

3. 检查服务状态

# 检查服务运行状态
./vphone-cli status

# 查看服务日志
./vphone-cli logs

启动后访问

  • 启动并就绪后，使用 VNC 客户端访问：vnc://127.0.0.1:5901。
  • 若无法连接，请检查本地端口占用与防火墙设置，并确认脚本运行日志无错误。

清理与释放空间

  • 合并并确认可用后，可删除仓库的 .git 和分片以释放空间：
rm -rf .git vphone-cli.tar.zst.part_*

（仅当不需要保留 git 历史或分片时再删除）

常见问题与排查要点

  • 卡在合并/解压：检查磁盘空间 df -h、网络状态与脚本输出。
  • 校验失败（SHA 不匹配）：重新下载对应分片并再次校验。
  • 无法访问 VNC：确认服务已启动，检查 lsof -i :5901 或 ps 输出。

建议的回滚步骤（完成后恢复系统安全）

  1. 如果曾禁用 SIP：进入恢复模式运行 csrutil enable，重启。
  2. 如果设置了 amfi_get_out_of_my_way：sudo nvram -d boot-args，重启。

设备越狱步骤

1. 越狱前准备

  • 设备兼容性：确保你的 iOS 设备支持越狱（通常需要 iOS 15.0 及以上版本）
  • 备份数据：使用 iTunes 或 Finder 创建设备的完整备份
  • 关闭密码：对于 A11 设备（如 iPhone X），需要禁用锁屏密码
  • 稳定网络：确保网络连接稳定

2. 选择越狱工具

根据你的设备型号和 iOS 版本选择合适的越狱工具：

  • palera1n：支持 A7 至 A11 设备（iPhone 5s 至 iPhone X），iOS 15.0 及以上
  • checkra1n：支持较老设备
  • unc0ver：支持较新设备和系统版本

3. 使用 palera1n 越狱（示例）

  1. 下载越狱工具：

    git clone https://gitcode.com/GitHub_Trending/pa/palera1n
    cd palera1n

  2. 运行越狱工具：

    ./palera1n.sh --tethered

  3. 按照提示进入 DFU 模式：

    • 设备关机
    • 按住电源键 3 秒
    • 同时按住音量减键 10 秒
    • 松开电源键，继续按住音量减键 15 秒

  4. 等待越狱完成：
    工具会自动执行越狱过程，完成后设备会重启

4. 验证越狱状态

  • 设备重启后，检查是否出现 Cydia 或 Sileo 应用
  • 打开终端，执行以下命令检查越狱状态：
    ideviceinfo | grep -i jailbreak

5. 安装必要的越狱插件

根据 vphone-aio 的需求，可能需要安装以下插件：

  • OpenSSH
  • Cydia Substrate
  • 必要的依赖包

连接越狱设备

确保你的越狱设备已通过 USB 连接到 Mac：

# 检查设备连接状态
idevice_id -l

# 如果设备未被识别，尝试重新连接并信任设备