# iOS 27 Tether-Jailbreak Kit（A12 / A13）

> 一套可在 **iPhone 11 系列（A13, t8030）** 上把 iOS 27 打成 **root + 内核读写** 的开源工具链。
> 链条：`usbliter8（SecureROM）→ pwn DFU → Liter8（语义化固件 patch）→ root / tfp0`。
> 只针对你本人拥有的设备。

---

## 0. 一句话原理

SecureROM 里的 USB 控制器有个低级 bug，用一块 **RP2350 单片机**在电气层打进去（普通 PC 的 USB 栈打不到），拿到 SecureROM 代码执行 →
设备进入 **pwn DFU**（序列号变成 `PWND:[...]`）→ 此后可以**送任意签名不合法的 iBSS/iBEC/ramdisk/kernelcache** →
`Liter8` 把官方 IPSW 里的每个组件**逐指令 patch** 成自定义固件 → 刷进去 → 开机即 root。

因为是 **bootrom 级**漏洞，Apple 发新版本修不了，只能靠新硬件；代价是 **tethered**：每次开机都要插着板子送一次引导链。

---

## 目录结构

```
ios27-jb-kit/
├── README.md                 本文件
├── LICENSE.liter8            Liter8 的 MIT 许可
├── docs/
│   ├── 01-usbliter8-原理.md   SecureROM 漏洞、RP2350、pwn DFU 协议
│   ├── 02-liter8-逆向笔记.md  resolver / 掩码指令 / tfp0 五站点 / fixture
│   └── 03-能力与排错.md       实测数据、能力矩阵、排错表、时间线
├── tools/
│   ├── liter8                主程序（40 MB）
│   ├── usbliter8ctl          pwned DFU 控制
│   ├── idevicerestore        erase restore
│   ├── ldid_macosx_arm64     重签
│   └── gtar / sshpass …
├── firmware/                 usbliter8 固件源码（RP2350 / RP2350-USB-A）
└── scripts/
    ├── 00-install-deps.sh
    ├── 01-prepare.sh         下载并解包 IPSW
    ├── 02-make-cfw.sh        构建 + 自检 CFW
    ├── 03-restore.sh         擦除刷机（清空设备）
    ├── 04-provision.sh       SSH ramdisk + bootstrap + rootfs
    ├── 05-boot.sh            日常开机（tethered）
    └── 06-ssh.sh             root shell
```

---

## 1. 支持矩阵

### 设备

| 机型 | board | 芯片 | 状态 |
|---|---|---|---|
| iPhone 11 | `n104ap` | A13 / t8030 | 主支持（作者实机） |
| iPhone 11 Pro | `d421ap` | A13 | experimental（有第三方 27.0.1 成功报告） |
| iPhone 11 Pro Max | `d431ap` | A13 | experimental |
| iPhone XS / XR（A12） | t8020/t8027 | A12 | exploit 支持，Liter8 暂无 profile |

> A12 也能被 usbliter8 打（exploit 里带 t8020 shellcode），但 Liter8 目前只写了 A13（t8030）的 patch plan。

### 系统

| iOS | build | 状态 |
|---|---|---|
| 27.0 beta 2 | `24A5370h` | 是（d421ap/d431ap） |
| 27.0 beta 4 | `24A5390f` | 是 |
| 27.0 / 27.0.1 | `24A435` / `24A437` / `24A446` | 同一套 plan（三者 iBSS/iBEC/SPTM/TXM 逐字节相同，kernel 偏移一致） |
| 27.2 beta 1–4 | `24B5084k` … `24B5110a` | 是 |
| 27.2 | `24B119` | 是 |

**签名是硬门槛。** `fw restore-cfw` 必须在恢复过程中向 Apple 抓一次 APTicket，
一旦停签就再也刷不进去。截至 2026-11-06：`24A446` 与 `24A437` **已停签**，`24B119` 仍在签。
所以今天要新建一台，只能走 **27.2**；27.0.1 只在 10 月中～11 月初那个窗口内有效。

