产品定位: 商业闭源 .NET 代码保护与授权工具(Eziriz 出品;非开源项目,无公开仓库)
项目主页: https://www.eziriz.com/(Eziriz 商业产品官网)
官网: https://www.eziriz.com/dotnet_reactor.htm
下载: https://www.eziriz.com/downloads.htm
版本: 7.5.0.0(官网下载页标注,Release date 2025-11-12;商业闭源,不在 NuGet 分发,截至 2026-10 实测)
许可证: 商业(提供个人/企业/全球许可证)
说明: 本 SKILL 仅作为技术使用说明,请确保使用 .NET Reactor 时拥有合法授权,并仅对自己拥有版权的代码使用。
概述
.NET Reactor 主要功能:
- 代码加密:将 IL 编译为本机受保护代码(Necrobit)
- 混淆:方法名/类名/字段名重命名、控制流模糊
- 字符串加密:常量字符串运行时解密
- 资源加密 / 压缩
- 反调试 / 反篡改 / Anti-ILdasm
- 许可证系统:序列号 / 硬件绑定 / 试用期 / 黑名单
- 合并程序集:将依赖 dll 合并入主可执行文件
- 支持目标:.NET Framework 2.0 – 4.8、.NET Core / .NET 5-10、Mono、Xamarin、Unity
安装与启动
.NET Reactor 是商业闭源 Windows 桌面工具,不走 NuGet,安装方式只有下面两种:
方式一:官网安装包(推荐)
- 打开 https://www.eziriz.com/downloads.htm,下载 .NET Reactor 7.5.0.0(Demo 版可先试用)
- 安装后启动,输入购买的 License 完成激活
- 主界面:左侧选项卡(Files / Protection / Native EXE File / License Manager / ...)
方式二:命令行工具单独分发(CI 用)
把安装目录下的 dotNET_Reactor.Console.exe 及其依赖复制到构建机,用 .nrproj 配置文件驱动,无需 GUI。
# 验证安装:控制台工具能启动并打印用法
# 安装路径因版本与安装选项而异,先在安装目录里定位到 dotNET_Reactor.Console.exe
"<安装目录>/dotNET_Reactor.Console.exe"
Linux 构建机无法跑 GUI,只能通过 Wine 或 Windows 构建 agent 执行
dotNET_Reactor.Console;跨平台流水线请把保护步骤放到 Windows runner 上。
也支持命令行 dotNET_Reactor.Console.exe 与 MSBuild 集成(CI 友好)。
基本保护流程(GUI)
- Files → Add Files:添加要保护的 .exe / .dll
- Protection 选项卡:
- Necrobit Protection(IL 加密,推荐必开)
- Anti ILDASM
- Anti Tampering
- Obfuscation → 重命名
- Control Flow Obfuscation
- String Encryption
- Resource Encryption / Compression(按需)
- Anti Debug
- Native EXE File(可选):将 EXE 编译为原生壳
- Output Path:输出目录
- 点击 Protect
完成后建议:
- 将原 dll/exe 备份
- 仅分发保护后的版本
- 测试运行(保护可能影响反射、序列化、IL 注入框架)
命令行(CI / 构建集成)
dotNET_Reactor.Console -project myproj.nrproj
# 或直接传参
dotNET_Reactor.Console -file App.dll \
-targetfile Protected\App.dll \
-necrobit 1 -obfuscation 1 -control_flow_obfuscation 1 \
-string_encryption 1 -anti_ildasm 1 -anti_tampering 1
-project 即保存的 GUI 配置(.nrproj XML)。
MSBuild 集成
<Target Name="Protect" AfterTargets="Build">
<Exec Command="dotNET_Reactor.Console -project $(MSBuildThisFileDirectory)protect.nrproj"/>
</Target>
排除规则(不重命名公开 API)
通过 GUI Obfuscation 选项卡或属性:
[Obfuscation(Exclude = true, ApplyToMembers = true)]
public class PublicApi
{
public string Hello() => "hi";
}
或在 .nrproj 中手动配置 Exclude 表。
推荐排除:
- 公共 API、对外 SDK
- 反射调用的方法 / 类型
- 序列化字段(JSON/XML/Protobuf)
- WPF/WinForms 控件类型(XAML 绑定)
- DI 容器扫描的服务
许可证 / 软件授权
1. 在主程序加入许可校验
下载 License Generator + License Library(Eziriz 提供),在代码中:
using DNR.LicenseManager;
if (!License.IsValid()) {
// 显示注册窗体或退出
Application.Exit();
}
将类标记为不可重命名:
[Obfuscation(Exclude = true, ApplyToMembers = true)]
public static class License { ... }
2. 在 GUI 启用 License Manager
License Manager 选项卡 → Enable Licensing → 配置:
- Type:Time-Limited / Hardware-Locked / Single Use
- Public Key:粘贴生成的公钥
- 校验失败动作:退出 / 显示对话框
3. 使用 License Generator 生成序列号
- Hardware ID:客户机器唯一码
- Expire Date:到期日
- Custom Data:自定义信息(用户名/邮箱)
试用版
GUI → License Manager → Trial Settings:
- 试用天数 / 启动次数
- 试用结束动作:禁用功能 / 提示购买 / 退出
反调试 / 反篡改
GUI → Advanced:
- Anti Debug:检测调试器 → 立即退出
- Anti Tampering:校验程序集签名 / Hash
- VM Detection:检测虚拟机
- Anti ILDASM:标记元数据让 ILDASM 拒绝
程序集合并
Files → Add multi assemblies → Merge Assemblies:将依赖打包到主 exe:
- 减少分发文件数
- 一并保护依赖
- 注意:合并后程序集的强签名失效;反射
Assembly.GetExecutingAssembly().Location可能变化
.NET Core / .NET 5+ 注意事项
- 选择对应运行时(CoreCLR)
- AOT 程序(NativeAOT)目前不支持保护,必须使用 JIT 模式
dotnet publish -c Release后再保护,对 self-contained 多文件目录可批量保护- 单文件发布:先生成单文件,再保护其外层 EXE 可能受限;建议保护 framework-dependent dll
与开源混淆器对比
| 工具 | 类型 | 强度 | 注意 |
|---|---|---|---|
| .NET Reactor | 商业 | 高(IL 加密 + 控制流) | 收费 |
| ConfuserEx 2 | 开源 | 中 | 维护活跃度低 |
| Obfuscar | 开源 | 仅重命名 | 简单稳定 |
| Eazfuscator.NET | 商业 | 高 | 收费 |
典型工作流
工作流一:首次保护一个发布包
- 在 GUI 里 Add Files 加入待保护的 .exe / .dll
- Protection 选项卡逐项勾选:Necrobit(IL 加密)+ Obfuscation + Control Flow + String Encryption + Anti ILDASM/Anti Tampering,按需再加资源加密
- 用排除规则把反射、序列化、XAML 绑定用到的类型排除掉
- 设 Output Path 后点 Protect,备份原始程序集,只分发保护后的版本
- 对保护后的产物跑一遍回归测试(反射、序列化、插件加载最容易被影响)
工作流二:接入 CI / MSBuild
- GUI 里调好参数后保存
.nrproj(XML),提交进仓库 - 构建脚本调用
dotNET_Reactor.Console -project xxx.nrproj,或直接传-file/-targetfile/-necrobit/-obfuscation/...参数 - MSBuild 用
AfterTargets="Build"的 Exec 任务自动执行 - 构建完在流水线上跑冒烟测试,确认保护没有破坏启动与授权校验
常见问题
| 问题 | 解决 |
|---|---|
反射 Type.GetType("...") 失败 |
排除被反射的类型/方法 |
| 序列化字段丢失 | JSON 用 [JsonProperty] 显式映射;或排除字段 |
| WPF XAML 绑定失败 | 排除被 XAML 引用的类型与属性 |
| 启动慢 | Necrobit 解密成本;可关闭部分保护项 |
| 被 AV 误报 | 联系杀软厂商加白;选择「Anti Debug = Mild」 |
| Linux 运行报错 | Necrobit 对 Linux / .NET Core 的支持依赖较新版本,需升级后实测验证 |
AI 使用建议
推荐工作流
- 先确定保护目标:反编译防护 → Necrobit + Obfuscation,授权管理 → License Manager,分发简化 → Merge Assemblies
- GUI 先调参:在 GUI 中逐项测试保护效果,保存
.nrproj配置文件 - CI 集成:将
.nrproj加入仓库,MSBuild AfterTarget 自动保护 - 排除反射类型:扫描项目中所有
Type.GetType()/Assembly.Load()调用,加入 Exclude 列表 - 测试验证:对保护后的程序集跑完整回归测试
关键模式与常见陷阱
- 反射失效:混淆后
Type.GetType("全名")会失败,必须排除被反射的类型 - 序列化字段丢失:JSON/XML/Protobuf 序列化的属性名改变后反序列化失败,需
[Obfuscation(Exclude=true)] - WPF XAML 绑定断裂:XAML 中
{Binding Path=Name}依赖属性名,必须排除被绑定的类型 - DI 容器扫描失败:
ITransient/IScoped接口按名称匹配的服务可能失效 - 强签名失效:合并程序集后强签名会丢失,需在保护后重新签名
- AV 误报:Necrobit 加密壳可能被杀软标记,建议联系厂商加白;可选择 Mild 模式降低误报
如何选择正确方案
| 场景 | 推荐方案 |
|---|---|
| 商业软件防破解 | .NET Reactor(Necrobit + 授权) |
| 开源项目基础混淆 | Obfuscar(免费,仅重命名) |
| 无需混淆(API 已鉴权) | 不保护,靠服务端鉴权 |
| 单文件分发 | Merge Assemblies + 保护 |
相关技能
- furion — .NET Web 框架,dotnet-reactor 可保护 Furion 构建的 API/桌面应用:../furion/SKILL.md
- admin-net-backend — 典型可分发后台项目,保护后需逐项验证动态 API 与反射调用:../admin-net-backend/SKILL.md
- sentry — 保护后堆栈需反混淆,配合 Debug Files / Release 还原符号:../sentry/SKILL.md
- serilog — 保护前后的运行日志,用于确认反射与序列化是否被破坏:../serilog/SKILL.md
参考资源
- 官网与用户手册:https://www.eziriz.com/dotnet_reactor.htm
- 中文教程(znlgis):https://znlgis.github.io/csharp/dotnet-reactor/