diff --git a/README.md b/README.md index c064429..23164a1 100644 --- a/README.md +++ b/README.md @@ -810,7 +810,7 @@ serverguard ### 安全防护层 (`com.aluer.security`) -这是系统中规模最大的包，包含 85+ 个安全服务（含 31 个超进化 v3.1 / v3.2 / v3.3 新增模块）： +这是系统中规模最大的包，包含 85+ 个安全服务（含 31 个高级扩展安全模块，V4.0 完整版）： | 类别 | 类 | 功能 | |------|-----|------| @@ -860,7 +860,7 @@ serverguard | | `LoadBalancerService` | 简易负载均衡 | | | `TrafficShapingService` | 流量整形/QoS | | | `EncryptionService` | 数据加密工具 | -| **超进化 v3.1** | `JwtAuthService` | JWT Token HMAC-SHA256 认证，常量时间签名比对 | +| **高级扩展模块** | `JwtAuthService` | JWT Token HMAC-SHA256 认证，常量时间签名比对 | | | `BruteForceProtectionService` | 三层时间窗口(60s/600s/3600s)暴力破解防护，渐进延迟 | | | `AntiBotDetectionService` | Minecraft 机器人检测：命名模式/加入速度/多账号/客户端品牌 | | | `AntiGriefDetectionService` | 方块破坏/放置速率监控，危险方块识别，容器掠夺检测 | @@ -885,7 +885,7 @@ serverguard | | `AntiDupeDetectionService` | 物品复制检测：堆叠溢出、高价值物品暴涨、9种已知复制方法监测 | | | `CrashExploitProtectionService` | 崩溃漏洞防护：超大包/负长度/NBT嵌套/书与笔/Sign炸弹/Tile Entity洪水 | | | `LagMachineDetectionService` | 卡服机检测：Observer链/TNT堆叠/红石密度/实体刷怪/掉落方块洪流 | -| **v3.3 扩展** | `GeoBlockService` | 地理IP封锁：国家/地区黑白名单，高风险Minecraft攻击来源国拦截 | +| **V4.0 扩展** | `GeoBlockService` | 地理IP封锁：国家/地区黑白名单，高风险Minecraft攻击来源国拦截 | | | `PlayerSessionValidationService` | 玩家会话验证：UUID格式/离线模式/正版检测/会话重放/多账号识别 | | | `PluginVerificationService` | 插件完整性校验：SHA-256哈希对比、恶意插件名检测、JAR结构检查 | | | `ConnectionThrottleService` | 连接速率限制：多时间窗口IP追踪、递增延迟(2s/5s/15s/30s)、并发上限 | diff --git a/README_EN.md b/README_EN.md index ad3bbb2..e9747f6 100644 --- a/README_EN.md +++ b/README_EN.md @@ -667,7 +667,7 @@ serverguard ### 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 | |----------|------------|-------------| @@ -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 | | **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 | +| **Advanced Extensions** | `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 | @@ -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 | | | `CrashExploitProtectionService` | Crash exploit protection: oversized packets, NBT bombs, book/sign exploits | | | `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 | | | `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) | diff --git a/docs/DEVELOPER.md b/docs/DEVELOPER.md new file mode 100644 index 0000000..ae2f942 --- /dev/null +++ b/docs/DEVELOPER.md @@ -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 reasons; + + private DetectionResult(boolean blocked, List reasons) { ... } + + public static DetectionResult clean() { return new DetectionResult(false, List.of()); } + public static DetectionResult blocked(List reasons) { return new DetectionResult(true, reasons); } + + public boolean isBlocked() { return blocked; } + public List 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> 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 getStatus() { + Map s = new LinkedHashMap<>(); + s.put("totalDetections", detectionCount.get()); + return s; + } + + public static class DetectionResult { + private final boolean flagged; + private final List reasons; + private DetectionResult(boolean f, List r) { this.flagged = f; this.reasons = r; } + public static DetectionResult clean() { return new DetectionResult(false, List.of()); } + public static DetectionResult flagged(List r) { return new DetectionResult(true, r); } + public boolean isFlagged() { return flagged; } + public List 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 操作；所有文件操作使用异步调度器 + +--- + +
+

Aluer ServerGuard V4.0

+

为 Minecraft 服务器安全构建的专业防护系统

+

Apache 2.0 License © 2026

