Skip to content

About

Eazfuscator.NET unpacker and deobfuscator with C# source recovery.

Resources

Stars

38 stars

Watchers

1 watching

Forks

Latest commit

 

History

45 Commits

Folders and files

Repository files navigation

EazUnpacker

面向 Eazfuscator.NET 托管程序集的命令行解包与反混淆工具。恢复可分析的 IL,生成可读名称,并可选导出 C# 工程。

简体中文 · English · v1.5.0 · 更新日志

快速开始 · 功能特点 · 字符串编辑 · 资源编辑 · 参数 · 开发

按元数据与 IL 语义识别保护。支持范围以实际恢复报告为准,不承诺任意程序集“完全还原”。

主要功能

能力 说明
字符串与资源 恢复受支持的字符串与资源;按原程序集名将已核对身份的嵌入依赖导出到输出目录;不脱壳编辑 Eaz 加密字符串
资源编辑 自动恢复受支持的保护层资源,展开 .resources 条目;按资源名或 Key 导出,修改文件后自动重建回写,不反序列化自定义对象
VM 还原 识别 VM 格式和调用点,恢复受支持的指令、签名及异常区域;失败时保留原方法
内联与代理 恢复一个宿主内的多个 VM 调用;支持受约束的 ref 写回;整理透明代理链,内联有界的纯整数叶表达式
控制流 折叠可证明的整数/枚举条件,整理 switch 分发、跳转链与单前驱常量,删除不可达指令和无用局部写入
可读命名 按类型角色、继承和入口点生成名称,精简参数名,保留名称映射与 Portable PDB;含界面标记资源的模块保留类型、命名空间及成员名,避免破坏绑定
密钥日志 通过原校验后输出密钥、Token、输入中的原命名空间/类名/方法签名;保留结构化记录
可选源码导出 使用 ILSpy 导出 C# 工程、字符串索引并尝试重构建
可选 CLR 检查 显式检查恢复后的宿主、内联适配器及访问桥;默认关闭
保护残留清理 VM 全部还原或未检测到 VM 时,清理无业务引用的 VM、字符串解密器和已替代资源;保留仍被引用或不能确认的内容

快速开始

1. 解压完整发布包

解压 EazUnpacker-v1.5.0-win.zip,保留 worker 下所有子目录。入口为 Unpacker.exe,不要只复制 EXE。

  • 运行环境:Windows、.NET Framework 4.8;BAML 转换需要 .NET 8 或更新运行时,处理现代 WPF 目标还需要相应的 .NET Desktop Runtime。现代后端可向已安装的更新主版本滚动。
  • 目录权限:解压到较短的可写目录,程序会在自身目录建立 temp。Framework 加载器或第三方工具仍可能受 Windows 长路径限制。
  • 是否需要 SDK:普通解包不需要;源码重构建需要 .NET SDK 和目标项目所需引用。开发构建见开发与构建。

2. 运行命令

在解压后的目录打开 PowerShell:

# 默认:恢复 IL 并输出程序,不执行 CLR 准备检查,不导出源码
.\Unpacker.exe unpack ".\input\input.dll" ".\output\input_unpacked.dll"

# 显式开启 CLR 检查
.\Unpacker.exe unpack ".\input\input.dll" ".\output\input_unpacked.dll" --validate-clr

# 导出并尝试重构建 C#;CLR 检查仍需单独开启
.\Unpacker.exe unpack ".\input\input.exe" ".\output\input_unpacked.exe" --export-source --validate-clr

# 静态元数据分析,标准输出为 JSON
.\Unpacker.exe analyzer ".\input\input.dll"

3. 查看输出与结果

控制台会显示输出文件、诊断目录和结束统计。先确认退出码,再查看对应运行目录的 result.json;没有执行的检查不代表检查通过。

输入与输出不能相同。只要生成了恢复程序集,即使后续阶段未完成也会尽量发布,并明确记录部分完成状态。Framework EXE 的生成 .config 应与 EXE 一起部署;DLL 仍受宿主配置和依赖影响。

内嵌托管依赖按程序集身份中的名称输出到主产物旁,不使用混淆资源名。依赖先于主程序就位;同名文件内容不同时停止发布,不覆盖现有依赖。只有可被外置文件替代的资源及无业务引用的保护代码才会删除;未恢复的 VM 和未知的动态加载逻辑仍保留。

原位编辑加密字符串

.\Unpacker.exe strings ".\local\input.exe"
.\Unpacker.exe strings apply ".\local\input.exe"
# 或覆盖原件,同时生成 .bak 备份
.\Unpacker.exe apply ".\local\input.exe" --in-place

