Files

87 lines
6.9 KiB
Markdown

# iOSGuard - 企业级 iOS 加固与安全防护系统
[![Platform](https://img.shields.io/badge/Platform-iOS%20%7C%20macOS%20%7C%20Linux-blue.svg)](https://developer.apple.com/ios/)
[![License](https://img.shields.io/badge/License-Proprietary-red.svg)]()
[![Architecture](https://img.shields.io/badge/Arch-ARM64%20%7C%20LLVM-orange.svg)]()
> **iOSGuard** 是一套融合了 **小蟹加固 (Crab iOS)** 与 **网易易盾 (NetEase YiDun)** 核心能力的企业级 iOS 应用安全加固与对抗系统。
> 支持 **“源码工程编译期深度混淆”** 与 **“无源码 IPA 纯二进制后处理加固”** 双模形态,满足 App Store 审核对抗(防 4.3 / 2.3.1 拒审)、核心代码防逆向防反编译、反外挂反调试、游戏与核心资产保护等多维需求。
---
## 🌟 核心特性概览
| 模块 | 核心能力 | 对标产品 |
| :--- | :--- | :--- |
| **Mach-O 深度重构** | Header 动态扩容、段全局平移、`LC_LOAD_DYLIB` 守护库注入、0x4000 严格页面对齐 | 网易易盾 / 顶象 |
| **Class-Dump 彻底防御** | 抹除 `__objc_methname`、`__objc_classname`,动态解密重构 `class_rw_t` | 网易易盾 / 爱加密 |
| **原生代码虚拟化 (VMP)** | ARM64 汇编抽离、私有紧凑字节码转换、合规纯解释型虚拟机(不破坏 W^X) | 网易易盾 / 梆梆安全 |
| **LLVM 编译加固 Pass** | 控制流平坦化 (Fla)、虚假控制流 (BCF)、常量字符串动态加密、调用栈蹦床代理 | 小蟹加固 / OLLVM / Hikari |
| **全维度主动防御 (Defender)** | 内联汇编 SVC 0x80 反调试、ARM64 硬件断点 (DR0-DR7) 探测、反 Frida、反 Inline/GOT Hook、沙盒越狱感知 | 网易易盾 |
| **双符号表与崩溃还原** | 编译期记录 `mapping.db`,重构 DWARF 调试节,无缝兼容 Bugly / Sentry / Crashlytics | 小蟹加固 |
| **资产与游戏安全** | 免加密文件 Hash 扰动、ChaCha20 流式透明解密、Unity `global-metadata.dat` 与 Cocos Lua/JS 保护 | 小蟹加固 / 网易易盾 |
| **跨平台自动化重签名** | 支持 macOS (`codesign`) 与 Linux/Docker (`zsign` 改造内核),强制支持 iOS 15+ DER 规范 | 企业自动化流水线 |
| **4.3 审核预检分析器** | 基于 SSDEEP 模糊哈希的 Mach-O 机器码比对、符号集 Jaccard 相似度、图片 pHash 差异度评分 | 小蟹加固 |
---
## 📂 项目模块结构
```
iOSGuard/
├── docs/ # 详细设计与实现方案文档
│ ├── 01_ROADMAP.md # 小蟹加固路线与技术全景
│ ├── 02_SECURITY_ARCHITECTURE.md # 易盾级安全加固架构深度剖析
│ └── 03_COMPLETE_IMPLEMENTATION_PLAN.md # 完整工程实现蓝图与技术规范
├── core/ # 核心 C/C++ 跨平台加固引擎
│ ├── macho/ # Mach-O 解析与重构器 (Header扩容 / 段平移 / 对齐)
│ ├── metadata/ # Objective-C 元数据清洗与加密 (防 Class-Dump)
│ ├── vmp/ # 原生代码虚拟化编译器与虚拟机解释引擎
│ └── signer/ # 跨平台重签名核心 (基于 zsign 扩展,支持 DER)
├── defender/ # 注入的运行时防护库源码 (输出 libDefender.dylib)
│ ├── anti_debug/ # 内联汇编 SVC 系统调用反调试、硬件断点轮询
│ ├── anti_hook/ # Inline Hook 前向指令探测、Dyld GOT 范围校验
│ ├── anti_frida/ # Frida 端口探测、线程扫描、动态库匹配
│ ├── anti_jailbreak/ # 沙盒感知、fork 检测、特征路径探测
│ └── vfs_crypto/ # 资源透明解密 Hook (open/read/imageNamed)
├── llvm-plugins/ # 源码加固 LLVM Pass (集成至 Xcode 自定义 Toolchain)
│ ├── Flattening/ # 控制流平坦化 Pass
│ ├── BogusControlFlow/ # 虚假控制流 Pass
│ ├── StringEncryption/ # 常量字符串加密 Pass
│ └── CallStackObfuscate/ # 调用栈伪装与蹦床代理 Pass
├── tools/ # 辅助工具链
│ ├── dsym_restorer/ # dSYM 崩溃逆向还原工具 (DWARF 重写)
│ ├── ipa_diff_analyzer/ # IPA 4.3 相似度静态评估分析器
│ └── pbx_injector/ # Xcode 工程配置与 Build Phase 自动化注入脚本
├── cli/ # 命令行终端工具
└── README.md # 本文件
```
---
## 📖 技术文档导航
详细技术实现细节与数学/算法推导请参阅 `docs/` 目录:
1. **[小蟹路线与技术全景](docs/01_ROADMAP.md)**:包含符号策略、资源 Hash 扰动、COSDK 运行时反射修复与 dSYM 崩溃还原体系。
2. **[易盾安全防护架构方案](docs/02_SECURITY_ARCHITECTURE.md)**:包含代码虚拟化 (VMP)、全维度主动防御底层汇编、游戏资产防护与白盒加密。
3. **[完整工程实现蓝图](docs/03_COMPLETE_IMPLEMENTATION_PLAN.md)**:包含八大子系统详细设计规范、Mach-O 段平移算法、跨平台签名时序与里程碑规划。
---
## 🚀 研发里程碑规划
- **M1 (第 1~4 周,极简闭环 MVP)**:自建 arm64 测试工程 + Padding 充足条件下验证 `LC_LOAD_DYLIB` 原地注入 + 物理嵌入 `libDefender.dylib` 与 `@rpath` 解析 + macOS 原生 `codesign` 重签名 + 真机冷启/基础合规反调试/崩溃符号化全流程闭环验证。
- **M2 (第 5~9 周,进阶加固与重定位修复)**:全局段平移(Segment Shift)与 `LC_DYLD_CHAINED_FIXUPS` 修复 + Objective-C 元数据精细化抽取与 ASLR 动态恢复 + Linux 端 `zsign` 无 Mac 依赖签名闭环。
- **M3 (第 10~14 周,LLVM 混淆与 dSYM 还原)**:控制流平坦化、字符串加密 Pass + DWARF 定点重写与线上崩溃还原。
- **M4 (第 15~20 周,代码虚拟化与游戏安全)**:原生纯解释型 VMP 虚拟机 + 完整内存/指令边界防御 + Unity IL2CPP / Cocos 加密保护。
- **M5 (第 21~24 周,4.3 预检与平台化)**:SSDEEP 相似度分析工具 + 内部风控度量体系 + CLI 命令行与商业控制台交付。
---
## ⚖️ 苹果审核与合规声明
1. **AMFI 与 W^X 合规**:本系统代码虚拟化 (VMP) 采用纯解释型虚拟机,不申请可执行内存(无 `mprotect(PROT_EXEC)`),严格遵守苹果 W^X 内存安全规范。
2. **公开 API 提审合规 (Guideline §2.5.1)**:App Store 提审版本中通过宏开关物理排除所有私有未公开符号(如 iPhoneOS SDK 未包含的 `ptrace` 相关调用)及裸汇编 syscall,仅依赖公开文档支持的 `sysctl` 调试检测;内核级汇编软中断与 `PT_DENY_ATTACH` 严格限制于企业内部分发 (Enterprise) / Ad-Hoc 场景。
3. **签名标准化**:重签名引擎严格遵从苹果 iOS 15+ DER-encoded Entitlements 与 CodeDirectory 16KB 分页哈希规范,保证 App Store 提审解签正常。