1
+ ## Contribute
2
+
3
+ > 你的任何反馈以及 issue 交流都是对当前项目的贡献
4
+
5
+ > It will be so nice if you want to contribute. 🎉
6
+
7
+ 1 . 如果你有高超的 Docker 环境构建技术,可以尝试添加 CVE 相关的集成测试用例。
8
+ 2 . 如果你有高超的内存马编写技术,可以尝试添加一个内存马试试。
9
+ 3 . 如果你有丰富的实战经验,可以尝试写写 issue 来提提建议。
10
+
1
11
### 目录结构
2
12
3
- - bom: 依赖版本管理,不用写到处写版本号就是舒服
4
13
- boot:使用 SpringBoot 为 UI 提供生成服务
5
- - common:bytebuddy 等工具类存放
14
+ - memshell-party- common:bytebuddy/asm 等工具类存放
6
15
- generator:内存马生成核心
7
- - deserialize:反序列化相关 gadget
16
+ - packer:常见漏洞 payload 生成
8
17
- integration-test:集成测试用例
9
- - memshell:内存功能类以及注入器(为保证兼容性够高,所以单独弄出来)
10
- - memshell-java8:Spring 相关的存在 lambda 表达式所以单独弄出来
11
- - tools/behinder:冰蝎简易连接器
12
- - tools/godzilla:哥斯拉简易连接器
13
- - tools/suo5:Suo5 简易连接器
18
+ - memshell:内存功能类以及注入器
19
+ - memshell-agent:Agent 内存马 playground,可参考 asm/javassist/bytebuddy 编写 Agent 内存马
20
+ - tools/* :内存马简易连接器,用于测试内存马注入之后是否可用
14
21
- web:使用 react 开发的 Web UI
15
22
- vul/vul-webapp:简易的 javax.servlet 靶场
16
23
- vul/vul-webapp-expression:简易的表达式注入、SSTI 注入相关靶场
24
+ - vul/vul-webapp-deserialize:简易的反序列化相关靶场
17
25
- vul/vul-webapp-jakarta:简易的 jakarta.servlet 靶场
18
26
- vul/springboot* : springboot 相关靶场
19
27
28
36
# 运行集成测试用例,谨慎运行,用例太多了
29
37
./gradlew :integration-test:test --info
30
38
31
- # 仅运行 tomcat 下的集成测试用例
39
+ # 仅运行 tomcat 下的集成测试用例(需要先构建靶场)
40
+ ./gradlew :vul:vul-webapp:war :vul:vul-webapp-expression:war :vul:vul-webapp-deserialize:war :vul:vul-webapp-jakarta:war
32
41
./gradlew :integration-test:test --tests ' *.tomcat.*'
33
- # 仅运行 jetty 下的集成测试用例
42
+
43
+ # 仅运行 jetty 下的集成测试用例(需要先构建靶场)
44
+ ./gradlew :vul:vul-webapp:war :vul:vul-webapp-jakarta:war
34
45
./gradlew :integration-test:test --tests ' *.jetty.*'
35
46
36
- # 构建 war 包
47
+ # 构建靶场 war 包
37
48
./gradlew :vul:vul-webapp:war
38
49
./gradlew :vul:vul-webapp-jakarta:war
39
50
./gradlew :vul:vul-webapp-expression:war
@@ -57,7 +68,7 @@ UI 采用的 React SPA + SpringBoot,构建时需要先将 React 前端项目
57
68
58
69
### Contribute Code
59
70
60
- > 参考 GitHub Docs, https://docs.github.com/en/get-started/exploring-projects-on-github/contributing-to-a-project
71
+ > 参考 GitHub Docs,https://docs.github.com/en/get-started/exploring-projects-on-github/contributing-to-a-project
61
72
62
73
1 . fork 当前项目
63
74
2 . git clone 自己 fork 后的项目
0 commit comments