Skip to content

Run a virtual iPhone on an Apple Silicon Mac.

Swift

docs: remove dropbear/cfw_install_jb_finalize references, update SSH instructions

Felipe Cavalcanti6df6db9159a6
diff --git a/README.md b/README.md
index b106c7a3..75d1077c 100644
--- a/README.md
+++ b/README.md
@@ -22,9 +22,9 @@ Three patch variants are available with increasing levels of security bypass:
| --------------- | :-------------: | :-------: | ------------------------------------------------------------ |
| **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` + `cfw_install_jb_finalize` |
+| **Jailbreak** | 66 / 78 patches | 14 phases | `fw_patch_jb` + `cfw_install_jb` |
-> `cfw_install_jb_finalize` requires booting into the full system, not the ramdisk.
+> 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`.
See [research/0_binary_patch_comparison.md](./research/0_binary_patch_comparison.md) for the detailed per-component breakdown.
@@ -151,40 +151,7 @@ Stop the DFU boot in terminal 1 (Ctrl+C), then:
make boot
```
-This gives you a **direct console** on the VM. 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.
-
-## *(optional) Finalize JB Patches*
-
-```bash
-# terminal 1 — keep running
-make boot # keep running
-```
-
-```bash
-# terminal 2 — keep running
-iproxy 22222 22222
-```
-
-```bash
-# terminal 3 — keep running
-make cfw_install_jb_finalize
-```
+After `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.
## Subsequent Boots
@@ -195,14 +162,14 @@ make boot
In a separate terminal, start iproxy tunnels:
```bash
-iproxy 22222 22222 # SSH
+iproxy 2222 22 # SSH (requires openssh-server from Sileo)
iproxy 5901 5901 # VNC
iproxy 5910 5910 # RPC
```
Connect via:
-- **SSH:** `ssh -p 22222 [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`
@@ -231,18 +198,13 @@ During iOS setup, do **not** select **Japan** or **European Union** as your regi
Connect via VNC (`vnc://127.0.0.1:5901`) and right-click anywhere on the screen (two-finger click on a Mac trackpad). This simulates the home button press.
-**Q: SSH connects but immediately closes (`Connection closed by 127.0.0.1`).**
+**Q: How do I get SSH access?**
-Dropbear host keys were not generated during first boot. Connect via VNC or the `make boot` console and run:
+Install `openssh-server` from Sileo (available on the jailbreak variant after first boot).
-```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
-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: SSH doesn't work after installing openssh-server.**
+
+Reboot the VM. The SSH server will start automatically on the next boot.
**Q: Can I update to a newer iOS version?**
diff --git a/docs/README_ja.md b/docs/README_ja.md
index a5cc9eb7..7d06ca5b 100644
--- a/docs/README_ja.md
+++ b/docs/README_ja.md
@@ -22,9 +22,9 @@ Apple の Virtualization.framework と PCC の研究用 VM インフラを使用
| ---------- | :------------: | :---------: | ------------------------------------------------------------ |
| **通常版** | 41 パッチ | 10 フェーズ | `fw_patch` + `cfw_install` |
| **開発版** | 52 パッチ | 12 フェーズ | `fw_patch_dev` + `cfw_install_dev` |
-| **脱獄版** | 66 / 78 パッチ | 14 フェーズ | `fw_patch_jb` + `cfw_install_jb` + `cfw_install_jb_finalize` |
+| **脱獄版** | 66 / 78 パッチ | 14 フェーズ | `fw_patch_jb` + `cfw_install_jb` |
-> `cfw_install_jb_finalize` はRAMディスクではなく、完全なシステムへの起動が必要です。
+> JB最終設定(シンボリックリンク、Sileo、apt、TrollStore)は `/cores/vphone_jb_setup.sh` LaunchDaemon により初回起動時に自動実行されます。進捗確認:`/var/log/vphone_jb_setup.log`。
詳細なコンポーネントごとの内訳については [research/0_binary_patch_comparison.md](../research/0_binary_patch_comparison.md) を参照してください。
@@ -130,40 +130,7 @@ make cfw_install
make boot
```
-これにより 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 ハンドシェイクを実行するためのキーがないためすぐに切断されます。
-
-## *(任意)JBパッチの最終適用*
-
-```bash
-# ターミナル 1 — 実行したままにする
-make boot # 実行したままにする
-```
-
-```bash
-# ターミナル 2 — 実行したままにする
-iproxy 22222 22222
-```
-
-```bash
-# ターミナル 3 — 実行したままにする
-make cfw_install_jb_finalize
-```
+`cfw_install_jb` 実行後、脱獄バリアントでは初回起動時に **Sileo** と **TrollStore** が利用可能になります。Sileo から `openssh-server` をインストールして SSH アクセスを有効にできます。
## 2回目以降の起動
@@ -174,14 +141,14 @@ make boot
別のターミナルで iproxy トンネルを開始します:
```bash
-iproxy 22222 22222 # SSH
+iproxy 2222 22 # SSH(Sileo から openssh-server のインストールが必要)
iproxy 5901 5901 # VNC
iproxy 5910 5910 # RPC
```
以下で接続します:
-- **SSH:** `ssh -p 22222 [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`
@@ -205,18 +172,13 @@ iOS の初期設定時に、地域として**日本**または**欧州連合**
VNC経由で接続し(`vnc://127.0.0.1:5901`)、画面の任意の場所を右クリック(Mac のトラックパッドでは 2 本指クリック)してください。これによりホームボタンの押下がシミュレートされます。
-**Q: SSH を接続した後にすぐ切断されます(`Connection closed by 127.0.0.1`)**
+**Q: SSH アクセスを有効にするには?**
-初回起動時にDropbearホストキーが生成されていません。VNC または `make boot` コンソール経由で接続し、以下を実行してください:
+Sileo から `openssh-server` をインストールしてください(脱獄バリアントの初回起動後に利用可能)。
-```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
-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: openssh-server をインストールしても SSH が動作しません。**
+
+VM を再起動してください。次回起動時に SSH サーバーが自動的に開始されます。
**Q: もっと新しいiOSバージョンにアップデートできますか?**
diff --git a/docs/README_ko.md b/docs/README_ko.md
index 3eaa8041..93e81c75 100644
--- a/docs/README_ko.md
+++ b/docs/README_ko.md
@@ -22,9 +22,9 @@ PCC 리서치 VM 인프라와 Apple의 Virtualization.framework를 사용하여
| -------- | :----------: | :-------: | ------------------------------------------------------------ |
| **일반** | 41 패치 | 10 페이즈 | `fw_patch` + `cfw_install` |
| **개발** | 52 패치 | 12 페이즈 | `fw_patch_dev` + `cfw_install_dev` |
-| **탈옥** | 66 / 78 패치 | 14 페이즈 | `fw_patch_jb` + `cfw_install_jb` + `cfw_install_jb_finalize` |
+| **탈옥** | 66 / 78 패치 | 14 페이즈 | `fw_patch_jb` + `cfw_install_jb` |
-> `cfw_install_jb_finalize`는 RAM 디스크가 아닌 전체 시스템으로 부팅해야 합니다.
+> JB 최종 설정(심볼릭 링크, Sileo, apt, TrollStore)은 `/cores/vphone_jb_setup.sh` LaunchDaemon을 통해 첫 번째 부팅 시 자동으로 실행됩니다. 진행 상황 확인: `/var/log/vphone_jb_setup.log`.
컴포넌트별 상세 분류는 [research/0_binary_patch_comparison.md](../research/0_binary_patch_comparison.md)를 참조하세요.
@@ -130,40 +130,7 @@ make cfw_install
make boot
```
-그러면 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 핸드셰이크를 수행할 키가 없어 즉시 연결을 종료합니다.
-
-## *(선택) JB 패치 마무리*
-
-```bash
-# 터미널 1 — 계속 실행 유지
-make boot # 계속 실행 유지
-```
-
-```bash
-# 터미널 2 — 계속 실행 유지
-iproxy 22222 22222
-```
-
-```bash
-# 터미널 3 — 계속 실행 유지
-make cfw_install_jb_finalize
-```
+`cfw_install_jb` 실행 후 탈옥 변형은 첫 번째 부팅 시 **Sileo**와 **TrollStore**를 사용할 수 있습니다. Sileo에서 `openssh-server`를 설치하여 SSH 접근을 활성화할 수 있습니다.
## 이후 부팅
@@ -174,14 +141,14 @@ make boot
별도의 터미널에서 iproxy 터널을 시작합니다:
```bash
-iproxy 22222 22222 # SSH
+iproxy 2222 22 # SSH (Sileo에서 openssh-server 설치 필요)
iproxy 5901 5901 # VNC
iproxy 5910 5910 # RPC
```
다음을 통해 연결합니다:
-- **SSH:** `ssh -p 22222 [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`
@@ -205,18 +172,13 @@ iOS 초기 설정 시 지역을 **일본** 또는 **유럽 연합**으로 선택
VNC(`vnc://127.0.0.1:5901`)로 접속하여 화면의 아무 곳이나 우클릭(Mac 트랙패드에서는 두 손가락 클릭)하세요. 이것이 홈 버튼 누르기를 시뮬레이션합니다.
-**Q: SSH가 연결되자마자 종료됩니다 (`Connection closed by 127.0.0.1`).**
+**Q: SSH 접근을 활성화하려면?**
-첫 부팅 시 Dropbear 호스트 키가 생성되지 않았습니다. VNC나 `make boot` 콘솔을 통해 연결하여 다음을 실행하세요:
+Sileo에서 `openssh-server`를 설치하세요 (탈옥 변형 첫 부팅 후 사용 가능).
-```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
-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: openssh-server를 설치했는데 SSH가 작동하지 않습니다.**
+
+VM을 재부팅하세요. 다음 부팅 시 SSH 서버가 자동으로 시작됩니다.
**Q: 최신 iOS 버전으로 업데이트할 수 있나요?**
diff --git a/docs/README_zh.md b/docs/README_zh.md
index 7e7075dd..63628836 100644
--- a/docs/README_zh.md
+++ b/docs/README_zh.md
@@ -22,9 +22,9 @@
| ---------- | :------------: | :--------: | ------------------------------------------------------------ |
| **常规版** | 41 个补丁 | 10 个阶段 | `fw_patch` + `cfw_install` |
| **开发版** | 52 个补丁 | 12 个阶段 | `fw_patch_dev` + `cfw_install_dev` |
-| **越狱版** | 66 / 78 个补丁 | 14 个阶段 | `fw_patch_jb` + `cfw_install_jb` + `cfw_install_jb_finalize` |
+| **越狱版** | 66 / 78 个补丁 | 14 个阶段 | `fw_patch_jb` + `cfw_install_jb` |
-> `cfw_install_jb_finalize` 需要启动到完整系统,而非 ramdisk。
+> 越狱最终配置(符号链接、Sileo、apt、TrollStore)通过 `/cores/vphone_jb_setup.sh` LaunchDaemon 在首次启动时自动运行。查看进度:`/var/log/vphone_jb_setup.log`。
详见 [research/0_binary_patch_comparison.md](../research/0_binary_patch_comparison.md) 了解各组件的详细分项对比。
@@ -130,40 +130,7 @@ make cfw_install
make boot
```
-这会为你提供 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
-# 终端 1 —— 保持运行
-make boot # 保持运行
-```
-
-```bash
-# 终端 2 —— 保持运行
-iproxy 22222 22222
-```
-
-```bash
-# 终端 3 —— 保持运行
-make cfw_install_jb_finalize
-```
+执行 `cfw_install_jb` 后,越狱变体在首次启动时将提供 **Sileo** 和 **TrollStore**。你可以使用 Sileo 安装 `openssh-server` 以获得 SSH 访问。
## 后续启动
@@ -174,14 +141,14 @@ make boot
在另一个终端中启动 iproxy 隧道:
```bash
-iproxy 22222 22222 # SSH
+iproxy 2222 22 # SSH(需要从 Sileo 安装 openssh-server)
iproxy 5901 5901 # VNC
iproxy 5910 5910 # RPC
```
连接方式:
-- **SSH:** `ssh -p 22222 [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`
@@ -205,18 +172,13 @@ sudo nvram boot-args="amfi_get_out_of_my_way=1 -v"
通过 VNC (`vnc://127.0.0.1:5901`) 连接,并在屏幕上右键单击任意位置(在 Mac 触控板上双指点击)。这会模拟 Home 按钮按下。
-**问:SSH 连接后立即关闭(`Connection closed by 127.0.0.1`)。**
+**问:如何获得 SSH 访问?**
-首次启动时未生成 dropbear 主机密钥。通过 VNC 或 `make boot` 控制台连接并运行:
+从 Sileo 安装 `openssh-server`(越狱变体首次启动后可用)。
-```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
-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
-```
+**问:安装 openssh-server 后 SSH 无法使用。**
+
+重启虚拟机。SSH 服务器将在下次启动时自动启动。
**问:可以升级到更新的 iOS 版本吗?**