---

## 2. 能力：能到什么程度

| 能力 | 有/无 | 说明 |
|---|---|---|
| root shell | 是 | SSH 2222，dropbear |
| 内核任意读写 | 是 | `tfp0` + `libkrw0-tfp0`，5 个 patch 站点把 `task_for_pid(0)` 打开 |
| 系统卷可写 | 是 | SSHRD 阶段 `prepare-rootfs` + `provision` 写 `/var/jb`，绕过 sealed volume 限制 |
| 包管理 | 是 | `/var/jb` 下 apt + Sileo，可装 deb |
| TrollStore | 是 | 可安装 IPA / 永久签名 |
| 注入 tweak | 部分 | ElleKit 可装，稳定性不如 vphone |
| 自定义内核 patch | 是 | 14 个 resolver，自己加 plan 即可 |
| **SEP / AKS** | 否 | 无 SEP → 无密码、无 Data 卷内容保护 |
| 蜂窝数据 / VoLTE | 否 | 基带能起、能注册网络、短信/通话走 WiFi Calling |
| Apple 服务 / 推送 | 否 | 缺 SEP 认证的 activation record，拿不到 push token |
| 关机后自动恢复 | 否 | tethered，必须插板重新引导 |

一句话：**这是一个"能 root、能读写内核、能装插件，但没有 SEP"的研究用越狱**，
不是给日常主力机用的成品。

---

## 3. 工具清单（`tools/`）

