Obfuscar的使用

1、在程序中nuget安装Obfuscar

 2、在工程中新建Obfuscar.xml文件,内容如下

<?xml version='1.0'?>
<Obfuscator>
	<!-- 输入的工作路径,采用如约定的 Windows 下的路径表示法,如以下表示当前工作路径 -->
	<!-- 推荐使用当前工作路径,因为 DLL 的混淆过程,需要找到 DLL 的所有依赖。刚好当前工作路径下,基本都能满足条件 -->
	<Var name="InPath" value="." />
	<!-- 混淆之后的输出路径,如下面代码,设置为当前工作路径下的 Obfuscar 文件夹 -->
	<!-- 混淆完成之后的新 DLL 将会存放在此文件夹里 -->
	<Var name="OutPath" value=".\Obfuscar" />
	<!-- 以下的都是细节的配置,配置如何进行混淆 -->

	<!-- 使用 KeepPublicApi 配置是否保持公开的 API 不进行混淆签名,如公开的类型公开的方法等等,就不进行混淆签名了 -->
	<!-- 语法的写法就是 name 表示某个开关,而 value 表示值 -->
	<!-- 对于大部分的库来说,设置公开的 API 不进行混淆是符合预期的 -->
	<Var name="KeepPublicApi" value="true" />
	<!-- 设置 HidePrivateApi 为 true 表示,对于私有的 API 进行隐藏,隐藏也就是混淆的意思 -->
	<!-- 可以通过后续的配置,设置混淆的方式,例如使用 ABC 字符替换,或者使用不可见的 Unicode 代替 -->
	<Var name="HidePrivateApi" value="true" />
	<!-- 设置 HideStrings 为 true 可以设置是否将使用的字符串进行二次编码 -->
	<!-- 由于进行二次编码,将会稍微伤一点点性能,二次编码需要在运行的时候,调用 Encoding 进行转换为字符串 -->
	<Var name="HideStrings" value="true" />
	<!-- 设置 UseUnicodeNames 为 true 表示使用不可见的 Unicode 字符代替原有的命名,通过此配置,可以让反编译看到的类和命名空间和成员等内容都是不可见的字符 -->
	<Var name="UseUnicodeNames" value="true" />
	<!-- 是否复用命名,设置为 true 的时候,将会复用命名,如在不同的类型里面,对字段进行混淆,那么不同的类型的字段可以是重名的 -->
	<!-- 设置为 false 的时候,全局将不会有重复的命名 -->
	<Var name="ReuseNames" value="true" />
	<!-- 配置是否需要重命名字段,默认配置了 HidePrivateApi 为 true 将都会打开重命名字段,因此这个配置的存在只是用来配置为 false 表示不要重命名字段 -->
	<Var name="RenameFields" value="true" />
	<!-- 是否需要重新生成调试信息,生成 PDB 符号文件 -->
	<Var name="RegenerateDebugInfo" value="false" />

	<Var name="OptimizeMethods" value="true"/>

	<Var name="SuppressIldasm" value="false"/>

	<!-- 需要进行混淆的程序集,可以传入很多个,如传入一排排 -->
	<!-- <Module file="$(InPath)\Lib1.dll" /> -->
	<!-- <Module file="$(InPath)\Lib2.dll" /> -->
	<Module file="$(InPath)\FengHua.Converter2.dll">
		<!--SkipType跳过指定的类 Program是Main所在的类名-->
		<!--
		<SkipType name="Program"  />
		-->
		<!--SkipMethod 跳过指定的方法-->
		<!--
		<SkipMethod type="Program" name="Main"/>-->
	</Module>


	<!-- 程序集的引用加载路径,对于 dotnet 6 应用,特别是 WPF 或 WinForms 项目,是需要特别指定引用加载路径的 -->
	<!-- 这里有一个小的需要敲黑板的知识点,应该让 Microsoft.WindowsDesktop.App 放在 Microsoft.NETCore.App 之前 -->
	<!-- 对于部分项目,如果没有找到如下顺序,将会在混淆过程中,将某些程序集解析为旧版本,从而失败 -->
	<!--<AssemblySearchPath path="C:\Program Files\dotnet\shared\Microsoft.WindowsDesktop.App\6.0.1\" />
	<AssemblySearchPath path="C:\Program Files\dotnet\shared\Microsoft.NETCore.App\6.0.1\" />-->
</Obfuscator>

其中

 3、设置生成事件指令

 

"$(Obfuscar)" Obfuscar.xml

4、最后编译运行即可。

### Obfuscar 的基本概念 Obfuscar 是一种用于保护 .NET 应用程序的开源混淆工具,它通过对代码中的方法、类和字段进行重命名,并对字符串进行编码等方式来增加反编译的难度[^1]。此外,Obfuscar 还支持控制流混淆、字符串加密以及资源文件保护等多种功能,从而进一步提升代码的安全性[^2]。 --- ### 如何使用 Obfuscar 对 .NET 项目进行混淆保护 以下是关于如何配置并运行 Obfuscar 来实现代码混淆的具体说明: #### 1. 安装 Obfuscar 可以从 NuGet 或者 GitHub 上获取 Obfuscar 工具。如果选择通过 NuGet 安装,则可以在 Visual Studio 中执行以下命令: ```bash Install-Package Obfuscar ``` 对于手动安装的情况,可以下载 Obfuscar 的二进制文件并将其集成到构建流程中。 #### 2. 配置 `obfuscar.xml` 文件 Obfuscar 使用 XML 文件作为配置输入。下面是一个简单的 `obfuscar.xml` 示例配置文件: ```xml <Obfuscator> <Var name="InPath" value="bin\Release\" /> <Var name="OutPath" value="bin\Obfuscated\" /> <Var name="KeepPublicApi" value="true" /> <Module file="$(InPath)MyApp.exe" /> </Obfuscator> ``` 在此配置中: - **InPath**: 输入目录路径,指定要混淆的应用程序所在的文件夹。 - **OutPath**: 输出目录路径,指定混淆后的文件存储位置。 - **KeepPublicApi**: 是否保留公共 API 不变(通常设置为 true,以便外部调用不受影响)。 - **Module**: 要混淆的目标模块或可执行文件。 #### 3. 执行混淆过程 完成上述配置后,可以通过命令行启动 Obfuscar 并传递配置文件参数: ```bash Obfuscar.Console.exe obfuscar.xml ``` 此命令会读取 `obfuscar.xml` 文件的内容并对目标程序集应用相应的混淆策略。 #### 4. 自定义高级选项 除了基础的功能外,还可以启用更复杂的混淆技术,例如: - 控制流混淆:改变代码逻辑结构以使分析更加困难。 - 字符串加密:隐藏敏感数据,防止硬编码密码或其他机密信息泄露。 这些特性都可以在 `obfuscar.xml` 文件中通过额外的 `<Rule>` 标签定义。 --- ### 示例代码片段展示 假设有一个简单的 C# 类如下所示: ```csharp namespace MyApp { public class SecretClass { private string secretKey = "mySecret"; public void PrintSecret() { Console.WriteLine(secretKey); } } } ``` 经过 Obfuscar 处理之后,原始变量名如 `secretKey` 和函数名如 `PrintSecret()` 将会被替换为难以理解的形式,比如 `_a0b1c2d3e4` 或类似的随机字符组合。 --- ### 注意事项 尽管 Obfuscar 提供了强大的保护能力,但也需要注意一些潜在问题: - 如果启用了过于激进的混淆规则,可能会破坏某些依赖反射机制的功能。 - 某些第三方库可能无法正常工作,因此建议针对特定组件排除混淆范围。 ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值