Dopamine Exploit 框架完整解析:DOExploitManager 如何动态加载并选择 9 个漏洞利用
Dopamine Exploit 框架完整解析:DOExploitManager 如何动态加载并选择 9 个漏洞利用
Dopamine 是一款面向 iOS 的 rootless 半脱离(semi-untethered)越狱工具,其核心亮点之一是用一个统一的 Exploit 管理框架,把 9 个独立编写的漏洞利用(内核漏洞、PAC 绕过、PPL/SPTM 绕过)以动态库(framework)形式打包进应用,由 DOExploitManager 在运行时自动扫描、筛选并按优先级选择最合适的一套组合来执行越狱。本文将带你通俗地理解这套"漏洞调度中心"的设计原理与工作流程。
一、为什么 Dopamine 需要一套 Exploit 管理框架?
越狱本质上需要三把"钥匙",缺一不可:
- 内核漏洞利用(Kernel Exploit):突破内核隔离,获得内核读写(krw)能力;
- PAC 绕过(PAC Bypass):针对 A12 及以上芯片(arm64e)指令指针认证的限制(仅 iOS 15.2 以下需要);
- PPL / SPTM 绕过:绕过内核指针认证(PPL),iOS 17 的 SPTM 安全子系统则需对应的 SPTM 绕过。
不同 iOS 版本、不同芯片对漏洞的可用性各不相同。如果把这些逻辑硬编码在 App 里,每支持一个新版本都要大改代码。Dopamine 的解法非常优雅:每个漏洞利用是一个独立的 framework,App 启动时扫描、识别、按规则挑选。这套设计的核心就是 DOExploitManager.m 和 DOExploit.m 两个文件。
二、9 个漏洞利用一览:谁负责什么?
在 project.pbxproj 的 "Embed Frameworks" 构建阶段可以看到,App 内嵌了整整 9 个漏洞 framework,源码分别位于 Application/Dopamine/Exploits/ 目录下:
| 漏洞利用 | 类型 | 优先级 | 源码位置 | 说明 |
|---|---|---|---|---|
| kfd | Kernel | 最高 1000(physpuppet flavor) | Exploits/kfd/ | 覆盖 iOS 15~16 主力机型,含 3 个"变种" |
| multicast_bytecopy | Kernel | 950 | Exploits/multicast_bytecopy/ | 利用 IOGPU 多播拷贝漏洞 |
| ClearSword | Kernel | 895 | Exploits/ClearSword/ | 面向新版 iOS 的内核利用 |
| DarkSword | Kernel | 890 | Exploits/DarkSword/ | ClearSword 的姊妹实现 |
| weightBufs | Kernel | 800 | Exploits/weightBufs/ | 利用 ANE 神经引擎权重缓冲漏洞 |
| badRecovery | PAC | 1000 | Exploits/badRecovery/ | A12/A13 老版本的 PAC 绕过 |
| dmaFail | PPL | 1000 | Exploits/dmaFail/ | 基于 DMA 的 PPL 绕过 |
| Titan | PPL | 999 | Exploits/Titan/ | A14~A17 机型的 PPL 绕过 |
| momentarius | PPL | 999 | Exploits/momentarius/ | A12/A13 机型的 PPL 绕过 |
💡 注意:kfd 一个 framework 里定义了 3 个 flavor(变种):
landa(900)、physpuppet(1000)、smith(600),分别针对不同的 iOS 版本区间,相当于"一套代码,多种口味"。
三、动态加载第一步:扫描 Frameworks 目录
DOExploitManager 是一个单例(通过 sharedManager 获取),初始化时会自动调用 _loadAvailableExploits。它的做法像"清点库存":
- 遍历 App 包内
Frameworks/目录下的每个 framework; - 读取其中的
Info.plist,如果含有DPExploitType键,就认定它是一个漏洞利用包; - 遍历
DPExploitFlavors里的每个 flavor,为每个 flavor 创建一个 DOExploit 对象; - 为 Kernel、PAC、PPL 三种类型各自选出优先级最高的一个,缓存为"首选漏洞"(
preferredKernelExploit、preferredPACBypass、preferredPPLBypass)。
相关代码见 DOExploitManager.m 中的 _loadAvailableExploits 方法。
以 Exploits/kfd/Info.plist 为例,plist 用声明式配置描述了这个利用包的全部"身份证":
DPExploitType = Kernel:声明类型;DPExploitFlavors:定义 landa / physpuppet / smith 三个 flavor 及各自的DPFlavorPriority优先级;DPSupportedRanges:声明支持的 iOS 版本区间(如 physpuppet 支持 15.0–15.7.3 与 16.0–16.3.1)。
这种"配置即能力"的设计意味着:新增一个漏洞利用,只需新增一个 framework + 写好 Info.plist,无需修改管理器的任何代码,扩展性极强。
四、支持性检测:三步筛选出"适合我的"漏洞
不是所有漏洞都能在你的设备上用。DOExploit.m 的 isSupported 方法会做三重检测(结果缓存,只检测一次):
① 版本区间检测 —— 通过 sysctlbyname("kern.osversion", ...) 获取 iOS 版本,与 plist 中的 DPSupportedRanges(Start/End 区间列表)逐一比对;
② 芯片/机型检测 —— 通过 hw.cpufamily 把设备映射到 A8~A17,再与 DPSupportedDevices 列表比对。例如 Exploits/Titan/Info.plist 只声明支持 A14/A15/A16/A17;
③ 构建号白/黑名单 —— DPSupportInclude 表示"仅这些构建号可用",DPSupportInclude 与 DPSupportExclude 配合可以精确到单个构建版本(如 ClearSword 仅在 23B5044l 等 Corellium 构建号下启用)。
只有三步全部通过的漏洞,才会出现在 availableExploitsForType: 返回的可用集合里。
五、执行阶段:load → run → cleanup 的 C ABI 契约
管理器和漏洞利用之间的通信非常简洁——每个漏洞 framework 内部必须导出两个 C 函数,DOExploit 通过 dlopen / dlsym 动态查找并调用:
load:dlopen加载漏洞 framework 的可执行文件(DOExploit.m#L195-L202);run:查找exploit_init符号并传入 flavor 名称,成功后把该漏洞加入activeExploits活动列表(DOExploit.m#L204-L212);cleanup:查找exploit_deinit符号执行清理,并从活动列表移除。
以 Exploits/momentarius/momentarius.m 等任一漏洞包为例,其导出接口都是这个统一形态——这就是整套框架"插件化"的关键契约。
六、选择逻辑:用户偏好优先,优先级兜底
真正决定"用哪个"的逻辑在 selectedKernelExploit 等三个只读属性中(DOExploitManager.m#L122-L147):
- 先从
DOPreferenceManager读取用户偏好键(如selectedKernelExploit); - 若用户没选过、或所选漏洞在当前设备已不可用(系统升级后版本区间不匹配),自动回退到优先级最高的首选漏洞;
- 这套"偏好 + 自动降级"策略保证了 App 在 iOS 升级后依然能工作。
在设置界面(DOSettingsController.m)中,未越狱状态下会出现 "Exploits" 分组,提供 Kernel Exploit、PAC Bypass、PPL/SPTM Bypass 三个下拉菜单;DOPSExploitListItemsController.m 还会在推荐项后标注 "(Recommended)",方便普通用户无脑选择。
七、越狱主流程中的实际调用顺序
在 DOJailbreaker.m 的 doExploitation 方法中,可以看到完整的组合拳:
- 从管理器取出三个漏洞对象,并校验"必需项是否存在"(PAC 绕过仅 arm64e 且 iOS < 15.2 时需要,见 DOEnvironmentManager.m;PPL 绕过所有 arm64e 设备都需要,iOS 17 的 SPTM 设备则走 SPTM 绕过);
- 先跑内核漏洞:
load+run,获得内核读写原语; - 再跑 PAC 绕过:若失败,立即回滚清理内核漏洞;
- 最后跑 PPL/SPTM 绕过:失败则按逆序逐级清理;
- 全部成功后,由
buildPhysRWPrimitive构建物理内存读写原语,再调用cleanUpExploits(DOExploitManager.m#L149-L156)逆序释放所有活动漏洞,随后提升权限、脱离沙盒、注入 launchdhook 完成越狱。
这种"严格顺序 + 失败逆序回滚"的设计,是 Dopamine 越狱流程稳定性的关键保障。
八、总结:这套设计值得借鉴的 3 点
- 插件化架构:漏洞利用 = 独立 framework + Info.plist 声明式配置,新增漏洞零侵入;
- 声明式能力描述:版本区间、芯片白名单、构建号黑白名单全部写进配置,运行时自动检测,避免硬编码的机型判断散落各处;
- 优雅降级:用户偏好优先、优先级兜底、可用性失效自动回退,让同一个 App 包横跨 iOS 15 到 18 的不同机型都能"开箱即越狱"。
如果你想深入阅读实现,建议按以下顺序浏览源码:
- 管理器主体:DOExploitManager.m
- 漏洞基类与 C ABI 契约:DOExploit.m
- 各漏洞的声明式配置:Exploits/kfd/Info.plist、Exploits/ClearSword/Info.plist
- 调用方(越狱主流程):DOJailbreaker.m