| 文件 | 作用 | 来源 |
|---|---|---|
| `liter8` | 主程序：解析 IPSW、重找 patch 站点、生成/校验/刷入 CFW、引导设备 | [Xplo8E/Liter8](https://github.com/Xplo8E/Liter8)（MIT） |
| `usbliter8ctl` | 在 pwned DFU 里发 `CUSTOM_BOOT`，把 iBSS 送进设备 | 同上（Liter8 内置） |
| `idevicerestore` | 执行 erase restore；由 Liter8 的 TSS 代理接管取票 | libimobiledevice（LGPL） |
| `ldid_macosx_arm64` | 重签 ramdisk 里的二进制 | procursus |
| `gtar` / `sshpass` | 打包 rootfs / 自动登录 | GNU / 社区 |
| `firmware/` | **usbliter8 固件源码**：RP2350 上跑的 SecureROM exploit | [JoshAtticus/usbliter8](https://github.com/JoshAtticus/usbliter8) · [ahmadkamal09999-tech/usbliter8](https://github.com/ahmadkamal09999-tech/usbliter8) |

`liter8` 是编译产物（40 MB，含 capstone），也可以自己编：

```sh
git clone --recurse-submodules https://github.com/Xplo8E/Liter8
cd Liter8 && make setup && make release     # → .build/release/liter8
```

---

## 4. 硬件要求

| 件 | 规格 |
|---|---|
| 攻击板 | **RP2350**（Waveshare RP2350 USB-A 或任意 RP2350 板） |
| 线 | **Lightning** 线（不能用 USB-C 线，针脚不同）；建议短 |
| 接线 | GPIO12 = D+，GPIO13 = D−，可改；板子的 R13 电阻可选拆除 |
| 主机 | macOS 14+ / Xcode CLT（Swift 6）；Linux 仅支持部分步骤 |

编译固件（`firmware/`）：

```sh
export PICO_SDK_PATH=/path/to/pico-sdk
cmake -B build -DPICO_BOARD=waveshare_rp2350_usb_a
cmake --build build -j
# 产物 build/usbliter8.uf2 拖进 BOOTSEL 模式的板子
```

---

## 5. 完整流程

```sh
export WORK_DIR=$PWD/work-24B119
export PATH=$PWD/tools:$PATH
```

### ① 装依赖

```sh
scripts/00-install-deps.sh
liter8 preflight          # 期望：all required host tools resolved
```

### ② 准备固件

```sh
scripts/01-prepare.sh     # 默认 iPhone12,1 / 24B119；可 DEVICE= BUILD= 覆盖
```

`fw prepare` 从 `BuildManifest.plist` 读版本（不看文件名），解包后对每个组件跑 `resolve`。

### ③ 构建 CFW（不碰设备，可反复跑）

```sh
scripts/02-make-cfw.sh
```

输出：patch 过的 iBSS / iBEC / kernelcache / TXM / devicetree + 重打包的 IPSW。
`verify-cfw` 会把每个站点按"原字节 → 补丁字节"再核一遍。

### ④ 擦除刷机（**会清空设备**）

设备进 pwn DFU（插板 → 自动打进去，序列号出现 `PWND:[...]`）：

```sh
scripts/03-restore.sh
```

内部顺序：检查 CFW → 起本地 TSS 代理 → `idevicerestore` 恢复 → 截获 APTicket 存成 `$WORK_DIR/apticket.im4m`。

### ⑤ 引导 SSH ramdisk 并安装 rootfs

```sh
scripts/04-provision.sh
```

依次：`get-rd` → `boot-rd`（再进一次 pwn DFU）→ `bootstrap`（解 `bootstrap_1900.tar.zst` 到 `/var/jb`）→
`prepare-rootfs`（挂 System/Data/Preboot）→ `provision`（部署 dropbear、launchd 服务缓存、注入载荷、Sileo、DNS 状态）→ `unmount-rootfs`。

### ⑥ 开机

```sh
scripts/05-boot.sh        # get-boot → pwn DFU → boot
```

### ⑦ 进系统

```sh
scripts/06-ssh.sh         # ssh -p 2222 root@127.0.0.1
```

进系统后 `apt update`、`sileo`、TrollStore 均可直接使用。

---

## 6. 它到底 patch 了什么（逆向要点）

`liter8 resolve --help` 列出的 plan 分四层：

**iBoot（iBSS/iBEC）**：跳过校验、改 boot-args、跳过 display init、忽略 pinot 失败 —— 让未签名镜像能被继续加载。

**Kernel（14 个）**：

| plan | 作用 |
|---|---|
| `restore` | 恢复模式相关路径 |
| `ppl-trust-cache` / `ppl-allow-invalid` | PPL 信任缓存放行 |
| `boot-policy` | 启动策略（nonce/ECID 绑定） |
| `aks` / `sep` / `sep-silence` | 无 SEP 环境下让 AKS 不阻断启动 |
| `credential-manager` | 凭据管理（KernelCredentialManager），让无 SEP 的 keychain 可用 |
| `sandbox` / `sandbox-public` | 沙箱规则打洞 |
| `valeria` | Valeria（屏幕/显示相关） |
| `exception-port` | 异常端口，调试器接入 |
| `vm-fault-cs-bypass` / `vm-map-protect` | 代码签名绕过、内存映射保护 |
| `boot-tfp0` | **核心**：打开 `task_for_pid(0)` |
| `diagnostic` | 诊断模式 |

**tfp0 的 5 个站点**（27.0/27.0.1 与 27.2 各自的偏移不同，但形状一致）：

| 站点 | 原始 | 补丁 | 语义 |
|---|---|---|---|
| `task-conversion` | `1f0009eb` | `ff031feb` | `CMP X0,X9` → `CMP XZR,XZR`，成功分支无条件 |
| `pid-zero` | `f7070034` | `1f2003d5` | `CBZ W7,reject` → `NOP`，pid 0 放行 |
| `kernel-map` | `41010054` | `0a000014` | `B.NE` → `B`，跳过 panic |
| `dyld-info-cave` | 56×`00` | `6893fed0…` | 在代码洞里写入 slide 返回桩 |
| `TASK_DYLD_INFO` | `88f241f9` | `51f41f14` | 跳进 cave，只对 `kernel_task` 返回 slide |

> 未加作用域版本会让**所有** task 的 dyld info 归零，进而 Settings 被 watchdog 杀、MobileKeyBag 卡死 ——
> 仓库里为此写了整整一篇排错记录。这是"能用"和"能开机"的分界线。

**TXM**：`boot-permissive`（任意签名、放宽 profile 信任、关 CS 强制、放开 task_for_pid），CoreTrust 仍然开。

**Userland**：`coreauthd` / `mobileactivationd` / `ctkd` / `asr` / `restored_external` —— 让无 SEP 的设备能过激活与配对。

---

## 7. 自己验证 / 加新版本（逆向工作流）

```sh
# 这个固件里所有 plan 能不能命中
liter8 survey work-24B119/extracted

# 单个组件、单个 plan，只打印不写
liter8 resolve kernel boot-tfp0 --input kernelcache.release.iphone12b

# 真的打补丁
liter8 apply kernel sandbox --input X --output Y

# 只读查询（找符号/字符串/xref，替代部分 IDA 操作）
liter8 inspect segments kernelcache
liter8 inspect xrefs 0x31b6640 kernelcache
liter8 inspect func  0x31b6640 kernelcache

# 把一次成功的解析固化成回归用例
liter8 fixture kernel boot-tfp0 kernelcache manifest.json \
        --device "iPhone 11" --board n104ap --build 24A446 \
        --component-name kernelcache.release.iphone12b

# 别人给的二进制，用它验证
liter8 verify manifest.json kernelcache
```

加一个新 build 的步骤：`survey` 看哪些 plan 挂了 → 用 `inspect` 定位新形状 →
在 `Sources/Liter8Core/Resolvers/Kernel/…` 里改 masked pattern 或加 `Site` →
`fixture` 生成清单 → 跑 `Tests/Liter8CoreTests` 回归。

详见 [docs/02-liter8-逆向笔记.md](docs/02-liter8-逆向笔记.md)。

---

## 8. 已知坑

| 症状 | 原因 | 处理 |
|---|---|---|
| 开机几分钟后黑屏重启 | `watchdogd` 打不开 `IOWatchdog`，连崩触发 launchd panic 策略 | 已由 `patch_watchdogd_job.py` 摘掉自动重启与 panic 升级 |
| USB 显示 Trust 但配对不完成 | `securityd` 缺 class-0 keychain 元数据 → coreauthd 空 ratchet buffer 崩 → policy 1028 返回 ACM `-3` | `provision` 内置三段 shim |
| Settings 打不开、`dyld info` 全 0 | 用了未加作用域的 TASK_DYLD_INFO patch | 必须用 `*_scoped` 版本 |
| Setup 卡住 | 无蜂窝数据，Setup 等网络 | 先拔 SIM，进桌面再插 |
| 重启后变砖（黑屏） | tethered，没送引导链 | 插板 `fw boot` |
| `restore-cfw` 报 TSS 错 | 该 build 已停签 | 换仍在签的 build |

---

## 9. 生态现状（2026-11）

- **Calif @ Hexacon 2026**：iPhone 18 Pro / iOS 27.0.1 的 untethered 越狱（TSS + cryptex + PAC 三层），
  **方法未公开**，无工具。这是私有链，与本文无关。
- **公开链（本 kit）**：`usbliter8`（A12/A13 bootrom）+ `Liter8`（固件 patch）。
  不需要 PAC/KRW 漏洞，纯 bootrom 降维打击，但 tethered、仅 A13。
- 中间层还有 `momentarius`（A12/A13 PPL bypass）、内核 DoS PoC（AVE2 / IOSurface UAF / HEVC），
  这些是"零件"，凑不成完整越狱。

---

## 10. 引用与许可

- Liter8 — MIT，© 2026 Vinay Kumar Rasala (Xplo8E)：`LICENSE.liter8`
- usbliter8 — 见 `firmware/` 原仓库
- idevicerestore / libimobiledevice — LGPL
- 本仓库的脚本与文档 — MIT

**免责**：仅在你自己拥有的设备上使用。刷机会清空数据、可能变砖，风险自担。
