confuse: 马甲包混淆工具 iOS 翻新工具差异化工具上架过包过审模拟人工手动混淆加密减少账号调查过机审 confuse confusion 解决4.3 2.3.1 OC confuse code mix

<a name="54fa66eaba498942a1604ffa591838ac"></a>
# ![1593768128247-016fe60b-8853-48fb-8b76-f9f702b83db5.png](https://cdn.nlark.com/yuque/0/2020/png/213807/1606304234500-46a10b02-f83d-4996-99fc-ce092241ea7c.png#averageHue=%23e9c2bf&height=100&id=SslN0&originHeight=200&originWidth=200&originalType=binary&ratio=1&rotation=0&showTitle=false&size=28522&status=done&style=shadow&title=&width=100)
<a name="HGXXr"></a>
### 中文 | [English](/README.md)
<a name="174be9787bb85687706b11dfa538cd99"></a>
# 前言
机缘巧合偶遇iOS[马甲包业务](https://www.yuque.com/docs/share/7e70244c-5dea-4035-b634-65cc082097da?#《马甲包简介》)，前期也使用过目前市面上其他得工具，实际效果不太理想。经过大量实践，开发出一款功能齐全的[混淆工具](https://github.com/520coding/confuse)。工具的主要功能OC、C++、Swift已封装成Mac应用，其他功能还在封装中，敬请期待。
<a name="9716a56c8b2aa1819920e42731952b21"></a>
# 提示
为了让大家快速上手及对比混淆效果，新建了测试工程[**confuse_test**](https://github.com/520coding/confuse/tree/master/confuse_test)，大家在实际使用过程中如果遇到问题，欢迎扩展测试工程，请在工程中请注明bug细节，有奖励。
<a name="zrzA4"></a>
#### 测试工程说明：
> [confuse_test](https://github.com/520coding/confuse/tree/master/confuse_test)：包含oc、c++、swift及一些第三方用例，快速验证整体效果  
> [confuse_test_oc](https://github.com/520coding/confuse/tree/master/confuse_test_oc)：只包含oc，方便验证每个功能的效果  
> [confuse_test_oc_fast](https://github.com/520coding/confuse/tree/master/confuse_test_oc_fast)：只包含oc，方便快速验证部分功能的效果  
> [confuse_test_swift](https://github.com/520coding/confuse/tree/master/confuse_test_swift)：只包含swift，代码来源于[Apple官方实例代码](https://docs.swift.org/swift-book/index.html#//apple_ref/doc/uid/TP40014097-CH3-ID0)，方便验证每个功能的效果

可任意修改源码来验证实际效果，建议用不同工具混淆以上测试工程或者第三方开源库项目，对比效果。
> 1.2.0之前的老版本说明：  
> 简介：不涉及语法及编译要求，但是混淆后可能出现局部漏改或者改错，请自行添加至黑名单过滤。  
> 适用项目：RN等还未适配的混合项目。  
> 使用条件：暂时没法使用，后期重新开放

<a name="d414d8542c4c96e2fa3cda81b4a61dc1"></a>
# 自述
<a name="6e674183b5d2f1af15baaa27bb7c93b2"></a>
### 马甲包的本质：

1. 阶段一减低重复率 ，本人开发初期的版本和目前市面上的其它工具基本相似，主要是‘名称’全局替换这一个基本的功能
2. 阶段二减少相似度（相同元素的正态分布），目前该工具经过优化及不断重构已经有了很大的改善，目前基本符合这方面要求，详情见以下功能介绍。事物都有两面性，功能越强大混淆耗时越长，如果你的项目很大，混淆几个小时也是有可能的，请不要见怪，后续持续优化中。
<a name="fc8a03eacc987f4c5e94e6dc0086ea50"></a>
### 区分工具优劣
其实识别一个工具的优劣，只需看看以下几点：

1. 能否修改所有的属性、方法，及方法的所有参数名
2. 修改成员（属性、方法）名称，能否按类区分，还是简单的全局替换
3. 带block的参数的方法，典型的网络请求
> 例如：+ (BOOL)post:(NSString *)url parameters:(NSDictionary *)parameters success:(HttpRequestResponse)success error:(HttpRequestResponse)error;

3. 方法名和属性名改后的名字的长短（本工具能够保证60~80%的改后名称是常见的一个单词，例如：name、title等且保证不与系统冲突，~~完全摒弃简单的靠大量单词库堆砌以保证命名的唯一性的做法~~，真正模拟人工开发）
4. 修改布局（Frame、Masonry、SDAutoLayout）
5. 插入的是代码还是‘垃圾’（本工具通过封装网络请求，创建自定义控件，文件之间使用MVC模式关联，彻底告别‘垃圾’，实现以假乱真）。
6. 更别说“还有谁...”能识别宏、区分继承链等上下文关联内容，智能识别不可修改部分
> 例如：+ (void)init;- (void)reloadData;基本能改，做到的有几个呢？”

7. 正常项目（或者第三方库）混淆完基本不报错（除了一些个别[语法不严谨](https://www.yuque.com/docs/share/4a87ec96-80fe-4d25-873d-93cb428b3e15?#5sCql)造成混淆后报错）
<a name="426215c094f184f34acdb12593ddb1fc"></a>
# 功能
confuse是一款[混淆工具](https://github.com/520coding/confuse)，尽可能模拟人工开发，仿照Xcode部分功能，避免机核4.3、2.1、2.3.1、账号调查等。<br />目标：**模拟人工修改一切能改的地方**，这也是为什么本工具只有黑名单没有白名单的原因<br />详细功能如下（基本功能不做描述，详见其他工具）：
<a name="82f2e3582d1466241460f1564b36b2a6"></a>
## 已完成
以下功能均支持：

1. 黑名单（二级）过滤，自由控制每个功能的混淆内容，几乎适应所有项目。
2. 混淆百分比控制，可以结合自己项目的实际需求，自由调整
3. 智能名词替换：
   1. 重命名时使用关联类型已有信息+相近语义+类型+部分旧词汇等组合，并且过滤敏感词汇，同时用户也可以自定义敏感词，~~弃用‘随机单词无脑组合’~~
   2. 异类同名成员->异类异名成员，异类异名成员->异类同名成员，模拟正常开发。成员指的是方法、属性、函数
4. 智能识别不可修改部分：通过类型及继承链方式识别系统、第三方、Pod方法，并不是‘简单’的相等判断，例如：
   1. 类方法：+ (void)init;原则上任何地方都能改
   2. 对象方法：- (void)reloadData;不是UITableView的子类是可以改的
   3. 属性：@property (readonly) NSUInteger length;如果不是NSString的子类也是可以改的
<a name="7e02145ffab0f7184b0a6b92e79d9acd"></a>
### 通用部分

1. [项目配置]，只要选择项目路径，自动完成其他默认配置
   1. 全局设置‘忽略路径’，支持正则，配合黑名单使用更佳
   2. ‘xcodeproj’设置，针对多xcodeproj项目和xx.xcodeproj不在项目根目录的情况
   3. ‘Scheme’混淆，与Xcode保持一致
   4. ‘Debug模式’，便于在源文件中查看修改前后对比，同时插入一些特殊注释标识便于定位bug
   5. ‘混编模式’，该模式用于处理混编项目中swift调用oc部分，保证混淆后维持调用关系
   6. ‘proto’设置，用于protobuf文件单独混淆
   7. ‘环境检查模式’设置，方便提前纠正不规范代码
   8. ‘参考项目根路径’设置，读取参考项目的单词、UUID
   9. ‘敏感词’过滤
   10. ‘关闭输出’，注释NSLog、print等调试语句
   11. ‘**版本迭代混淆**’，过审后迭代更新，沿用上一次（也可以任意选择版本）混淆记录增量混淆，保持版本连续性，模拟正常开发。优势：做到开发和混淆同步且各自独立。目前主要功能均支持更新混淆
2. ~~[杀病毒]，~~[~~Xcode中毒，XCSSET Malware~~](https://juejin.cn/post/6936535178118430733)
   1. ~~‘UUID后缀’，病毒会随机插入UUID，会带有固定后缀，正则扫描~~
   2. ~~‘脚本路径特征’，病毒编译前会执行一个可疑脚本，支持正则扫描~~
   3. ~~‘运行脚本代码标志’，病毒编译前会执行一个可疑脚本代码，支持正则扫描~~
3. [资源替换]，混淆前指定需要替换的资源文件夹，自动进行同名文件替换，方便快捷 
4. [修改sks]，修改SpriteKit中sks文件的布局和节点名称
   1. ‘运行拼接名称’，用于运行时通过字符串拼接生成的图片名
5. [删除注释]，识别单行、多行注释
6. [修改图片]，每个子功能都可以单独运行
   1. ‘自定义路径’，方便调试和针对性混淆
   2. ‘自定义RGBA’、‘RGBA偏移’，指定随机颜色修改
   3. ‘主题色’，生成统一颜色风格
   4. ‘色调偏移’、‘饱和度偏移’、‘明暗度偏移’，细节调整
   5. ‘像素点数’，局部像素微调
   6. ‘质量调整’、‘大小偏移’，整体控制
   7. ‘模式修改’，多种模式支持
7. [修改Lottie]，模拟真实Lottie文件结构，修改和扩充源文件，基本不影响实际效果
8. [修改文件属性]，如创建时间、访问时间、修改时间
9. [修改项目]，无需删除Cocoapods
   1. 可设置‘修改uuid’，彻底翻新
   2. 自定义‘修改target’名称，相关联信息同步更新
10. [文件对比]，对比混淆前后文件修改百分比
    1. ‘参考路径’，自定义设置原始项目
    2. ‘最大限制’，超过部分跳过对比
11. 自动备份源码
<a name="279a46203c9fe475b30ffab43dad6dba"></a>
### Objective-C

1. [修改控制流]，if条件语句中的逻辑运算进行等价替换
2. [重命名全局方法]，可设置‘前缀’
3. [重命名图片]，智能名词替换，自动处理二进制sks文件，自动纠正图片名和xcassets文件夹名不对应的情况
   1. 可设置‘运行拼接名称’，用于运行时通过字符串拼接生成的图片名
   2. 可设置‘重命名关联字符串’，用于修改字符串与图片名相等的情况
   3. 可设置‘指定忽略长度’，图片名长度小于指定长度为危险名称，将忽略
   4. 可设置‘忽略危险’，与字典key同名，将忽略
   5. 可设置‘关联文件’，其他包含图片名的文件
4. [插入图片]，自动插入图片，同时根据上下文及类型模拟人工调用，可指定插入个数
5. [重命名成员变量]，支持synthesize和箭头语法识别
6. [重命名属性]，支持@property的所有类型，支持Protobuf，优势：
   1. 识别语法，识别类型、继承关系，**属性名混淆和类名（包含继承链）关联**，自动识别系统属性
   2. 可设置‘Model后缀’，按类名的后缀过滤，方便过滤Model
   3. 可设置‘Model映射’，自动插入映射关系（已自定义，自动补齐其他属性），确保匹配后台数据
7. [插入属性]，创建、赋值、修改都关联已有类型，智能名词替换
   1. ‘Model后缀’，按类名的后缀过滤，目的：避免Model归档或者数据转模型失败
   2. 可多次执行，指数x2递增
8. [重命名方法]，近似Xcode的Rename功能，优势：
   1. 语法相关，识别类型、继承关系，支持**多参修改，方法名混淆和类名（包含继承链）及类型关联**，自动识别系统方法
9. [修改闭包]，提取方法体中的闭包内容封装为方法并调用
10. [拆分方法]，拆分方法体，打乱函数堆栈结构，可多次拆分
11. [插入方法]，插入并调用上下文关联方法，告别“垃圾代码”，优势：
    1. 根据方法的返回值类型，在分类中创建相应的方法。同时封装原方法的返回值并利用（局部变量、属性、形参）调用。
    2. 可多次执行，指数x2递增
12. [合并方法]，穿插合并代码，改变函数堆栈结构
13. [修改方法]，模拟人工封装调用，优势：
    1. 对原方法进行**拆分调用并根据参数类型（支持继承）局部调整**，详情见[支持参数类型汇总表](https://www.yuque.com/docs/share/315b72d9-28f9-4fa6-bf20-c40d94f2253a?#《修改方法-支持参数类型汇总表》)
    2. 支持‘交换参数’，随机交换参数位置，主要用于多参方法
    3. 可多次执行，指数x2递增
14. [重命名全局变量]，智能名词替换
15. [修改全局变量]，替换全局变量名、**全局变量转化为全局函数**、混淆字符串变量值
16. [插入局部变量]，单行复合调用变为简单多行调用，**改变执行顺序**
17. [修改局部变量]，模拟人工封装调用，变量名关联类型，优势：
    1. 局部变量值运行时保持不变，详情见[支持类型汇总表](https://www.yuque.com/docs/share/90444065-4f4e-49c8-9e1a-5bd3d3b4f84d?#《修改局部变量-支持类型汇总表》)
    2. 可多次执行，指数x2递增
18. [重命名多语言]，对直接或间接使用系统方法**NSLocalizedString**、**NSLocalizedStringFromTable**的多语言进行修改，[自定义封装方法](https://520coding.yuque.com/docs/share/de45751a-c629-4737-84ad-251fb2502123)需要手动处理
19. [修改字符串]，支持任意字符串，加密处理（硬编码->内存），原始字符串保留在注释中方便检查
    1. 设置‘最少长度’过滤
    2. 也可设置‘有效个数’搭配使用
20. [修改xib、storyboard]，自动插入视图，并修改内部结构属性
21. [修改字体]，对项目中使用的字体随机微调，识别宏
22. [修改颜色]，对项目中UI控件颜色随机偏移，识别宏
23. [UI布局偏移]，支持Frame、Mansonry、SDAutoLayout常见布局微调
24. [插入文件]，生成其它文件（结合网络、存储、MVC，保证代码具有高关联度和实际意义），项目中自动高关联调用；**注意：**(在项目根路径下，会生成"**other_xxx_file**"的文件夹，子选项**Target**控制导入方式，若为空，则需要手动导入，将生成的文件夹拖入工程即可；反之，自动导入）
25. [插入文本]，生成json、txt、plist等常用文本文件，项目中自动高关联调用；**注意：**(在项目根路径下，会生成"**other_xxx_text**"的文件夹，生成的文件会**自动导入**）
26. [修改类]，修改成员变量、属性、方法声明及定义的顺序
27. [重命名类]，类名不限制（例如：my、My），可指定添加前缀，支持class及分类名、struct、protocol，优势：
    1. 智能名词替换
    2. 可设置‘重命名同名文件’
    3. 可设置‘重命名相似字符串’，(忽略|相等|包含)三种设置
    4. 新增‘纠正非标准点语法’，针对非标准的点语法调用（方法当做属性调用）
<a name="015937695b202fc108bd5bc9b3283082"></a>
### C++

1. [重命名属性]，支持所有类型属性，识别语法，识别类型、继承
2. [插入属性]，插入属性（成员变量）并相互调用修改，自动初始化、销毁、并在其他方法中赋值修改等类似人工操作，支持‘百分比控制’
3. [重命名方法]，近似Xcode的Rename功能，识别类型、模板、重载、重写、继承等关系
4. [修改方法]，利用重载技术修改函数原型并调用修改形参
5. [修改字符串]，支持任意字符串，加密处理（硬编码->内存），原始字符串保留在注释中方便检查
   1. 设置‘最少长度’过滤
   2. 也可设置‘有效个数’搭配使用
6. [重命名类]，支持模板等类型
   1. 可切换旧模式
   2. 前缀设置
   3. 可设置‘重命名同名文件’
<a name="ea78561d0c1d5c21d3e2c93d960472e5"></a>
### Cocos2d-x
该部分功能整合至C++中，支持cocos2dx自动过滤
<a name="47038e8338f9e18ef9eaba0ea5effb80"></a>
### Swift
适配Swift5.5，SPM包管理项目暂未测试

1. [修改控制流]，if条件语句中的逻辑运算和可选绑定进行等价替换
2. [重命名全局方法]，自动识别系统方法
   1. 可设置‘参数标签’，支持隐藏参数标签和尾随闭包用法
   2. 可设置‘前缀’
3. [重命名图片]，智能名词替换，自动处理二进制sks文件，自动纠正图片名和xcassets文件夹名不对应的情况
   1. 可设置‘运行拼接名称’，用于运行时通过字符串拼接生成的图片名
   2. 可设置‘指定忽略长度’，图片名长度小于指定长度为危险名称，将忽略
   3. 可设置‘忽略危险’，与字典key同名，将忽略
   4. 可设置‘关联文件’，其他包含图片名的文件
4. [重命名Lottie]，适配多种场景
   1. 可设置‘运行拼接名称’，用于运行时通过字符串拼接生成的lottie名
   2. 可设置‘指定忽略长度’，lottie名长度小于指定长度为危险名称，将忽略
   3. 可设置‘忽略危险’，与字典key同名，将忽略
5. [插入图片]，自动插入图片，同时根据上下文及类型模拟人工调用，可指定插入个数
6. [重命名枚举]，识别关联值和原始值
   1. 可设置‘原始值’，细化控制范围
7. [重命名属性]，基本功能，不做过多描述，优势：
   1. 类似OC[重命名属性]，识别继承链及嵌套类型，支持存储和计算属性、观察器、包装器、类属性
   2. 可设置‘Model后缀’，按类名的后缀过滤，方便过滤Model
   3. 可设置‘Model映射’，自动插入映射关系，匹配后台数据
8. [插入属性]，利用计算属性对原属性包装及调用替换
   1. 支持存储和计算属性、观察器、包装器、类属性
   2. 可设置‘Model后缀’，按类名的后缀过滤，目的：避免Model归档或者数据转模型失败
9. [重命名方法]，基本功能改名字类似其他工具，不做过多描述，优势：
   1. 可设置‘参数标签’，支持隐藏参数标签和尾随闭包用法
   2. 识别继承链嵌套类型，支持（class、struct、enum）的静态方法和实例方法，及可选链等
10. [修改闭包]，提取方法体中的闭包内容封装为方法并调用
11. [拆分方法]，拆分方法体，打乱函数堆栈结构，可多次拆分
12. [插入方法]，封装原方法的返回值并利用上下文调用额外关联方法，告别“垃圾代码”
13. [修改方法]，利用重载技术修改函数原型并调用修改形参
    1. 支持‘交换参数’，随机交换参数位置，主要用于多参方法
    2. ‘动态派发’，改变方法调用方式
14. [重命名全局变量]，智能名词替换
15. [修改字体]，对项目中使用的字体随机微调
16. [修改颜色]，对项目中UI控件颜色随机偏移
17. [UI布局偏移]，支持Frame、SnapKit常见布局微调
18. [插入局部变量]，拆分单行复合调用，改变执行顺序
19. [修改局部变量]，模拟人工封装调用，变量名关联类型（支持嵌套），优势：
    1. 局部变量值运行时保持不变，详情见[支持类型汇总表](https://520coding.yuque.com/docs/share/cd70e83b-4ab4-40e5-b719-70f214e869c8)
    2. 可多次执行，指数x2递增
20. [重命名多语言]，支持自定义方法多语言处理
21. [修改字符串]，识别单行、多行、字符串插值、及扩展字符串，改后由加密和拆分字符组等多种方式自由组合，并保留原有字符的注释，方便检查
    1. 设置‘最少长度’过滤
    2. 也可设置‘有效个数’搭配使用
22. [修改xib、storyboard]，自动插入视图，并修改内部结构属性
23. [插入文件]，接近实际开发（结合网络、存储、MVC、xib等，保证代码具有高关联度和实际意义），强化上下文关联。可设置‘文件名前缀’，设置‘**Target**导入’方式和OC相同
24. [插入文本]，生成json、txt、plist等常用文本文件，项目中自动高关联调用（引入属性、初始化、自动销毁等）。**注意：**(在项目根路径下，会生成"**other_xxx_text**"的文件夹，生成的文件会**自动导入**）
25. [重命名类]，类名不限制（例如：my、My），识别嵌套类型及typealias，支持class、struct、enum、protocol
    1. 可设置‘重命名同名文件’
    2. 可设置‘前缀’
> 注意：目前Swift和OC混编项目，OC调用Swift部分暂不处理，后续将优化。

<a name="6554a51551d5572e2cd7d848844e9660"></a>
## 规划中
更新迭代将按照以下顺序依次进行

1. Objective-C（95%），主要提高工具的通用性和稳定性，及强化功能
   1. 音频、视频文件使用少，后续添加
2. Swift（95%），开发中...
   1. 强化性能
3. C++（60%），开发中...
   1. 方法：插入
   2. 属性：修改
   3. 全局变量：修改
4. Lua（10%）的针对性太强了，暂时不开放，暂时不打算重构有需要在说吧
5. C#（0%），本人实际项目使用不多，故排在最后，看用户需求再决定
6. 其他功能：
   1. 快速混淆模式
<a name="af444a353c9380bc9aa8aec067937316"></a>
# 图文介绍
运行APP效果图，使用前请详细阅读[工具使用教程](https://www.yuque.com/docs/share/edd2603f-d09d-4795-ae71-b42419b99446?#《confuse使用说明》)<br />![image.png](https://cdn.nlark.com/yuque/0/2020/png/213807/1607931800015-f60e682f-6ef3-4c5a-bfc5-4c88222bb1a7.png#averageHue=%239a6a2a&height=540&id=Ai791&originHeight=1080&originWidth=1920&originalType=binary&ratio=1&rotation=0&showTitle=false&size=489209&status=done&style=none&title=&width=960)
<a name="c318fa67bf88d5d842cee03115743b4b"></a>
# 更新日志
<h3 id="INHAC">v8.0.4（2024.11.23）热更新</h3>

1. 适配Swift5.5并发语法
2. 优化模版部分替换规则
3. 优化OC的关闭输出

[查看更多历史更新记录](https://www.yuque.com/docs/share/39f2f60e-b6a8-443b-b005-b9364fb79b95?#《confuse更新说明》)
<a name="41b9f638a3e62c9449ec872644258c8d"></a>
# 感谢反馈
[shizu2014](https://github.com/shizu2014)、[myhonior](https://github.com/myhonior)、[imbahong](https://github.com/imbahong)、[tabier008](https://github.com/tabier008)
<a name="0ae29cb26e944f357b114cccc4c1211b"></a>
# 链接导航

1. [工具使用教程](https://www.yuque.com/docs/share/edd2603f-d09d-4795-ae71-b42419b99446?#《confuse使用说明》)
2. [软件使用问答（Q&A）](https://www.yuque.com/docs/share/4a87ec96-80fe-4d25-873d-93cb428b3e15?#《软件使用问答（Q&A）》)
3. [OC[修改方法]参数类型汇总表](https://www.yuque.com/docs/share/315b72d9-28f9-4fa6-bf20-c40d94f2253a?#《修改方法-支持参数类型汇总表》)
4. [OC[修改局部变量]修改局部变量-支持类型汇总表](https://www.yuque.com/docs/share/90444065-4f4e-49c8-9e1a-5bd3d3b4f84d?#《修改局部变量-支持类型汇总表》)
5. [OC[重命名多语言]自定义封装方法处理](https://520coding.yuque.com/docs/share/de45751a-c629-4737-84ad-251fb2502123)
6. [Swift[修改方法]参数类型汇总表](https://520coding.yuque.com/docs/share/cd70e83b-4ab4-40e5-b719-70f214e869c8)

YJS/confuse

简介

发行版

贡献者

近期动态