导出和回写默认使用与输入同目录的 input.exe.strings.json;也可显式指定清单路径。回写默认另存为 input.edited.exe,可指定其他输出或使用 --in-place。只编辑清单中的 text;可删去不需要修改的条目。清单与导出时的程序绑定,再次编辑已改文件时需重新导出。清单含解密文本,请仅在本地保存。

支持可静态识别的托管 PE 嵌入字符串表。不执行目标程序,也不脱壳。可缩短、清空或加长字符串;超出原槽位时重排资源并给原解码器添加偏移映射,保留字符串 ID 和原调用点。单条编码文本上限 1 MiB。回写会重新解密核对,不生成部分结果;修改会使已有数字签名失效。

资源提取与替换

.\Unpacker.exe resources ".\local\input.exe"
.\Unpacker.exe resources apply ".\local\input.exe"
# 或覆盖原件,同时生成 .bak 备份
.\Unpacker.exe resources apply ".\local\input.exe" --in-place
# 独立资源容器使用相同流程
.\Unpacker.exe resources ".\local\input.resources"
.\Unpacker.exe resources apply ".\local\input.resources"

默认清单为 input.exe.resources.json,资源文件位于清单路径加 .files 的目录;resources export 是显式导出写法。文件按资源名或条目 Key 命名,容器子条目位于对应的 .entries 目录;非法字符、超长名称及大小写冲突会自动处理。JSON 是仅含 id、name、type、format、file 的数组,不记录大小、哈希或其他参数。只需修改导出目录内的文件再执行 apply,不必修改 JSON;也可移除无需回写的清单条目。回写默认另存为 input.edited.exe(容器为 input.edited.resources),--in-place 会备份覆盖原件;已有输出或备份不会被覆盖。修改程序集后再次编辑需重新导出,清单和资源请仅保存在本地忽略目录。

受支持的保护型资源先自动恢复再导出;必要时在独立后端调用资源解码器,抑制运行副本的模块初始化,不进行完整反虚拟化或命名恢复。普通嵌入资源直接处理,不跟随外部链接或处理本机 PE 资源。.resources 中的条目会自动展开,修改子条目后自动重建容器,无需再次手工提取或设置大小、偏移;不要同时修改整个容器及其子条目。字符串使用 UTF-8,字节数组和流使用原始文件,其他类型保留序列化字节;兼容标准及受支持的预序列化容器,并保留读取器类型。不新增或删除资源,保留名称、类型与属性;支持清空、缩短与扩容,单项上限 256 MiB、文件及资源总量上限 512 MiB。普通 PE 资源替换不重写方法 IL;保护型资源恢复可能需要重建资源元数据及启动兼容处理。修改仍可能使数字签名或自校验失效。

BAML 按内容自动识别并导出为同名 .xaml,清单 format 为 xaml,资源名和 Key 仍保留 .baml。直接编辑 XAML 后 apply 会自动编译回 BAML;未修改的内容保留原始二进制。可修改文字、属性及布局、添加无代码后台的新控件;保留已有元素的 ub:* 往返标记、x:Class 和事件处理器,它们用于保持原连接 ID 与代码后台绑定,不能通过资源编辑新增或重命名处理器。编译在独立的匹配 CLR 后端运行,需要原程序集及控件依赖;独立容器会自动查找同目录的对应程序集。无效 XML、不支持的指令或编译错误会停止回写,不生成部分结果。已有二进制清单仍可应用;要获得 XAML,请重新导出到新清单目录。

回写时忽略默认空白模式下的纯缩进,保留 xml:space="preserve" 的文本,并用 WPF 二进制读取器检查新生成的节点流。另存程序集会同步现有的 .config、.runtimeconfig.json、.runtimeconfig.dev.json 和 .deps.json;已有配置内容不同时停止,不覆盖配置或程序。原位修改保持配置不变,输出仍需部署所需依赖。

保护型资源仅在临时副本中展开;最终以原始程序集为基底,按可验证的原格式重新封装、压缩和加密,保留原清单资源名、属性及载体内的资源 Key,不额外挂明文资源。支持已验证的流式对称变换及受支持的压缩/载体封装;无法验证反向编码时停止,不降级为明文输出。不要同时修改原密文载体和其中的解密条目。请以原受保护文件为输入;旧版已展开的输出不会自动恢复其历史保护结构。现代依赖描述中的主程序集文件映射会随另存文件名更新,避免加载旧程序。

参数与退出码

参数 默认 作用
--export-source 关闭 额外导出 C# 工程、字符串索引,并尝试编译
--validate-clr 关闭 开启恢复 IL 的 CLR 准备检查;同时导出源码时也检查重构建方法

