代码混淆之class-winter

迈不过友情╰ 2022-10-06 14:47 9阅读 0赞

#### **郑重声明** ####

[**class-winter**][class-winter]是本人在学习完[**class-final(v1.1.9)**][class-final_v1.1.9]后，仿照class-final进行编写的，整体思路与class-final一致，代码部分(约20%~30%)复用了class-final中的代码。可将class-winter看作是class-final的一个分支。

### 功能与特性 ###

*  支持war加密。
 *  支持jar(普通jar+可执行jar)加密。

### 加密 ###

*  #### **方式一**：通过maven插件自动加密。 ####
    
        
        <plugin>
            <groupId>com.idea-aedi</groupId>
            <artifactId>class-winter-maven-plugin</artifactId>
            <version>最新版本号</version>
            
            <configuration>
                
                <includePrefix>加密范围</includePrefix>
                
                
                
                
                
                
                
            </configuration>
            <executions>
                <execution>
                    <phase>package</phase>
                    <goals>
                        <goal>class-winter</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    
    注：不必担心信息泄漏问题，使用此方式生成混淆的jar包时，会擦除pom.xml中关于class-winter-plugin的信息。
 *  #### **方式二**：通过[**class-winter-core.jar**][class-winter-core.jar]主动加密。 ####
    
        java -jar class-winter-core-${version}.jar originJarOrWar=${要加密的项目.jar或.war包} includePrefix=${加密范围} [k3=v3 k4=v4 ...]
        # 对于复杂的参数值，可以使用引号引起来
        # linux
        java -jar class-winter-core-${version}.jar k1='v1' k2='v2'
        # windows
        java -jar class-winter-core-${version}.jar k1="v1" k2="v2"

### 加密参数 ###

<table> 
 <tbody> 
  <tr> 
   <td>参数</td> 
   <td>是否必填</td> 
   <td>说明</td> 
   <td>示例</td> 
  </tr> 
  <tr> 
   <td>originJarOrWar</td> 
   <td>是</td> 
   <td>指定要加密的jar/war文件<br>注：当使用maven插件进行自动加密时，无此参数。</td> 
   <td>originJarOrWar=/my-project.jar</td> 
  </tr> 
  <tr> 
   <td>includePrefix</td> 
   <td>是</td> 
   <td>通过前缀匹配的形式定位要加密的class <br> 注：多个通过逗号分割。</td> 
   <td>includePrefix=com <br> includePrefix=com,org</td> 
  </tr> 
  <tr> 
   <td>excludePrefix</td> 
   <td>否</td> 
   <td>通过前缀匹配的形式排除class，不对其加密 <br> 注：多个通过逗号分割。 <br> 注:excludePrefix优先级高于includePrefix。</td> 
   <td>excludePrefix=com.example.service,com.example.util.StrUtil.class</td> 
  </tr> 
  <tr> 
   <td>finalName</td> 
   <td>否</td> 
   <td>指定加密后生成的jar包名 <br> 注：若finalName与加密的包一致，那么生成的加密后的包会覆盖原来的包。</td> 
   <td>finalName=mine-project</td> 
  </tr> 
  <tr> 
   <td>password</td> 
   <td>否</td> 
   <td>主动指定密码 <br> 注：密码不能包含空格和逗号。</td> 
   <td>password=123456</td> 
  </tr> 
  <tr> 
   <td>includeLibs</td> 
   <td>否</td> 
   <td>指定将lib包也纳入加密范围内 <br> 注:多个通过逗号分割。 <br> 注：lib中的class是否会被加密，还得由includePrefix和excludePrefix决定。</td> 
   <td>includeLibs=a.jar,b.jar</td> 
  </tr> 
  <tr> 
   <td>alreadyProtectedLibs</td> 
   <td>否</td> 
   <td>指明项目所以来的lib中，哪些lib本身就已经是被class-winter加密了的 <br> 注：多个通过逗号分割。 <br> 注:主要用于处理第三方提供的由class-winter加密了的依赖包的场景。 <br> 注：若lib需要密码，那么需要在指定lib的同时通过冒号接上密码。 <br> 注：如果lib有密码，那么密码不能包含逗号。</td> 
   <td>alreadyProtectedLibs=a.jar,b.jar <br> alreadyProtectedLibs=a.jar,b.jar:pwd123 <br> alreadyProtectedLibs=a.jar:pwd1,b.jar:2</td> 
  </tr> 
  <tr> 
   <td>supportFile</td> 
   <td>否</td> 
   <td>指定一个加密辅助jar文件（或jar文件所在的目录） <br> 注：当为目录时，该目录(含子孙目录)下的所有jar都会被作采集作为辅助文件。 <br> 注:主要用于解决因ClassNotFound导致的加密失败问题。</td> 
   <td>supportFile=/abc.jar <br> supportFile=/libs</td> 
  </tr> 
  <tr> 
   <td>tips</td> 
   <td>否</td> 
   <td>指定提示语。 <br> 注：当直接使用加密后的jar/war时，用到了加密了的类后，会先System.err.println输出此tips,然后System.exit退出程序。</td> 
   <td>windows示例：tips="请不要直接使用混淆后的jar/war" <br> linux示例：tips='请不要直接使用混淆后的jar/war'</td> 
  </tr> 
  <tr> 
   <td>debug</td> 
   <td>否</td> 
   <td>是否开启debug模式</td> 
   <td>debug=true</td> 
  </tr> 
 </tbody> 
