Dopamine Exploit 框架完整解析:DOExploitManager 如何动态加载并选择 9 个漏洞利用

原创2026-11-12 16:12:391,660 阅读

Dopamine Exploit 框架完整解析:DOExploitManager 如何动态加载并选择 9 个漏洞利用

Dopamine 是一款面向 iOS 的 rootless 半脱离(semi-untethered)越狱工具,其核心亮点之一是用一个统一的 Exploit 管理框架,把 9 个独立编写的漏洞利用(内核漏洞、PAC 绕过、PPL/SPTM 绕过)以动态库(framework)形式打包进应用,由 DOExploitManager 在运行时自动扫描、筛选并按优先级选择最合适的一套组合来执行越狱。本文将带你通俗地理解这套"漏洞调度中心"的设计原理与工作流程。

Dopamine 越狱工具应用背景图:紫色沙丘,代表 Dopamine Exploit 框架主题

一、为什么 Dopamine 需要一套 Exploit 管理框架?

越狱本质上需要三把"钥匙",缺一不可:

  1. 内核漏洞利用(Kernel Exploit):突破内核隔离,获得内核读写(krw)能力;
  2. PAC 绕过(PAC Bypass):针对 A12 及以上芯片(arm64e)指令指针认证的限制(仅 iOS 15.2 以下需要);
  3. 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。它的做法像"清点库存":

  1. 遍历 App 包内 Frameworks/ 目录下的每个 framework;
  2. 读取其中的 Info.plist,如果含有 DPExploitType 键,就认定它是一个漏洞利用包;
  3. 遍历 DPExploitFlavors 里的每个 flavor,为每个 flavor 创建一个 DOExploit 对象;
  4. 为 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):

  1. 先从 DOPreferenceManager 读取用户偏好键(如 selectedKernelExploit);
  2. 若用户没选过、或所选漏洞在当前设备已不可用(系统升级后版本区间不匹配),自动回退到优先级最高的首选漏洞;
  3. 这套"偏好 + 自动降级"策略保证了 App 在 iOS 升级后依然能工作。

在设置界面(DOSettingsController.m)中,未越狱状态下会出现 "Exploits" 分组,提供 Kernel Exploit、PAC Bypass、PPL/SPTM Bypass 三个下拉菜单;DOPSExploitListItemsController.m 还会在推荐项后标注 "(Recommended)",方便普通用户无脑选择。

七、越狱主流程中的实际调用顺序

在 DOJailbreaker.m 的 doExploitation 方法中,可以看到完整的组合拳:

  1. 从管理器取出三个漏洞对象,并校验"必需项是否存在"(PAC 绕过仅 arm64e 且 iOS < 15.2 时需要,见 DOEnvironmentManager.m;PPL 绕过所有 arm64e 设备都需要,iOS 17 的 SPTM 设备则走 SPTM 绕过);
  2. 先跑内核漏洞:load + run,获得内核读写原语;
  3. 再跑 PAC 绕过:若失败,立即回滚清理内核漏洞;
  4. 最后跑 PPL/SPTM 绕过:失败则按逆序逐级清理;
  5. 全部成功后,由 buildPhysRWPrimitive 构建物理内存读写原语,再调用 cleanUpExploits(DOExploitManager.m#L149-L156)逆序释放所有活动漏洞,随后提升权限、脱离沙盒、注入 launchdhook 完成越狱。

这种"严格顺序 + 失败逆序回滚"的设计,是 Dopamine 越狱流程稳定性的关键保障。

八、总结:这套设计值得借鉴的 3 点

  1. 插件化架构:漏洞利用 = 独立 framework + Info.plist 声明式配置,新增漏洞零侵入;
  2. 声明式能力描述:版本区间、芯片白名单、构建号黑白名单全部写进配置,运行时自动检测,避免硬编码的机型判断散落各处;
  3. 优雅降级:用户偏好优先、优先级兜底、可用性失效自动回退,让同一个 App 包横跨 iOS 15 到 18 的不同机型都能"开箱即越狱"。

如果你想深入阅读实现,建议按以下顺序浏览源码:

Dopamine 越狱应用蓝色天空背景图,象征 Dopamine 漏洞利用框架的云端调度

登录后查看全文
Dopamine