+
diff --git a/docs/PROJECT_SUMMARY.md b/docs/PROJECT_SUMMARY.md index 689e656..7fef577 100644 --- a/docs/PROJECT_SUMMARY.md +++ b/docs/PROJECT_SUMMARY.md @@ -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) 版本新增，覆盖身份认证、网络攻防、应用安全、数据保护和运维响应全维度： ### 9.1 身份与访问控制 diff --git a/docs/USER_MANUAL.md b/docs/USER_MANUAL.md index 5b4d447..653f9c0 100644 --- a/docs/USER_MANUAL.md +++ b/docs/USER_MANUAL.md @@ -85,7 +85,7 @@ cd /path/to/AluerIII ./apache-maven-3.9.6/bin/mvn package -DskipTests # 上传 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/ ``` @@ -105,7 +105,7 @@ After=network.target Type=simple User=minecraft 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 RestartSec=10 @@ -130,7 +130,7 @@ sudo systemctl status aluer ### 启动系统 ```bash # 方式1: 直接运行 -java -jar serverguard-1.0.0.jar +java -jar AluerServerGuard-V4.0.jar # 方式2: 使用启动脚本 ./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" ``` -### 超进化安全模块 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/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/lag-machine/status` | GET | 卡服机检测状态（Observer链、TNT堆、红石密度） | -#### v3.3 新增安全 API +#### V4.0 新增安全 API | 接口路径 | 方法 | 说明 | |----------|------|------| @@ -528,15 +528,15 @@ backup: backup-config: true ``` -#### 超进化安全模块开关 +#### 高级扩展安全模块开关（V4.0） -所有超进化安全模块均可通过 `application.yml` 中的 `serverguard.security.super-evolution` 节点独立控制开关。设为 `false` 即可关闭该模块，不消耗任何性能。 +以下 31 个高级扩展安全模块均可通过 `application.yml` 中的 `serverguard.security.super-evolution` 节点独立控制开关。设为 `false` 即可关闭该模块，相关检测逻辑将被跳过，不消耗额外性能。 ```yaml serverguard: security: super-evolution: - # === v3.1 超进化安全模块（20个）=== + # === V4.0 高级扩展安全模块（20个） === jwt-auth: true # JWT身份认证与令牌管理 brute-force: true # 暴力破解防护（多时间窗口检测） anti-bot: true # 反机器人检测（Bot名称/加入速率/IP关联） @@ -557,13 +557,13 @@ serverguard: threat-hunting: true # 威胁狩猎（10种狩猎定义/5个类别） compliance: true # 合规扫描（7类20+检查项） anti-grief: true # 反破坏检测（方块破坏率/TNT/纵火/偷箱） - # === v3.2 Minecraft专属模块（5个）=== + # === Minecraft 专属防护模块（5个） === anti-xray: true # X-ray透视检测（钻石比/直线挖掘/暗处精准） anti-fly: true # 飞行外挂检测（垂直/水平速度/悬空时间） anti-dupe: true # 物品复制检测（堆叠异常/高价值暴涨/9种复制法） crash-exploit: true # 崩溃漏洞防护（超大包/NBT炸弹/书与笔攻击） lag-machine: true # 卡服机检测（Observer链/TNT堆/红石密度） - # === v3.3 新模块（6个）=== + # === V4.0 新增模块（6个） === geo-block: true # 地理IP封锁（按国家/地区拦截） session-validation: true # 玩家会话验证（UUID伪造/正版/离线检测） plugin-verification: true # 插件完整性校验（Hash对比/未授权修改） @@ -647,7 +647,7 @@ sudo systemctl stop aluer cp -r /opt/aluer/backups /backup/ # 替换jar包 -cp target/serverguard-1.0.0.jar /opt/aluer/ +cp target/AluerServerGuard-V4.0.jar /opt/aluer/ # 重启服务 sudo systemctl start aluer diff --git a/pom.xml b/pom.xml index ff7174d..61fa0c2 100644 --- a/pom.xml +++ b/pom.xml @@ -6,7 +6,7 @@ com.aluer serverguard - 1.0.0 + 4.0.0 jar Aluer ServerGuard diff --git a/release/V4.0/AluerServerGuard-V4.0.jar b/release/V4.0/AluerServerGuard-V4.0.jar new file mode 100644 index 0000000..d075471 Binary files /dev/null and b/release/V4.0/AluerServerGuard-V4.0.jar differ diff --git a/src/main/java/com/aluer/terminal/AITerminal.java b/src/main/java/com/aluer/terminal/AITerminal.java index 82e8e26..9c1947e 100644 --- a/src/main/java/com/aluer/terminal/AITerminal.java +++ b/src/main/java/com/aluer/terminal/AITerminal.java @@ -1012,41 +1012,329 @@ public class AITerminal { 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(); - sb.append("╔══════════════════════════════════════════════════╗\n"); - sb.append("║ Aluer AI 终端帮助 ║\n"); - sb.append("╠══════════════════════════════════════════════════╣\n"); - sb.append("║ ai <命令> - AI智能命令 ║\n"); - sb.append("║ ask <问题> - 向AI提问 ║\n"); - sb.append("║ status - 服务器状态 ║\n"); - sb.append("║ test [类型] - 测试服务器 ║\n"); - sb.append("║ defense [操作] - 防御管理 ║\n"); - sb.append("║ backup [操作] - 备份管理 ║\n"); - sb.append("║ security [类型] - 安全状态 ║\n"); - sb.append("║ autonomy [操作] - Aluer主控引擎 ║\n"); - sb.append("║ kernel [操作] - Aluer中心内核 ║\n"); - sb.append("║ bus [操作] - 内核任务总线 ║\n"); - sb.append("║ heal [操作] - 自愈编排器 ║\n"); - sb.append("║ network [操作] - 网络分析 ║\n"); - sb.append("║ quarantine - 隔离高风险IP ║\n"); - sb.append("║ unquarantine - 解除IP隔离 ║\n"); - sb.append("║ world [操作] - 世界管理 ║\n"); - sb.append("║ alert [操作] - 预警系统 ║\n"); - sb.append("║ metrics [类型] - 性能指标 ║\n"); - sb.append("║ audit [操作] - 安全审计 ║\n"); - sb.append("║ kick <玩家> - 踢出玩家 ║\n"); - sb.append("║ ban <玩家> - 封禁玩家 ║\n"); - sb.append("║ tasks [操作] - 计划任务 ║\n"); - sb.append("╚══════════════════════════════════════════════════╝\n\n"); - sb.append("【示例命令】\n"); - sb.append(" ai 测试一下服务器\n"); - sb.append(" ai 开启防御\n"); - sb.append(" ai 查看安全状态\n"); - sb.append(" ai 帮我备份\n"); + sb.append("╔══════════════════════════════════════════════════════════════════╗\n"); + sb.append("║ Aluer ServerGuard - 完整命令帮助 ║\n"); + sb.append("╠══════════════════════════════════════════════════════════════════╣\n"); + sb.append("║ 输入 help <分类> 查看分类帮助: ai/status/defense/security ║\n"); + sb.append("║ monitor/player/world/admin/info ║\n"); + sb.append("╚══════════════════════════════════════════════════════════════════╝\n\n"); + + sb.append("┌─────────────────────────────────────────────────────────────────┐\n"); + sb.append("│ AI 智能助手 │\n"); + sb.append("├─────────────────────────────────────────────────────────────────┤\n"); + sb.append("│ ai <自然语言> AI智能命令(测试服务器/开启防御/查看安全) │\n"); + sb.append("│ ask <问题> 向DeepSeek AI提问任何问题 │\n"); + sb.append("└─────────────────────────────────────────────────────────────────┘\n\n"); + + sb.append("┌─────────────────────────────────────────────────────────────────┐\n"); + sb.append("│ 服务器状态与测试 │\n"); + sb.append("├─────────────────────────────────────────────────────────────────┤\n"); + sb.append("│ status 查看服务器CPU/内存/连接/AI防御总览 │\n"); + sb.append("│ test [类型] 测试服务器: all/cpu/memory/network/security │\n"); + sb.append("│ tps 显示服务器TPS (来自AdminCommands) │\n"); + sb.append("│ memory 显示内存使用率 (来自AdminCommands) │\n"); + sb.append("└─────────────────────────────────────────────────────────────────┘\n\n"); + + sb.append("┌─────────────────────────────────────────────────────────────────┐\n"); + sb.append("│ 安全防御管理 │\n"); + sb.append("├─────────────────────────────────────────────────────────────────┤\n"); + sb.append("│ defense [操作] 防御管理: status/on/off/list/level [等级] │\n"); + sb.append("│ security summary 安全总览(态势分/威胁等级/高风险IP/DDoS等) │\n"); + sb.append("│ security posture 网络安全态势(建议/重点关注IP) │\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 原因) │\n"); + sb.append("│ unquarantine 解除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(); } + 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 + unquarantine [原因] 解除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地理位置 + network reputation 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() { try { com.sun.management.OperatingSystemMXBean os = diff --git a/src/main/resources/application.yml b/src/main/resources/application.yml index 2dc93bf..c591869 100644 --- a/src/main/resources/application.yml +++ b/src/main/resources/application.yml @@ -150,7 +150,7 @@ serverguard: max-recovery-actions-per-hour: 8 super-evolution: - # === v3.1 超进化安全模块开关 === + # === V4.0 高级扩展安全模块开关 === jwt-auth: true # JWT身份认证与令牌管理 brute-force: true # 暴力破解防护（多时间窗口检测） anti-bot: true # 反机器人检测（Bot名称/加入速率/IP关联） @@ -171,13 +171,13 @@ serverguard: threat-hunting: true # 威胁狩猎（10种狩猎定义/5个类别） compliance: true # 合规扫描（7类20+检查项） anti-grief: true # 反破坏检测（方块破坏率/TNT/纵火/偷箱） - # === v3.2 Minecraft专属模块开关 === + # === Minecraft 专属防护模块开关 === anti-xray: true # X-ray透视检测（钻石比/直线挖掘/暗处精准） anti-fly: true # 飞行外挂检测（垂直/水平速度/悬空时间） anti-dupe: true # 物品复制检测（堆叠异常/高价值暴涨/9种复制法） crash-exploit: true # 崩溃漏洞防护（超大包/NBT炸弹/书与笔攻击） lag-machine: true # 卡服机检测（Observer链/TNT堆/红石密度） - # === v3.3 新模块开关 === + # === V4.0 新增模块开关 === geo-block: true # 地理IP封锁（按国家/地区拦截） session-validation: true # 玩家会话验证（UUID伪造/正版/离线检测） plugin-verification: true # 插件完整性校验（Hash对比/未授权修改）