</table>

### 解密(启动) ###

通过-javaagent指定代理进行解密启动。

*  #### jar解密(启动) ####
    
        # 假设your-project-encrypted.jar是由class-winter加密后的包，那么你可以这么启动
        java -javaagent:/your-project-encrypted.jar -jar /your-project-encrypted.jar
        # 也可以用class-winter-core-1.0.0.jar
        # java -javaagent:/class-winter-core-1.0.0.jar -jar /your-project-encrypted.jar
        # 或者指定参数
        # java -javaagent:/your-project-encrypted.jar=debug=true,password=pwd12345 -jar /your-project-encrypted.jar
        # 参数可以引起来(linux)
        # java -javaagent:/your-project-encrypted.jar='debug=true,password=pwd12345' -jar /your-project-encrypted.jar
        # 参数可以引起来(windows)
        # java -javaagent:/your-project-encrypted.jar="debug=true,password=pwd12345" -jar /your-project-encrypted.jar
 *  #### war解密(启动) ####
    
    > **以Tomcat9为例**
    
     *  linux方式一
        
        编辑tomcat/bin/catalina.sh文件，在最上面加上
        
            # 如果你有参数， 那么 -javaagent:/class-winter-core-1.0.0.jar=k1=v1,k2=v2
            CATALINA_OPTS="$CATALINA_OPTS -javaagent:/class-winter-core-1.0.0.jar=debug=true";
            export CATALINA_OPTS;
     *  linux方式二
        
        在tomcat/bin目录下创建setenv.sh文件，并写上
        
            # 如果你有参数， 那么 -javaagent:/class-winter-core-1.0.0.jar=k1=v1,k2=v2
            JAVA_OPTS="$JAVA_OPTS -javaagent:/class-winter-core-1.0.0.jar=debug=true";
            export JAVA_OPTS;
     *  windows方式一
        
        编辑tomcat/bin/catalina.bat文件，在@echo off后加上catalina参数
        
            rem 如果你有参数， 那么 -javaagent:D:/class-winter-core-1.0.0.jar=k1=v1,k2=v2
            set CATALINA_OPTS="-javaagent:D:/class-winter-core-1.0.0.jar"
     *  windows方式二
        
        在tomcat/bin目录下创建setenv.bat文件，并写上
        
            rem 如果你有参数， 那么 -javaagent:D:/class-winter-core-1.0.0.jar=k1=v1,k2=v2
            set JAVA_OPTS="-javaagent:D:/class-winter-core-1.0.0.jar"

### 解密参数 ###

<table> 
 <tbody> 
  <tr> 
   <td>参数</td> 
   <td>是否必填</td> 
   <td>说明</td> 
   <td>示例</td> 
  </tr> 
  <tr> 
   <td>password</td> 
   <td>否</td> 
   <td>指定解密密码</td> 
   <td>password=pwd123</td> 
  </tr> 
  <tr> 
   <td>debug</td> 
   <td>否</td> 
   <td>是否开启debug模式</td> 
   <td>debug=true</td> 
  </tr> 
 </tbody> 
</table>

--------------------

**^\_^ 本文已经被收录进[《程序员成长笔记》 ][Link 1]，笔者JustryDeng**

[class-winter]: https://gitee.com/JustryDeng/class-winter
[class-final_v1.1.9]: https://gitee.com/roseboy/classfinal
[class-winter-core.jar]: https://gitee.com/JustryDeng/class-winter/raw/master/class-winter-core/src/test/resources/class-winter-core-1.2.3.jar
[Link 1]: https://gitee.com/JustryDeng/notebook