Files

152 lines
10 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 并建立默认豁免名单。