选项可放在输入/输出路径之前或之后;未知或重复选项报错。未请求的可选阶段不计为恢复失败,未检查不代表检查通过。

退出码 含义
0 请求的处理阶段完成
2 已有输出,但恢复或显式请求的附加阶段未全部完成
1 参数、输入或处理错误

常用环境变量

变量 用途
UNPACKER_DEPENDENCY_PATHS 额外依赖目录;Windows 下用 ; 分隔绝对路径
UNPACKER_VM_VERBOSE=1 输出更多映射信息
UNPACKER_VM_DEBUG=1 输出逐方法/指令等调试细节
UNPACKER_VM_KEY_SEARCH_LIMIT 有界整数候选搜索次数,默认 65536;0 禁用,上限一千万
UNPACKER_VM_KEY_SEARCH_SECONDS 整个模块的整数兜底搜索时间预算,默认 20 秒;单个校验器最多 5 秒,0 禁用,上限 120 秒
UNPACKER_VM_INT32_KEYS 显式整数候选,逗号分隔;仍须通过原校验
UNPACKER_VM_STRING_KEYS 显式字符串候选,使用 JSON 字符串数组;仍须通过原校验
UNPACKER_VM_KEY_ASSET_PATHS 额外密钥资源文件或目录,Windows 下用 ; 分隔;支持托管程序集、.resources 与 .baml
UNPACKER_VM_USE_KEY_CACHE=1 允许读取显式指定的历史候选缓存
UNPACKER_VM_KEY_CACHE_PATH 候选缓存文件路径;不默认读取或捆绑预设密钥表

外部资源型字符串密钥还会从输入同目录和声明的依赖目录中提取候选,不递归扫描。资源文件仅按数据读取,扫描有数量和体积上限;候选必须通过原校验。相关资源不在输入中时,需提供资源文件;缺少密钥仍保留原方法,不跳过校验,也不内置特定程序的密钥。

临时目录与输出位置

临时文件统一位于 程序目录下的 temp。这里的程序目录是 Unpacker.exe 所在目录,不是启动命令时的当前目录。

Unpacker.exe
worker/
  Unpacker.Worker.exe
  modern/
temp/
  work/<输出路径哈希>/
    latest.json
    run-<时间>-<唯一标识>/
      result.json
      progress.log
      ...
  analysis-<唯一标识>/       # 分析结束后删除

主程序和配套 worker 共用该位置,子进程的 TEMP / TMP 也指向此处。程序目录必须可写;不可写时会报错,不静默转存其他位置。诊断、源码导出和重构建产物保留在对应运行目录;处理进程全部退出后可自行清理 temp。

第三方依赖与许可

组合项目采用 GPL-3.0。第三方组件保留各自许可证;来源、固定源码基线和本地修改说明见 NOTICE。

内置源码

组件 用途 许可证
EazFixer 字符串、资源与内嵌程序集恢复 MIT
EazyDevirt VM 格式识别、解码与 IL 恢复 GPL-3.0
Echo CIL 分析与解释基础设施 LGPL-3.0

主要 NuGet 引用

包 项目固定版本 用途
dnlib 4.5.0 托管元数据、IL 与 PDB 改写
AsmResolver.DotNet 6.0.0-beta.4 VM 后端的 PE/元数据与 CIL 生成
Lib.Harmony 2.4.2 独立解码后端中的运行时适配
BouncyCastle.Cryptography 2.5.1 VM 加密流相关实现
ICSharpCode.Decompiler 11.1.0.9782(主后端)、9.1.0.7988(BAML 后端) ILSpy 反编译
ICSharpCode.BamlDecompiler 9.1.0.7988 独立 BAML 转 XAML 后端
Newtonsoft.Json 13.0.3 报告和进度序列化
System.Memory 4.6.3(主项目) Framework 兼容支持

Echo 另保留其固定上游引用,如 System.Collections.Immutable、Nullable。完整直接/传递引用及其许可证以项目文件、NuGet 元数据和包内许可为准;这不是“最新版本”列表。

开发与构建

从仓库根目录执行。需要支持 .slnx 的 .NET SDK 和 .NET Framework 4.8 开发引用。可使用 .NET 10 SDK 构建。

dotnet build Unpacker.slnx -c Release

构建入口为 src\bin\Release\net48\Unpacker.exe。发布脚本从提交快照构建,并排除本地输入、缓存及临时文件:

pwsh -File .\scripts\Build-Release.ps1

About

Eazfuscator.NET unpacker and deobfuscator with C# source recovery.

Resources

Stars

38 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages