Apple Silicon で iPhone VM を起動する方法 (Virtualization.framework)

Apple の

Virtualization.framework

1. 前提条件と環境設定

システム要件

• チップセット: Apple Silicon (M1/M2/M3 など) 搭載 Mac
• OS: macOS 15 (Sequoia) 以降
• 開発環境: Xcode および iOS SDK（ゲストのデーモンをクロスコンパイルするため必須）

セキュリティ設定 (SIP/AMFI の緩和)

仮想マシンを実行するには、システム保護機能の一時的な緩和が必要です。以下のいずれかの方法で対応してください。

オプション A: SIP を完全に無効化する（推奨：最も制限が少ない）

Recovery モード（電源ボタン長押し → ターミナル起動）から実行します。

csrutil disable
csrutil allow-research-guests enable

その後、以下のブート引数で再起動して AMFI を無効化します。

sudo nvram boot-args="amfi_get_out_of_my_way=1 -v"

オプション B: SIP を維持しつつホワイトリスト化する（デバッグ用）

Recovery モードから実行します。

csrutil enable --without debug
csrutil allow-research-guests enable

その後、以下のコマンドを実行：

vphone-amfidont
# ローカルビルドの場合: .build/vphone-cli.app/Contents/Resources/vphone-amfidont

依存関係のインストール

Homebrew を使用して必要なツールをインストールしてください。

brew install python@3.13 aria2 wget gnu-tar openssl@3 ldid-procursus sshpass keystone cmake libusb ipsw zstd
# ldid-procursus の最新ビルドが必要な場合は:
brew install --HEAD ldid-procursus && brew link --overwrite ldid-procursus

2. インストールとビルド

ソースの取得

brew install zqxwce/tap/vphone-cli
git clone --recurse-submodules https://github.com/Lakr233/vphone-cli.git

ビルド手順

依存関係の解決、クロスコンパイル、署名処理を自動で行います。

cd vphone-cli
./scripts/setup_tools.sh        # ツールチェーンの準備と仮想環境作成
./scripts/build.sh              # バインディング作成と vphoned のビルド

インストール確認

ビルドされたアプリケーションの確認：

cd .build/vphone-cli.app/Contents/MacOS/
vphone-cli --help

注意: 構築されたファイルは

~/.vphone/

に自動的に保存されます。

3. クイックスタート (VM の作成と起動)

単一コマンドで VM のセットアップ（ダウンロード→パッチ→DFU リストアール→CFW 導入）を実行します。

# VM の作成 (-V / --variant でバージョン選択可能)
vphone-cli vm create myphone -V jb

# VM の起動
vphone-cli vm launch myphone

4. コマンド一覧と詳細な運用

管理コマンド

VM のライフサイクルを制御します。

vm list

--json

vm info <name>

vm new <name>

vm config

--cpu 8 --memory 8192

vm clone

vm export

vm import

vm rename

vm delete

手動での VM ビルド（自動化を避ける場合）

以下の手順で個別に処理を行うことができます。

1. 空のバインディング作成

   vphone-cli vm new myphone
   

2. IPSW ダウンロードとマージ

   vphone-cli fw prepare myphone --iphone-version 26.1
   # より新しい iOS のソースを指定したい場合:
   # vphone-cli fw prepare myphone --iphone-source <path> --cloudos-source <path>
   

3. ブートチェーンパッチ適用

   vphone-cli fw patch myphone --variant jb
   

4. DFU リストアールと起動

   vphone-cli vm launch myphone --dfu &          # バックグラウンド実行
   vphone-cli restore myphone --get-shsh         # SHSH トークン取得 (オプション)
   vphone-cli restore myphone                    # 正式なリストアール
   

5. CFW インストール

   vphone-cli cfw install myphone --variant jb
   

   注意: このコマンドはホストマウントを使用するため、パスワード入力が必要です。

6. 初回ブート

   vphone-cli vm launch myphone
   

5. ファームウェアバリエーション (

--variant

)

セキュリティバイパスの度合いを制御するための 5 つのパターンがあります。

詳細な比較は

research/0_binary_patch_comparison.md

6. アクセス方法 (接続)

VM 起動後に以下のいずれかで接続できます。

• SSH (Jailbreak モード):

  ssh -p 22222 mobile@<vm-ip>
  # パスワード: alpine
  

• SSH (Regular/Dev モード):

  ssh -p 22222 root@<vm-ip>
  

• VNC:

  vnc://<vm-ip>:5901
  

7. ファイル構成とパス管理

vphone-cli

~/.vphone/

デフォルトパス構造

~/.vphone/

$VPHONE_ROOT

~/.vphone/VMs/

~/.vphone/ipsws/

~/.vphone/tools/

fw prepare

~/.vphone/debs/

.deb

~/.vphone/venv/

$VPHONE_VENV_DIR

優先順位（オーバーライド順）

1. アイテム固有の上書き設定 (例:

   $VPHONE_LIBRARY_ROOT

   ) — 最優先

2. $VPHONE_ROOT

3. ~/.vphone

   — デフォルト

8. よくあるトラブルシューティング (FAQ)

• zsh: killed ./vphone-cli

  エラー
  • AMFI やデバッグ制限が回避されていない可能性があります。
  • 対処法：SIP/AMFI 緩和設定（

    amfi_get_out_of_my_way=1

    または

    amfidont

    ）を再確認してください。

• 特定のハードウェアで起動しない

  • ネステッド仮想化（VM within VM）に対応していない可能性があります。
  • macOS 15+ のホスト環境を使用しているか確認してください。

• 「ホームボタンを押して続行」でフリーズ

  • VNC 経由で接続し、マウスの**右クリック（2 フィンガータップ）**でホームボタンの押下をシミュレーションしてください。

• システムアプリのインストール失敗

  • iOS セットアップ時の地域設定で「日本」や「EU」を選択すると追加規制チェックが発生します。
  • **「米国」**などの他国を選択して回避してください。

• 起動時

  EXC_GUARD / GUARD_TYPE_MACH_PORT

  エラー

  • vphone-cli fw patch <name> --variant <v> --force-exc-guard

    で再パッチを適用し、リストアールを行ってください。（iOS 18 ベースでは必須）

• .ipa/.tipa

  のインストール
  • 起動中の VM ウィンドウ内のメニューから直接インストーターを使用するか、ドラッグ＆ドロップ、またはファイルピッカー経由で導入してください。

• ldid-procursus

  によるメモリ無限増加・停止

  • ldid-procursus

    2.1.5-procursus7 のバグです。0 長所のエントリーメントを持つ Apple システムバイナリを処理する際、ゼロガードがないため発生します。
  • 対処法：ソースから再ビルドして最新バージョンを使用してください（上記のインストールコマンド参照）。

9. オートメーション (vphone-mcp)

vphone-cli

<bundle>/vphone.sock

• スクリーンショット取得
• タッチ/スワイプ操作
• ハードウェアキー操作
• クリップボード管理
• AI 駆動のエンドツーエンドテスト（Inline スクリーンショット返却）

詳細は

vphone-mcp

10. 謝辞

本プロジェクトおよび関連ドキュメントは以下を参考に作成されました。

• wh1te4ever/super-tart-vphone-writeup