# iOSGuard:企业级 iOS 加固与安全防护系统完整实现方案
---
## 方案定位与设计目标
本项目(代号 **iOSGuard**)融合 **小蟹加固(Crab iOS)** 的“App Store 审核对抗、差异化混淆、dSYM 崩溃还原”与 **网易易盾(NetEase YiDun)** 的“Mach-O 深度加固、原生代码虚拟化 (VMP)、全维度主动防御、无源码 IPA 二进制处理与跨平台重签名”能力,构建一套工业级双模加固平台:
1. **双加固入口**:
* **源码级加固(Compiler Pipeline)**:对接 Xcode,通过 LLVM Pass 实施深度混淆与代码虚拟化。
* **无源码 IPA 加固(Binary Pipeline)**:直接上传打好的 `.ipa` 包,由 Mach-O 重构引擎进行二进制级加固与自动重签名。
2. **零运行时破坏**:通过双符号表与 DWARF 重构技术,完全兼容 Bugly / Crashlytics / Sentry 等线上崩溃收集;通过智能反射桥接保证 KVC/JSON 反序列化零闪退。
3. **App Store 提审合规**:不依赖 JIT 动态内存分配,完全满足苹果 AMFI 代码签名、W^X 内存防护以及 App Review Guidelines 审核要求。
---
## 一、 系统总体架构与工作流
```mermaid
flowchart TD
subgraph Input["1. 输入层 (Input)"]
In1["源码工程 (Xcode / Flutter / Unity / Cocos)"]
In2["已打包无源码 IPA (Binary Input)"]
In3["开发者证书与描述文件 (.p12 / .mobileprovision)"]
end
subgraph Pipeline["2. 加固调度核心流水线 (Guard Orchestrator)"]
P1["工程解析与 xcconfig / Build Phase 自动化注入"]
P2["IPA 解包与 Mach-O 静态解构器"]
P3["加固策略配置路由器 (Rules & Exclusions Engine)"]
end
subgraph Engines["3. 核心加固与对抗引擎"]
direction TB
E1["Mach-O 二进制重构器\n(Header扩容 / 段平移 / LC_LOAD_DYLIB 注入)"]
E2["Class-Dump 彻底抹除\n(__objc_methname 清空 / 动态重映射)"]
E3["代码虚拟化 (VMP) 引擎\n(ARM64 抽离 / 自定义字节码 / 解释器)"]
E4["LLVM 编译混淆 Pass\n(控制流平坦化 / 虚假分支 / 字符串加密)"]
E5["主动防御内核 (Defender Core)\n(SVC内联反调试 / 反Hook / 反Frida / 越狱感知)"]
E6["资源与游戏资产保护\n(PNG Hash扰动 / 深度透明解密 / Unity IL2CPP)"]
end
subgraph RestoreAndSign["4. 恢复与重签发布引擎"]
R1["双符号表与 dSYM 崩溃逆向还原 (DWARF 重写)"]
R2["跨平台重签名流水线 (Linux zsign / macOS codesign, DER 支持)"]
R3["IPA 4.3 相似度静态预检 (SSDEEP / 符号比对 / 风险报告)"]
end
subgraph Output["5. 交付产物 (Output)"]
Out1["加固且重签名后 IPA (可直接提审 / 分发)"]
Out2["还原后 dSYM 文件 (上传崩溃分析平台)"]
Out3["加固与安全审计报告 (PDF / HTML)"]
end
Input --> Pipeline
Pipeline --> Engines
Engines --> RestoreAndSign
RestoreAndSign --> Output
```
---
## 二、 八大核心子系统详细实现方案
### 1. Mach-O 深度重构与二进制引擎 (Mach-O Rewriter)
* **模块目标**:在不依赖源码的前提下,解析并重写 IPA 主 Mach-O 及动态库,插入防护逻辑。
* **关键算法与技术点**:
1. **Header 扩容与段平移算法**:
* 读取 `mach_header_64`,计算 `sizeofcmds`。
* 检测 `load_commands` 结束位置与首个 Section(通常为 `__TEXT,__text`)之间的空白填充(Padding)。
* 若 Padding $\ge sizeof(dylib\_command)$,直接原地追加 `LC_LOAD_DYLIB` 指令,并递增 `ncmds` 和 `sizeofcmds`。
* 若 Padding 不足,触发**全局平移(Segment Shift)**:将首个 Section 起始偏移向后推移一个页面对齐大小(ARM64 为 `0x4000` / 16KB),递归修复所有后续 Segment/Section 的 `fileoff`、`offset`,以及重定位表、导出树(Export Trie)与符号表偏移。
2. **新增私有防护段 (`__PROTECT`)**:
* 写入一个全新的 `LC_SEGMENT_64`,段名为 `__PROTECT`,权限设为 `VM_PROT_READ`。
* 确保其 `fileoff` 与 `vmaddr` 严格满足 `0x4000`(16KB)对齐。
* 用于存放抽取出的加密代码、加密 Objective-C 元数据及白盒秘钥表。
3. **修复 `LC_CODE_SIGNATURE` 边界**:
* 修改前先抹除旧签名指令,加固完成后将 `LC_CODE_SIGNATURE` 重新定位至文件尾部。
### 2. Class-Dump 彻底防御与动态重映射 (Metadata Protector)
* **模块目标**:让 `class-dump`、`dscli`、IDA、Hopper 无法导出任何业务类名、属性名和方法名。
* **加固实现链路**:
1. **静态扫描与元数据序列化**:
* 定位 `__DATA,__objc_classlist` 段,遍历每个 `objc_class` 结构体,沿着指针提取 `class_ro_t`:
* `const char *name`(类名)
* `method_list_t *baseMethods`(方法列表:包含 `SEL name`, `const char *types`, `IMP imp`)
* `ivar_list_t *ivars`、`property_list_t *baseProperties`、`protocol_list_t *baseProtocols`
* 扫描 `__TEXT,__objc_methname`、`__TEXT,__objc_classname`。
* 将这些数据序列化为私有二进制格式,使用 ChaCha20-Poly1305 加密存入 `__PROTECT` 段。
2. **Mach-O 元数据清洗与置空**:
* 将 `__TEXT,__objc_methname` 节内的所有 ASCII 字符串重置为 `\0` 或覆盖为伪造的无害字符(如系统库常见名称)。
* 将 `class_ro_t` 的 `baseMethods` 指针置为 `NULL`,或指向一个仅包含假初始化方法的假列表。
3. **运行时受控动态还原 (Dynamic Relocation)**:
* 守护库 `libDefender.dylib` 注册在 Mach-O 的 `LC_LOAD_DYLIB` 列表最顶部,拥有最优先加载权。
* 在 `+load` 执行前的 `__mod_init_func`(C++ 全局构造器阶段):
1. 从 `__PROTECT` 内存段解密元数据;
2. 遍历类对象,调用 Objective-C 底层 API(如 `class_addMethod`)或直接在内存中修正 `class_rw_t` 的方法切片(Method Slice);
3. 建立内存映射快速索引表,确保 `objc_msgSend` 消息分发完全正常。
### 3. 原生代码虚拟化 (VMP) 引擎 (Code Virtualization)
* **模块目标**:对抗 IDA/Ghidra 反编译,将关键 ARM64 机器码逻辑编译或抽取为自定义私有字节码,通过内嵌解释器执行。
* **架构设计**:
```
原始 ARM64 函数逻辑 ===> [ VMP Compiler ] ===> 私有字节码 (Bytecode Stream)
+
[ VM 解释器状态机 (C/汇编) ]
```
* **核心组件设计**:
1. **私有指令集设计 (Custom IR / ISA)**:
* 设计约 30~45 条紧凑指令:`VM_NOP`, `VM_LOAD`, `VM_STORE`, `VM_ADD`, `VM_SUB`, `VM_XOR`, `VM_CMP`, `VM_JMP`, `VM_JZ`, `VM_CALL`, `VM_RET` 等。
* 操作码(Opcode)每次构建随机重映射(例如构建 A 中 `0x1A` 代表加法,构建 B 中 `0x7F` 代表加法)。
2. **上下文栈帧与寄存器映射 (Context Simulation)**:
* 定义 `VMContext` 结构体,模拟通用寄存器(`X0`~`X30`)、栈指针(`SP`)、状态标志寄存器(`NZCV`)。
* 当进入加固函数时,跳板代码(Trampoline)将真实 CPU 寄存器压入栈,并将其值拷贝至 `VMContext`。
3. **纯解释型分发器(不破坏 W^X 合规红线)**:
* 严禁调用 `mprotect(PROT_EXEC)`。
* 采用 **Direct-Threaded Code(直接线程代码 / 间接跳转表)** 循环:
```c
void VM_Execute(VMContext *ctx, const uint8_t *bytecode) {
static const void *dispatch_table[] = { &&do_nop, &&do_load, &&do_add, ... };
#define DISPATCH() goto *dispatch_table[*pc++]
// ... 寄存器状态机流转 ...
}
```
### 4. 全维度内核级主动防御对抗矩阵 (Defender Core)
* **模块目标**:以静态库或注入动态库形式驻留进程,全面压制逆向与动态分析工具。
* **五大防御维度实现细节**:
```
主动防御矩阵 (Defender Core)
├── 1. 内核级反调试 (Anti-Debug)
│ ├── 内联汇编 SVC 0x80 调用 ptrace(PT_DENY_ATTACH, 0, 0, 0)
│ ├── sysctl 轮询检查 kinfo_proc.kp_proc.p_flag 包含 P_TRACED
│ ├── 硬件断点探测:thread_get_state 获取 ARM_DEBUG_STATE64,比对 bvr/bcr 寄存器
│ └── Mach 异常端口劫持:task_set_exception_ports 抢占 EXC_BREAKPOINT / EXC_BAD_ACCESS
├── 2. 反 Hook 与反 Frida (Anti-Hook & Anti-Frida)
│ ├── 扫描加载模块:_dyld_get_image_name 校验是否存在 frida-agent, CydiaSubstrate, Dobby
│ ├── 检测默认端口 (27042) 与探测本地 loopback 反向 socket 连接
│ ├── 线程检测:遍历 task_threads,检测线程名为 "gum-js-loop"、"gmain"
│ ├── 函数头 Inline Hook 探测:校验关键函数(open, ptrace, exit)前 16 字节是否包含 "LDR PC, [PC, #0]" 或 "BR X16"
│ └── GOT 表边界检测:校验 __la_symbol_ptr / __got 内函数指针是否位于合法 Dyld Shared Cache 内存空间
├── 3. 越狱与沙盒感知 (Anti-Jailbreak)
│ ├── 特征路径扫描:/Applications/Cydia.app, /bin/sh, /usr/sbin/sshd, /var/jb 等
│ ├── 沙盒逃逸写入探测:尝试向 /private/jailbreak_test 写入文件
│ ├── 环境变量检查:getenv("DYLD_INSERT_LIBRARIES")
│ └── 内核限制探测:调用 fork(),未越狱沙盒环境必返回 -1 (errno=EPERM)
├── 4. 内存完整性保护 (Anti-Patch)
│ ├── 运行时读取 Mach-O 的 __TEXT,__text 内存页
│ └── 计算 SHA256 模糊哈希并与静态基线比对,防止内存被动态打补丁 (Memory Patch)
└── 5. 白盒密码学 (Whitebox Cryptography)
└── 实现白盒 AES-128 / SM4 算法,将密钥彻底融合至预计算查找表 (LUT),防止内存 Dump Key
```
### 5. 双符号表体系与 dSYM 崩溃逆向还原 (Dual-Symbol & Crash Restorer)
* **痛点**:加固导致线上崩溃日志(Sentry / Bugly / Crashlytics)堆栈全为无意义字符(如 `_a8f9bc71()`),严重影响线上问题排查。
* **实现方案**:
1. **构建双向映射数据库 (`mapping.sqlite` / `mapping.json`)**:
* 记录格式:`{ MD5(Raw_Signature): { raw_name: "LoginManager", obfuscated_name: "a7c2d8", type: "class", file: "LoginManager.m" } }`。
2. **DWARF 调试文件反向重写引擎 (dSYM Restorer)**:
* 解析 Release 构建生成的原始 `App.app.dSYM` 中的 Mach-O(DWARF 结构)。
* 解析 `.debug_info` 节中的编译单元(Compilation Units)和调试信息条目(DIE)。
* 解析 `.debug_str`(字符串池)与 `.debug_line`(行号状态机)。
* 建立 DWARF 字符串重映射管道,将里面的混淆名批量替换回 `raw_name`。
* 产出无缝还原后的 `Restored_App.app.dSYM`,直接上传至 Bugly/Sentry。
### 6. 资源与游戏资产保护 (Assets & Game Protection)
1. **静态免加密文件 Hash 扰动**:
* 针对 PNG:向 PNG 插入合规私有 chunk(如 `tEXt` 注入随机 UUID),MD5 彻底改变,渲染完全正常。
* 针对 MP3/MP4/PDF:文件末尾追加随机长度的填充字节(Padding)。
2. **深度资源透明加密与虚拟文件系统 Hook**:
* 加密算法:ChaCha20-Poly1305。
* Hook 拦截层:
* 底层 C API(POSIX):`open`、`fopen`、`stat`、`lstat`、`read`、`fread`(基于 `fishhook`)。
* Cocoa 框架层:`[NSData dataWithContentsOfFile:]`、`[UIImage imageNamed:]`、`[NSBundle pathForResource:ofType:]`(基于 Method Swizzling)。
* 拦截后在内存中执行无落盘解密(In-Memory Decryption),外部工具解压 IPA 只能看到乱码文件。
3. **Unity 与 Cocos 专项防护**:
* **Unity IL2CPP**:加密 `global-metadata.dat`,Hook `il2cpp::vm::MetadataCache::Initialize()` 动态解密;对 `Classes/Native` 的 C++ 符号深度平坦化。
* **Cocos**:对 `src` 目录下的 LuaJIT 字节码或 JS 脚本添加自定义文件头混淆,Hook 引擎底层 `FileUtils::getDataFromFile`。
### 7. 跨平台自动化重签名流水线 (Cross-Platform Signer Engine)
* **模块目标**:支持在 **macOS(本地终端)** 与 **Linux/Docker(SaaS 云端服务器)** 两种环境下全自动完成加固后 IPA 的重签名。
* **签名核心算法实现流程 (严格顺序)**:
```mermaid
sequenceDiagram
autonumber
participant Runner as 签名调度器
participant Prov as Mobileprovision 与 Entitlements 协调
participant Dylibs as Frameworks/PlugIns (内部组件)
participant Res as CodeResources 资源清单
participant MachO as 主可执行文件 Header 与 CodeDirectory
participant CMS as OpenSSL 签名核
Runner->>Prov: 解析 embedded.mobileprovision 提取授权范围
Runner->>Prov: 协调生成目标所需 Entitlements (XML + DER 编码)
Runner->>Dylibs: 先行签名内部 Frameworks/*.dylib 与 *.framework
Runner->>Dylibs: 先行签名 PlugIns/*.appex (独立 Entitlements 与 BundleID)
Runner->>Res: 扫描 Bundle 全部文件生成 _CodeSignature/CodeResources
Runner->>MachO: 预先计算 SuperBlob 大小,在 Header 预设 LC_CODE_SIGNATURE (dataoff=codeLimit, datasize=blob_size)
Runner->>MachO: 将 CodeResources 的 SHA256 填入 CodeDirectory Slot -3 (极关键)
Runner->>MachO: 将 Info.plist、Entitlements 哈希填入 Slot -1, -2, -5, -7
Runner->>MachO: 按 16KB 页面计算 0..codeLimit 范围内的代码页 SHA256 填入 Slot 0..N
Runner->>CMS: 传入完整的 CodeDirectory 序列化字节数据,由 OpenSSL 生成 PKCS#7 签名
Runner->>MachO: 组装 SuperBlob (包含 0, 2, 5, 7, 0x10000 槽位) 回写至 dataoff 偏移
Runner->>Runner: 重新打包为 Payload 结构并压缩为 .ipa
```
* **跨平台工具选型**:
* **macOS 环境**:直接调用系统 `codesign -f -s ... --entitlements ... --generate-entitlement-der`。
* **Linux / Docker 环境**:集成自研 C++ 签名模块(基于 `zsign` 内核改造),使用 OpenSSL 3.0 解析 `.p12` 证书私钥,手动构建完整的 Apple `SuperBlob` 二进制数据结构。
### 8. IPA 相似度预检中心 (App Store 4.3 预检器)
* **模块目标**:在提审前评估加固包与母包(或老版本)的相似度,规避 App Store 4.3 / 2.3.1 拒审。
* **算法度量指标**:
1. **代码段模糊哈希(SSDEEP / TLSH)**:提取主 Mach-O `__TEXT,__text` 段,计算基于上下文触发分段哈希(CTPH),比对机器码序列相似度。
2. **符号表 Jaccard 相似系数**:计算两包之间导出的类名、方法名集合交并比:$J(A, B) = \frac{|A \cap B|}{|A \cup B|}$。
3. **资源感知哈希(pHash & SSIM)**:对所有图片计算感知哈希与结构相似性,检测图片指纹重合度。
4. **内部风控基准评分**:内部相似度 $< 35\%$ 判定为低相似度;$35\% \sim 50\%$ 建议调换混淆特征库;$> 50\%$ 建议内部阻断提审。(注:苹果 4.3 条款为人工审查与机审结合的行为政策,指标仅作内部风控参考,不构成绝对过审保证)。
---
## 三、 工程代码组织与目录结构 (Repository Layout)
```
iOSGuard/
├── bin/ # 编译输出的可执行文件 (cli, zsign-mod)
├── core/ # 核心 C/C++ / Rust 跨平台加固引擎
│ ├── macho/ # Mach-O 解析与重构器
│ │ ├── macho_parser.cpp # Header, Load Commands, Section 解析
│ │ ├── macho_rewriter.cpp # Header扩容、段平移、LC_LOAD_DYLIB 注入
│ │ └── macho_align.cpp # 0x4000 页面对齐校准
│ ├── metadata/ # Objective-C 元数据清洗与加密
│ │ ├── objc_extractor.cpp # 抽取 __objc_classlist, class_ro_t
│ │ └── objc_scrambler.cpp # 符号置空与加密段生成
│ ├── vmp/ # 原生代码虚拟化引擎
│ │ ├── vmp_compiler.cpp # 汇编 -> 私有字节码翻译器
│ │ ├── vmp_isa.h # 私有指令集定义
│ │ └── vm_interpreter.c # 运行时解释器状态机
│ └── signer/ # 跨平台重签名核心 (基于 zsign 扩展)
│ ├── codesign_engine.cpp# CodeDirectory, SuperBlob, CMS 构建
│ ├── der_encoder.cpp # DER-encoded Entitlements 编码器
│ └── resource_signer.cpp# _CodeSignature/CodeResources 生成器
├── defender/ # 注入的运行时防护库源码 (输出 libDefender.dylib)
│ ├── anti_debug/ # 内联 SVC 汇编、硬件断点轮询
│ ├── anti_hook/ # Inline Hook 校验、Dyld GOT 范围比对
│ ├── anti_frida/ # 端口探测、线程扫描、动态库匹配
│ ├── anti_jailbreak/ # 沙盒感知、fork 检测、关键路径
│ ├── vfs_crypto/ # 资源透明解密 Hook (open/read/imageNamed)
│ └── dynamic_loader/ # 元数据内存解密与动态注册 (+load 前执行)
├── llvm-plugins/ # 源码加固 LLVM Pass (集成至 Xcode)
│ ├── Flattening.cpp # 控制流平坦化 Pass
│ ├── BogusControlFlow.cpp # 虚假控制流 Pass
│ ├── StringEncryption.cpp # 常量字符串加密 Pass
│ └── CallStackObfuscate.cpp # 调用栈蹦床代理 Pass
├── tools/ # 辅助工具链
│ ├── dsym_restorer/ # dSYM 崩溃逆向还原工具 (DWARF 重写)
│ ├── ipa_diff_analyzer/ # IPA 4.3 相似度静态评估分析器
│ └── pbx_injector/ # Xcode 工程配置与 Build Phase 自动化注入
├── cli/ # 命令行交互工具 (Go / Python 实现)
└── web/ # SaaS 云端管理后台 (前端 Vue / 后端 Go)
```
---
## 四、 实施路线图与阶段性交付物
```mermaid
flowchart LR
M1["里程碑 1 (MVP)\nPadding充足下注入\n+ macOS 原生签名闭环"] --> M2["里程碑 2\n段平移与Fixup修复\n+ ObjC 动态元数据恢复"]
M2 --> M3["里程碑 3\nLLVM 编译混淆\n+ dSYM 崩溃符号化还原"]
M3 --> M4["里程碑 4\n代码虚拟化 (VMP)\n+ 游戏资产保护"]
M4 --> M5["里程碑 5\n4.3 预检分析器\n+ 商业平台化"]
```
| 阶段 | 周期 | 研发重点与技术验证 | 关键交付产物 |
| :--- | :--- | :--- | :--- |
| **M1: 极简闭环验证 (MVP 收敛范围)** | 3~4 周 | 1. **目标载体**:自有简单 arm64 测试 App(UIKit/SwiftUI);
2. **注入约束**:仅在 Header Padding 充足条件下验证 `LC_LOAD_DYLIB` 原地注入(空间不足直接拒绝,不盲目平移);
3. **依赖与路径**:物理嵌入 `libDefender.dylib` 至 `Payload/App.app/Frameworks/`,解析并验证 `@rpath` 依赖链;
4. **签名验证**:使用 macOS 原生 `codesign`(带 `--generate-entitlement-der`);
5. **真机闭环**:验证真机安装、冷启动通过、`libDefender` 基础合规反调试生效、制造崩溃并跑通 dSYM 符号化还原。 | 1. 自建 arm64 测试工程
2. `libDefender.dylib` 最小原型
3. 原地注入脚本与重签流水线
4. 真机冷启与崩溃还原验证报告 |
| **M2: Mach-O 进阶加固与重定位修复** | 5 周 | 1. 攻克全局段平移(Segment Shift)与 `LC_DYLD_CHAINED_FIXUPS` 重定位链表重构;
2. 实施 Objective-C 元数据精细化抽取与 ASLR 动态还原;
3. 验证 Linux 端 `zsign` 无 Mac 依赖签名闭环。 | 1. 支持段平移的 `macho_rewriter`
2. 保持语义的 `objc_scrambler`
3. Linux Docker 自动化签名工具 |
| **M3: LLVM 编译管线与 dSYM 深度还原** | 5 周 | 1. 研发控制流平坦化、虚假分支与常量字符串加密 LLVM Pass;
2. 完善 DWARF 重写工具,确保 UUID 严格匹配。 | 1. Xcode 自定义 LLVM Toolchain / Plugin
2. `dsym_restorer` 崩溃堆栈还原器 |
| **M4: 原生代码虚拟化 (VMP) 与游戏加固** | 6 周 | 1. 完善基于 ARM64 的私有解释型虚拟机 (VMP),补充边界安全检查与异常退出;
2. 实现 Unity `global-metadata.dat` 加密与 Cocos 脚本内存流解密。 | 1. 包含安全防御的 `vmp_compiler` 与 `vm_interpreter`
2. Unity / Cocos 游戏专用加固套件 |
| **M5: 4.3 审核预检与商业化平台** | 4 周 | 1. 实现基于 SSDEEP 与符号图谱的内部风控评分算法;
2. 构建 SaaS 网页端控制台或跨平台桌面客户端 (macOS/Windows)。 | 1. `ipa_diff` 相似度检测中心
2. 完整的商业级加固发布包 |