# 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. 完整的商业级加固发布包 |