# iOS 混淆加固工具(iOSGuard)技术全景与实现路线图 本路线图对标 **小蟹 iOS 混淆 (Crab iOS)** 核心架构与功能体系,针对 iOS 应用的 **App Store 过审差异化(应对 4.3 / 2.3.1 审查)** 和 **应用代码安全加固(防逆向 / 防 Dump / 防重打包)** 需求,制定从 0 到 1 的工程实现方案。 --- ## 一、 系统架构全景 Crab iOS 并非单纯的源码文本替换工具,而是一套**“LLVM IR 级编译加固 + 源码预处理 + 运行时动态桥接 (COSDK) + 资产透明加密 + dSYM 逆向还原 + IPA 差异度度量”**的复合系统。 ```mermaid flowchart TD subgraph Input["输入工程"] A1["Objective-C / Swift / C / C++ 源码"] A2["Unity (IL2CPP) / Flutter (Dart) / Cocos"] A3["资源文件 (.png / .storyboard / .bundle / .xcassets)"] A4["静态依赖 (.a / static .framework / .xcframework)"] end subgraph PreProcess["源码与工程预处理层 (AST & Project Rewriter)"] B1["PBXProject / xcconfig 自动化注入"] B2["符号提取与静态分析 (AST Parsing)"] B3["源码代码膨胀 (Junk Code / 假调用)"] B4["Dart / Unity IL2CPP 前置特征擦除"] end subgraph CompilerPass["LLVM 编译级加固引擎 (Compiler Toolchain / Clang Plugin)"] C1["字符串常量动态加密 Pass"] C2["控制流平坦化 (Control Flow Flattening)"] C3["虚假控制流 (Bogus Control Flow) 与指令替换"] C4["Objective-C Selector / Method 加密 Pass"] C5["防 Class-Dump 结构抹除"] end subgraph RuntimeBridge["运行时支撑框架 (COSDK)"] D1["C API 拦截 (Fishhook: open, stat, access)"] D2["ObjC Runtime 反射桥接 (NSClassFromString / sel_registerName)"] D3["内存透明资源解密 (In-Memory Asset Decryption)"] D4["随机特征签名隔离 (Per-Build Unique Fingerprint)"] end subgraph BinaryPostProcess["产物后处理与双符号表还原"] E1["Mach-O 二进制混淆 (Section 混淆 / 符号 Strip)"] E2["资源哈希混淆 (破坏文件哈希 / 元数据注入)"] E3["双符号表数据库构建 (Mapping DB)"] E4["dSYM 反向还原引擎 (适配 Bugly / Crashlytics / Sentry)"] end subgraph Analysis["质量与过审检测中心"] F1["IPA 对比与特征相似度评估 (SSDEEP / AST Diff / 4.3 预检)"] F2["Xcode Debug 联调辅助与符号映射支持"] end Input --> PreProcess PreProcess --> CompilerPass CompilerPass --> RuntimeBridge CompilerPass --> BinaryPostProcess RuntimeBridge --> BinaryPostProcess BinaryPostProcess --> Analysis ``` --- ## 二、 核心子系统关键技术方案 ### 1. 语言与符号混淆子系统 (AST & LLVM) * **符号重命名策略**: * 支持类名 (Class)、分类名 (Category)、协议 (Protocol)、属性 (Property)、实例变量 (Ivar)、方法名/选择器 (Selector)、全局函数、结构体、枚举。 * **符号库隔离策略 (Symbol Profiles)**:维护不同的随机伪随机种子库与词典库,确保同一份源码使用不同策略编译出的符号特征完全隔离。 * **黑白名单排除机制**:支持系统 API 继承链自动穿透分析(如继承自 `UITableViewCell`、遵从 `NSCoding` 协议的类成员必须排除)、支持 KVC/JSON 反序列化(`YYModel` / `MJExtension`)通用规则排除。 * **常量与字符串加密 (LLVM IR Pass)**: * 在 LLVM IR 阶段匹配全局字符串(`ConstantDataSequential`),将其替换为加密数组,并在每个函数入口或 `.init_array` / `+load` 动态解密,防止 IDA / Hopper 静态分析直接搜索到敏感 URL、Key 或特征字。 * **调用栈混淆与代码膨胀**: * 插入多层蹦床代理函数(Trampoline Calls)、不透明谓词(Opaque Predicates)与无害控制流分支。 * 混淆调用栈(Call Stack),破坏调用拓扑,使得 Apple 静态代码相似度对比(AST 树结构比对)无法匹配。 ### 2. 运行时拦截与支撑库 (COSDK) * **动态反射修复**: * 当符号被重命名后,运行时的动态反射调用(如 `NSClassFromString(@"UserViewController")`、`NSSelectorFromString(@"clickLogin:")`)默认会返回 `nil`。 * COSDK 注入动态映射表,使用 `fishhook` 拦截 C 运行时及 Method Swizzling 拦截 ObjC Runtime API: * `objc_getClass` / `NSClassFromString` * `NSStringFromClass` / `NSStringFromSelector` * `sel_registerName` / `NSSelectorFromString` * `class_getInstanceMethod` / `class_getMethodImplementation` * 拦截后自动执行“原始符号 ↔ 混淆符号”的双向查表转换,保证业务反射逻辑完全正常。 * **SDK 每次打包特征隔离**: * 运行时支撑库(COSDK)每次构建时动态随机命名库文件名、重构内部函数符号、生成随机校验密钥,防止 Apple 将加固 SDK 本身标记为“马甲包公共特征”。 ### 3. 资源文件混淆与透明解密 * **资源名混淆与代码关联重写**: * 提取 `.png`、`.jpg`、`.webp`、`.plist`、`.json`、`.sks` 等资源,生成混淆文件名(如 `a8f9b2c.png`)。 * 自动化遍历扫描与改写: * 代码中的硬编码字符串 `[UIImage imageNamed:@"old_icon"]`。 * `.storyboard`、`.xib`、`.xcassets` 的引用关系。 * **文件哈希混淆 (Hash Distortion)**: * 针对免加密的静态图片资源,修改 PNG 的自定义无用 Chunk(如增加 `tEXt` 随机注释)或尾部无害填充字节,确保文件 MD5/SHA256 改变,但图像显示完全一致。 * **深度资源加密与虚拟文件系统 Hook**: * 资源采用高强度流加密(如 ChaCha20/AES-CTR)加密存放在 Bundle 中。 * 运行时在底层拦截 POSIX 文件 API:`open`、`fopen`、`stat`、`lstat`、`access` 以及 Cocoa 层 `[NSBundle pathForResource:ofType:]`、`[NSData dataWithContentsOfFile:]`、`[UIImage imageNamed:]`,在内存流中即时解密,外部工具无法解压直接提取。 ### 4. 双符号表策略与 dSYM 崩溃还原 (Crash Restoration) * **痛点**:源码符号被混淆后,上架 App 产生的崩溃日志通过 Bugly、Firebase Crashlytics、Sentry 解析出来的全是一串乱码(如 `a8b9c()`),严重阻碍生产运维。 * **解决技术路径**: 1. 编译混淆时输出全局符号双向映射映射表:`mapping.json / mapping.db`(记录 `OriginalSymbol -> ObfuscatedSymbol` 及其签名、文件名)。 2. 生成两份 dSYM 文件: * **混淆 dSYM**:匹配 App Store 提审的 Mach-O,用于苹果机审或基础定位。 * **还原工具 / 还原后的 dSYM**:读取原始 DWARF 调试节,利用 `llvm-dwarfdump` / 自研 DWARF 重构器,遍历 `.debug_info`、`.debug_str`,将里面的混淆符号批量替换回原始符号。 3. 还原后的 dSYM 可直接上传至 Bugly / Sentry,实现线上崩溃栈无感还原。 ### 5. 跨跨端框架专项适配 (Flutter / Unity / Cocos) * **Flutter / Dart**: * Dart AOT 编译成 `App.framework` 中的快照(Snapshot 二进制代码段),传统 LLVM 无法直接处理 Dart 符号。 * 采用“Dart 源码前置 AST 处理”与“Dart 方法转发”方案,混淆 Dart 类名与方法名,并阻断 Dart 与原生通信的 MethodChannel 字符串特征。 * **Unity (IL2CPP)**: * Unity 导出为 Xcode 工程后,核心 C# 代码已转为 C++(`Classes/Native` 目录)。 * 直接利用 C/C++ 语言混淆能力与控制流加固,对 IL2CPP 生成的 C++ 函数符号、元数据字符串表格、全局结构体进行混淆。 * **Cocos / Cocos2d-x / Quick-Cocos**: * 混淆 C++ 底层驱动层,并对 JS/Lua 脚本资产进行加密打包与 Loader 注入解密。 ### 6. 马甲包与 4.3 审核对抗分析器 (IPA Diff Tool) * **Mach-O 静态分析**:分析 `__TEXT,__text` 段机器码相似度(采用 SSDEEP 模糊哈希、TLSH、SimHash)。 * **符号表相似度**:导出符号表(Exports / Imports / Objective-C Class Ro/Rw),计算 Jaccard 相似度。 * **资产重复度检测**:对比图片直方图、感知哈希(pHash)、结构相似度(SSIM)。 * **自动化生成风控报告**:量化输出与母包/前置版本的相似百分比,低于安全阈值(如 < 30% 相似度)方可提审。 --- ## 三、 分阶段实施路线图 (Phase 1 ~ Phase 5) | 阶段 | 周期 | 核心目标 | 交付产物 | | :--- | :--- | :--- | :--- | | **Phase 1: 基础工程体系与基础符号/资源混淆 (MVP)** | 4~6 周 | 跑通 Xcode 工程解析、基础符号重命名、资源重命名与 Hash 扰动、简单的 ObjC 反射拦截 | 基础 CLI 工具、可混淆纯 ObjC/Swift 工程并在真机运行通过 | | **Phase 2: LLVM 编译级加固核心 (定向加固)** | 6~8 周 | 搭建定制 Clang 插件/Toolchain,实现控制流平坦化、虚假控制流、常量字符串加密、防 Dump | 独立编译插件、集成至 Xcode Target 的加固能力 | | **Phase 3: 运行时支撑 (COSDK) 与透明解密** | 4~6 周 | 完善动态库/静态库运行时 SDK,完成 C/ObjC API 全量 Hook,实现文件透明加解密 | 生产级 COSDK 库、动态特征重签名器 | | **Phase 4: 双符号表 dSYM 还原与生态适配** | 4~6 周 | 攻克 DWARF 调试节符号还原、打通 Unity/Flutter/Cocos 适配流程 | dSYM 还原工具、跨跨端构建脚本与配置模板 | | **Phase 5: IPA 相似度分析工具与桌面客户端** | 4~6 周 | 研发基于 Qt / Electron / SwiftUI 的跨平台客户端,集成 IPA 相似度比对引擎 | 桌面应用 (GUI)、完整商业化闭环、自动化测试套件 | --- ## 四、 核心技术难点与规避策略 1. **Apple 审核红线规避 (2.5.2 / 2.3.1 / 3.3.1)** * 严禁引入已知的私有 API(Private Frameworks / Undocumented Selectors)。 * 严禁使用动态下载执行机器码(JIT / Dynamic Executable Memory)。 * 加固支撑库本身的代码特征必须**每次打包均动态生成**,避免成为苹果机审黑名单特征。 2. **Swift 静态派发与 Name Mangling 兼容** * Swift 5+ 具备稳定的 ABI,符号名有严格的 Mangling 规则(如 `_$s...`)。 * 对 Swift 处理时,优先在 AST 层面或中间文件处理,并处理好 `@objc` 桥接方法与模块导出接口。 3. **运行时崩溃与第三方库冲突** * 严禁盲目混淆第三方成熟开源库(如 AFNetworking, SDWebImage, Masonry 等),否则反而会增加相似度聚集特征,且极易引发系统调用崩溃。 * 必须内置智能扫描器,自动识别 Pods / Carthage / SPM 并建立默认豁免名单。