Run a virtual iPhone on an Apple Silicon Mac.
Swift
docs: rework READMEs — fix patch counts, merge PR #148, sync translations
Lakr3a644b733253
diff --git a/AGENTS.md b/AGENTS.mdindex ea5f6f61..1d694da7 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -29,11 +29,11 @@ For any changes applying new patches, also update research/0_binary_patch_compar## Firmware Variants-| Variant | Boot Chain | CFW | Make Targets |-| --------------- | :---------: | :-------: | ------------------------------------------------------------ |-| **Regular** | 51 patches | 10 phases | `fw_patch` + `cfw_install` |-| **Development** | 64 patches | 12 phases | `fw_patch_dev` + `cfw_install_dev` |-| **Jailbreak** | 126 patches | 14 phases | `fw_patch_jb` + `cfw_install_jb` |+| Variant | Boot Chain | CFW | Make Targets |+| --------------- | :---------: | :-------: | ---------------------------------- |+| **Regular** | 51 patches | 10 phases | `fw_patch` + `cfw_install` |+| **Development** | 64 patches | 12 phases | `fw_patch_dev` + `cfw_install_dev` |+| **Jailbreak** | 126 patches | 14 phases | `fw_patch_jb` + `cfw_install_jb` |> JB finalization (symlinks, Sileo, apt, TrollStore) runs automatically on first boot via `/cores/vphone_jb_setup.sh` LaunchDaemon. Monitor progress: `/var/log/vphone_jb_setup.log`.diff --git a/README.md b/README.mdindex 75d1077c..39228080 100644--- a/README.md+++ b/README.md@@ -18,11 +18,11 @@ Boot a virtual iPhone (iOS 26) via Apple's Virtualization.framework using PCC reThree patch variants are available with increasing levels of security bypass:-| Variant | Boot Chain | CFW | Make Targets |-| --------------- | :-------------: | :-------: | ------------------------------------------------------------ |-| **Regular** | 41 patches | 10 phases | `fw_patch` + `cfw_install` |-| **Development** | 52 patches | 12 phases | `fw_patch_dev` + `cfw_install_dev` |-| **Jailbreak** | 66 / 78 patches | 14 phases | `fw_patch_jb` + `cfw_install_jb` |+| Variant | Boot Chain | CFW | Make Targets |+| --------------- | :---------: | :-------: | ---------------------------------- |+| **Regular** | 41 patches | 10 phases | `fw_patch` + `cfw_install` |+| **Development** | 52 patches | 12 phases | `fw_patch_dev` + `cfw_install_dev` |+| **Jailbreak** | 112 patches | 14 phases | `fw_patch_jb` + `cfw_install_jb` |> JB finalization (symlinks, Sileo, apt, TrollStore) runs automatically on first boot via `/cores/vphone_jb_setup.sh` LaunchDaemon. Monitor progress: `/var/log/vphone_jb_setup.log`.@@ -153,6 +153,24 @@ make bootAfter `cfw_install_jb`, the jailbreak variant will have **Sileo** and **TrollStore** available on first boot. You can use Sileo to install `openssh-server` for SSH access.+For the regular/development variant, the VM gives you a **direct console**. When you see `bash-4.4#`, press Enter and run these commands to initialize the shell environment and generate SSH host keys:++```bash+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++# generate SSH host keys (required for SSH to work)+dropbearkey -t rsa -f /var/dropbear/dropbear_rsa_host_key+dropbearkey -t ecdsa -f /var/dropbear/dropbear_ecdsa_host_key++shutdown -h now+```++> **Note:** Without the host key generation step, dropbear (SSH server) will accept connections but immediately close them because it has no keys to perform the SSH handshake.+## Subsequent Boots```bash@@ -162,14 +180,15 @@ make bootIn a separate terminal, start iproxy tunnels:```bash-iproxy 2222 22 # SSH (requires openssh-server from Sileo)+iproxy 2222 22 # SSH (JB: requires openssh-server from Sileo; Regular/Dev: dropbear)iproxy 5901 5901 # VNCiproxy 5910 5910 # RPC```Connect via:-- **SSH:** `ssh -p 2222 [email protected]` (password: `alpine`)+- **SSH (JB):** `ssh -p 2222 [email protected]` (password: `alpine`)+- **SSH (Regular/Dev):** `ssh -p 2222 [email protected]` (password: `alpine`)- **VNC:** `vnc://127.0.0.1:5901`- [**RPC:**](http://github.com/doronz88/rpc-project) `rpcclient -p 5910 127.0.0.1`@@ -206,6 +225,10 @@ Install `openssh-server` from Sileo (available on the jailbreak variant after fiReboot the VM. The SSH server will start automatically on the next boot.+**Q: Can I install `.tipa` files?**++Yes. The install menu supports both `.ipa` and `.tipa` packages. Drag and drop or use the file picker.+**Q: Can I update to a newer iOS version?**Yes. Override `fw_prepare` with the IPSW URL for the version you want:diff --git a/docs/README_ja.md b/docs/README_ja.mdindex 7d06ca5b..2948097c 100644--- a/docs/README_ja.md+++ b/docs/README_ja.md@@ -18,11 +18,11 @@ Apple の Virtualization.framework と PCC の研究用 VM インフラを使用セキュリティバイパスのレベルが異なる3つのパッチバリアントが利用可能です:-| バリアント | ブートチェーン | CFW | Make ターゲット |-| ---------- | :------------: | :---------: | ------------------------------------------------------------ |-| **通常版** | 41 パッチ | 10 フェーズ | `fw_patch` + `cfw_install` |-| **開発版** | 52 パッチ | 12 フェーズ | `fw_patch_dev` + `cfw_install_dev` |-| **脱獄版** | 66 / 78 パッチ | 14 フェーズ | `fw_patch_jb` + `cfw_install_jb` |+| バリアント | ブートチェーン | CFW | Make ターゲット |+| ---------- | :------------: | :---------: | ---------------------------------- |+| **通常版** | 41 パッチ | 10 フェーズ | `fw_patch` + `cfw_install` |+| **開発版** | 52 パッチ | 12 フェーズ | `fw_patch_dev` + `cfw_install_dev` |+| **脱獄版** | 112 パッチ | 14 フェーズ | `fw_patch_jb` + `cfw_install_jb` |> JB最終設定(シンボリックリンク、Sileo、apt、TrollStore)は `/cores/vphone_jb_setup.sh` LaunchDaemon により初回起動時に自動実行されます。進捗確認:`/var/log/vphone_jb_setup.log`。@@ -32,22 +32,42 @@ Apple の Virtualization.framework と PCC の研究用 VM インフラを使用**ホストOS:** PV=3 仮想化には macOS 15+(Sequoia)が必要です。-**SIPとAMFIを無効化** — プライベートな Virtualization.framework の entitlement を使うために必要です。+**SIP/AMFIの設定** — プライベートな Virtualization.framework の entitlement と未署名バイナリのワークフローに必要です。-復旧モードで起動し(電源ボタンを長押し)、ターミナルを開いて以下を実行します:+復旧モードで起動し(電源ボタンを長押し)、ターミナルを開いて、以下のいずれかの方法を選択します:-```bash-csrutil disable-csrutil allow-research-guests enable-```+- **方法 1:SIP を完全に無効化 + AMFI boot-arg(最も制限が少ない)**-通常の macOS に再起動した後:+ 復旧モードで:-```bash-sudo nvram boot-args="amfi_get_out_of_my_way=1 -v"-```+ ```bash+ csrutil disable+ csrutil allow-research-guests enable+ ```++ 通常の macOS に再起動した後:++ ```bash+ sudo nvram boot-args="amfi_get_out_of_my_way=1 -v"+ ```++ もう一度再起動します。-実行したらもう一度再起動します。+- **方法 2:SIP はほぼ有効のまま、デバッグ制限のみ無効化、[`amfidont`](https://github.com/zqxwce/amfidont) を使用**++ 復旧モードで:++ ```bash+ csrutil enable --without debug+ csrutil allow-research-guests enable+ ```++ 通常の macOS に再起動した後:++ ```bash+ xcrun python3 -m pip install amfidont+ sudo amfidont --path [PATH_TO_VPHONE_DIR]+ ```**依存関係のインストール:**@@ -65,6 +85,7 @@ git clone --recurse-submodules https://github.com/Lakr233/vphone-cli.git```bashmake setup_machine # 初回起動までを完全自動化(復元/ラムディスク/CFWを含む)+# オプション:NONE_INTERACTIVE=1 SUDO_PASSWORD=...```## 手動セットアップ@@ -109,7 +130,7 @@ sudo make ramdisk_build # 署名済みSSH Ramdisk のビルドmake ramdisk_send # デバイスへ送信```-Ramdisk が起動したら(出力に `Running server` と表示されるはずです)、iproxy トンネル用 に **3つ目のターミナル** を開き、ターミナル 2 から CFW をインストールします:+Ramdisk が起動したら(出力に `Running server` と表示されるはずです)、iproxy トンネル用に **3つ目のターミナル** を開き、ターミナル 2 から CFW をインストールします:```bash# ターミナル 3 — 実行したままにする@@ -132,6 +153,24 @@ make boot`cfw_install_jb` 実行後、脱獄バリアントでは初回起動時に **Sileo** と **TrollStore** が利用可能になります。Sileo から `openssh-server` をインストールして SSH アクセスを有効にできます。+通常版/開発版では、VM に**直接繋がるコンソール**が開きます。`bash-4.4#` と表示されたら、Enter を押し、シェル環境を初期化して SSH ホストキーを生成するために以下のコマンドを実行します:++```bash+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回目以降の起動```bash@@ -141,14 +180,15 @@ make boot別のターミナルで iproxy トンネルを開始します:```bash-iproxy 2222 22 # SSH(Sileo から openssh-server のインストールが必要)+iproxy 2222 22 # SSH(脱獄版:Sileo から openssh-server が必要;通常版/開発版:dropbear)iproxy 5901 5901 # VNCiproxy 5910 5910 # RPC```以下で接続します:-- **SSH:** `ssh -p 2222 [email protected]` (パスワード: `alpine`)+- **SSH(脱獄版):** `ssh -p 2222 [email protected]` (パスワード: `alpine`)+- **SSH(通常版/開発版):** `ssh -p 2222 [email protected]` (パスワード: `alpine`)- **VNC:** `vnc://127.0.0.1:5901`- [**RPC:**](http://github.com/doronz88/rpc-project) `rpcclient -p 5910 127.0.0.1`@@ -158,11 +198,16 @@ iproxy 5910 5910 # RPC**Q: 実行しようとすると `zsh: killed ./vphone-cli` と表示されます**-AMFIが無効化されていません。boot-arg を設定して再起動してください:+AMFI/デバッグ制限が正しくバイパスされていません。以下のいずれかの方法を選択してください:-```bash-sudo nvram boot-args="amfi_get_out_of_my_way=1 -v"-```+- **方法 1(AMFI を完全に無効化):**++ ```bash+ sudo nvram boot-args="amfi_get_out_of_my_way=1 -v"+ ```++- **方法 2(デバッグ制限のみ無効化):**+ 復旧モードで `csrutil enable --without debug`(完全な SIP 無効化は不要)を使用し、[`amfidont`](https://github.com/zqxwce/amfidont) をインストール/ロードして AMFI のその他の機能は有効のままにします。**Q: システムアプリ(App Store、メッセージなど)がダウンロード・インストールできません**@@ -180,6 +225,10 @@ Sileo から `openssh-server` をインストールしてください(脱獄VM を再起動してください。次回起動時に SSH サーバーが自動的に開始されます。+**Q: `.tipa` ファイルをインストールできますか?**++はい。インストールメニューは `.ipa` と `.tipa` パッケージの両方に対応しています。ドラッグ&ドロップまたはファイルピッカーを使用してください。+**Q: もっと新しいiOSバージョンにアップデートできますか?**はい。`fw_prepare` に希望するバージョンの IPSW URL を指定することでできます:diff --git a/docs/README_ko.md b/docs/README_ko.mdindex 93e81c75..151c6673 100644--- a/docs/README_ko.md+++ b/docs/README_ko.md@@ -18,11 +18,11 @@ PCC 리서치 VM 인프라와 Apple의 Virtualization.framework를 사용하여보안 우회 수준이 다른 3가지 패치 변형을 사용할 수 있습니다:-| 변형 | 부트 체인 | CFW | Make 타겟 |-| -------- | :----------: | :-------: | ------------------------------------------------------------ |-| **일반** | 41 패치 | 10 페이즈 | `fw_patch` + `cfw_install` |-| **개발** | 52 패치 | 12 페이즈 | `fw_patch_dev` + `cfw_install_dev` |-| **탈옥** | 66 / 78 패치 | 14 페이즈 | `fw_patch_jb` + `cfw_install_jb` |+| 변형 | 부트 체인 | CFW | Make 타겟 |+| -------- | :-------: | :-------: | ---------------------------------- |+| **일반** | 41 패치 | 10 페이즈 | `fw_patch` + `cfw_install` |+| **개발** | 52 패치 | 12 페이즈 | `fw_patch_dev` + `cfw_install_dev` |+| **탈옥** | 112 패치 | 14 페이즈 | `fw_patch_jb` + `cfw_install_jb` |> JB 최종 설정(심볼릭 링크, Sileo, apt, TrollStore)은 `/cores/vphone_jb_setup.sh` LaunchDaemon을 통해 첫 번째 부팅 시 자동으로 실행됩니다. 진행 상황 확인: `/var/log/vphone_jb_setup.log`.@@ -32,22 +32,42 @@ PCC 리서치 VM 인프라와 Apple의 Virtualization.framework를 사용하여**호스트 OS:** PV=3 가상화를 위해 macOS 15+(Sequoia)가 필요합니다.-**SIP 및 AMFI 비활성화** — Private Virtualization.framework 권한을 사용하기 위해 필요합니다.+**SIP/AMFI 설정** — Private Virtualization.framework 권한과 서명되지 않은 바이너리 워크플로우에 필요합니다.-복구 모드(전원 버튼 길게 누르기)로 부팅한 후 터미널을 엽니다:+복구 모드(전원 버튼 길게 누르기)로 부팅한 후 터미널을 열고, 다음 중 하나를 선택합니다:-```bash-csrutil disable-csrutil allow-research-guests enable-```+- **방법 1: SIP 완전 비활성화 + AMFI boot-arg (가장 관대)**-macOS로 다시 시작한 후:+ 복구 모드에서:-```bash-sudo nvram boot-args="amfi_get_out_of_my_way=1 -v"-```+ ```bash+ csrutil disable+ csrutil allow-research-guests enable+ ```++ macOS로 다시 시작한 후:++ ```bash+ sudo nvram boot-args="amfi_get_out_of_my_way=1 -v"+ ```++ 한 번 더 재시작합니다.-한 번 더 재시작합니다.+- **방법 2: SIP은 대부분 활성 유지, 디버그 제한만 비활성화, [`amfidont`](https://github.com/zqxwce/amfidont) 사용**++ 복구 모드에서:++ ```bash+ csrutil enable --without debug+ csrutil allow-research-guests enable+ ```++ macOS로 다시 시작한 후:++ ```bash+ xcrun python3 -m pip install amfidont+ sudo amfidont --path [PATH_TO_VPHONE_DIR]+ ```**의존성(Dependencies) 설치:**@@ -65,6 +85,7 @@ git clone --recurse-submodules https://github.com/Lakr233/vphone-cli.git```bashmake setup_machine # "First Boot"까지의 전체 과정 자동화 (복원/Ramdisk/커스텀 펌웨어 포함)+# 옵션: NONE_INTERACTIVE=1 SUDO_PASSWORD=...```## 수동 설정@@ -132,6 +153,24 @@ make boot`cfw_install_jb` 실행 후 탈옥 변형은 첫 번째 부팅 시 **Sileo**와 **TrollStore**를 사용할 수 있습니다. Sileo에서 `openssh-server`를 설치하여 SSH 접근을 활성화할 수 있습니다.+일반/개발 변형의 경우, VM에서 **direct console**이 나타납니다. `bash-4.4#`이 보이면 엔터를 누르고 다음 명령어를 실행하여 쉘 환경을 초기화하고 SSH 호스트 키를 생성하세요:++```bash+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 핸드셰이크를 수행할 키가 없어 즉시 연결을 종료합니다.+## 이후 부팅```bash@@ -141,14 +180,15 @@ make boot별도의 터미널에서 iproxy 터널을 시작합니다:```bash-iproxy 2222 22 # SSH (Sileo에서 openssh-server 설치 필요)+iproxy 2222 22 # SSH (탈옥: Sileo에서 openssh-server 설치 필요; 일반/개발: dropbear)iproxy 5901 5901 # VNCiproxy 5910 5910 # RPC```다음을 통해 연결합니다:-- **SSH:** `ssh -p 2222 [email protected]` (password: `alpine`)+- **SSH (탈옥):** `ssh -p 2222 [email protected]` (password: `alpine`)+- **SSH (일반/개발):** `ssh -p 2222 [email protected]` (password: `alpine`)- **VNC:** `vnc://127.0.0.1:5901`- [**RPC:**](http://github.com/doronz88/rpc-project) `rpcclient -p 5910 127.0.0.1`@@ -158,11 +198,16 @@ iproxy 5910 5910 # RPC**Q: 실행하려고 하면 `zsh: killed ./vphone-cli` 오류가 발생합니다.**-AMFI가 비활성화되지 않았습니다. boot-arg를 설정하고 재시작하세요:+AMFI/디버그 제한이 올바르게 우회되지 않았습니다. 다음 중 하나를 선택하세요:-```bash-sudo nvram boot-args="amfi_get_out_of_my_way=1 -v"-```+- **방법 1 (AMFI 완전 비활성화):**++ ```bash+ sudo nvram boot-args="amfi_get_out_of_my_way=1 -v"+ ```++- **방법 2 (디버그 제한만 비활성화):**+ 복구 모드에서 `csrutil enable --without debug`(완전한 SIP 비활성화 없음)를 사용한 다음, [`amfidont`](https://github.com/zqxwce/amfidont)를 설치/로드하여 AMFI의 나머지 기능은 활성 상태로 유지합니다.**Q: 시스템 앱(App Store, 메시지 등)을 다운로드하거나 설치할 수 없습니다.**@@ -180,6 +225,10 @@ Sileo에서 `openssh-server`를 설치하세요 (탈옥 변형 첫 부팅 후VM을 재부팅하세요. 다음 부팅 시 SSH 서버가 자동으로 시작됩니다.+**Q: `.tipa` 파일을 설치할 수 있나요?**++네. 설치 메뉴는 `.ipa`와 `.tipa` 패키지를 모두 지원합니다. 드래그 앤 드롭 또는 파일 선택기를 사용하세요.+**Q: 최신 iOS 버전으로 업데이트할 수 있나요?**네. `fw_prepare`를 원하는 버전의 IPSW URL로 덮어쓰세요:diff --git a/docs/README_zh.md b/docs/README_zh.mdindex 63628836..96e26c5b 100644--- a/docs/README_zh.md+++ b/docs/README_zh.md@@ -18,11 +18,11 @@提供三种补丁变体,安全绕过级别逐步递增:-| 变体 | 启动链 | 自定义固件 | Make 目标 |-| ---------- | :------------: | :--------: | ------------------------------------------------------------ |-| **常规版** | 41 个补丁 | 10 个阶段 | `fw_patch` + `cfw_install` |-| **开发版** | 52 个补丁 | 12 个阶段 | `fw_patch_dev` + `cfw_install_dev` |-| **越狱版** | 66 / 78 个补丁 | 14 个阶段 | `fw_patch_jb` + `cfw_install_jb` |+| 变体 | 启动链 | 自定义固件 | Make 目标 |+| ---------- | :--------: | :--------: | ---------------------------------- |+| **常规版** | 41 个补丁 | 10 个阶段 | `fw_patch` + `cfw_install` |+| **开发版** | 52 个补丁 | 12 个阶段 | `fw_patch_dev` + `cfw_install_dev` |+| **越狱版** | 112 个补丁 | 14 个阶段 | `fw_patch_jb` + `cfw_install_jb` |> 越狱最终配置(符号链接、Sileo、apt、TrollStore)通过 `/cores/vphone_jb_setup.sh` LaunchDaemon 在首次启动时自动运行。查看进度:`/var/log/vphone_jb_setup.log`。@@ -32,22 +32,42 @@**主机系统:** PV=3 虚拟化要求 macOS 15+(Sequoia)。-**禁用 SIP 和 AMFI** —— 需要私有的 Virtualization.framework 权限。+**配置 SIP/AMFI** —— 需要私有的 Virtualization.framework 权限和未签名二进制文件工作流。-重启到恢复模式(长按电源键),打开终端:+重启到恢复模式(长按电源键),打开终端,选择以下任一设置方式:-```bash-csrutil disable-csrutil allow-research-guests enable-```+- **方式 1:完全禁用 SIP + AMFI boot-arg(最宽松)**-重新启动回 macOS 后:+ 在恢复模式中:-```bash-sudo nvram boot-args="amfi_get_out_of_my_way=1 -v"-```+ ```bash+ csrutil disable+ csrutil allow-research-guests enable+ ```++ 重新启动回 macOS 后:++ ```bash+ sudo nvram boot-args="amfi_get_out_of_my_way=1 -v"+ ```++ 再重启一次。-再重启一次。+- **方式 2:保持 SIP 大部分启用,仅禁用调试限制,使用 [`amfidont`](https://github.com/zqxwce/amfidont)**++ 在恢复模式中:++ ```bash+ csrutil enable --without debug+ csrutil allow-research-guests enable+ ```++ 重新启动回 macOS 后:++ ```bash+ xcrun python3 -m pip install amfidont+ sudo amfidont --path [PATH_TO_VPHONE_DIR]+ ```**安装依赖:**@@ -65,6 +85,7 @@ git clone --recurse-submodules https://github.com/Lakr233/vphone-cli.git```bashmake setup_machine # 完全自动化完成"首次启动"流程(包含 restore/ramdisk/CFW)+# 选项:NONE_INTERACTIVE=1 SUDO_PASSWORD=...```## 手动设置@@ -132,6 +153,24 @@ make boot执行 `cfw_install_jb` 后,越狱变体在首次启动时将提供 **Sileo** 和 **TrollStore**。你可以使用 Sileo 安装 `openssh-server` 以获得 SSH 访问。+对于常规版/开发版,VM 会提供**直接控制台**。当看到 `bash-4.4#` 时,按回车并运行以下命令以初始化 shell 环境并生成 SSH 主机密钥:++```bash+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 服务器)会接受连接但立刻关闭,因为它没有密钥进行握手。+## 后续启动```bash@@ -141,14 +180,15 @@ make boot在另一个终端中启动 iproxy 隧道:```bash-iproxy 2222 22 # SSH(需要从 Sileo 安装 openssh-server)+iproxy 2222 22 # SSH(越狱版:需从 Sileo 安装 openssh-server;常规版/开发版:dropbear)iproxy 5901 5901 # VNCiproxy 5910 5910 # RPC```连接方式:-- **SSH:** `ssh -p 2222 [email protected]`(密码:`alpine`)+- **SSH(越狱版):** `ssh -p 2222 [email protected]`(密码:`alpine`)+- **SSH(常规版/开发版):** `ssh -p 2222 [email protected]`(密码:`alpine`)- **VNC:** `vnc://127.0.0.1:5901`- [**RPC:**](http://github.com/doronz88/rpc-project) `rpcclient -p 5910 127.0.0.1`@@ -158,11 +198,16 @@ iproxy 5910 5910 # RPC**问:运行时出现 `zsh: killed ./vphone-cli`。**-AMFI 未禁用。设置 boot-arg 并重启:+AMFI/调试限制未正确绕过。选择以下任一方式:-```bash-sudo nvram boot-args="amfi_get_out_of_my_way=1 -v"-```+- **方式 1(完全禁用 AMFI):**++ ```bash+ sudo nvram boot-args="amfi_get_out_of_my_way=1 -v"+ ```++- **方式 2(仅禁用调试限制):**+ 在恢复模式中使用 `csrutil enable --without debug`(不完全禁用 SIP),然后安装/加载 [`amfidont`](https://github.com/zqxwce/amfidont),保持 AMFI 其他功能不变。**问:系统应用(App Store、信息等)无法下载或安装。**@@ -180,6 +225,10 @@ sudo nvram boot-args="amfi_get_out_of_my_way=1 -v"重启虚拟机。SSH 服务器将在下次启动时自动启动。+**问:可以安装 `.tipa` 文件吗?**++可以。安装菜单同时支持 `.ipa` 和 `.tipa` 包。拖放或使用文件选择器即可。+**问:可以升级到更新的 iOS 版本吗?**可以。使用你想要的版本的 IPSW URL 覆盖 `fw_prepare`:diff --git a/sources/vphone-cli/VPhoneInstallPackage.swift b/sources/vphone-cli/VPhoneInstallPackage.swiftindex 4e872051..00b2a90f 100644--- a/sources/vphone-cli/VPhoneInstallPackage.swift+++ b/sources/vphone-cli/VPhoneInstallPackage.swift@@ -5,7 +5,7 @@ enum VPhoneInstallPackage {static let allowedContentTypes: [UTType] = [UTType(filenameExtension: "ipa"),UTType(filenameExtension: "tipa"),- ].compactMap { $0 }+ ].compactMap(\.self)static func isSupportedFile(_ url: URL) -> Bool {switch url.pathExtension.lowercased() {