把程序拆成多个目标文件进行忒修斯船式重写:ghidra-delinker-extension反编译项目应用指南
把程序拆成多个目标文件进行忒修斯船式重写:ghidra-delinker-extension反编译项目应用指南
ghidra-delinker-extension 是一个 Ghidra 目标文件导出扩展,它能把已链接的可执行程序"反向拆分"(delink)成带有完整符号表与重定位表的可重定位目标文件(ELF / COFF / OMF),让你像操作源码工程一样,把程序逐块重写、再用链接器拼回可执行文件。本文给出从安装、一键拆分到忒修斯船式重写的完整应用指南。
它解决什么问题?
可执行文件在链接完成后,重定位信息被丢弃,只剩下"烧死"的机器码。想修改某段逻辑,只能手动算偏移、硬编码打补丁。
ghidra-delinker-extension 的思路相反:通过分析重建重定位表,把程序还原成目标文件(object file)。一个目标文件由三部分组成:
| 组成 | 作用 |
|---|---|
| 可重定位节字节(section bytes) | 真正的机器码/数据 |
| 符号表(symbol table) | 函数、全局变量的名字与位置 |
| 重定位表(relocation table) | 告诉链接器"哪里需要按最终地址回填" |
有了这三样,链接器就能把你导出的目标文件与新的目标文件一起链接成可执行程序——这正是"忒修斯之船"式重写的基础:把船的一根根船板(函数/数据块)换成重写的版本,船还是那艘船。
典型应用场景包括:
- 🩹 借助链接器完成高级二进制补丁,替代手工回填地址;
- 🚢 软件移植,隔离出与系统无关的代码,替换其余部分;
- 🔄 在 ELF / COFF / OMF 三种格式之间转换目标文件;
- 📦 提取库,把程序中的部分代码导出后复用到其他工程;
- 🔁 反编译项目,把程序拆成多个目标文件,逐块重新实现。
支持的架构与目标文件格式
| x86 | x86_64 | MIPS | |
|---|---|---|---|
| COFF | ✅ | ✅ | ❌ |
| ELF | ✅ | ✅ | ✅ |
| OMF | ✅ | ❌ | ❌ |
一键安装:构建与导入扩展
方式一:使用现成发行包
- 从项目的 releases 页面下载扩展包,或本地构建;
- 在 Ghidra 中选择 File > Install Extensions… 导入;
- 在 CodeBrowser 窗口中通过 File > Configure > Experimental 启用 RelocationTableSynthesizedPlugin 插件。
方式二:本地构建(CLI)
git clone https://gitcode.com/gh_mirrors/gh/ghidra-delinker-extension
export GHIDRA_INSTALL_DIR=/path/to/ghidra_install
gradle buildExtension
扩展压缩包会生成在 dist/ 目录中。注意:如果无法访问 GitHub Maven 仓库,需要配置 read:packages 权限的 GitHub classic token(写入 ~/.gradle/gradle.properties 的 githubToken),或先运行 gradle installStandaloneDeps 从子模块构建 vendored 依赖(见 README.md 的构建说明)。
核心用法:三步把程序拆成目标文件
- 在 Listing 视图中选中要提取的地址集合(函数、数据都可以);
- 运行 Relocation table synthesizer 分析器(支持 one-shot 模式,会即时处理选中的范围);
- 通过 File > Export Program… 调用可重定位对象文件导出器(ELF / COFF / OMF relocatable object)。
导出后,可以用 Window > Relocation table (synthesized) 窗口查看重建出来的重定位表,验证结果是否符合预期。
💡 小贴士:不需要先把整个程序逆向完成。拆分能否成功,主要取决于你导出子集内部的元数据质量:函数/指针(重定位位置)、符号范围(重定位目标)、以及两者之间的引用关系。
无头脚本批量拆分:DelinkProgram.java
如果你要把整个程序按模块、按文件拆成多个目标文件,仓库内置的无头脚本 ghidra_scripts/DelinkProgram.java 是主力工具。它支持通过符号名、内存块、地址范围、模块树路径批量筛选地址,再逐个导出:
/include-range 00401000-00402000
/include-file symbols_list.txt
/exclude foo
/exporter "ELF relocatable object"
/export part1.o
/include-block .text
/export part2.o
常用参数速查:
| 参数 | 说明 |
|---|---|
/exporter |
指定导出器名称(如 ELF / COFF / OMF relocatable object) |
/export |
把当前地址集合导出到指定文件 |
/include-tree / /exclude-tree |
按 Program Tree 模块路径包含/排除 |
/include-block / /exclude-block |
按内存块名包含/排除 |
/include-range / /exclude-range |
按 start-end 地址范围包含/排除 |
/include-file |
从符号名清单文件(每行一个)批量包含 |
/include / /exclude |
按单个符号名包含/排除(函数会取整个函数体) |
脚本内部会自动先对选中范围调度一次 Relocation table synthesizer 分析,再执行导出,保证了重定位表是最新的(实现见 DelinkProgram.java 中的 export 方法)。
忒修斯船式重写:推荐的完整工作流
把程序重写为新实现时,推荐如下循环:
- 拆分:用
DelinkProgram脚本把程序切成若干目标文件(每个模块/代码段一个.o); - 选定重写块:选中要替换的函数或数据范围;
- 腾空重写:运行脚本 ghidra_scripts/MakeSelectionUninitialized.java,它会把选中范围独立成一个内存块并转换为未初始化数据——原字节不再影响链接结果,你重新实现的内容将成为新字节;
- 重新实现:在 Ghidra 中直接以汇编/数据形式实现新逻辑,或把该范围导出后用编译器生成新代码替换;
- 再导出并链接:重新运行分析器、导出目标文件,用链接器把新旧目标文件拼回可执行程序。
每一块被替换掉后,程序的"身份"保持不变但实现已换血——这就是 Ship of Theseus 式重写的精髓。
分析器选项:让重定位表更可信
Relocation table synthesizer 分析器(实现见 RelocationTableSynthesizerAnalyzer.java)提供三个关键选项,可在 Analysis > Auto Analyze... 对话框中配置:
- Relocatable address ranges:限定哪些地址范围允许成为重定位目标,留空则整个程序均可重定位;
- Redirect thunks to targets:把指向 thunk 的重定位重定向到其真正目标函数(默认开启);
- Evaluation report policy:设置评估报告输出策略(
Never/On failure/Always)。拆分遇到问题时,建议切到 Always,详细的评估报告会输出到日志,帮助定位是哪条指令模式没匹配上。
代码重定位的匹配模式由 relocations/synthesizers/ 下的合成器实现,分别支持 x86(X86CodeRelocationSynthesizer.java)与 MIPS(MipsCodeRelocationSynthesizer.java)等架构的指令操作数模式。
导出器选项速览
三种格式各有一个导出器实现:
- ElfRelocatableObjectExporter.java:ELF 可重定位对象(
.o) - CoffRelocatableObjectExporter.java:COFF 可重定位对象(
.obj) - OmfRelocatableObjectExporter.java:OMF 可重定位对象(
.obj)
导出对话框中常用选项包括 ELF header 属性、符号可见性(支持按"动态符号""函数内部符号""符号名正则"等谓词批量设为 local,见 predicates/visibility/)、符号命名偏好(Itanium ABI 等)以及重定位表格式选择。
注意事项 ⚠️
- 重定位表合成依赖 Ghidra 数据库的准确性:函数边界、类型、符号信息错误或缺失,都会导致重定位损坏或遗漏;
- 导出器依赖分析结果,拿不准时请在导出前再跑一次 Relocation table synthesizer,确保重定位表是最新的;
- 导出的目标文件可直接交给标准工具链(如
ld)处理,这正是"借助链接器修复合并"补丁方案能成立的前提。
关键路径索引 📁
| 资料 | 路径 |
|---|---|
| 项目说明与用法 | README.md |
| 无头拆分脚本 | ghidra_scripts/DelinkProgram.java |
| 选区转未初始化脚本 | ghidra_scripts/MakeSelectionUninitialized.java |
| 重定位表合成分析器 | src/main/java/ghidra/app/analyzers/RelocationTableSynthesizerAnalyzer.java |
| 重定位模型 | src/main/java/ghidra/program/model/relocobj/ |
| 合成窗口插件 | src/main/java/ghidra/app/plugin/core/relocobj/ |
| MIPS hi16/lo16 匹配测试 | src/test/java/ghidra/app/analyzers/relocations/arch/mipsel/ |
装好扩展、跑通一次三步拆分,你就拥有了把任意可执行程序"拆开再组装"的能力——接下来的事,就交给你的重写了。