|
|
@@ -52,12 +52,12 @@
|
|
|
<plugin>
|
|
|
<groupId>com.idea-aedi</groupId>
|
|
|
<artifactId>class-winter-maven-plugin</artifactId>
|
|
|
- <version>2.8.1</version>
|
|
|
+ <version>2.8.2</version>
|
|
|
<!-- 相关配置 -->
|
|
|
<configuration>
|
|
|
<!-- <finalName></finalName>-->
|
|
|
<includePrefix>加密范围</includePrefix>
|
|
|
- <!-- <originJarOrWar></originJarOrWar>-->
|
|
|
+ <!-- <originJarOrWar>非必填(不填则自动获取)</originJarOrWar>-->
|
|
|
<!-- <excludePrefix></excludePrefix>-->
|
|
|
<!-- <includeXmlPrefix></includeXmlPrefix>-->
|
|
|
<!-- <excludeXmlPrefix></excludeXmlPrefix>-->
|
|
|
@@ -83,19 +83,25 @@
|
|
|
```
|
|
|
注:不必担心信息泄漏问题,使用此方式生成混淆的jar包时,会擦除pom.xml中关于class-winter-plugin的信息。
|
|
|
|
|
|
-- #### <font face="幼圆" ><font face="幼圆" color = "#86CA5E">**方式二**</font>:通过 [**class-winter-core.jar**](https://gitee.com/JustryDeng/class-winter/raw/master/class-winter-core/src/test/resources/class-winter-core-2.8.1.jar) 主动加密</font>
|
|
|
+- #### <font face="幼圆" ><font face="幼圆" color = "#86CA5E">**方式二**</font>:通过 [**class-winter-core.jar**](https://gitee.com/JustryDeng/class-winter/raw/master/class-winter-core/src/test/resources/class-winter-core-2.8.2.jar) 主动加密</font>
|
|
|
|
|
|
```bash
|
|
|
- java -jar class-winter-core-2.8.1.jar originJarOrWar=${要加密的项目.jar或.war包} includePrefix=${加密范围} [k3=v3 k4=v4 ...]
|
|
|
+ java -jar class-winter-core-2.8.2.jar originJarOrWar=${要加密的项目.jar或.war包} includePrefix=${加密范围} [k3=v3 k4=v4 ...]
|
|
|
# 对于复杂的参数值,可以使用引号引起来
|
|
|
# linux
|
|
|
- java -jar class-winter-core-2.8.1.jar k1='v1' k2='v2'
|
|
|
+ java -jar class-winter-core-2.8.2.jar k1='v1' k2='v2'
|
|
|
# windows
|
|
|
- java -jar class-winter-core-2.8.1.jar k1="v1" k2="v2"
|
|
|
+ java -jar class-winter-core-2.8.2.jar k1="v1" k2="v2"
|
|
|
```
|
|
|
|
|
|
## <font face="幼圆" color = "#3399EA" >加密参数</font>
|
|
|
|
|
|
+> <font face="幼圆" color = "#F53B45">**提示:**</font>慎用`cca(尤其)`、`cma`、`cfa`参数,如果要用,请做好充分测试。
|
|
|
+>
|
|
|
+> 原因说明:部分框架在获取某些元数据时,并不全都从已被premain处理后的类中读取,而是直接去对应位置读取资源文件本身(如:spring的`SimpleMetadataReader implements MetadataReader`直接去读取.class文件本身,以知道是否需要将类注册进容器等),因为class-winter会对该位置的资源进行加密(如:使用cca、cma、cfa时会擦除类、方法、字段上的注解信息),因此此时如果直接去.class文件本身获取元信息的话,可能会丢失部分信息(如:被class-winter擦除了的类的注解信息就读取不到)
|
|
|
+>
|
|
|
+> 解决办法:可以考虑对相关逻辑进行定制,使其不从已加密的.class中获取相关信息(如:spring框架可考虑定制MetadataReader)
|
|
|
+
|
|
|
<table>
|
|
|
<tr align="center">
|
|
|
<td>参数</td>
|
|
|
@@ -296,8 +302,8 @@ linux示例:tips='请不要直接使用混淆后的jar/war'</td>
|
|
|
```bash
|
|
|
# 假设your-project-encrypted.jar是由class-winter加密后的包,那么你可以这么启动
|
|
|
java -javaagent:/your-project-encrypted.jar -jar /your-project-encrypted.jar
|
|
|
- # 也可以用class-winter-core-2.8.1.jar
|
|
|
- # java -javaagent:/class-winter-core-2.8.1.jar -jar /your-project-encrypted.jar
|
|
|
+ # 也可以用class-winter-core-2.8.2.jar
|
|
|
+ # java -javaagent:/class-winter-core-2.8.2.jar -jar /your-project-encrypted.jar
|
|
|
# 或者指定参数
|
|
|
# java -javaagent:/your-project-encrypted.jar=debug=true,password=pwd12345 -jar /your-project-encrypted.jar
|
|
|
# 参数可以引起来(linux)
|
|
|
@@ -313,9 +319,9 @@ linux示例:tips='请不要直接使用混淆后的jar/war'</td>
|
|
|
编辑tomcat/bin/catalina.sh文件,在最上面加上
|
|
|
|
|
|
```bash
|
|
|
- # 如果你有参数, 那么 -javaagent:/class-winter-core-2.8.1.jar=k1=v1,k2=v2
|
|
|
+ # 如果你有参数, 那么 -javaagent:/class-winter-core-2.8.2.jar=k1=v1,k2=v2
|
|
|
# tomcat启动往往需要通过decryptProjectPathPrefix指定要解密的路径
|
|
|
- CATALINA_OPTS="$CATALINA_OPTS -javaagent:/class-winter-core-2.8.1.jar=debug=true,decryptProjectPathPrefix=/usr/local/xxx/";
|
|
|
+ CATALINA_OPTS="$CATALINA_OPTS -javaagent:/class-winter-core-2.8.2.jar=debug=true,decryptProjectPathPrefix=/usr/local/xxx/";
|
|
|
export CATALINA_OPTS;
|
|
|
```
|
|
|
|
|
|
@@ -324,9 +330,9 @@ linux示例:tips='请不要直接使用混淆后的jar/war'</td>
|
|
|
在tomcat/bin目录下创建setenv.sh文件,并写上
|
|
|
|
|
|
```bash
|
|
|
- # 如果你有参数, 那么 -javaagent:/class-winter-core-2.8.1.jar=k1=v1,k2=v2
|
|
|
+ # 如果你有参数, 那么 -javaagent:/class-winter-core-2.8.2.jar=k1=v1,k2=v2
|
|
|
# tomcat启动往往需要通过decryptProjectPathPrefix指定要解密的路径
|
|
|
- JAVA_OPTS="$JAVA_OPTS -javaagent:/class-winter-core-2.8.1.jar=debug=true,decryptProjectPathPrefix=/usr/local/xxx/";
|
|
|
+ JAVA_OPTS="$JAVA_OPTS -javaagent:/class-winter-core-2.8.2.jar=debug=true,decryptProjectPathPrefix=/usr/local/xxx/";
|
|
|
export JAVA_OPTS;
|
|
|
```
|
|
|
|
|
|
@@ -335,9 +341,9 @@ linux示例:tips='请不要直接使用混淆后的jar/war'</td>
|
|
|
编辑tomcat/bin/catalina.bat文件,在@echo off后加上catalina参数
|
|
|
|
|
|
```bash
|
|
|
- rem 如果你有参数, 那么 -javaagent:D:/class-winter-core-2.8.1.jar=k1=v1,k2=v2
|
|
|
+ rem 如果你有参数, 那么 -javaagent:D:/class-winter-core-2.8.2.jar=k1=v1,k2=v2
|
|
|
rem tomcat启动往往需要通过decryptProjectPathPrefix指定要解密的路径
|
|
|
- set CATALINA_OPTS="-javaagent:D:/class-winter-core-2.8.1.jar=decryptProjectPathPrefix=/D:/tmp/"
|
|
|
+ set CATALINA_OPTS="-javaagent:D:/class-winter-core-2.8.2.jar=decryptProjectPathPrefix=/D:/tmp/"
|
|
|
```
|
|
|
|
|
|
- windows方式二
|
|
|
@@ -345,9 +351,9 @@ linux示例:tips='请不要直接使用混淆后的jar/war'</td>
|
|
|
在tomcat/bin目录下创建setenv.bat文件,并写上
|
|
|
|
|
|
```bash
|
|
|
- rem 如果你有参数, 那么 -javaagent:D:/class-winter-core-2.8.1.jar=k1=v1,k2=v2
|
|
|
+ rem 如果你有参数, 那么 -javaagent:D:/class-winter-core-2.8.2.jar=k1=v1,k2=v2
|
|
|
rem tomcat启动往往需要通过decryptProjectPathPrefix指定要解密的路径
|
|
|
- set JAVA_OPTS="-javaagent:D:/class-winter-core-2.8.1.jar=decryptProjectPathPrefix=/D:/tmp/"
|
|
|
+ set JAVA_OPTS="-javaagent:D:/class-winter-core-2.8.2.jar=decryptProjectPathPrefix=/D:/tmp/"
|
|
|
```
|
|
|
|
|
|
- #### <font face="幼圆" color = "#86CA5E" >IDE解密(启动)</font>
|
|
|
@@ -458,7 +464,7 @@ linux示例:tips='请不要直接使用混淆后的jar/war'</td>
|
|
|
<parent>
|
|
|
<groupId>org.springframework.boot</groupId>
|
|
|
<artifactId>spring-boot-starter-parent</artifactId>
|
|
|
- <version>2.8.1</version>
|
|
|
+ <version>2.8.2</version>
|
|
|
<relativePath/> <!-- lookup parent from repository -->
|
|
|
</parent>
|
|
|
<groupId>com.example</groupId>
|