8.9 KiB
vphone-cli
Apple の Virtualization.framework と PCC の研究用 VM インフラを使用して、仮想 iPhone (iOS 26) を起動するためのツール
検証済み環境
| ホスト | iPhone | CloudOS |
|---|---|---|
| Mac16,12 26.3 | 17,3_26.1_23B85 |
26.1-23B85 |
| Mac16,12 26.3 | 17,3_26.3_23D127 |
26.1-23B85 |
| Mac16,12 26.3 | 17,3_26.3_23D127 |
26.3-23D128 |
ファームウェアバリアント
セキュリティバイパスのレベルが異なる3つのパッチバリアントが利用可能です：
| バリアント | ブートチェーン | CFW | Make ターゲット |
|---|---|---|---|
| 通常版 | 38 パッチ | 10 フェーズ | fw_patch + cfw_install |
| 開発版 | 47 パッチ | 12 フェーズ | fw_patch_dev + cfw_install_dev |
| 脱獄版（WIP） | 84 パッチ | 14 フェーズ | fw_patch_jb + cfw_install_jb |
詳細なコンポーネントごとの内訳については research/patch_comparison_all_variants.md を参照してください。
前提条件
ホストOS: PV=3 仮想化には macOS 15+（Sequoia）が必要です。
SIPとAMFIを無効化 — プライベートな Virtualization.framework の entitlement を使うために必要です。
復旧モードで起動し（電源ボタンを長押し）、ターミナルを開いて以下を実行します：
csrutil disable
csrutil allow-research-guests enable
通常の macOS に再起動した後：
sudo nvram boot-args="amfi_get_out_of_my_way=1 -v"
実行したらもう一度再起動します。
依存関係のインストール:
brew install ideviceinstaller wget gnu-tar openssl@3 ldid-procursus sshpass keystone autoconf automake pkg-config libtool
Submodules — このリポジトリはリソースアーカイブに git submodule を使用しています。クローン時に以下を使用してください：
git clone --recurse-submodules https://github.com/Lakr233/vphone-cli.git
クイックスタート
make setup_machine # 初回起動までを完全自動化（復元/ラムディスク/CFWを含む）
手動セットアップ
make setup_tools # brew の依存関係インストール、trustcache + libimobiledevice のビルド、Python venv の作成
make build # vphone-cli のビルド + 署名
make vm_new # vm/ ディレクトリの作成（ROM、ディスク、SEP ストレージ）
make fw_prepare # IPSW のダウンロード、抽出、マージ、マニフェスト生成
make fw_patch # ブートチェーンのパッチ当て（通常バリアント）
# または: make fw_patch_dev # 開発バリアント（+ TXM entitlement/デバッグバイパス）
# または: make fw_patch_jb # 脱獄バリアント（+ 完全セキュリティバイパス）（WIP）
復元
復元プロセスには 2つのターミナル が必要です。ターミナル 2 を使用している間、ターミナル 1 を実行し続けてください。
# ターミナル 1
make boot_dfu # DFUモードでVMを起動（実行したままにする）
# ターミナル 2
make restore_get_shsh # SHSH blob の取得
make restore # idevicerestore 経由でファームウェアを焼き込み
カスタムファームウェアのインストール
ターミナル 1 の DFU 起動を停止し（Ctrl+C）、Ramdisk 用に再び DFU で起動します：
# ターミナル 1
make boot_dfu # 実行したままにする
# ターミナル 2
make ramdisk_build # 署名済みSSH Ramdisk のビルド
make ramdisk_send # デバイスへ送信
Ramdisk が起動したら（出力に Running server と表示されるはずです）、iproxy トンネル用 に 3つ目のターミナル を開き、ターミナル 2 から CFW をインストールします：
# ターミナル 3 — 実行したままにする
iproxy 2222 22
# ターミナル 2
make cfw_install
初回起動
ターミナル 1 の DFU 起動を停止し（Ctrl+C）、以下を実行します：
make boot
これにより VM に 直接繋がるコンソール が開きます。bash-4.4# と表示されたら、Enter を押し、シェル環境を初期化して SSH ホストキーを生成するために以下のコマンドを実行します：
export PATH='/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/bin/X11:/usr/games:/iosbinpack64/usr/local/sbin:/iosbinpack64/usr/local/bin:/iosbinpack64/usr/sbin:/iosbinpack64/usr/bin:/iosbinpack64/sbin:/iosbinpack64/bin'
mkdir -p /var/dropbear
cp /iosbinpack64/etc/profile /var/profile
cp /iosbinpack64/etc/motd /var/motd
# SSHホストキーの生成（SSHを機能させるために必要）
dropbearkey -t rsa -f /var/dropbear/dropbear_rsa_host_key
dropbearkey -t ecdsa -f /var/dropbear/dropbear_ecdsa_host_key
shutdown -h now
注意: ホストキー生成手順を行わないと、dropbear（SSH サーバー）は接続を受け付けますが、SSH ハンドシェイクを実行するためのキーがないためすぐに切断されます。
2回目以降の起動
make boot
別のターミナルで iproxy トンネルを開始します：
iproxy 22222 22222 # SSH
iproxy 5901 5901 # VNC
iproxy 5910 5910 # RPC
以下で接続します：
- SSH:
ssh -p 22222 root@127.0.0.1(パスワード:alpine) - VNC:
vnc://127.0.0.1:5901 - RPC:
rpcclient -p 5910 127.0.0.1
よくある質問 (FAQ)
何よりもまず —
git pullを実行して最新バージョンであることを確認してください
Q: 実行しようとすると zsh: killed ./vphone-cli と表示されます
AMFIが無効化されていません。boot-arg を設定して再起動してください：
sudo nvram boot-args="amfi_get_out_of_my_way=1 -v"
Q: システムアプリ（App Store、メッセージなど）がダウンロード・インストールできません
iOS の初期設定時に、地域として日本または欧州連合を選択しないでください。これらの地域では追加の規制チェック（サイドローディングの開示、カメラのシャッター音など）が適用されますが、仮想マシンではこれらの要件を満たせないため、システムアプリのダウンロードおよびインストールができなくなります。この問題を回避するには、他の地域（例: 米国）を選択してください。
Q: "Press home to continue" の画面から進めません
VNC経由で接続し（vnc://127.0.0.1:5901）、画面の任意の場所を右クリック（Mac のトラックパッドでは 2 本指クリック）してください。これによりホームボタンの押下がシミュレートされます。
Q: SSH を接続した後にすぐ切断されます（Connection closed by 127.0.0.1）
初回起動時にDropbearホストキーが生成されていません。VNC または make boot コンソール経由で接続し、以下を実行してください：
export PATH='/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/bin/X11:/usr/games:/iosbinpack64/usr/local/sbin:/iosbinpack64/usr/local/bin:/iosbinpack64/usr/sbin:/iosbinpack64/usr/bin:/iosbinpack64/sbin:/iosbinpack64/bin'
mkdir -p /var/dropbear
dropbearkey -t rsa -f /var/dropbear/dropbear_rsa_host_key
dropbearkey -t ecdsa -f /var/dropbear/dropbear_ecdsa_host_key
killall dropbear
dropbear -R -p 22222
Q: もっと新しいiOSバージョンにアップデートできますか？
はい。fw_prepare に希望するバージョンの IPSW URL を指定することでできます：
export IPHONE_SOURCE=/path/to/some_os.ipsw
export CLOUDOS_SOURCE=/path/to/some_os.ipsw
make fw_prepare
make fw_patch
私たちのパッチは静的なオフセットではなくバイナリ解析によって適用されるため、新しいバージョンでも動作するはずです。何か壊れた場合は AI に聞いてください。