PeijunDev/Aluer
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

V4.0 正式发布：130源文件/114测试全部通过，31个高级扩展安全模块，完整API与专业开发文档

Browse Source 
- 版本号从1.0.0升级至4.0.0，pom.xml版本号同步
- 新增 docs/DEVELOPER.md 详细技术开发文档（架构设计/模块详解/API参考/扩展指南）
- 文档用词规范化，去除非专业"超进化"用语，以V4.0和专业表述统一
- README/README_EN/USER_MANUAL/PROJECT_SUMMARY同步更新模块数量和版本信息
- CLI help命令全面重写，200行分类命令参考，覆盖14个功能类别
- 31个高级扩展模块独立开关，配置注释去除版本标签
- 发布产物 release/V4.0/AluerServerGuard-V4.0.jar
This commit is contained in:
Peijun Zhao
2026-05-10 22:36:02 +08:00
parent b271eda8d5
commit c60ceda94f
9 changed files with 1117 additions and 54 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+3 -3
View File
@@ -810,7 +810,7 @@ serverguard
### 安全防护层 (`com.aluer.security`) ### 安全防护层 (`com.aluer.security`)
这是系统中规模最大的包，包含 85+ 个安全服务（含 31 个超进化 v3.1 / v3.2 / v3.3 新增模块）： 这是系统中规模最大的包，包含 85+ 个安全服务（含 31 个高级扩展安全模块，V4.0 完整版）：
| 类别 | 类 | 功能 | | 类别 | 类 | 功能 |
|------|-----|------| |------|-----|------|
@@ -860,7 +860,7 @@ serverguard
| | `LoadBalancerService` | 简易负载均衡 | | | `LoadBalancerService` | 简易负载均衡 |
| | `TrafficShapingService` | 流量整形/QoS | | | `TrafficShapingService` | 流量整形/QoS |
| | `EncryptionService` | 数据加密工具 | | | `EncryptionService` | 数据加密工具 |
| **超进化 v3.1** | `JwtAuthService` | JWT Token HMAC-SHA256 认证，常量时间签名比对 | | **高级扩展模块** | `JwtAuthService` | JWT Token HMAC-SHA256 认证，常量时间签名比对 |
| | `BruteForceProtectionService` | 三层时间窗口(60s/600s/3600s)暴力破解防护，渐进延迟 | | | `BruteForceProtectionService` | 三层时间窗口(60s/600s/3600s)暴力破解防护，渐进延迟 |
| | `AntiBotDetectionService` | Minecraft 机器人检测：命名模式/加入速度/多账号/客户端品牌 | | | `AntiBotDetectionService` | Minecraft 机器人检测：命名模式/加入速度/多账号/客户端品牌 |
| | `AntiGriefDetectionService` | 方块破坏/放置速率监控，危险方块识别，容器掠夺检测 | | | `AntiGriefDetectionService` | 方块破坏/放置速率监控，危险方块识别，容器掠夺检测 |
@@ -885,7 +885,7 @@ serverguard
| | `AntiDupeDetectionService` | 物品复制检测：堆叠溢出、高价值物品暴涨、9种已知复制方法监测 | | | `AntiDupeDetectionService` | 物品复制检测：堆叠溢出、高价值物品暴涨、9种已知复制方法监测 |
| | `CrashExploitProtectionService` | 崩溃漏洞防护：超大包/负长度/NBT嵌套/书与笔/Sign炸弹/Tile Entity洪水 | | | `CrashExploitProtectionService` | 崩溃漏洞防护：超大包/负长度/NBT嵌套/书与笔/Sign炸弹/Tile Entity洪水 |
| | `LagMachineDetectionService` | 卡服机检测：Observer链/TNT堆叠/红石密度/实体刷怪/掉落方块洪流 | | | `LagMachineDetectionService` | 卡服机检测：Observer链/TNT堆叠/红石密度/实体刷怪/掉落方块洪流 |
| **v3.3 扩展** | `GeoBlockService` | 地理IP封锁：国家/地区黑白名单，高风险Minecraft攻击来源国拦截 | | **V4.0 扩展** | `GeoBlockService` | 地理IP封锁：国家/地区黑白名单，高风险Minecraft攻击来源国拦截 |
| | `PlayerSessionValidationService` | 玩家会话验证：UUID格式/离线模式/正版检测/会话重放/多账号识别 | | | `PlayerSessionValidationService` | 玩家会话验证：UUID格式/离线模式/正版检测/会话重放/多账号识别 |
| | `PluginVerificationService` | 插件完整性校验：SHA-256哈希对比、恶意插件名检测、JAR结构检查 | | | `PluginVerificationService` | 插件完整性校验：SHA-256哈希对比、恶意插件名检测、JAR结构检查 |
| | `ConnectionThrottleService` | 连接速率限制：多时间窗口IP追踪、递增延迟(2s/5s/15s/30s)、并发上限 | | | `ConnectionThrottleService` | 连接速率限制：多时间窗口IP追踪、递增延迟(2s/5s/15s/30s)、并发上限 |
README_EN.md
+3 -3
View File
@@ -667,7 +667,7 @@ serverguard
### Security Defense Layer (`com.aluer.security`) ### Security Defense Layer (`com.aluer.security`)
The largest package in the system, containing 85+ security services (with 31 Super Evolution v3.1 / v3.2 / v3.3 modules): The largest package in the system, containing 85+ security services (with 31 advanced extended security modules, V4.0 complete edition):
| Category | Key Classes | Description | | Category | Key Classes | Description |
|----------|------------|-------------| |----------|------------|-------------|
@@ -682,7 +682,7 @@ The largest package in the system, containing 85+ security services (with 31 Sup
| **Security Operations** | `SIEMService`, `SecurityOrchestrationService`, `SecurityAutomationScheduler`, `SecurityBaselineHardeningService`, `BackupSecurityService` | SIEM correlation, security orchestration, baseline hardening | | **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) | | **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 | | **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 | | **Advanced Extensions** | `JwtAuthService` | JWT HMAC-SHA256 auth with constant-time comparison |
| | `BruteForceProtectionService` | Three-layer time window (60s/600s/3600s) brute force defense | | | `BruteForceProtectionService` | Three-layer time window (60s/600s/3600s) brute force defense |
| | `AntiBotDetectionService` | Minecraft bot detection: name patterns/join velocity/multi-account | | | `AntiBotDetectionService` | Minecraft bot detection: name patterns/join velocity/multi-account |
| | `AntiGriefDetectionService` | Block break/place rate monitoring, dangerous block detection | | | `AntiGriefDetectionService` | Block break/place rate monitoring, dangerous block detection |
@@ -707,7 +707,7 @@ The largest package in the system, containing 85+ security services (with 31 Sup
| | `AntiDupeDetectionService` | Item duplication detection: stack overflow, high-value item surges, 9 known methods | | | `AntiDupeDetectionService` | Item duplication detection: stack overflow, high-value item surges, 9 known methods |
| | `CrashExploitProtectionService` | Crash exploit protection: oversized packets, NBT bombs, book/sign exploits | | | `CrashExploitProtectionService` | Crash exploit protection: oversized packets, NBT bombs, book/sign exploits |
| | `LagMachineDetectionService` | Lag machine detection: observer chains, TNT stacks, entity spam, falling blocks | | | `LagMachineDetectionService` | Lag machine detection: observer chains, TNT stacks, entity spam, falling blocks |
| **v3.3 New Modules** | `GeoBlockService` | Geo IP blocking: country allowlist/blocklist, high-risk Minecraft attack source interception | | **V4.0 Extensions** | `GeoBlockService` | Geo IP blocking: country allowlist/blocklist, high-risk Minecraft attack source interception |
| | `PlayerSessionValidationService` | Player session validation: UUID format, offline/premium detection, session replay, multi-account | | | `PlayerSessionValidationService` | Player session validation: UUID format, offline/premium detection, session replay, multi-account |
| | `PluginVerificationService` | Plugin integrity verification: SHA-256 hash comparison, malicious plugin name detection | | | `PluginVerificationService` | Plugin integrity verification: SHA-256 hash comparison, malicious plugin name detection |
| | `ConnectionThrottleService` | Connection rate limiting: multi-window IP tracking, progressive delay (2s/5s/15s/30s) | | | `ConnectionThrottleService` | Connection rate limiting: multi-window IP tracking, progressive delay (2s/5s/15s/30s) |
docs/DEVELOPER.md
+773
View File
@@ -0,0 +1,773 @@
# Aluer ServerGuard V4.0 — 开发参考手册
## 版本信息
| 项目 | 内容 |
|------|------|
| 版本号 | V4.0 |
| 发布日期 | 2026-05-10 |
| 构建工具 | Apache Maven 3.9.6 (bundled) |
| 运行环境 | Java 17+, Spring Boot 3.2.0 |
| 许可证 | Apache 2.0 |
---
## 目录
1. [技术架构](#1-技术架构)
2. [项目结构](#2-项目结构)
3. [模块详解](#3-模块详解)
4. [核心设计模式](#4-核心设计模式)
5. [配置体系](#5-配置体系)
6. [API 参考](#6-api-参考)
7. [CLI 命令系统](#7-cli-命令系统)
8. [测试策略](#8-测试策略)
9. [构建与部署](#9-构建与部署)
10. [安全机制层次](#10-安全机制层次)
11. [扩展开发指南](#11-扩展开发指南)
---
## 1. 技术架构
### 1.1 总体架构
Aluer ServerGuard 采用分层架构设计，自底向上分为基础层、安全层、AI 决策层与交互层：
```
┌──────────────────────────────────────────────────────┐
│ 交互层 (Interaction) │
│ AITerminal (Spring Shell) │ Dashboard (REST API) │
├──────────────────────────────────────────────────────┤
│ AI 决策层 (Intelligence) │
│ DeepSeekClient │ AnomalyDetector │ StrategyEngine│
├──────────────────────────────────────────────────────┤
│ 安全层 (Security) │
│ ┌──────────┬──────────┬──────────┬──────────┐ │
│ │ 网络防御 │ 主机安全 │ 应用防护 │ 合规审计 │ │
│ │ DDoS/IDS │ 进程/内存 │ WAF/CSP │ 取证/报告 │ │
│ └──────────┴──────────┴──────────┴──────────┘ │
├──────────────────────────────────────────────────────┤
│ 基础层 (Foundation) │
│ KernelEngine │ TaskBus │ SelfHealing │ Config │
└──────────────────────────────────────────────────────┘
```
### 1.2 技术栈
| 层次 | 技术 | 用途 |
|------|------|------|
| 运行时 | Java 17 | 核心语言 |
| 框架 | Spring Boot 3.2.0 | 应用容器、依赖注入、配置管理 |
| CLI | Spring Shell 3.1.3 | 交互式命令行终端 |
| Web | Spring Boot Web (Tomcat) | REST API 服务 |
| 构建 | Maven 3.9.6 | 依赖管理、打包 |
| AI | DeepSeek API | 威胁分析、根因诊断 |
| 数学 | Commons Math 3.6.1 | 孤立森林、统计计算 |
| SSH | JSch 0.2.20 | 远程 SSH 连接 |
| 序列化 | Gson 2.10.1 | JSON 处理 |
| 邮件 | javax.mail 1.6.2 | 告警通知 |
| 前端 | React 19.1 + Vite 6.3 | Web 控制台 |
### 1.3 数据流
```
Minecraft Server ──> ProcessMonitor ──> MetricsService ──> AnomalyDetector
│ │ │ │
│ LogMonitor │ DeepSeekClient
│ │ │ │
└── RconClient ──> AutoExecutor <── AIStrategyEngine <──┘
│
Dashboard API ──> Web Console
```
---
## 2. 项目结构
```
AluerIII/
├── pom.xml # Maven 项目配置
├── apache-maven-3.9.6/ # 内置 Maven（无需系统安装）
├── src/
│ ├── main/java/com/aluer/
│ │ ├── ServerGuardApplication.java # Spring Boot 启动入口
│ │ ├── ai/ # AI 智能分析模块 (7 files)
│ │ ├── alert/ # 邮件告警 (1 file)
│ │ ├── anticheat/ # 反作弊集成 (1 file)
│ │ ├── audit/ # 安全审计 (1 file)
│ │ ├── backup/ # 自动备份 (1 file)
│ │ ├── chat/ # 聊天过滤 (1 file)
│ │ ├── command/ # Shell 命令 (2 files)
│ │ ├── config/ # 配置管理 (2 files)
│ │ ├── console/ # 运维控制台 (4 files)
│ │ ├── controller/ # 测试端点 (1 file)
│ │ ├── export/ # 数据导出 (1 file)
│ │ ├── kernel/ # 内核引擎 (3 files)
│ │ ├── metrics/ # 指标采集 (1 file)
│ │ ├── model/ # 数据模型 (3 files)
│ │ ├── monitor/ # 系统监控 (4 files)
│ │ ├── notification/ # Webhook/报告 (2 files)
│ │ ├── profiler/ # 性能分析 (1 file)
│ │ ├── punishment/ # 玩家处罚 (1 file)
│ │ ├── schedule/ # 定时任务 (1 file)
│ │ ├── security/ # 安全引擎 (85 files)
│ │ ├── service/ # 核心服务 (4 files)
│ │ ├── terminal/ # AI 终端 (1 file)
│ │ ├── vpn/ # VPN 检测 (1 file)
│ │ ├── web/ # Web 控制台 (5 files)
│ │ └── world/ # 世界管理 (1 file)
│ ├── main/resources/
│ │ └── application.yml # 全局配置
│ └── test/java/com/aluer/ # 测试 (12 files, 114 cases)
├── docs/
│ ├── DEVELOPER.md # 本文档
│ ├── USER_MANUAL.md # 用户手册
│ └── PROJECT_SUMMARY.md # 功能拆解
├── frontend/ # React Web 控制台源码
├── forensics/ # 取证输出目录
├── release/ # 发布产物
└── README.md # 项目概览
```
---
## 3. 模块详解
### 3.1 AI 智能分析模块 (`com.aluer.ai`)
负责威胁感知、异常检测、趋势预测与智能决策。
| 类名 | 功能 | 核心算法 |
|------|------|----------|
| `AIAutonomousService` | 自主威胁感知与自动防御触发 | 正则模式匹配、流量时序分析 |
| `AIStrategyEngine` | 根据威胁严重程度匹配防御策略 | 规则引擎 |
| `DeepSeekClient` | DeepSeek API 集成，深度威胁分析 | LLM 推理 |
| `AnomalyDetector` | 多指标异常检测 | 孤立森林 (Isolation Forest) |
| `AttackDetector` | 协同攻击检测 | 关联分析 |
| `TimeSeriesPredictor` | TPS/内存趋势预测 | 滑动窗口 + 线性回归 |
| `AdaptiveThreshold` | 动态告警阈值调整 | 历史基线学习 |
| `AluerSovereignEngine` | 自主决策总控引擎 | 多信号融合 |
### 3.2 Kernel 内核模块 (`com.aluer.kernel`)
系统级信号处理与任务调度核心。
| 类名 | 功能 |
|------|------|
| `AluerKernelEngine` | 内核脉冲引擎，周期性采集系统信号，维护信号日志与回响队列 |
| `AluerKernelTaskBus` | 异步任务总线，支持任务排队、分发与历史记录 |
| `AluerSelfHealingOrchestrator` | 自愈编排器，检测异常后自动执行恢复剧本（重启/备份/白名单） |
### 3.3 安全引擎 (`com.aluer.security`)
85 个安全服务类，分为以下子类：
#### 3.3.1 网络安全防御
| 服务类 | 防护目标 | 关键技术 |
|--------|----------|----------|
| `DDoSProtectionService` | DDoS 攻击 | SYN/HTTP/UDP/ICMP Flood 检测 |
| `DDoSDefenseCoordinator` | 多层 DDoS 协同防御 | 流量清洗调度 |
| `IntrusionDetectionService` | 入侵检测 | 行为基线偏离 |
| `IntrusionPreventionSystem` | 入侵阻断 | 实时封禁 |
| `FirewallService` | 主机防火墙 | iptables/ufw 规则管理 |
| `NetworkMonitorService` | 网络流量监控 | 带宽统计、连接追踪 |
| `PortScanDetectionService` | 端口扫描检测 | 连接频率 + 端口序列分析 |
| `IPReputationService` | IP 信誉评估 | 黑名单 + 行为评分 |
| `GeoIPService` | IP 地理定位 | GeoIP 数据库查询 |
| `GeoBlockService` | 地理区域封锁 | 国家/地区级拦截 (v3.3) |
| `ConnectionThrottleService` | 连接速率限制 | 多时间窗口 + 递增延迟 (v3.3) |
| `TrafficAnalysisService` | 流量深度分析 | 协议识别、异常流量模式 |
| `TrafficShapingService` | 流量整形 | 带宽限制、优先级队列 |
| `LoadBalancerService` | 负载均衡 | 连接分发 |
| `NetworkThreatFusionService` | 威胁信号融合 | 多源威胁情报合并 |
| `NetworkSegmentationService` | 网络隔离 | 微隔离策略 |
| `NetworkSnifferService` | 网络嗅探 | 原始数据包捕获 |
| `PacketInspectionService` | 深度包检测 | 载荷特征匹配 |
| `ProtocolAnalysisService` | 协议分析 | Minecraft 协议异常 |
| `FlowAnalyzerService` | 流量分析器 | NetFlow/sFlow 分析 |
| `DistributedAttackMitigationService` | 分布式攻击缓解 | 多节点协同防御 |
| `ContainerSecurityService` | 容器安全 | Docker/K8s 安全策略 |
#### 3.3.2 应用层安全
| 服务类 | 防护目标 | 关键技术 |
|--------|----------|----------|
| `WebApplicationFirewall` | Web 应用攻击 | SQLi/XSS/路径遍历过滤 |
| `WafRequestFilter` | HTTP 请求过滤 | Servlet Filter 拦截 |
| `JwtAuthService` | API 身份认证 | JWT 令牌签发/验证 |
| `BruteForceProtectionService` | 暴力破解防护 | 多时间窗口登录失败计数 |
| `AntiBotDetectionService` | 机器人检测 | 名称模式/加入速率/IP 关联 |
| `CSPEnforcementService` | 内容安全策略 | 8 种 HTTP 安全响应头 |
| `XXEProtectionService` | XML 外部实体防护 | Entity 注入检测 |
| `SSRFProtectionService` | 服务端请求伪造防护 | 内网 IP/云元数据/编码绕过 |
| `SessionManagementService` | 会话管理 | 超时/并发/固定 |
| `APIRateLimitService` | API 速率限制 | 令牌桶算法 |
| `RateLimitService` | 通用速率限制 | 滑动窗口 |
| `CommandExecutionGuardService` | 命令执行防护 | 注入检测 |
#### 3.3.3 主机与端点安全
| 服务类 | 防护目标 | 关键技术 |
|--------|----------|----------|
| `ReverseShellDetectionService` | 反向 Shell 检测 | 50+ Shell 模式匹配 |
| `ARPSpoofDetectionService` | ARP 欺骗检测 | MAC 变更/网关伪造监测 |
| `DNSTunnelDetectionService` | DNS 隧道检测 | 香农熵/Base32 编码/可疑 TLD |
| `ExploitSignatureService` | 漏洞特征检测 | 15 种已知漏洞模式匹配 |
| `DatabaseFirewallService` | 数据库防火墙 | SQL 注入/联合查询/时间盲注 |
| `DataLossPreventionService` | 数据防泄漏 | 12 种敏感信息规则/自动脱敏 |
| `MemoryProtectionService` | JVM 内存保护 | 堆/GC/内存泄漏监控 |
| `ProcessInjectionDetectionService` | 进程注入检测 | /proc 扫描/线程异常检测 |
| `SecureFileDeletionService` | 安全文件删除 | 多道覆写 (DoD 5220.22-M) |
| `ForensicsCollectorService` | 取证数据收集 | 进程/网络/日志快照 |
| `IncidentResponseService` | 事件响应自动化 | 5 种预定义响应剧本 |
| `ThreatHuntingService` | 威胁狩猎 | 10 种狩猎定义/5 个 IOC 类别 |
| `ComplianceScannerService` | 合规扫描 | 7 类 20+ 检查项 |
| `SecurityBaselineHardeningService` | 安全基线硬化 | 系统配置加固 |
| `SecurityAutomationScheduler` | 安全自动化调度 | 定时安全任务 |
| `SecurityOrchestrationService` | 安全编排 | 多模块协同 |
| `FileIntegrityMonitorService` | 文件完整性监控 | 哈希比对 |
| `EndpointDetectionResponseService` | 端点检测响应 | 行为监控 |
| `HostEnforcementService` | 主机强制策略 | 内核级防火墙 |
| `HostIntrusionCountermeasureService` | 主机入侵对策 | 自动隔离 |
| `LogAnalysisService` | 日志分析 | 模式匹配与异常检测 |
| `LogCorrelationService` | 日志关联 | 多源日志关联分析 |
| `SIEMService` | 安全信息事件管理 | 事件关联引擎 |
| `EncryptionService` | 加密服务 | AES/RSA 操作 |
| `SSLMonitorService` | SSL 证书监控 | 到期检测 |
| `SSLTLSCertificateService` | SSL/TLS 管理 | 证书生命周期 |
#### 3.3.4 Minecraft 专属安全
| 服务类 | 防护目标 | 关键技术 |
|--------|----------|----------|
| `MinecraftProtocolSecurityService` | 协议层安全 | NBT/数据包校验 |
| `AntiGriefDetectionService` | 反破坏检测 | 方块破坏率/TNT/纵火/偷箱 |
| `AntiXrayDetectionService` | X-ray 透视检测 | 钻石矿比例/直线挖掘/暗处精准 |
| `AntiFlyDetectionService` | 飞行外挂检测 | 垂直/水平速度阈值/悬空时间 |
| `AntiDupeDetectionService` | 物品复制检测 | 堆叠异常/高价值暴涨/9 种复制模式 |
| `CrashExploitProtectionService` | 崩溃漏洞防护 | 超大包/NBT 炸弹/书与笔攻击 |
| `LagMachineDetectionService` | 卡服机检测 | Observer 链/TNT 堆/红石密度 |
| `PlayerSessionValidationService` | 玩家会话验证 | UUID 格式/离线模式/快速切换 (v3.3) |
| `PluginVerificationService` | 插件完整性校验 | SHA-256/文件大小/恶意名称 (v3.3) |
| `AntiSkinSpoofService` | 皮肤伪造检测 | 模型异常/URL 检测/变更频率 (v3.3) |
#### 3.3.5 运维安全
| 服务类 | 功能 |
|--------|------|
| `BackupSecurityService` | 备份安全策略管理 |
| `BackupIntegrityService` | 备份完整性校验 SHA-256 (v3.3) |
| `HoneypotService` | 蜜罐诱捕系统 |
| `ZeroTrustArchitectureService` | 零信任架构 |
| `CloudflareIntegrationService` | Cloudflare CDN 联动 |
| `ThreatIntelligenceService` | 威胁情报中心 |
| `AdvancedMalwareDetectionService` | 恶意软件扫描 |
| `DNSSecurityService` | DNS 安全 |
### 3.4 监控模块 (`com.aluer.monitor`)
| 类名 | 监控目标 | 采集指标 |
|------|----------|----------|
| `ResourceMonitor` | 系统资源 | CPU/内存/磁盘/TPS |
| `LogMonitor` | 服务端日志 | 异常堆栈/安全事件 |
| `ProcessMonitor` | Minecraft 进程 | 存活状态/重启触发 |
| `ConnectionMonitor` | 网络连接 | 连接数/连接频率 |
### 3.5 核心服务 (`com.aluer.service`)
| 类名 | 功能 |
|------|------|
| `ServerGuardService` | 系统总控，协调所有模块启动与调度 |
| `AutoExecutor` | 自动化指令执行，将 AI 决策转为服务器操作 |
| `RconClient` | RCON 协议客户端，安全下发 Minecraft 指令 |
### 3.6 Web 控制台 (`com.aluer.web`)
| 类名 | 功能 |
|------|------|
| `DashboardController` | 主 API 控制器，48 个 REST 端点 |
| `ConsoleStreamController` | 控制台实时流 |
| `OperationsConsoleController` | 运维操作 API |
| `HealthService` | 健康检查服务 |
| `RequestLoggingFilter` | HTTP 请求日志过滤器 |
---
## 4. 核心设计模式
### 4.1 结果封装模式
所有安全服务采用**内部静态结果类 + 静态工厂方法**模式：
```java
public class SomeSecurityService {
public static class DetectionResult {
private final boolean blocked;
private final List<String> reasons;
private DetectionResult(boolean blocked, List<String> reasons) { ... }
public static DetectionResult clean() { return new DetectionResult(false, List.of()); }
public static DetectionResult blocked(List<String> reasons) { return new DetectionResult(true, reasons); }
public boolean isBlocked() { return blocked; }
public List<String> getReasons() { return reasons; }
}
}
```
优势：不可变、类型安全、语义明确、易于测试断言。
### 4.2 双构造函数模式
所有安全服务实现双构造函数以支持 Spring 注入和单元测试：
```java
public class SomeSecurityService {
private final ServerGuardConfig config;
// 无参构造函数 — 测试用
public SomeSecurityService() {
this(new ServerGuardConfig());
}
// 参数化构造函数 — Spring 注入
@Autowired
public SomeSecurityService(ServerGuardConfig config) {
this.config = config;
}
}
```
### 4.3 开关控制模式
所有 31 个扩展安全模块通过 `ServerGuardConfig` 统一控制，方法入口处检查：
```java
public DetectionResult detect(String input) {
if (!config.getSecurity().getSuperEvolution().isXxx()) {
return DetectionResult.clean(); // 模块关闭，返回安全结果
}
// ... 实际检测逻辑
}
```
### 4.4 配置层次绑定
使用 `@ConfigurationProperties(prefix = "serverguard")` 实现类型安全的 YAML 到 Java 映射，支持嵌套静态内部类，每个层级对应 YAML 的一级缩进。
---
## 5. 配置体系
### 5.1 配置层级
```
serverguard
├── minecraft # Minecraft 服务端连接
│ └── rcon # RCON 协议配置
├── monitor # 监控阈值
├── alert # 告警配置
│ └── email # 邮件服务
│ └── rate-limit
├── ai # AI 模块配置
│ └── deepseek # DeepSeek API
│ └── auto-execute
├── security # 安全模块配置
│ ├── anti-intrusion
│ │ └── file-integrity
│ ├── host-enforcement
│ ├── cloud-edge
│ ├── orchestration
│ ├── autonomy
│ ├── shield
│ ├── kernel
│ ├── task-bus
│ ├── self-healing
│ └── super-evolution # 31 个扩展模块独立开关
├── dashboard # Web 控制台
│ └── ssh-gateway
├── webhook # 通知集成
└── report # 报告输出
```
### 5.2 Super Evolution 模块开关 (V4.0 全部 31 个)
所有开关均为 `boolean` 类型，默认值 `true`，位于 `serverguard.security.super-evolution` 路径下：
| 配置键 | 模块名称 | 版本 |
|--------|----------|------|
| `jwt-auth` | JWT 身份认证 | v3.1 |
| `brute-force` | 暴力破解防护 | v3.1 |
| `anti-bot` | 反机器人检测 | v3.1 |
| `reverse-shell` | 反向 Shell 检测 | v3.1 |
| `arp-spoof` | ARP 欺骗检测 | v3.1 |
| `dns-tunnel` | DNS 隧道检测 | v3.1 |
| `exploit-signature` | 漏洞签名检测 | v3.1 |
| `ssrf` | SSRF 防护 | v3.1 |
| `xxe` | XXE 防护 | v3.1 |
| `csp` | CSP 安全头 | v3.1 |
| `database-firewall` | 数据库防火墙 | v3.1 |
| `dlp` | 数据防泄漏 | v3.1 |
| `memory-protection` | 内存保护 | v3.1 |
| `process-injection` | 进程注入检测 | v3.1 |
| `secure-delete` | 安全文件删除 | v3.1 |
| `forensics` | 取证收集 | v3.1 |
| `incident-response` | 事件响应 | v3.1 |
| `threat-hunting` | 威胁狩猎 | v3.1 |
| `compliance` | 合规扫描 | v3.1 |
| `anti-grief` | 反破坏检测 | v3.1 |
| `anti-xray` | X-ray 检测 | v3.2 |
| `anti-fly` | 飞行外挂检测 | v3.2 |
| `anti-dupe` | 物品复制检测 | v3.2 |
| `crash-exploit` | 崩溃漏洞防护 | v3.2 |
| `lag-machine` | 卡服机检测 | v3.2 |
| `geo-block` | 地理 IP 封锁 | v3.3 |
| `session-validation` | 会话验证 | v3.3 |
| `plugin-verification` | 插件校验 | v3.3 |
| `connection-throttle` | 连接速率限制 | v3.3 |
| `backup-integrity` | 备份完整性 | v3.3 |
| `anti-skin-spoof` | 皮肤伪造检测 | v3.3 |
---
## 6. API 参考
所有 API 基于 Spring Boot REST，前缀 `/api`。以下按功能域分组：
### 6.1 系统状态
| 方法 | 路径 | 说明 |
|------|------|------|
| GET | `/api/health` | 系统健康检查 |
| GET | `/api/status` | 综合状态概览 |
| GET | `/api/status/ai` | AI 模块状态 |
| GET | `/api/status/monitor` | 监控模块状态 |
### 6.2 安全防御
| 方法 | 路径 | 说明 |
|------|------|------|
| GET | `/api/security/ddos/status` | DDoS 防御状态 |
| GET | `/api/security/firewall/status` | 防火墙状态 |
| GET | `/api/security/ids/status` | 入侵检测状态 |
| GET | `/api/security/ips/status` | 入侵防御状态 |
| GET | `/api/security/waf/status` | WAF 状态 |
| GET | `/api/security/ip-reputation/status` | IP 信誉状态 |
| GET | `/api/security/geo-block/status` | 地理封锁状态 (v3.3) |
| GET | `/api/security/session-validation/status` | 会话验证状态 (v3.3) |
| GET | `/api/security/plugin-verification/status` | 插件校验状态 (v3.3) |
| GET | `/api/security/connection-throttle/status` | 连接限制状态 (v3.3) |
| GET | `/api/security/backup-integrity/status` | 备份完整性状态 (v3.3) |
| GET | `/api/security/anti-skin-spoof/status` | 反皮肤伪造状态 (v3.3) |
### 6.3 安全检测（应用层）
| 方法 | 路径 | 说明 |
|------|------|------|
| GET | `/api/security/jwt/status` | JWT 认证状态 |
| GET | `/api/security/brute-force/status` | 暴力破解防御状态 |
| GET | `/api/security/anti-bot/status` | 反机器人状态 |
| GET | `/api/security/reverse-shell/status` | 反向 Shell 检测状态 |
| GET | `/api/security/arp-spoof/status` | ARP 欺骗检测状态 |
| GET | `/api/security/dns-tunnel/status` | DNS 隧道状态 |
| GET | `/api/security/exploit-signature/status` | 漏洞签名状态 |
| GET | `/api/security/ssrf/status` | SSRF 防护状态 |
| GET | `/api/security/xxe/status` | XXE 防护状态 |
| GET | `/api/security/csp/status` | CSP 状态 |
| GET | `/api/security/database-firewall/status` | 数据库防火墙状态 |
| GET | `/api/security/dlp/status` | 数据防泄漏状态 |
| GET | `/api/security/memory-protection/status` | 内存保护状态 |
| GET | `/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` | 合规扫描状态 |
### 6.4 Minecraft 专属防御
| 方法 | 路径 | 说明 |
|------|------|------|
| GET | `/api/security/anti-grief/status` | 反破坏检测状态 |
| GET | `/api/security/anti-xray/status` | 反 X-ray 状态 |
| GET | `/api/security/anti-fly/status` | 反飞行外挂状态 |
| GET | `/api/security/anti-dupe/status` | 反物品复制状态 |
| GET | `/api/security/crash-exploit/status` | 崩溃漏洞防护状态 |
| GET | `/api/security/lag-machine/status` | 反卡服机状态 |
### 6.5 运维操作
| 方法 | 路径 | 说明 |
|------|------|------|
| POST | `/api/player/kick` | 踢出玩家 |
| POST | `/api/player/ban` | 封禁玩家 |
| POST | `/api/player/unban` | 解封玩家 |
| GET | `/api/player/list` | 在线玩家列表 |
| POST | `/api/world/backup` | 触发世界备份 |
| GET | `/api/world/backup/list` | 备份列表 |
| POST | `/api/world/restore` | 恢复世界备份 |
| GET | `/api/profile` | 性能分析数据 |
| POST | `/api/security/report/generate` | 生成安全报告 |
### 6.6 返回格式
```json
{
"success": true,
"data": { ... },
"timestamp": "2026-05-10T22:00:00+08:00"
}
```
---
## 7. CLI 命令系统
### 7.1 架构
基于 Spring Shell 3.1.3，入口类 `AITerminal` (`@ShellComponent`)。支持 `@ShellMethod` 注解自动注册。
### 7.2 命令分类
| 类别 | 命令数 | 说明 |
|------|--------|------|
| `all` | ~35 | 全部命令列表（默认） |
| `ai` | 6 | AI 分析与策略指令 |
| `status` | 5 | 系统状态查询 |
| `defense` | 8 | 防御模式控制 |
| `security` | 6 | 安全模块管理 |
| `monitor` | 4 | 监控数据查询 |
| `player` | 5 | 玩家管理 |
| `world` | 3 | 世界/备份管理 |
| `admin` | 6 | 管理员运维操作 |
### 7.3 使用示例
```bash
# 启动终端
java -jar AluerServerGuard-V4.0.jar
# 在终端内
help # 显示完整命令参考
help ai # AI 相关命令
help security # 安全相关命令
help all # 全部命令（含 API 端点列表）
# 自然语言交互
分析当前服务器安全状态
查看最近攻击报告
```
---
## 8. 测试策略
### 8.1 测试框架
- JUnit 5 (Jupiter)
- Plain POJO 测试（不加载 Spring 上下文）
- 不依赖 Mockito
### 8.2 测试文件清单
| 测试类 | 用例数 | 覆盖范围 |
|--------|--------|----------|
| `MinecraftSecurityTest` | 21 | 核心安全模块 |
| `SuperEvolutionSecurityTest` | 52 | v3.1/v3.2 扩展模块 |
| `V33SecurityTest` | 29 | v3.3 新模块 (6 个服务) |
| `WebApplicationFirewallTest` | 2 | WAF 引擎 |
| `NetworkThreatFusionServiceTest` | 2 | 威胁融合 |
| `SecurityBaselineHardeningServiceTest` | 1 | 安全基线 |
| `AluerKernelEngineTest` | 2 | 内核引擎 |
| `AluerKernelTaskBusTest` | 1 | 任务总线 |
| `AluerSelfHealingOrchestratorTest` | 1 | 自愈编排 |
| `AluerEngineHandshakeServiceTest` | 1 | 引擎握手 |
| `AluerMirageShieldServiceTest` | 1 | Mirage 盾 |
| `RemoteSshGatewayServiceTest` | 1 | SSH 网关 |
| **总计** | **114** | |
### 8.3 运行测试
```bash
./apache-maven-3.9.6/bin/mvn test
```
### 8.4 测试模式
所有安全服务使用双构造函数，测试中直接 `new ServiceName()` 实例化，无需 Spring 容器。涉及文件 I/O 的测试使用 `/tmp/` 路径配合不存在的文件，避免磁盘污染。
---
## 9. 构建与部署
### 9.1 环境要求
| 项目 | 最低要求 |
|------|----------|
| JDK | 17+ |
| 构建工具 | 内置 Maven 3.9.6 (无需系统安装) |
| 操作系统 | Linux (推荐 Ubuntu 22.04+) |
| 内存 | 建议 2GB+ 可用 |
| 磁盘 | 建议 10GB+ 可用 |
### 9.2 构建命令
```bash
# 编译 + 运行全部测试
./apache-maven-3.9.6/bin/mvn test
# 构建 fat JAR（跳过测试）
./apache-maven-3.9.6/bin/mvn package -DskipTests
# 产物位置
# target/serverguard.jar (Spring Boot 可执行 fat JAR)
```
### 9.3 部署
```bash
# 复制到目标服务器
scp release/V4.0/AluerServerGuard-V4.0.jar user@server:/opt/aluer/
# 启动（前台测试）
java -jar /opt/aluer/AluerServerGuard-V4.0.jar
# 启动（后台生产）
nohup java -jar /opt/aluer/AluerServerGuard-V4.0.jar > /var/log/aluer.log 2>&1 &
# 或使用 systemd（配置见 systemd/ 目录）
sudo systemctl enable aluer
sudo systemctl start aluer
```
### 9.4 版本发布
发布产物存放于 `release/V4.0/` 目录：
| 文件 | 说明 |
|------|------|
| `AluerServerGuard-V4.0.jar` | Spring Boot fat JAR (~29MB) |
---
## 10. 安全机制层次
系统实现四层纵深防御体系：
```
第一层 — 边界防御
GeoBlock, ConnectionThrottle, IPReputation, DDoS Protection
Cloudflare Integration, Port Scan Detection
第二层 — 网络与协议
Firewall, IDS/IPS, Deep Packet Inspection, Protocol Analysis
DNS Tunnel Detection, ARP Spoof Detection, Reverse Shell Detection
DNSSEC, SSL/TLS Monitoring
第三层 — 应用与数据
WAF, JWT Auth, Brute Force Protection, Anti-Bot
CSP, XXE Protection, SSRF Protection
SQL Firewall, DLP, Encryption Service
Session Management, API Rate Limit
第四层 — 主机与运营
Memory Protection, Process Injection Detection
File Integrity Monitoring, Secure Delete, Forensics
Anti-Cheat (Xray/Fly/Dupe/Grief)
Crash Exploit, Lag Machine, Skin Spoof
Plugin Verification, Backup Integrity
Compliance Scanner, Threat Hunting, Incident Response
```
---
## 11. 扩展开发指南
### 11.1 新增安全模块流程
**步骤 1** — 创建服务类 (`src/main/java/com/aluer/security/NewDetectionService.java`)
```java
package com.aluer.security;
import com.aluer.config.ServerGuardConfig;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import java.util.*;
import java.util.concurrent.ConcurrentHashMap;
import java.util.concurrent.atomic.AtomicLong;
@Service
public class NewDetectionService {
private final ServerGuardConfig config;
private final AtomicLong detectionCount = new AtomicLong(0);
private final Map<String, List<DetectionEvent>> history = new ConcurrentHashMap<>();
public NewDetectionService() { this(new ServerGuardConfig()); }
@Autowired
public NewDetectionService(ServerGuardConfig config) { this.config = config; }
public DetectionResult detect(String input, String source) {
if (!config.getSecurity().getSuperEvolution().isNewDetection()) {
return DetectionResult.clean();
}
// 检测逻辑...
return DetectionResult.clean();
}
public Map<String, Object> getStatus() {
Map<String, Object> s = new LinkedHashMap<>();
s.put("totalDetections", detectionCount.get());
return s;
}
public static class DetectionResult {
private final boolean flagged;
private final List<String> reasons;
private DetectionResult(boolean f, List<String> r) { this.flagged = f; this.reasons = r; }
public static DetectionResult clean() { return new DetectionResult(false, List.of()); }
public static DetectionResult flagged(List<String> r) { return new DetectionResult(true, r); }
public boolean isFlagged() { return flagged; }
public List<String> getReasons() { return reasons; }
}
private static class DetectionEvent {
final long timestamp;
final String source;
final String input;
DetectionEvent(long t, String s, String i) {}
}
}
```
**步骤 2** — 添加配置开关 (`ServerGuardConfig.SuperEvolutionConfig` 中添加 `boolean` 字段)
**步骤 3** — 添加 YAML 配置 (`application.yml` 中添加带中文注释的开关行)
**步骤 4** — 注册 API 端点 (`DashboardController` 中添加 `@GetMapping` 方法)
**步骤 5** — 编写测试 (至少 3 个用例：正常/异常/状态)
**步骤 6** — 更新文档
### 11.2 代码规范
- 使用 `LinkedHashMap` 保持状态 Map 的插入顺序
- 并发场景使用 `ConcurrentHashMap` + `AtomicLong`
- 结果类使用内部静态类，构造函数私有，提供静态工厂方法
- 不引入 Lombok 以外的额外依赖
- 日志使用 Slf4j，级别：WARN（关键事件）、INFO（状态变更）、DEBUG（详细追踪）
- 禁止在安全服务中执行阻塞 I/O 操作；所有文件操作使用异步调度器
---
<div align="center">
<p><strong>Aluer ServerGuard V4.0</strong></p>
<p>为 Minecraft 服务器安全构建的专业防护系统</p>
<p>Apache 2.0 License © 2026</p>
</div>
docs/PROJECT_SUMMARY.md
+3 -1
View File
@@ -143,7 +143,9 @@ AluerIII 是一个专为 Minecraft (PaperMC) 服务器设计的高级安全防
--- ---
## 9. 超进化安全模块 (`com.aluer.security`) — v3.1 新增 ## 9. V4.0 高级扩展安全模块 (`com.aluer.security`)
以下 31 个模块为 V4.0 新增的高级扩展安全模块，涵盖网络层、应用层、主机层和 Minecraft 专属防护：
以下20个安全服务模块为超级进化 (Super Evolution) 版本新增，覆盖身份认证、网络攻防、应用安全、数据保护和运维响应全维度： 以下20个安全服务模块为超级进化 (Super Evolution) 版本新增，覆盖身份认证、网络攻防、应用安全、数据保护和运维响应全维度：
### 9.1 身份与访问控制 ### 9.1 身份与访问控制
docs/USER_MANUAL.md
+12 -12
View File
@@ -85,7 +85,7 @@ cd /path/to/AluerIII
./apache-maven-3.9.6/bin/mvn package -DskipTests ./apache-maven-3.9.6/bin/mvn package -DskipTests
# 上传 jar 包和配置到服务器 # 上传 jar 包和配置到服务器
scp target/serverguard-1.0.0.jar user@your-server:/opt/aluer/ scp target/AluerServerGuard-V4.0.jar user@your-server:/opt/aluer/
scp start.sh user@your-server:/opt/aluer/ scp start.sh user@your-server:/opt/aluer/
``` ```
@@ -105,7 +105,7 @@ After=network.target
Type=simple Type=simple
User=minecraft User=minecraft
WorkingDirectory=/opt/aluer WorkingDirectory=/opt/aluer
ExecStart=/usr/bin/java -jar /opt/aluer/serverguard-1.0.0.jar ExecStart=/usr/bin/java -jar /opt/aluer/AluerServerGuard-V4.0.jar
Restart=on-failure Restart=on-failure
RestartSec=10 RestartSec=10
@@ -130,7 +130,7 @@ sudo systemctl status aluer
### 启动系统 ### 启动系统
```bash ```bash
# 方式1: 直接运行 # 方式1: 直接运行
java -jar serverguard-1.0.0.jar java -jar AluerServerGuard-V4.0.jar
# 方式2: 使用启动脚本 # 方式2: 使用启动脚本
./start.sh ./start.sh
@@ -388,7 +388,7 @@ export ALUER_WEBHOOK_DISCORD="https://discord.com/api/webhooks/xxx/yyy"
export ALUER_WEBHOOK_SLACK="https://hooks.slack.com/services/xxx/yyy/zzz" export ALUER_WEBHOOK_SLACK="https://hooks.slack.com/services/xxx/yyy/zzz"
``` ```
### 超进化安全模块 API（v3.1 新增） ### 高级扩展安全模块 API（V4.0 完整版）
#### 身份认证与访问控制 #### 身份认证与访问控制
@@ -442,7 +442,7 @@ export ALUER_WEBHOOK_SLACK="https://hooks.slack.com/services/xxx/yyy/zzz"
| `/api/security/threat-hunting/status` | GET | 威胁狩猎状态（最近狩猎结果） | | `/api/security/threat-hunting/status` | GET | 威胁狩猎状态（最近狩猎结果） |
| `/api/security/compliance/status` | GET | 合规扫描结果（评分、通过/失败项） | | `/api/security/compliance/status` | GET | 合规扫描结果（评分、通过/失败项） |
#### Minecraft 专属安全（v3.2 新增） #### Minecraft 专属安全（V4.0）
| 接口路径 | 方法 | 说明 | | 接口路径 | 方法 | 说明 |
|----------|------|------| |----------|------|------|
@@ -452,7 +452,7 @@ export ALUER_WEBHOOK_SLACK="https://hooks.slack.com/services/xxx/yyy/zzz"
| `/api/security/crash-exploit/status` | GET | 崩溃漏洞防护状态（超大包、NBT炸弹、书与笔攻击） | | `/api/security/crash-exploit/status` | GET | 崩溃漏洞防护状态（超大包、NBT炸弹、书与笔攻击） |
| `/api/security/lag-machine/status` | GET | 卡服机检测状态（Observer链、TNT堆、红石密度） | | `/api/security/lag-machine/status` | GET | 卡服机检测状态（Observer链、TNT堆、红石密度） |
#### v3.3 新增安全 API #### V4.0 新增安全 API
| 接口路径 | 方法 | 说明 | | 接口路径 | 方法 | 说明 |
|----------|------|------| |----------|------|------|
@@ -528,15 +528,15 @@ backup:
backup-config: true backup-config: true
``` ```
#### 超进化安全模块开关 #### 高级扩展安全模块开关（V4.0）
所有超进化安全模块均可通过 `application.yml` 中的 `serverguard.security.super-evolution` 节点独立控制开关。设为 `false` 即可关闭该模块，不消耗任何性能。 以下 31 个高级扩展安全模块均可通过 `application.yml` 中的 `serverguard.security.super-evolution` 节点独立控制开关。设为 `false` 即可关闭该模块，相关检测逻辑将被跳过，不消耗额外性能。
```yaml ```yaml
serverguard: serverguard:
security: security:
super-evolution: super-evolution:
# === v3.1 超进化安全模块（20个）=== # === V4.0 高级扩展安全模块（20个） ===
jwt-auth: true # JWT身份认证与令牌管理 jwt-auth: true # JWT身份认证与令牌管理
brute-force: true # 暴力破解防护（多时间窗口检测） brute-force: true # 暴力破解防护（多时间窗口检测）
anti-bot: true # 反机器人检测（Bot名称/加入速率/IP关联） anti-bot: true # 反机器人检测（Bot名称/加入速率/IP关联）
@@ -557,13 +557,13 @@ serverguard:
threat-hunting: true # 威胁狩猎（10种狩猎定义/5个类别） threat-hunting: true # 威胁狩猎（10种狩猎定义/5个类别）
compliance: true # 合规扫描（7类20+检查项） compliance: true # 合规扫描（7类20+检查项）
anti-grief: true # 反破坏检测（方块破坏率/TNT/纵火/偷箱） anti-grief: true # 反破坏检测（方块破坏率/TNT/纵火/偷箱）
# === v3.2 Minecraft专属模块（5个）=== # === Minecraft 专属防护模块（5个） ===
anti-xray: true # X-ray透视检测（钻石比/直线挖掘/暗处精准） anti-xray: true # X-ray透视检测（钻石比/直线挖掘/暗处精准）
anti-fly: true # 飞行外挂检测（垂直/水平速度/悬空时间） anti-fly: true # 飞行外挂检测（垂直/水平速度/悬空时间）
anti-dupe: true # 物品复制检测（堆叠异常/高价值暴涨/9种复制法） anti-dupe: true # 物品复制检测（堆叠异常/高价值暴涨/9种复制法）
crash-exploit: true # 崩溃漏洞防护（超大包/NBT炸弹/书与笔攻击） crash-exploit: true # 崩溃漏洞防护（超大包/NBT炸弹/书与笔攻击）
lag-machine: true # 卡服机检测（Observer链/TNT堆/红石密度） lag-machine: true # 卡服机检测（Observer链/TNT堆/红石密度）
# === v3.3 新模块（6个）=== # === V4.0 新增模块（6个） ===
geo-block: true # 地理IP封锁（按国家/地区拦截） geo-block: true # 地理IP封锁（按国家/地区拦截）
session-validation: true # 玩家会话验证（UUID伪造/正版/离线检测） session-validation: true # 玩家会话验证（UUID伪造/正版/离线检测）
plugin-verification: true # 插件完整性校验（Hash对比/未授权修改） plugin-verification: true # 插件完整性校验（Hash对比/未授权修改）
@@ -647,7 +647,7 @@ sudo systemctl stop aluer
cp -r /opt/aluer/backups /backup/ cp -r /opt/aluer/backups /backup/
# 替换jar包 # 替换jar包
cp target/serverguard-1.0.0.jar /opt/aluer/ cp target/AluerServerGuard-V4.0.jar /opt/aluer/
# 重启服务 # 重启服务
sudo systemctl start aluer sudo systemctl start aluer
pom.xml
+1 -1
View File
@@ -6,7 +6,7 @@
<groupId>com.aluer</groupId> <groupId>com.aluer</groupId>
<artifactId>serverguard</artifactId> <artifactId>serverguard</artifactId>
<version>1.0.0</version> <version>4.0.0</version>
<packaging>jar</packaging> <packaging>jar</packaging>
<name>Aluer ServerGuard</name> <name>Aluer ServerGuard</name>
release/V4.0/AluerServerGuard-V4.0.jar
BIN
View File
Binary file not shown.
src/main/java/com/aluer/terminal/AITerminal.java
+319 -31
View File
@@ -1012,41 +1012,329 @@ public class AITerminal {
return "【DeepSeek 主控回答】\n" + deepSeekClient.askQuestion(question); return "【DeepSeek 主控回答】\n" + deepSeekClient.askQuestion(question);
} }
private String getHelp() { @ShellMethod(key = "help", value = "显示全部可用命令与详细帮助")
public String help(@ShellOption(defaultValue = "all", help = "查看分类: all/ai/status/defense/security/monitor/player/world/admin/info") String category) {
if (!"all".equals(category)) {
return getHelpCategory(category);
}
return getFullHelp();
}
private String getFullHelp() {
StringBuilder sb = new StringBuilder(); StringBuilder sb = new StringBuilder();
sb.append("╔══════════════════════════════════════════════════╗\n"); sb.append("╔══════════════════════════════════════════════════════════════════╗\n");
sb.append("║ Aluer AI 终端帮助 ║\n"); sb.append("║ Aluer ServerGuard - 完整命令帮助 ║\n");
sb.append("╠══════════════════════════════════════════════════╣\n"); sb.append("╠══════════════════════════════════════════════════════════════════╣\n");
sb.append("║ ai <命令> - AI智能命令 ║\n"); sb.append("║ 输入 help <分类> 查看分类帮助: ai/status/defense/security ║\n");
sb.append("║ ask <问题> - 向AI提问 ║\n"); sb.append("║ monitor/player/world/admin/info ║\n");
sb.append("║ status - 服务器状态 ║\n"); sb.append("╚══════════════════════════════════════════════════════════════════╝\n\n");
sb.append("║ test [类型] - 测试服务器 ║\n");
sb.append("║ defense [操作] - 防御管理 ║\n"); sb.append("┌─────────────────────────────────────────────────────────────────┐\n");
sb.append("║ backup [操作] - 备份管理 ║\n"); sb.append("│ AI 智能助手 │\n");
sb.append("║ security [类型] - 安全状态 ║\n"); sb.append("├─────────────────────────────────────────────────────────────────┤\n");
sb.append("║ autonomy [操作] - Aluer主控引擎 ║\n"); sb.append("│ ai <自然语言> AI智能命令(测试服务器/开启防御/查看安全) │\n");
sb.append("║ kernel [操作] - Aluer中心内核 ║\n"); sb.append("│ ask <问题> 向DeepSeek AI提问任何问题 │\n");
sb.append("║ bus [操作] - 内核任务总线 ║\n"); sb.append("└─────────────────────────────────────────────────────────────────┘\n\n");
sb.append("║ heal [操作] - 自愈编排器 ║\n");
sb.append("║ network [操作] - 网络分析 ║\n"); sb.append("┌─────────────────────────────────────────────────────────────────┐\n");
sb.append("║ quarantine <IP> - 隔离高风险IP ║\n"); sb.append("│ 服务器状态与测试 │\n");
sb.append("║ unquarantine <IP> - 解除IP隔离 ║\n"); sb.append("├─────────────────────────────────────────────────────────────────┤\n");
sb.append("║ world [操作] - 世界管理 ║\n"); sb.append("│ status 查看服务器CPU/内存/连接/AI防御总览 │\n");
sb.append("║ alert [操作] - 预警系统 ║\n"); sb.append("│ test [类型] 测试服务器: all/cpu/memory/network/security │\n");
sb.append("║ metrics [类型] - 性能指标 ║\n"); sb.append("│ tps 显示服务器TPS (来自AdminCommands) │\n");
sb.append("║ audit [操作] - 安全审计 ║\n"); sb.append("│ memory 显示内存使用率 (来自AdminCommands) │\n");
sb.append("║ kick <玩家> - 踢出玩家 ║\n"); sb.append("└─────────────────────────────────────────────────────────────────┘\n\n");
sb.append("║ ban <玩家> - 封禁玩家 ║\n");
sb.append("║ tasks [操作] - 计划任务 ║\n"); sb.append("┌─────────────────────────────────────────────────────────────────┐\n");
sb.append("╚══════════════════════════════════════════════════╝\n\n"); sb.append("│ 安全防御管理 │\n");
sb.append("【示例命令】\n"); sb.append("├─────────────────────────────────────────────────────────────────┤\n");
sb.append(" ai 测试一下服务器\n"); sb.append("│ defense [操作] 防御管理: status/on/off/list/level [等级] │\n");
sb.append(" ai 开启防御\n"); sb.append("│ security summary 安全总览(态势分/威胁等级/高风险IP/DDoS等) │\n");
sb.append(" ai 查看安全状态\n"); sb.append("│ security posture 网络安全态势(建议/重点关注IP) │\n");
sb.append(" ai 帮我备份\n"); sb.append("│ security incidents 近期安全事件列表 │\n");
sb.append("│ security ddos DDoS防护状态(封禁IP/检测攻击数) │\n");
sb.append("│ security firewall 防火墙状态(活跃规则/模式) │\n");
sb.append("│ security intrusion 入侵检测状态(告警/跟踪用户) │\n");
sb.append("│ security threats AI威胁检测统计 │\n");
sb.append("│ security network 网络监控(流量/会话/高风险IP) │\n");
sb.append("│ security vpn VPN/代理检测状态 │\n");
sb.append("│ security chat 聊天过滤状态(违规词数量) │\n");
sb.append("│ quarantine <IP> 隔离高风险IP (参数: IP 原因) │\n");
sb.append("│ unquarantine <IP> 解除IP隔离 (参数: IP 原因) │\n");
sb.append("└─────────────────────────────────────────────────────────────────┘\n\n");
sb.append("┌─────────────────────────────────────────────────────────────────┐\n");
sb.append("│ 网络分析 │\n");
sb.append("├─────────────────────────────────────────────────────────────────┤\n");
sb.append("│ network stats 网络统计(活跃会话/入站/出站流量) │\n");
sb.append("│ network geoip IP地理位置查询 (参数: IP) │\n");
sb.append("│ network reputation IP信誉/风险等级查询 (参数: IP) │\n");
sb.append("│ network ports 端口扫描检测统计 │\n");
sb.append("└─────────────────────────────────────────────────────────────────┘\n\n");
sb.append("┌─────────────────────────────────────────────────────────────────┐\n");
sb.append("│ AI 主控引擎 / 内核 / 自愈 │\n");
sb.append("├─────────────────────────────────────────────────────────────────┤\n");
sb.append("│ autonomy summary Aluer主控引擎状态(模式/循环/决策) │\n");
sb.append("│ autonomy run 手动执行一次主控循环 │\n");
sb.append("│ autonomy history 最近5条主控决策历史 │\n");
sb.append("│ autonomy hardening 安全基线加固得分与发现项 │\n");
sb.append("│ kernel summary Aluer Kernel状态(脉冲/Echo/热度) │\n");
sb.append("│ kernel pulse 手动执行一次内核脉冲 │\n");
sb.append("│ kernel matrix 内核信号矩阵权重与向量 │\n");
sb.append("│ kernel journal 内核日志(最近6条) │\n");
sb.append("│ kernel pulses 最近5次脉冲历史 │\n");
sb.append("│ bus summary 内核任务总线(队列深度/执行任务) │\n");
sb.append("│ bus queue 任务队列快照 │\n");
sb.append("│ bus history 最近任务执行历史 │\n");
sb.append("│ bus dispatch 手动派发队列任务 │\n");
sb.append("│ bus plugins 已注册TaskBus插件列表 │\n");
sb.append("│ heal summary Aluer自愈编排器(循环/计划/热度) │\n");
sb.append("│ heal run 手动执行一次自愈循环 │\n");
sb.append("│ heal history 最近5次自愈历史 │\n");
sb.append("└─────────────────────────────────────────────────────────────────┘\n\n");
sb.append("┌─────────────────────────────────────────────────────────────────┐\n");
sb.append("│ 备份管理 │\n");
sb.append("├─────────────────────────────────────────────────────────────────┤\n");
sb.append("│ backup list 查看所有备份记录 │\n");
sb.append("│ backup create 创建新备份 (参数: 备份名称) │\n");
sb.append("│ backup status 备份服务状态 │\n");
sb.append("│ backup start 启动定时备份服务 │\n");
sb.append("└─────────────────────────────────────────────────────────────────┘\n\n");
sb.append("┌─────────────────────────────────────────────────────────────────┐\n");
sb.append("│ 玩家管理 │\n");
sb.append("├─────────────────────────────────────────────────────────────────┤\n");
sb.append("│ kick <玩家名> 踢出指定玩家 (RCON连接需启用) │\n");
sb.append("│ ban <玩家名> 封禁玩家 (参数: 玩家名 原因) │\n");
sb.append("│ unban <玩家名> 解封玩家 │\n");
sb.append("│ player kick 踢出玩家 (来自AdminCommands) │\n");
sb.append("│ player ban 封禁玩家 (来自AdminCommands) │\n");
sb.append("│ player mute 禁言玩家 (来自AdminCommands) │\n");
sb.append("└─────────────────────────────────────────────────────────────────┘\n\n");
sb.append("┌─────────────────────────────────────────────────────────────────┐\n");
sb.append("│ 世界管理 │\n");
sb.append("├─────────────────────────────────────────────────────────────────┤\n");
sb.append("│ world list 列出所有世界(名称/区块数/实体数) │\n");
sb.append("│ world load <世界> 加载世界 (如: world world_nether) │\n");
sb.append("│ world unload <世界> 卸载世界 │\n");
sb.append("└─────────────────────────────────────────────────────────────────┘\n\n");
sb.append("┌─────────────────────────────────────────────────────────────────┐\n");
sb.append("│ 预警系统 │\n");
sb.append("├─────────────────────────────────────────────────────────────────┤\n");
sb.append("│ alert status 邮件预警服务状态 │\n");
sb.append("│ alert test 发送测试邮件 │\n");
sb.append("│ alert send <消息> 手动发送告警邮件 │\n");
sb.append("└─────────────────────────────────────────────────────────────────┘\n\n");
sb.append("┌─────────────────────────────────────────────────────────────────┐\n");
sb.append("│ 性能监控与审计 │\n");
sb.append("├─────────────────────────────────────────────────────────────────┤\n");
sb.append("│ metrics summary 性能指标摘要(计数器/计量器数量) │\n");
sb.append("│ metrics counters 查看所有计数器 │\n");
sb.append("│ metrics gauges 查看所有计量器 │\n");
sb.append("│ audit recent [N] 最近N条审计事件 (默认10条) │\n");
sb.append("│ audit summary 审计事件分类摘要 │\n");
sb.append("│ tasks list 查看计划任务(备份/AI/VPN) │\n");
sb.append("│ tasks start 启动计划任务服务 │\n");
sb.append("│ config reload 重新加载配置 (来自AdminCommands) │\n");
sb.append("└─────────────────────────────────────────────────────────────────┘\n\n");
sb.append("┌─────────────────────────────────────────────────────────────────┐\n");
sb.append("│ 系统测试 (test命令扩展) │\n");
sb.append("├─────────────────────────────────────────────────────────────────┤\n");
sb.append("│ test all 运行全部测试 (来自TestCommands) │\n");
sb.append("│ test quick 快速测试(config/rcon/email) │\n");
sb.append("│ test config 测试配置 │\n");
sb.append("│ test rcon 测试RCON连接 │\n");
sb.append("│ test process 测试进程监控 │\n");
sb.append("│ test resource 测试资源监控 │\n");
sb.append("│ test connection 测试连接监控 │\n");
sb.append("│ test email 测试邮件服务 │\n");
sb.append("│ test email send 发送测试邮件 │\n");
sb.append("│ test deepseek 测试DeepSeek API │\n");
sb.append("│ test autoexecute 测试自动执行配置 │\n");
sb.append("│ test simulate attack 模拟攻击测试 │\n");
sb.append("│ test rcon exec 执行RCON命令 (参数: 命令) │\n");
sb.append("└─────────────────────────────────────────────────────────────────┘\n\n");
sb.append("┌─────────────────────────────────────────────────────────────────┐\n");
sb.append("│ 安全API端点 (HTTP GET /api/...) │\n");
sb.append("├─────────────────────────────────────────────────────────────────┤\n");
sb.append("│ /api/status 系统运行状态 │\n");
sb.append("│ /api/performance TPS/CPU/内存指标 │\n");
sb.append("│ /api/health 完整健康报告 │\n");
sb.append("│ /api/health/live 存活探针 │\n");
sb.append("│ /api/health/ready 就绪探针 │\n");
sb.append("│ /api/security/stats 安全统计总览 │\n");
sb.append("│ /api/security/network/posture 网络安全态势 │\n");
sb.append("│ /api/security/network/offenders 高风险IP列表 │\n");
sb.append("│ /api/security/network/incidents 安全事件列表 │\n");
sb.append("│ /api/security/auth/status JWT认证状态 │\n");
sb.append("│ /api/security/brute-force/status 暴力破解防护 │\n");
sb.append("│ /api/security/anti-bot/status 反机器人检测 │\n");
sb.append("│ /api/security/anti-grief/status 反破坏检测 │\n");
sb.append("│ /api/security/anti-xray/status X-ray透视检测 │\n");
sb.append("│ /api/security/anti-fly/status 飞行外挂检测 │\n");
sb.append("│ /api/security/anti-dupe/status 物品复制检测 │\n");
sb.append("│ /api/security/anti-skin-spoof/status 皮肤伪造检测 │\n");
sb.append("│ /api/security/crash-exploit/status 崩溃漏洞防护 │\n");
sb.append("│ /api/security/lag-machine/status 卡服机检测 │\n");
sb.append("│ /api/security/reverse-shell/status 反向Shell检测 │\n");
sb.append("│ /api/security/arp-spoof/status ARP欺骗检测 │\n");
sb.append("│ /api/security/dns-tunnel/status DNS隧道检测 │\n");
sb.append("│ /api/security/exploit-signature/status 漏洞签名检测 │\n");
sb.append("│ /api/security/ssrf/status SSRF防护 │\n");
sb.append("│ /api/security/xxe/status XXE防护 │\n");
sb.append("│ /api/security/csp/status CSP安全头 │\n");
sb.append("│ /api/security/database-firewall/status 数据库防火墙 │\n");
sb.append("│ /api/security/dlp/status 数据防泄漏 │\n");
sb.append("│ /api/security/memory/status JVM内存保护 │\n");
sb.append("│ /api/security/process-injection/status 进程注入检测 │\n");
sb.append("│ /api/security/secure-delete/status 安全文件删除 │\n");
sb.append("│ /api/security/forensics/status 取证收集 │\n");
sb.append("│ /api/security/incident-response/status 事件响应 │\n");
sb.append("│ /api/security/threat-hunting/status 威胁狩猎 │\n");
sb.append("│ /api/security/compliance/status 合规扫描 │\n");
sb.append("│ /api/security/geo-block/status 地理IP封锁 │\n");
sb.append("│ /api/security/session-validation/status 会话验证 │\n");
sb.append("│ /api/security/plugin-verification/status 插件校验 │\n");
sb.append("│ /api/security/connection-throttle/status 连接速率限制 │\n");
sb.append("│ /api/security/backup-integrity/status 备份完整性 │\n");
sb.append("│ /api/attacks/recent 最近攻击列表 │\n");
sb.append("│ /api/backup/list 备份列表 │\n");
sb.append("│ /api/punishment/list 封禁/禁言统计 │\n");
sb.append("└─────────────────────────────────────────────────────────────────┘\n\n");
sb.append("┌─────────────────────────────────────────────────────────────────┐\n");
sb.append("│ 自然语言快捷指令 (ai 命令) │\n");
sb.append("├─────────────────────────────────────────────────────────────────┤\n");
sb.append("│ ai 测试一下服务器 → 运行完整服务器测试 │\n");
sb.append("│ ai 开启防御 → 打开AI自主防御模式 │\n");
sb.append("│ ai 关闭防御 → 关闭AI自主防御模式 │\n");
sb.append("│ ai 查看安全状态 → 显示安全总览 │\n");
sb.append("│ ai 查看网络状态 → 显示网络统计 │\n");
sb.append("│ ai 帮我备份 → 查看备份记录 │\n");
sb.append("│ ai 查看世界 → 列出所有世界 │\n");
sb.append("│ ai 发送预警 → 查看预警系统状态 │\n");
sb.append("│ ai 查看主控引擎 → 显示Aluer主控引擎状态 │\n");
sb.append("│ ai 查看内核 → 显示Kernel内核状态 │\n");
sb.append("│ ai <其他问题> → 通过DeepSeek AI智能回答 │\n");
sb.append("└─────────────────────────────────────────────────────────────────┘\n\n");
sb.append(" 💡 提示: 输入 help <分类> 查看分类命令, help all 查看全部\n");
sb.append(" 💡 所有安全模块开关: application.yml → serverguard.security.super-evolution\n");
return sb.toString(); return sb.toString();
} }
private String getHelpCategory(String category) {
return switch (category) {
case "ai" -> """
【AI 智能助手】
ai <自然语言> 使用自然语言与服务器交互
ask <问题> 直接向DeepSeek AI提问
快捷指令:
ai 测试一下服务器 ai 开启防御 ai 查看安全状态
ai 查看网络状态 ai 帮我备份 ai 查看世界
ai 发送预警 ai 查看主控引擎 ai 查看内核""";
case "status" -> """
【服务器状态与测试】
status 查看服务器CPU/内存/连接/AI防御总览
test all 运行全部测试
test cpu 仅CPU测试
test memory 仅内存测试
test network 仅网络测试
test security 仅安全测试
tps 显示TPS
memory 显示内存使用率""";
case "defense" -> """
【防御管理】
defense status 查看防御状态(AI防御/等级/策略数)
defense on 开启AI自主防御模式
defense off 关闭AI自主防御模式
defense list 列出所有可用防御策略
defense level <等级> 调整防御等级""";
case "security" -> """
【安全状态查询】
security summary 安全总览(态势分/威胁/高风险IP)
security posture 网络安全态势(建议/重点关注)
security incidents 近期安全事件
security ddos DDoS防护状态
security firewall 防火墙状态
security intrusion 入侵检测状态
security threats AI威胁检测
security network 网络监控
security vpn VPN检测
security chat 聊天过滤
quarantine <IP> [原因] 隔离高风险IP
unquarantine <IP> [原因] 解除IP隔离""";
case "monitor" -> """
【AI引擎/内核/自愈/性能监控】
autonomy summary/run/history/hardening 主控引擎
kernel summary/pulse/matrix/journal/pulses Kernel内核
bus summary/queue/history/dispatch/plugins 任务总线
heal summary/run/history 自愈编排
metrics summary/counters/gauges 性能指标
audit recent [N]/summary 安全审计
tasks list/start 计划任务""";
case "player" -> """
【玩家与网络管理】
kick <玩家名> 踢出玩家(RCON需启用)
ban <玩家名> [原因] 封禁玩家
unban <玩家名> 解封玩家
player kick/ban/mute AdminCommands玩家管理
network stats 网络统计
network geoip <IP> IP地理位置
network reputation <IP> IP信誉查询
network ports 端口扫描检测""";
case "world" -> """
【世界与备份管理】
world list 列出所有世界
world load <世界> 加载世界
world unload <世界> 卸载世界
backup list 查看备份记录
backup create [名称] 创建新备份
backup status 备份服务状态
backup start 启动定时备份""";
case "admin" -> """
【系统管理】
alert status/test/send [消息] 邮件预警
server status 服务器状态(AdminCommands)
config reload 重新加载配置
ai analyze <数据> AI分析(AdminCommands)
test quick/config/rcon/process/resource/connection
test email/email send/deepseek/autoexecute
test simulate attack/rcon exec <命令>""";
case "info" -> """
【安全API端点 (HTTP GET)】
/api/status /api/performance /api/health
/api/security/stats /api/security/network/*
/api/security/auth/status /api/security/brute-force/status
/api/security/anti-bot|anti-grief|anti-xray|anti-fly/status
/api/security/anti-dupe|anti-skin-spoof|crash-exploit/status
/api/security/lag-machine|reverse-shell|arp-spoof/status
/api/security/dns-tunnel|exploit-signature|ssrf/status
/api/security/xxe|csp|database-firewall|dlp/status
/api/security/memory|process-injection|secure-delete/status
/api/security/forensics|incident-response|threat-hunting/status
/api/security/compliance|geo-block|session-validation/status
/api/security/plugin-verification|connection-throttle/status
/api/security/backup-integrity/status
/api/attacks/recent /api/backup/list /api/punishment/list
完整API文档: docs/USER_MANUAL.md""";
default -> "未知分类: " + category + "\n可用: ai/status/defense/security/monitor/player/world/admin/info";
};
}
private String getHelp() {
return getFullHelp();
}
private int getCpuUsage() { private int getCpuUsage() {
try { try {
com.sun.management.OperatingSystemMXBean os = com.sun.management.OperatingSystemMXBean os =
src/main/resources/application.yml
+3 -3
View File
@@ -150,7 +150,7 @@ serverguard:
max-recovery-actions-per-hour: 8 max-recovery-actions-per-hour: 8
super-evolution: super-evolution:
# === v3.1 超进化安全模块开关 === # === V4.0 高级扩展安全模块开关 ===
jwt-auth: true # JWT身份认证与令牌管理 jwt-auth: true # JWT身份认证与令牌管理
brute-force: true # 暴力破解防护（多时间窗口检测） brute-force: true # 暴力破解防护（多时间窗口检测）
anti-bot: true # 反机器人检测（Bot名称/加入速率/IP关联） anti-bot: true # 反机器人检测（Bot名称/加入速率/IP关联）
@@ -171,13 +171,13 @@ serverguard:
threat-hunting: true # 威胁狩猎（10种狩猎定义/5个类别） threat-hunting: true # 威胁狩猎（10种狩猎定义/5个类别）
compliance: true # 合规扫描（7类20+检查项） compliance: true # 合规扫描（7类20+检查项）
anti-grief: true # 反破坏检测（方块破坏率/TNT/纵火/偷箱） anti-grief: true # 反破坏检测（方块破坏率/TNT/纵火/偷箱）
# === v3.2 Minecraft专属模块开关 === # === Minecraft 专属防护模块开关 ===
anti-xray: true # X-ray透视检测（钻石比/直线挖掘/暗处精准） anti-xray: true # X-ray透视检测（钻石比/直线挖掘/暗处精准）
anti-fly: true # 飞行外挂检测（垂直/水平速度/悬空时间） anti-fly: true # 飞行外挂检测（垂直/水平速度/悬空时间）
anti-dupe: true # 物品复制检测（堆叠异常/高价值暴涨/9种复制法） anti-dupe: true # 物品复制检测（堆叠异常/高价值暴涨/9种复制法）
crash-exploit: true # 崩溃漏洞防护（超大包/NBT炸弹/书与笔攻击） crash-exploit: true # 崩溃漏洞防护（超大包/NBT炸弹/书与笔攻击）
lag-machine: true # 卡服机检测（Observer链/TNT堆/红石密度） lag-machine: true # 卡服机检测（Observer链/TNT堆/红石密度）
# === v3.3 新模块开关 === # === V4.0 新增模块开关 ===
geo-block: true # 地理IP封锁（按国家/地区拦截） geo-block: true # 地理IP封锁（按国家/地区拦截）
session-validation: true # 玩家会话验证（UUID伪造/正版/离线检测） session-validation: true # 玩家会话验证（UUID伪造/正版/离线检测）
plugin-verification: true # 插件完整性校验（Hash对比/未授权修改） plugin-verification: true # 插件完整性校验（Hash对比/未授权修改）