Jar包加密工具 ClassFinal
- 介绍
- 环境依赖
- 使用说明
- 下载
- 加密
- 命令行
- 示例
- maven插件方式
- 无密码模式
- 机器绑定
- 启动加密后的jar
- 启动参数给密码
- 不加密码参数直接启动
- 1. 密码文件获取
- 2. 交互输入
- 参考资料
介绍
ClassFinal 是一款 java class 文件安全加密工具,支持直接加密jar
包或war
包,无需修改任何项目代码,兼容spring-framework;可避免源码泄漏或字节码被反编译。
加密后,原始的class
文件中方法体被清空,当class
被classloader
加载时,真正的方法体会被解密注入。
为兼容spring
,swagger
等扫描注解的框架,故而保留了方法参数
、注解
等信息;
反编译者只能看到方法名和注解;
环境依赖
JDK 1.8 +
使用说明
下载
点此下载
加密
命令行
执行以下命令
java -jar classfinal-fatjar.jar -file jerry.jar -libjars a.jar,b.jar -packages com.jerry1,com.jerry2 -exclude com.jerry.Main -pwd 123456 -Y
参数说明
-file 加密的jar/war完整路径
-packages 加密的包名(可为空,多个用","分割)
-libjars jar/war包lib下要加密jar文件名(可为空,多个用","分割)
-cfgfiles 需要加密的配置文件,一般是classes目录下的yml或properties文件(可为空,多个用","分割)
-exclude 排除的类名(可为空,多个用","分割)
-classpath 外部依赖的jar目录,例如/tomcat/lib(可为空,多个用","分割)
-pwd 加密密码,如果是#号,则使用无密码模式加密
-code 机器码,在绑定的机器生成,加密后只可在此机器上运行
-Y 无需确认,不加此参数会提示确认以上信息
结果: 生成加密后的jar文件 jerry-encrypted.jar
。执行时需带 javaagent
参数。
注: 也可以直接执行 java -jar classfinal-fatjar.jar 以交互式操作。
示例
我的jar包:jerry.jar
,密码123456
java -jar classfinal-fatjar-1.2.1.jar -file jerry.jar -packages com.jerry -pwd 123456 -Y
=========================================================
= =
= Java Class Encryption Tool v1.2.1 by Mr.K =
= =
=========================================================
加密信息如下:
-------------------------
1. jar/war路径: jerry.jar
2. lib下的jar:
3. 包名前缀: com.jerry
4. 排除的类名:
5. 加密配置文件:
6. ClassPath:
7. 密码: 123456
8. 机器码:
-------------------------
处理中...
加密完成,请牢记密码!
==>jerry-encrypted.jar
maven插件方式
在要加密的项目pom.xml中加入以下插件配置,目前最新版本是:1.2.1。
<plugin>
<!-- https://gitee.com/roseboy/classfinal -->
<groupId>net.roseboy</groupId>
<artifactId>classfinal-maven-plugin</artifactId>
<version>${classfinal.version}</version>
<configuration>
<password>000000</password><!--加密打包之后pom.xml会被删除,不用担心在jar包里找到此密码-->
<packages>com.yourpackage,com.yourpackage2</packages>
<cfgfiles>application.yml</cfgfiles>
<excludes>org.spring</excludes>
<libjars>a.jar,b.jar</libjars>
</configuration>
<executions>
<execution>
<phase>package</phase>
<goals>
<goal>classFinal</goal>
</goals>
</execution>
</executions>
</plugin>
运行mvn package
时会在target
下自动加密生成yourpaoject-encrypted.jar
。
maven 插件的参数名称与直接运行的参数相同,请参考上节的参数说明。
无密码模式
- 加密时
-pwd
参数设为#
,启动时可不用输入密码; - 如果是war包,启动时指定参数
-nopwd
,跳过输密码过程。
机器绑定
机器绑定只允许加密的项目在特定的机器上运行;
加密时用 -code
指定机器码。机器绑定可同时支持机器码
+密码
的方式加密。
在需要绑定的机器上执行以下命令,生成机器码
java -jar classfinal-fatjar.jar -C
启动加密后的jar
加密后的项目需要设置 javaagent
来启动,项目在启动过程中解密class,完全内存解密,不留下任何解密后的文件。
解密功能已经自动加入到 yourpaoject-encrypted.jar
中,所以启动时 -javaagent
与 -jar
相同,不需要额外的jar包。
密码读取顺序:
参数获取
>> 环境变量获取
>> 密码文件获取
>> 控制台输入
>> GUI输入
>> 退出
启动参数给密码
启动jar项目执行以下命令:注意:如果是win系统 "-pwd 0000000"
这里要用双引号。
java -javaagent:jerry-encrypted.jar="-pwd 0000000" -jar jerry-encrypted.jar
//参数说明
// -pwd 加密项目的密码
// -pwdname 环境变量中密码的名字
不加密码参数直接启动
1. 密码文件获取
java -javaagent:yourpaoject-encrypted.jar -jar yourpaoject-encrypted.jar
不加 pwd
参数直接启动,优先从密码文件
读取。
在同级目录下的classfinal.txt
或jerry-encrypted.classfinal.txt
中写入密码。
直接给密码:classfinal.txt
123456
参数化配置启动后删除:classfinal.txt
--pwd 123456 --del yes
这里的del
只要不给false
或no
都会删除。
项目读取到密码后会清空此文件。
2. 交互输入
没有找到 密码文件
就会进入交互输入模式:先控制台输入
还是没给密码就会进入 GUI输入
模式,都不给密码,就报错退出了。
- 控制台输入
- GUI输入
参考资料
Gitee: https://gitee.com/roseboy/classfinal