docs: add springweb intro

ReaJason · ReaJason · commit 517cc9f6f586 · 2025-12-14T19:25:05.000+08:00
diff --git a/web/app/utils/transformer.ts b/web/app/utils/transformer.ts
@@ -4,10 +4,7 @@ import type {
   ShellToolConfig,
 } from "@/types/memshell";
 import type { ProbeConfig, ProbeContentConfig } from "@/types/probeshell";
-import type {
-  MemShellFormSchema,
-  ProbeShellFormSchema,
-} from "@/types/schema";
+import type { MemShellFormSchema, ProbeShellFormSchema } from "@/types/schema";
 
 export function transformToPostData(formValue: MemShellFormSchema) {
   const shellConfig: ShellConfig = {
diff --git a/web/bun.lock b/web/bun.lock
diff --git a/web/content/docs/(shelltool)/godzilla.mdx b/web/content/docs/(shelltool)/godzilla.mdx
@@ -53,14 +53,14 @@ import { Step, Steps } from 'fumadocs-ui/components/steps';
 <Steps>
 
 <Step>
-### 生成 Tomcat WebSocket Godzilla 马
+### 生成 WebSocket 马
 目前仅支持 Tomcat，当选中 Tomcat Godzilla，可以在内存马挂载类型处选择 WebSocket 内存马
 
 ![godzilla_websocket](../images/godzilla_websocket.png)
 </Step>
 
 <Step>
-### 下载并装载 GZWebsocket.jar 插件
+### 下载并装载插件
 
 下载链接：https://github.com/xsshim/GzWebsocket/blob/main/plugins/GzWebsocket.jar?raw=true
 
diff --git a/web/content/docs/(shelltool)/suo5.mdx b/web/content/docs/(shelltool)/suo5.mdx
@@ -12,16 +12,12 @@ import { Step, Steps } from 'fumadocs-ui/components/steps';
 ![experience](../images/suo5.gif)
 
 
-## Suo5 v2 版本主要特性
+## 主要特性
 
 - **优异的传输性能**
     - 全双工：借助双向 Chunked-Encoding 实现单连接双向通信，传输性能接近 FRP
     - 半双工：下行长连接 + 上行短连接实现，在 Nginx 反代场景下仍可保持良好性能
     - 短链接：上下行均使用短连接，适配多层反代和严格限制长连接的场景，作为兜底方案
-- **良好的服务端兼容性**
-    - Java 支持 Tomcat、WebLogic、JBoss、Resin 等主流中间件，JDK6 ~ JDK 2x 全版本支持
-    - .Net 支持 IIS 下所有 .Net Framework 版本 (>=2.0)
-    - PHP 支持 Nginx/Apache 等服务器环境，PHP 5.6 ~ PHP 8.x 全版本支持
 - **复杂网络环境支持**
     - 支持一层、两层、多层反向代理下的稳定连接
     - 支持通过流量转发和请求重试来支持负载均衡场景
diff --git a/web/content/docs/meta.json b/web/content/docs/meta.json
@@ -10,6 +10,7 @@
     "---内存马生成器---",
     "memshell-core-config",
     "servlet",
+    "springweb",
     "custom-memshell",
     "---内存马工具---",
     "...(shelltool)",
diff --git a/web/content/docs/servlet/filter.mdx b/web/content/docs/servlet/filter.mdx
@@ -1,5 +1,5 @@
 ---
-title: Filter 内存马
+title: Filter
 ---
 
 > [Servlet 3.1 规范 — Filter 主要概念](https://github.com/waylau/servlet-3.1-specification/blob/master/docs/Filtering/6.2%20Main%20Concepts.md)
diff --git a/web/content/docs/servlet/index.mdx b/web/content/docs/servlet/index.mdx
@@ -2,9 +2,7 @@
 title: Java Servlet 规范内存马
 ---
 
-Java SE 中我们可以创建 socket 服务端为用户提供服务，但需要用户使用 socket 客户端，当然也可以基于 socket 实现 HTTP 协议，WebFlux 就是这样子的存在。而在 Java EE 中，Java 制定了 Servlet 规范，来规范在 Java 中提供 HTTP 服务的编写方式，其中有两个重要的概念，Servlet 与 Servlet Container。Servlet 是基于 Java 的 Web 组件，由容器进行管理，提供动态内容。Servlet 容器用于提供基于请求/响应发送模式的服务，必须支持 HTTP，并且管理 Servlet 的生命周期，使 Servlet 在一个受限的安全环境中执行。
-
-Servlet 规范旨在让开发者基于规范开发的应用，可以部署在任意满足规范的 Web 容器上。每个 Servlet 规范版本都引入了一些新的东西，Servlet 4.0 前的版本变更可查看 [java-servlet-version-history](https://www.codejava.net/java-ee/servlet/java-servlet-version-history)。
+在 Java EE 中，Java 制定了 Servlet 规范，来规范在 Java 中提供 HTTP 服务的编写方式，其中有两个重要的概念，Servlet 与 Servlet Container。Servlet 是基于 Java 的 Web 组件，由容器进行管理，提供动态内容。Servlet 容器用于提供基于请求/响应发送模式的服务，必须支持 HTTP，并且管理 Servlet 的生命周期，使 Servlet 在一个受限的安全环境中执行。Servlet 规范旨在让开发者基于规范开发的应用，可以部署在任意满足规范的 Web 容器上。在 Java Servlet 规范中处理基础的 Servlet Web 组件，还声明了 Filter 和 Listener 两个 Web 组件用于辅助开发，这些 Web 组件都由 ServletContext 进行管理。
 
 目前常见的 Servlet 规范就是 [Servlet 3.1](https://github.com/waylau/servlet-3.1-specification/blob/master/docs), Tomcat 8.x 版本就是 Servlet 3.1 版本，从 Servlet 5.0 开始，Java EE 更名为 Jakarta EE，包路径从 **javax** 改为 **jakarta**。目前最新 Servlet 规范为 Jakarta Servlet 6.1，可前往 https://jakarta.ee/specifications/servlet/ 查看。
 
diff --git a/web/content/docs/servlet/listener.mdx b/web/content/docs/servlet/listener.mdx
@@ -1,5 +1,5 @@
 ---
-title: Listener 内存马
+title: Listener
 ---
 
 > [Servlet 3.1 规范 - 事件监听器](https://github.com/waylau/servlet-3.1-specification/blob/master/docs/Application%20Lifecycle%20Events/11.2%20Event%20Listeners.md)
diff --git a/web/content/docs/servlet/servlet.mdx b/web/content/docs/servlet/servlet.mdx
@@ -1,10 +1,11 @@
 ---
-title: Servlet 内存马
+title: Servlet
 ---
 
 > [Servlet 3.1 规范 — 什么是 Servlet](https://github.com/waylau/servlet-3.1-specification/blob/master/docs/Overview/1.1%20What%20is%20a%20Servlet.md)
 
-Servlet 是基于 Java 的 Web 组件，由容器进行管理，提供动态内容。
+Servlet 是基于 Java 的 Web 组件，就是我们常说的 Web 接口，例如 /hello，JSP 技术也是 Java Servlet 规范的一部分，JSP 文件解析之后也会成为 Servlet 提供 HTTP 服务，只不过它的接口是 JSP 文件名，例如 /app/hello.jsp。
+Servlet 规范中规定了，对于非分布式应用来说，Servlet 容器必须确保对于每个 Servlet 定义只存在一个实例，但是 Web 服务是多线程的，所以 Servlet 是线程不安全的，在 Servlet 中的成员变量都是线程不安全的。
 
 ## HttpServlet
 
diff --git a/web/content/docs/springweb/controller.mdx b/web/content/docs/springweb/controller.mdx
@@ -0,0 +1,5 @@
+---
+title: WebMVC Controller
+---
+
+WIP
diff --git a/web/content/docs/springweb/handler-function.mdx b/web/content/docs/springweb/handler-function.mdx
@@ -0,0 +1,5 @@
+---
+title: WebFlux HandlerFunction
+---
+
+WIP
diff --git a/web/content/docs/springweb/handler-method.mdx b/web/content/docs/springweb/handler-method.mdx
@@ -0,0 +1,5 @@
+---
+title: WebFlux HandlerMethod
+---
+
+WIP
diff --git a/web/content/docs/springweb/index.mdx b/web/content/docs/springweb/index.mdx
@@ -0,0 +1,220 @@
+---
+title: Spring Web 框架内存马
+---
+
+在 Java 企业级开发生态中，使用最为广泛的当属 Spring 全家桶，从 SSH（Spring + SpringWebMVC + Hibernate）到 SSM（Spring + SpringWebMVC + MyBatis），XML 配置文件到注解配置方式，最后 Spring Boot 以其自动装配原理，可零配置装配各种 Spring 生态得以广泛使用。
+Spring Web 框架中不仅提供了传统的 SpringWebMVC 还提供了异步编程模型的 SpringWebFlux，基于 Netty 开发的 Reactor，常见的 Spring Boot Web 使用的是 SpringWebMVC，而 Spring Gateway（Spring Cloud）则使用的是 SpringWebFlux。
+
+SpringWebMVC 衍生出来的内存马有 Interceptor、Controller、HandlerMethod、HandlerFunction 等等
+SpirngWebFlux 衍生出来的内存马有 WebFilter、HandlerMethod、HandlerFunction、NettyHandler 等等。
+
+## Spring 框架
+
+Java 是一门面向对象语言，需要对象我们就 new 一个，对于一个 Java 大型项目来说一般充斥着成百上千的类，为了提高项目的可维护性，出现了大量 [准则](https://java-design-patterns.com/principles/) 和 [设计模式](https://java-design-patterns.com/patterns/) ，其中单一职责原则是亘古不变的道理也是最难遵守的。
+为了遵守单一职责原则，我们会把同一职责的函数放在一个类中，并在业务类中组合各种类实现功能，久而久之我们业务类可能依赖了超多其他功能类，如果业务没有组织良好，一时半会可能难以发现其依赖关系，例如：
+
+```java
+public class A {
+    public void f1(){
+        // so many code in here
+        A2 a2 = new A2();
+        // do
+        // so many code in here
+        A4 a4 = new A4();
+        // do
+    }
+
+    public void f2(){
+        // so many code in here
+        B1 b1 = new B1();
+        // do something
+
+        // so many code in here
+        B6 b6 = new B6();
+        // do something
+    }
+}
+```
+
+因此出现一种设计模式叫作 [依赖注入（Dependency Injection，简称 DI）](https://zh.wikipedia.org/zh-cn/%E4%BE%9D%E8%B5%96%E6%B3%A8%E5%85%A5)，通过依赖注入实现了 [控制反转（Inversion of Control，缩写为 IoC）](https://zh.wikipedia.org/wiki/%E6%8E%A7%E5%88%B6%E5%8F%8D%E8%BD%AC)，Spring 框架正是一款依赖注入的框架，用户不再关心对象的创建，而是需要什么就注入什么，这样既解耦（接口方式传入不同实现类）也方便对类进行测试（传入 mock 类），例如：
+
+```java
+public class A {
+    private A2 a2;
+    private A4 a4;
+    private B1 b1;
+    private B6 b6;
+    
+    // 通过构造方式注入
+    public A(A2 a2, A4, a4, B1 b1, B6 b6) {
+        this.a2 = a2;
+        this.a4 = a4;
+        this.b1 = b1;
+        this.b6 = b6;
+    }
+
+    public void f1(){
+        // so many code in here
+        this.a2.do();
+        // do
+        // so many code in here
+        this.a2.do();
+        // do
+    }
+
+    public void f2(){
+        // so many code in here
+        this.b1.do();
+        // do something
+
+        // so many code in here
+        this.b6.do();
+        // do something
+    }
+}
+```
+
+org.springframework.beans 和 org.springframework.context 包是 Spring Framework 的 IoC 容器的基础。BeanFactory 接口提供了一种高级配置机制，能够管理任何类型的对象。
+org.springframework.aop 提供了 Spring 自己定义的 AOP 概念整合 AspectJ 对 Bean 进行增强，使得我们能面向切面编程，例如事务、日志、安全等等。
+
+ApplicationContext 是 BeanFactory 的子接口。在漏洞注入中我们常用的是 org.springframework.context.support.ClassPathXmlApplicationContext，解析 XML bean 配置，
+而后来 Spring 提供了基于注解的 bean 配置方式，也是目前最常用的，使用的是 org.springframework.context.annotation.AnnotationConfigApplicationContext。因此在 Spring 应用中我们只要想法设法拿到 ApplicationContext 我们就能手动管理业务中几乎所有的 Java 对象。
+
+## Spring Web 框架
+
+### Spring WebMVC
+
+> [官方文档 - Spring Web MVC](https://docs.spring.io/spring-framework/reference/web/webmvc.html)
+
+Spirng WebMVC 对 Java Servlet 规范进行封装实现 MVC 架构，可以部署在任意实现 Java Servlet 规范的容器上。
+
+通过 org.springframework.web.servlet.DispatcherServlet 配置 `/*` 的 urlPattern，实现接管业务访问入口，让所有流量进入 Spring WebMVC 框架。其中最重要的方法是 `doDispatcher`，可以从中窥视 Spring WebMVC 处理请求的主流程。
+```java
+protected void doDispatch(HttpServletRequest request, HttpServletResponse response) throws Exception {
+    HttpServletRequest processedRequest = request;
+    HandlerExecutionChain mappedHandler = null;
+
+    try {
+        ModelAndView mv = null;
+        Exception dispatchException = null;
+
+        try {
+            // 通过 HandlerMapping 获取 Handler
+            mappedHandler = getHandler(processedRequest);
+            if (mappedHandler == null || mappedHandler.getHandler() == null) {
+                noHandlerFound(processedRequest, response);
+                return;
+            }
+
+            // Handler 可以五花八门，为了接口统一会转换成对应的 HandlerAdapter
+            HandlerAdapter ha = getHandlerAdapter(mappedHandler.getHandler());
+
+            // 执行 Interceptor preHandler 方法，判断是否还需要继续执行
+            if (!mappedHandler.applyPreHandle(processedRequest, response)) {
+                return;
+            }
+
+            // 处理 Handler 中的逻辑，也就是 Controller 中的具体业务代码
+            mv = ha.handle(processedRequest, response, mappedHandler.getHandler());
+
+            // 执行 Interceptor postHandler 方法
+            mappedHandler.applyPostHandle(processedRequest, response, mv);
+        }
+        catch (Exception ex) {
+            dispatchException = ex;
+        }
+        catch (Throwable err) {
+            // ...
+        }
+        
+        // 对返回的 ModelAndView 进行封装转为响应流放回给用户
+        processDispatchResult(processedRequest, response, mappedHandler, mv, dispatchException);
+    }
+    catch (Exception ex) {
+        triggerAfterCompletion(processedRequest, response, mappedHandler, ex);
+    }
+    catch (Throwable err) {
+        triggerAfterCompletion(processedRequest, response, mappedHandler,
+                new NestedServletException("Handler processing failed", err));
+    }
+    finally {
+        // ...
+    }
+}
+
+protected HandlerExecutionChain getHandler(HttpServletRequest request) throws Exception {
+    // 遍历 handlerMappings，查看有没有能处理当前 request 的 handler。
+    for (HandlerMapping hm : this.handlerMappings) {
+        HandlerExecutionChain handler = hm.getHandler(request);
+        if (handler != null) {
+            return handler;
+        }
+    }
+    return null;
+}
+```
+
+所谓 MVC 中的 C 控制器在 Spring WebMVC 实际上是 Handler，并且由 HandlerMapping 管理，因此我们最常注入的就是 Controller 内存马和 Interceptor 内存马。参考 [SpringWeb 内存马变型 - 银针安全](https://mp.weixin.qq.com/s/aWTcq3690F3CmGGo4A-a0w) 也可以实现其他内存马。
+
+<Cards>
+  <Card
+    href="/docs/spring/controller"
+    title="Controller 内存马"
+  >控制器，创建独特的 entrypoint 访问路径</Card>
+  <Card
+    href="/docs/spring/interceptor"
+    title="Interceptor 内存马"
+  >拦截器，命中 webshell 逻辑中断请求</Card>
+</Cards>
+
+
+
+### Spring WebFlux
+
+> [官方文档 - Spring WebFlux](https://docs.spring.io/spring-framework/reference/web/webflux.html)
+
+Spring WebFlux 使用 Reactive Streams 响应式异步非阻塞模型，相较于 Servlet API 阻塞模式，异步非阻塞模型能使用更少的资源提供更高的并发量，默认使用的 Netty 提供 HTTP 服务。
+
+处理请求的核心类为 org.springframework.web.reactive.DispatcherHandler，其中最重要的方法是 `handle` 方法：
+
+```java
+@Override
+public Mono<Void> handle(ServerWebExchange exchange) {
+    if (this.handlerMappings == null) {
+        return createNotFoundError();
+    }
+    if (CorsUtils.isPreFlightRequest(exchange.getRequest())) {
+        return handlePreFlight(exchange);
+    }
+    return Flux.fromIterable(this.handlerMappings)
+            .concatMap(mapping -> mapping.getHandler(exchange))
+            .next()
+            .switchIfEmpty(createNotFoundError())
+            .flatMap(handler -> invokeHandler(exchange, handler))
+            .flatMap(result -> handleResult(exchange, result));
+}
+```
+
+和 Spring WebMVC 类似，也是通过遍历 HandlerMapping 找到合适 Handler 进行请求处理。
+
+WebFlux 中同样可以使用 `@Controller` 和 `@RequestMapping`，因此也有 Controller 内存马，不过根据实现原理通常叫作 HandlerMethod，而 WebFlux 有个特殊的 RouterFunction 定义路由的方式叫作 HandlerFunction。WebFlux 框架内为了对请求实现过滤的效果，也设有 WebFilter 组件。
+当然底层使用的 Netty 提供的 HTTP 服务，因此也有 Netty Handler 马可以打，所以 WebFlux 常见的内存马就是 WebFilter、HandlerMethod、HandlerFunction 和 NettyHandler 马。
+
+<Cards>
+<Card
+    href="/docs/spring/webfilter"
+    title="WebFilter 内存马"
+  >过滤器，总是需要一种方式对所有进入的请求进行处理</Card>
+  <Card
+    href="/docs/spring/handler-method"
+    title="HandlerMethod 内存马"
+  >@RequestMapping，WebMVC 式创建路由的方式</Card>
+  <Card
+    href="/docs/spring/handler-function"
+    title="HandlerFunction 内存马"
+  >RouterFunction，函数式路由声明方式</Card>
+  <Card
+    href="/docs/spring/netty-handler"
+    title="Netty Handler 内存马"
+  >Netty Handler API 允许处理 request 和 response</Card>
+</Cards>
diff --git a/web/content/docs/springweb/interceptor.mdx b/web/content/docs/springweb/interceptor.mdx
@@ -0,0 +1,5 @@
+---
+title: WebMVC Interceptor
+---
+
+WIP
diff --git a/web/content/docs/springweb/meta.json b/web/content/docs/springweb/meta.json
@@ -0,0 +1,11 @@
+{
+  "title": "Spring Web 框架内存马",
+  "pages": [
+    "controller",
+    "interceptor",
+    "webfilter",
+    "handler-method",
+    "handler-function",
+    "netty-handler"
+  ]
+}
diff --git a/web/content/docs/springweb/netty-handler.mdx b/web/content/docs/springweb/netty-handler.mdx
@@ -0,0 +1,5 @@
+---
+title: WebFlux Netty Handler
+---
+
+WIP
diff --git a/web/content/docs/springweb/webfilter.mdx b/web/content/docs/springweb/webfilter.mdx
@@ -0,0 +1,5 @@
+---
+title: WebFlux WebFilter
+---
+
+hello
diff --git a/web/package.json b/web/package.json
@@ -21,7 +21,7 @@
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "framer-motion": "^12.23.26",
-    "fumadocs-core": "^16.2.4",
+    "fumadocs-core": "^16.2.5",
     "fumadocs-mdx": "14.1.0",
     "fumadocs-ui": "16.2.4",
     "i18next": "^25.7.2",
@@ -46,7 +46,7 @@
     "@react-router/dev": "^7.10.1",
     "@tailwindcss/vite": "^4.1.18",
     "@types/mdx": "^2.0.13",
-    "@types/node": "^25.0.1",
+    "@types/node": "^25.0.2",
     "@types/react": "^19.2.7",
     "@types/react-copy-to-clipboard": "^5.0.7",
     "@types/react-dom": "^19.2.3",

-Original file line number
+Diff line change
@@ @@ -0,0 +1,5 @@ @@
 +---
 +title: WebMVC Controller
 +---
++
 +WIP