[有意思的代码] ClassFinal: Java字节码加密工具

[](#classfinal)ClassFinal

[](#%E4%BB%8B%E7%BB%8D)介绍

ClassFinal是一款java class文件安全加密工具，支持直接加密jar包或war包，无需修改任何项目代码，兼容spring-framework；可避免源码泄漏或字节码被反编译。

[](#gitee-httpsgiteecomroseboyclassfinal)Gitee: https://gitee.com/roseboy/classfinal

[](#%E9%A1%B9%E7%9B%AE%E6%A8%A1%E5%9D%97%E8%AF%B4%E6%98%8E)项目模块说明

  • classfinal-core: ClassFinal的核心模块，几乎所有加密的代码都在这里；
  • classfinal-fatjar: ClassFinal打包成独立运行的jar包；
  • classfinal-maven-plugin: ClassFinal加密的maven插件；

[](#%E5%8A%9F%E8%83%BD%E7%89%B9%E6%80%A7)功能特性

  • 无需修改原项目代码，只要把编译好的jar/war包用本工具加密即可。
  • 运行加密项目时，无需求修改tomcat，spring等源代码。
  • 支持普通jar包、springboot jar包以及普通java web项目编译的war包。
  • 支持spring framework、swagger等需要在启动过程中扫描注解或生成字节码的框架。
  • 支持maven插件，添加插件后在打包过程中自动加密。
  • 支持加密WEB-INF/lib或BOOT-INF/lib下的依赖jar包。
  • 支持绑定机器，项目加密后只能在特定机器运行。
  • 支持加密springboot的配置文件。

[](#%E7%8E%AF%E5%A2%83%E4%BE%9D%E8%B5%96)环境依赖

JDK 1.8 +

[](#%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E)使用说明

[](#%E4%B8%8B%E8%BD%BD)下载

点此下载

[](#%E5%8A%A0%E5%AF%86)加密

执行以下命令

java -jar classfinal-fatjar.jar -file yourpaoject.jar -libjars a.jar,b.jar -packages com.yourpackage,com.yourpackage2 -exclude com.yourpackage.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 无需确认，不加此参数会提示确认以上信息

结果: 生成 yourpaoject-encrypted.jar，这个就是加密后的jar文件；加密后的文件不可直接执行，需要配置javaagent。

注: 以上示例是直接用参数执行，也可以直接执行 java -jar classfinal-fatjar.jar按照步骤提示输入信息完成加密。

[](#maven%E6%8F%92%E4%BB%B6%E6%96%B9%E5%BC%8F)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插件的参数名称与直接运行的参数相同，请参考上节的参数说明。

[](#%E6%97%A0%E5%AF%86%E7%A0%81%E6%A8%A1%E5%BC%8F)无密码模式

加密时-pwd参数设为#，启动时可不用输入密码； 如果是war包，启动时指定参数 -nopwd，跳过输密码过程。

[](#%E6%9C%BA%E5%99%A8%E7%BB%91%E5%AE%9A)机器绑定

机器绑定只允许加密的项目在特定的机器上运行；

在需要绑定的机器上执行以下命令，生成机器码

java -jar classfinal-fatjar.jar -C

加密时用-code指定机器码。机器绑定可同时支持机器码+密码的方式加密。

[](#%E5%90%AF%E5%8A%A8%E5%8A%A0%E5%AF%86%E5%90%8E%E7%9A%84jar)启动加密后的jar

加密后的项目需要设置javaagent来启动，项目在启动过程中解密class，完全内存解密，不留下任何解密后的文件。

解密功能已经自动加入到 yourpaoject-encrypted.jar中，所以启动时-javaagent与-jar相同，不需要额外的jar包。

启动jar项目执行以下命令：

java -javaagent:yourpaoject-encrypted.jar='-pwd 0000000' -jar yourpaoject-encrypted.jar
//参数说明
// -pwd 加密项目的密码
// -pwdname 环境变量中密码的名字

或者不加pwd参数直接启动，启动后在控制台里输入密码，推荐使用这种方式：

java -javaagent:yourpaoject-encrypted.jar -jar yourpaoject-encrypted.jar

使用nohup命令启动时，如果系统支持gui，会弹出输入密码的界面，如果是纯命令行下，不支持gui，则需要在同级目录下的classfinal.txt或yourpaoject-encrypted.classfinal.txt中写入密码，项目读取到密码后会清空此文件。

密码读取顺序已经改为：参数获取密码||环境变量获取密码||密码文件获取密码||控制台输入密码||GUI输入密码||退出

[](#tomcat%E4%B8%8B%E8%BF%90%E8%A1%8C%E5%8A%A0%E5%AF%86%E5%90%8E%E7%9A%84war)tomcat下运行加密后的war

将加密后的war放在tomcat/webapps下， tomcat/bin/catalina 增加以下配置:

//linux下 catalina.sh
CATALINA_OPTS="$CATALINA_OPTS -javaagent:classfinal-fatjar.jar='-pwd 0000000'";
export CATALINA_OPTS;
//win下catalina.bat
set JAVA_OPTS="-javaagent:classfinal-fatjar.jar='-pwd 000000'"
//参数说明
// -pwd 加密项目的密码
// -nopwd 无密码加密时启动加上此参数，跳过输密码过程
// -pwdname 环境变量中密码的名字

    • *
本工具使用AES算法加密class文件，密码是保证不被破解的关键，请保存好密码，请勿泄漏。

密码一旦忘记，项目不可启动且无法恢复，请牢记密码。

本工具加密后，原始的class文件并不会完全被加密，只是方法体被清空，保留方法参数、注解等信息，这是为了兼容spring，swagger等扫描注解的框架； 方法体被清空后，反编译者只能看到方法名和注解，看不到方法的具体内容；当class被classloader加载时，真正的方法体会被解密注入。

为了保证项目在运行时的安全，启动jvm时请加参数: -XX:+DisableAttachMechanism 。

[](#%E7%89%88%E6%9C%AC%E8%AF%B4%E6%98%8E)版本说明

  • v1.2.1 bug修复
  • v1.2.0 packages、libjars、cfgfiles、exclude 参数增加通配符功能
  • v1.1.7 支持加密springboot的配置文件；增加环境变量中读取密码
  • v1.1.6 增加机器绑定功能
  • v1.1.5 增加无密码加密方式，启动无需输密码，但是并不安全
  • v1.1.4 纯命令行下运行jar时，从配置文件中读取密码，读取后清空文件
  • v1.1.3 加入输入密码的弹框
  • v1.1.2 修复windows下加密后不能启动的问题
  • v1.1.1 启动jar时在控制台输入密码，无需将密码放在参数中
  • v1.1.0 加密jar包时将解密代码加入加密后的jar包，无需使用多余的jar文件
  • v1.0.0 第一个正式版发布

[](#%E5%8D%8F%E8%AE%AE%E5%A3%B0%E6%98%8E)协议声明

Apache-2.0

原网址: 访问
创建于: 2021-03-03 11:28:50
目录: default
标签: 无

未标明原创文章均为采集，版权归作者所有，转载无需和我联系，请注明原出处，南摩阿彌陀佛，知识，不只知道，要得到

请先后发表评论
  • 最新评论
  • 总共0条评论