使用ClassFinal对java项目加密

曾经终败给现在 2024-04-01 19:39 97阅读 0赞

### 一、ClassFinal介绍 ###

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

依赖环境：jdk1.8

Gitee: [ClassFinal: Java字节码加密工具][ClassFinal_ Java]

**1、项目模块说明**

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

**2、功能特性**

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

### 二、使用说明 ###

**1、加密某个jar**

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按照步骤提示输入信息完成加密。

**2、maven插件执行：**

<plugin>
        
        <groupId>net.roseboy</groupId>
        <artifactId>classfinal-maven-plugin</artifactId>
        <version>${classfinal.version}</version>
        <configuration>
            <password>000000</password>
            <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插件的参数名称与直接运行的参数相同，请参考上节的参数说明。

**3、无密码模式：**

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

**4、机器绑定：**

机器绑定只允许加密的项目在特定的机器上运行；在需要绑定的机器上执行以下命令，生成机器码

java -jar classfinal-fatjar.jar -C

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

**5、启动加密后的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

密码读取顺序已经改为：参数获取密码||环境变量获取密码||密码文件获取密码||控制台输入密码||GUI输入密码||退出 （CoreAgent.java源码里可以看到这个逻辑）

假设我们启动时不指定密码，如下：

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

这是会在命令行中要求输入密码：

![d3dfc411f4814bf9a7deb6ce53aad458.png][]

**6、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  环境变量中密码的名字

**补充：使用密码文件获取密码**

在youproject-encryted.jar同目录下，见一个文件classfinal.txt，里面明文写好密码，然后通过如下命令启动：

java -javaagent:model_api-0.0.1-SNAPSHOT-encrypted.jar -jar model_api-0.0.1-SNAPSHOT-encrypted.jar

这样就可以直接启动了。如果希望启动后把文件里的密码删除，可以通过如下方式：

java -javaagent:model_api-0.0.1-SNAPSHOT-encrypted.jar='-del yes' -jar model_api-0.0.1-SNAPSHOT-encrypted.jar

从CoreAgent.java源码中可以看到，按照上面方式在启动后可以删除文件中的密码，但是实际执行中没有删除，原因是代码中有个bug：

![02e53cc976244d45be6a13ce2bd16831.png][]

该项目的仓库已经处于暂停状态，无法提交pr了。。。

### 三、ClassFinal原理 ###

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

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

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

ClassFinal会将原class文件加密，然后保存到一个地方（源码很简单，可以很容易找到写在了哪里），当启动时从加密的文件中再解密恢复。

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

[ClassFinal_ Java]: https://gitee.com/roseboy/classfinal
[d3dfc411f4814bf9a7deb6ce53aad458.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/01/4ce696a3ecb840fd8d999b7ea45b9521.png
[02e53cc976244d45be6a13ce2bd16831.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/01/a4dd10b9c3314b2d885496425545e848.png