Files
iOSGuard/README.md
T

86 lines
6.4 KiB
Markdown
Raw 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.
# 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)**:主动防御内核库 `libDefender.dylib` + Linux 跨平台自动化重签名管线闭环。
- **M2 (第 5~9 周,Mach-O 深度加固)**:Mach-O 段平移扩容工具 + Objective-C 元数据彻底抹除与动态重映射。
- **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 零依赖**:主动防御与反逆向对抗全量下沉至公开 POSIX 标准接口与 ARM64 裸汇编软中断,零引入苹果私有 Framework。
3. **签名标准化**:重签名引擎严格遵从苹果 iOS 15+ DER-encoded Entitlements 与 CodeDirectory 16KB 分页哈希规范,保证 App Store 提审解签正常。