Unity IL2CPP 逆向:GameAssembly/libil2cpp + global-metadata 经 Il2CppDumper 恢复符号并导入 IDA/Ghidra
code-analysis/reverse · verified
一句话结论
Unity IL2CPP 游戏把 C# 编译成 GameAssembly.dll(Windows)或 libil2cpp.so(Android/Linux)中的机器码,但为反射保留了 Data/il2cpp_data/Metadata/global-metadata.dat;用 Il2CppDumper 解析两者,可生成 DummyDll、dump.cs、script.json、il2cpp.h、stringliteral.json 和 IDA/Ghidra 脚本,在反汇编器中恢复类名/方法名/字符串并定位关键逻辑。
原理
- IL2CPP 编译链:C# → IL → IL2CPP 转 C++ → 平台 C++ 编译器 → 机器码。运行时不再依赖 Mono JIT,代码以 AOT 原生代码存在,直接反编译只能得到汇编/伪代码。
- 元数据是突破口:Unity 为支持反射、序列化等能力,必须保留类名、方法名、字段、字符串常量等元数据到
global-metadata.dat;Il2CppDumper 解析该文件,再在可执行文件中定位对应的函数地址,把“元数据”和“机器码地址”关联起来。 - 输出物的用途:
DummyDll/:方法体为空但保留命名空间、类名、方法签名、字段/属性,可用 dnSpy/ILSpy 查看高层结构;dump.cs:所有类/方法定义的纯文本,适合 grep 关键词(encrypt、flag、password 等);script.json:方法地址(RVA/偏移)与名称映射,供 IDA/Ghidra 脚本重命名函数;il2cpp.h:Il2CppObject、Il2CppString、Il2CppArray、Il2CppClass、MethodInfo等运行时结构体,导入后反编译更易读;stringliteral.json:字符串常量地址映射,可按字符串地址反查引用函数;ida.py/ida_with_struct.py、ghidra.py/ghidra_wasm.py:反汇编器脚本。- 为什么有效:即使方法体是机器码,恢复符号后可以像分析 C/C++ 程序一样按类名/方法名定位;再结合 DummyDll 的签名和 stringliteral 的字符串引用,能快速从“无意义地址”收敛到关键函数。
- 边界:
global-metadata.dat与 Unity 版本/Il2CppDumper 版本需匹配;元数据被加密/混淆时需先解密;强混淆(控制流平坦化、VM、字符串加密)会削弱符号恢复的效果,但仍可作为入口。
触发条件
- 目标为 Unity IL2CPP 打包:根目录有较大的
GameAssembly.dll,Data/il2cpp_data/Metadata/global-metadata.dat存在;Mono 打包则是Data/Managed/Assembly-CSharp.dll等可直接反编译的 dll。 - 能获取可执行文件与
global-metadata.dat(Windows 游戏目录、Android APK 的lib/<abi>/libil2cpp.so、iOS IPA 的Payload主二进制)。 - 有 Il2CppDumper(含对应平台版本)与 IDA/Ghidra、dnSpy/ILSpy。
- 元数据未加密,或已通过脱壳/解密还原;若加密,需要先处理保护。
利用步骤
- 识别打包方式:检查
GameAssembly.dll与Data/il2cpp_data/Metadata/global-metadata.dat;Mono 游戏则检查Data/Managed/*.dll。 - 运行 Il2CppDumper:
Il2CppDumper.exe <executable> <global-metadata.dat> <output>;按提示选择 Auto/Manual/Auto(Advanced),Auto 失败时手动指定平台、架构、Unity 版本。 - 查看输出:用 dnSpy 打开
DummyDll/Assembly-CSharp.dll了解类结构;用文本编辑器/grep 搜索dump.cs;用stringliteral.json找关键字符串地址。 - IDA 导入符号:打开
GameAssembly.dll,File → Script file运行ida_with_struct.py,依次选择script.json与il2cpp.h;函数名会被重命名并应用结构体。Ghidra 用ghidra.py(WASM 用ghidra_wasm.py)。 - 定位关键逻辑:按类名/方法名搜索(如
PlayerController_Update),或按stringliteral.json的地址在 IDA 中查交叉引用;结合 DummyDll 的方法签名理解参数。 - 动静结合:静态分析遇到困难时,用 CE/调试器动态跟踪(见 [[code-analysis-reverse-unity-il2cpp-ce-trigger-embedded-pe]])。
PoC
# Windows x64 示例
Il2CppDumper.exe .\GameAssembly.dll .\Game_Data\il2cpp_data\Metadata\global-metadata.dat .\output\
# Android 示例:从 APK 解出 lib/<abi>/libil2cpp.so 与 assets/bin/Data/Managed/Metadata/global-metadata.dat
Il2CppDumper.exe .\libil2cpp.so .\global-metadata.dat .\output\
输出目录:
DummyDll/ # dnSpy/ILSpy 查看类结构
dump.cs # grep encrypt/decrypt/flag
script.json # IDA/Ghidra 函数地址与名称映射
il2cpp.h # Il2CppString/Il2CppArray/MethodInfo 等结构体
stringliteral.json # 字符串常量地址
ida.py / ida_with_struct.py
ghidra.py / ghidra_wasm.py
IDA:File -> Script file -> ida_with_struct.py
1) 选择 script.json
2) 选择 il2cpp.h
之后可在函数窗口按类名/方法名搜索,或按字符串地址查交叉引用。
变体与关联
- Android/iOS 变体:Android 分析
libil2cpp.so,iOS 分析 IPA 主二进制;元数据位置随打包方式不同(assets、Data/Managed/Metadata 等)。 - 工具变体:Il2CppInspector、Cpp2IL 等可替代 Il2CppDumper;Ghidra 脚本适合无 IDA 环境。
- 保护变体:元数据加密、字符串加密、控制流平坦化、VM 保护需要先脱壳/解密;可结合 Frida 动态 dump 元数据或内存中的方法地址。
- 关联:[[mobile-android-unity-il2cpp-frida-gadget-infinite-revival]](Android IL2CPP + Frida Hook 的实战);[[code-analysis-reverse-unity-il2cpp-ce-trigger-embedded-pe]](CE 动态触发与释放 PE 分析)。
- 边界:版本不匹配会导致解析失败/符号错位;方法体仍为机器码,变量名/局部类型可能丢失,需要人工推断。
检测与防御
- 防御方(游戏保护):加密/混淆
global-metadata.dat,剥离或加密字符串常量,使用控制流平坦化/VM 保护关键逻辑;增加反调试/反 dump/完整性校验。 - 但元数据是反射所需,完全隐藏成本高;不要把核心算法或密钥只放在客户端,服务端校验关键结果。
- 分析方:只在授权环境分析;保留原始文件与哈希,先备份再修改;对加密元数据先做脱壳/解密并记录版本。