docs: update all documentation for super evolution v3.1

- PROJECT_SUMMARY: add Section 9 with all 20 new security modules
- USER_MANUAL: add super evolution API endpoints table (20+ new endpoints)
- README.md: update security table to 60+ services with new module entries
- README_EN.md: update security table to 60+ services with new module entries
This commit is contained in:
Peijun Zhao
2026-05-10 20:41:04 +08:00
parent f7c590e34e
commit 939d257ce6
4 changed files with 185 additions and 1 deletions
+21 -1
View File
@@ -810,7 +810,7 @@ serverguard
### 安全防护层 (`com.aluer.security`)
这是系统中规模最大的包,包含 30+ 个安全服务:
这是系统中规模最大的包,包含 60+ 个安全服务(含 20 个超进化 v3.1 新增模块):
| 类别 | 类 | 功能 |
|------|-----|------|
@@ -860,6 +860,26 @@ serverguard
| | `LoadBalancerService` | 简易负载均衡 |
| | `TrafficShapingService` | 流量整形/QoS |
| | `EncryptionService` | 数据加密工具 |
| **超进化 v3.1** | `JwtAuthService` | JWT Token HMAC-SHA256 认证,常量时间签名比对 |
| | `BruteForceProtectionService` | 三层时间窗口(60s/600s/3600s)暴力破解防护,渐进延迟 |
| | `AntiBotDetectionService` | Minecraft 机器人检测:命名模式/加入速度/多账号/客户端品牌 |
| | `AntiGriefDetectionService` | 方块破坏/放置速率监控,危险方块识别,容器掠夺检测 |
| | `ReverseShellDetectionService` | 50+ 反向Shell命令模式匹配,混淆命令检测 |
| | `ARPSpoofDetectionService` | ARP表基线对比,MAC变更/网关欺骗/重复MAC检测 |
| | `DNSTunnelDetectionService` | 子域名熵值分析,Base64编码识别,频率/TLD评分 |
| | `ExploitSignatureService` | 15+ 漏洞签名(Log4Shell/SQLi/XSS/反序列化/Book Exploit) |
| | `SSRFProtectionService` | 内网IP/云元数据/危险Scheme/DNS Rebinding防护 |
| | `XXEProtectionService` | XML实体注入 + Billion Laughs 攻击检测与净化 |
| | `CSPEnforcementService` | Content-Security-Policy + 8项安全响应头自动生成 |
| | `DatabaseFirewallService` | SQL注入检测(UNION/注释/堆叠查询/时间盲注) |
| | `DataLossPreventionService` | 12种敏感数据模式(邮箱/API Key/SSH Key/JWT/银行卡) |
| | `MemoryProtectionService` | JVM堆监控/GC过载/内存泄漏模式识别 |
| | `ProcessInjectionDetectionService` | 进程线程尖峰/内存映射/非标准native库检测 |
| | `SecureFileDeletionService` | DoD多pass覆写(0x00/随机/0xFF/0xAA)安全删除 |
| | `ForensicsCollectorService` | 6种取证数据(进程/网络/文件/日志)案件管理 |
| | `IncidentResponseService` | 5套响应剧本(DDoS/爆破/入侵/MC漏洞/数据泄露) |
| | `ThreatHuntingService` | 10种主动狩猎规则(持久化/横向移动/提权/挖矿/WebShell) |
| | `ComplianceScannerService` | 7大类20+项合规检查,自动评分(0-100%) |
### 运营控制层 (`com.aluer.console`)
+20
View File
@@ -682,6 +682,26 @@ The largest package in the system, containing 30+ security services:
| **Security Operations** | `SIEMService`, `SecurityOrchestrationService`, `SecurityAutomationScheduler`, `SecurityBaselineHardeningService`, `BackupSecurityService` | SIEM correlation, security orchestration, baseline hardening |
| **Command Security** | `CommandExecutionGuardService` | Dangerous command interception (rm -rf / wget \| sh / privilege escalation) |
| **Execution Layer** | `CloudflareIntegrationService`, `DNSSecurityService`, `SessionManagementService`, `LoadBalancerService`, `TrafficShapingService`, `EncryptionService` | Cloudflare API integration, DNS security, session management, load balancing, traffic shaping |
| **Super Evolution v3.1** | `JwtAuthService` | JWT HMAC-SHA256 auth with constant-time comparison |
| | `BruteForceProtectionService` | Three-layer time window (60s/600s/3600s) brute force defense |
| | `AntiBotDetectionService` | Minecraft bot detection: name patterns/join velocity/multi-account |
| | `AntiGriefDetectionService` | Block break/place rate monitoring, dangerous block detection |
| | `ReverseShellDetectionService` | 50+ reverse shell pattern matching + obfuscated command detection |
| | `ARPSpoofDetectionService` | ARP table baseline diff, MAC/Gateway spoof detection |
| | `DNSTunnelDetectionService` | Subdomain entropy analysis, Base64 encoding detection |
| | `ExploitSignatureService` | 15+ exploit signatures (Log4Shell/SQLi/XSS/Deserialization) |
| | `SSRFProtectionService` | Internal IP/Cloud metadata/DNS rebinding protection |
| | `XXEProtectionService` | XML entity injection + Billion Laughs attack detection |
| | `CSPEnforcementService` | Content-Security-Policy + 8 security headers auto-generation |
| | `DatabaseFirewallService` | SQL injection detection (UNION/sleep/stacked queries) |
| | `DataLossPreventionService` | 12 sensitive data patterns (email/API key/SSH key/JWT/card) |
| | `MemoryProtectionService` | JVM heap/GC overload/memory leak pattern detection |
| | `ProcessInjectionDetectionService` | Thread spike/memory mapping/non-standard native lib detection |
| | `SecureFileDeletionService` | DoD multi-pass overwrite (0x00/random/0xFF/0xAA) secure delete |
| | `ForensicsCollectorService` | 6 evidence types (process/network/files/logs) case management |
| | `IncidentResponseService` | 5 playbooks (DDoS/brute force/intrusion/MC exploit/data breach) |
| | `ThreatHuntingService` | 10 proactive hunt rules (persistence/lateral/privilege/crypto/webshell) |
| | `ComplianceScannerService` | 7 categories 20+ checks, auto compliance scoring (0-100%) |
### Operations Control Layer (`com.aluer.console`)
+90
View File
@@ -143,5 +143,95 @@ AluerIII 是一个专为 Minecraft (PaperMC) 服务器设计的高级安全防
---
## 9. 超进化安全模块 (`com.aluer.security`) — v3.1 新增
以下20个安全服务模块为超级进化 (Super Evolution) 版本新增,覆盖身份认证、网络攻防、应用安全、数据保护和运维响应全维度:
### 9.1 身份与访问控制
- **`JwtAuthService`** (JWT认证服务)
- 基于 HMAC-SHA256 的 JWT token 创建、验证、吊销。
- 支持自定义 Claims、过期时间、自动清理。
- 常量时间签名比对防止时序攻击。
- **`BruteForceProtectionService`** (反暴力破解服务)
- 三层时间窗口检测 (60s/600s/3600s)。
- 渐进式登录延迟 (1s-15s),IP 全局阈值监控。
- 自动账号锁定 + 自动解锁。
### 9.2 Minecraft 专项防护
- **`AntiBotDetectionService`** (反机器人检测)
- 6种机器人命名模式识别,10+已知机器人前缀检测。
- 加入速度/多账号/客户端品牌/IP洪水多维度评分。
- Minecraft 登录和状态包频率监控。
- **`AntiGriefDetectionService`** (反破坏检测)
- 方块破坏/放置速率监控 (150/min爆破, 200/min放置)。
- 危险方块识别 (TNT/岩浆/水晶/凋零)。
- 隧道挖掘模式检测,容器掠夺监控,聊天刷屏检测。
### 9.3 网络攻击检测
- **`ReverseShellDetectionService`** (反向Shell检测)
- 50+ 反向Shell命令模式匹配 (bash/python/perl/php/ruby/lua/powershell)。
- 混淆命令检测 (base64编码/eval/exec)。
- 进程级Shell指标监控。
- **`ARPSpoofDetectionService`** (ARP欺骗检测)
- ARP表周期性扫描与基线对比。
- MAC地址变更/重复MAC/网关欺骗三种攻击检测。
- 自动识别网关IP并重点监控。
- **`DNSTunnelDetectionService`** (DNS隧道检测)
- 子域名熵值分析 (Shannon Entropy > 3.8)。
- Base32/Base64编码子域名识别。
- 查询频率/类型/TLD多维度评分,可疑域名TLD黑名单。
- **`ExploitSignatureService`** (漏洞签名检测)
- 15+ 已知漏洞签名 (Log4Shell/JNDI/SQL注入/XSS/路径穿越/反序列化)。
- Minecraft 专属漏洞 (Book Exploit/Sign Exploit/Chunk Ban/NBT Traversal)。
- 命令注入和服务端配置篡改检测。
### 9.4 Web与API安全
- **`SSRFProtectionService`** (SSRF防护)
- 内网IP/云元数据端点/危险Scheme检测。
- DNS Rebinding + 十进制IP绕过 + URL编码绕过防护。
- 云厂商元数据地址全覆盖 (AWS/GCP/Azure/阿里云/腾讯云)。
- **`XXEProtectionService`** (XXE防护)
- XML实体注入 + 十亿笑 (Billion Laughs) 攻击检测。
- 外部实体引用 + 实体扩展炸弹检测。
- XML自动净化处理。
- **`CSPEnforcementService`** (CSP强制执行)
- Content-Security-Policy 头自动生成。
- 8个安全响应头 (CSP/HSTS/X-Frame/X-XSS/Referrer-Policy等)。
- XSS/Clickjacking反射检测。
- **`DatabaseFirewallService`** (数据库防火墙)
- SQL注入检测 (UNION/注释/永真条件/堆叠查询/时间盲注)。
- 危险关键字拦截 (DROP/TRUNCATE/ALTER/INTO OUTFILE)。
### 9.5 数据与内存保护
- **`DataLossPreventionService`** (数据防泄漏)
- 12种敏感数据模式 (邮箱/API Key/密码/SSH Key/JWT/身份证/银行卡/电话号码/数据库连接串/MC Token/RCON密码/IP地址)。
- 自动脱敏 (Redaction) 功能,支持日志/聊天/配置文件扫描。
- **`MemoryProtectionService`** (内存保护)
- JVM堆/非堆内存实时监控,GC过载检测。
- 内存泄漏模式识别 (连续5次以上堆使用率上升)。
- 自动GC触发和告警。
- **`ProcessInjectionDetectionService`** (进程注入检测)
- 进程线程数量异常尖峰检测。
- /proc/{pid}/maps 新内存映射监控,非标准native库检测。
- /proc/{pid}/fd 文件描述符异常增长检测。
- **`SecureFileDeletionService`** (安全文件删除)
- DoD 5220.22-M 风格多pass覆写 (0x00/随机/0xFF/0xAA 交替)。
- 文件截断 + fsync + 删除,支持递归目录安全删除。
### 9.6 安全运维与合规
- **`ForensicsCollectorService`** (取证收集器)
- 6种取证数据采集 (进程列表/网络连接/打开文件/系统日志/MC日志/时间戳快照)。
- 取证案件 (Case) 管理,自动保存到 forensics/ 目录。
- **`IncidentResponseService`** (事件响应服务)
- 5套预定义响应剧本 (DDoS攻击/暴力破解/入侵检测/MC漏洞利用/数据泄露)。
- 自动化动作执行:限流/IP封禁/取证/备份恢复/Token吊销/密钥轮换。
- **`ThreatHuntingService`** (威胁狩猎服务)
- 10种主动狩猎规则 (异常登录时间/可疑命令/持久化机制/横向移动/提权/数据外泄/挖矿/WebShell/后门账号/快速世界切换)。
- 分类:MINECRAFT/COMMAND/HOST/NETWORK/WEB。
- **`ComplianceScannerService`** (合规扫描服务)
- 7大类20+项合规检查 (文件权限/加密标准/认证要求/审计日志/网络安全/MC服务端安全/备份合规)。
- 自动合规评分 (0-100%) 和修复建议生成。
---
### 架构总结
AluerIII 采用 **高度解耦的插件式架构**,底层通过 Spring 的依赖注入(DI)机制紧密配合。系统形成了一套 **实时监测 -> AI 深度分析 -> 策略下发 -> 自动防御** 的完整闭环,极大地降低了 Minecraft 服务器运维人员的安全管理成本。
+54
View File
@@ -388,6 +388,60 @@ export ALUER_WEBHOOK_DISCORD="https://discord.com/api/webhooks/xxx/yyy"
export ALUER_WEBHOOK_SLACK="https://hooks.slack.com/services/xxx/yyy/zzz"
```
### 超进化安全模块 API(v3.1 新增)
#### 身份认证与访问控制
| 接口路径 | 方法 | 说明 |
|----------|------|------|
| `/api/security/auth/status` | GET | JWT 认证状态(活跃Token数、已吊销Token数) |
| `/api/security/brute-force/status` | GET | 暴力破解防护状态(锁定账号、检测统计) |
#### Minecraft 专项防护
| 接口路径 | 方法 | 说明 |
|----------|------|------|
| `/api/security/anti-bot/status` | GET | 反机器人检测状态(被拦截IP、Bot分数) |
| `/api/security/anti-grief/status` | GET | 反破坏检测状态(被标记玩家、方块破坏率) |
#### 网络攻击监控
| 接口路径 | 方法 | 说明 |
|----------|------|------|
| `/api/security/reverse-shell/status` | GET | 反向Shell检测状态 |
| `/api/security/arp-spoof/status` | GET | ARP欺骗检测状态(MAC变更记录) |
| `/api/security/dns-tunnel/status` | GET | DNS隧道检测状态 |
| `/api/security/exploit-signature/status` | GET | 漏洞签名检测统计 |
| `/api/security/exploit-signature/scan` | POST | 扫描内容中的漏洞签名 (参数: `content`, `source`) |
#### Web与应用安全
| 接口路径 | 方法 | 说明 |
|----------|------|------|
| `/api/security/ssrf/status` | GET | SSRF防护状态 |
| `/api/security/xxe/status` | GET | XXE防护状态 |
| `/api/security/csp/status` | GET | CSP违规统计 |
| `/api/security/csp/headers` | GET | 获取推荐的安全响应头 |
| `/api/security/database-firewall/status` | GET | 数据库防火墙状态 |
| `/api/security/dlp/status` | GET | 数据防泄漏检测统计 |
#### 系统保护
| 接口路径 | 方法 | 说明 |
|----------|------|------|
| `/api/security/memory/status` | GET | JVM内存保护状态(堆使用率、GC统计) |
| `/api/security/process-injection/status` | GET | 进程注入检测状态 |
| `/api/security/secure-delete/status` | GET | 安全文件删除统计 |
#### 安全运维
| 接口路径 | 方法 | 说明 |
|----------|------|------|
| `/api/security/forensics/status` | GET | 取证案件列表与证据统计 |
| `/api/security/incident-response/status` | GET | 事件响应状态(活跃事件、剧本列表) |
| `/api/security/threat-hunting/status` | GET | 威胁狩猎状态(最近狩猎结果) |
| `/api/security/compliance/status` | GET | 合规扫描结果(评分、通过/失败项) |
---
## 配置说明