mirror of
https://github.com/Momoko-Ayase/Senbei.git
synced 2026-09-19 03:57:59 -04:00
2.7 KiB
2.7 KiB
Senbei Android
用于静态还原 Android 版受保护的 libil2cpp.so 和 IL2CPP
global-metadata.dat。生产路径已经完全 Rust 化,不执行保护器代码,也不依赖
Unicorn、IDA 或 Python。
兼容性
| 游戏 | 平台 | 版本 | 架构 | libil2cpp.so | global-metadata.dat |
|---|---|---|---|---|---|
| リバースブルー×リバースエンド | Android | 1.28.2 | AArch64 | 支持 | v31 MethodDef token |
当前 SO 实现针对该版本的 Stage 2 模块格式,运行时会从模块产物中发现
0x9B 的种子、AES-256 key schedule 和相关配置,不硬编码样本 offset。
metadata 默认使用模块 0x0C 中确认的 seed 0xA6FAE968。
构建
cargo build --release
生成的程序为:
target\release\senbei-android.exe
还原 libil2cpp.so
senbei-android restore-so INPUT OUTPUT --index INDEX_JSON --report REPORT_JSON
示例:
senbei-android restore-so `
Native\libil2cpp.so `
Native\libil2cpp_restored.so `
--index Native\libil2cpp_stage2_modules\index.json `
--report Native\libil2cpp_restore_report.json
省略 --index 时,默认读取输入文件同目录下的:
libil2cpp_stage2_modules\index.json
可选参数:
--dump-aux FILE:保存解码后的辅助 ELF 数据。--outer-only:只还原主容器,不物化辅助动态链接表。--preserve-entrypoint:保留保护器入口点;正常干净输出不应使用此项。
完整还原会静态处理 0x9B/0x9D/0x9E 数据,恢复 ELF load image、隐藏动态
符号、字符串、SysV/GNU hash、version、.rela.dyn 和 .rela.plt,移除
SHT_LOUSER 私有区并将入口点归零。
还原 metadata
senbei-android restore-metadata INPUT OUTPUT --report REPORT_JSON
示例:
senbei-android restore-metadata `
Package\base\assets\bin\Data\Managed\Metadata\global-metadata.dat `
Package\base\assets\bin\Data\Managed\Metadata\global-metadata_restored.dat `
--report metadata_restore_report.json
可用 --seed 0xA6FAE968 显式指定十六进制 seed,也支持十进制。还原操作是
幂等的:已规范化的 image 会保持不变。
Workspace
| Crate | 职责 |
|---|---|
senbei-android-cli |
命令行参数解析与结果输出 |
senbei-android-io |
路径推导、原地覆盖保护、原子写入与 JSON 报告 |
senbei-android-elf |
AArch64 ELF 还原与结构验证 |
senbei-android-crypto |
0x9B/0x9D 容器、AES、Huffman/LZ 和字变换 |
senbei-android-metadata |
v31 MethodDef token 静态逆变换与覆盖验证 |