# AluerIII 服务器安全防护系统 - 详细项目概括与功能拆解 AluerIII 是一个专为 Minecraft (PaperMC) 服务器设计的高级安全防护与自动化运维系统。它集成了 **AI 驱动威胁感知**、**多层网络安全防御**、**实时监控预警** 与 **自动化管理** 功能。本项目采用 Java 与 Spring Boot 框架构建，具有高度模块化和可扩展的插件式架构。 以下是项目中所有核心模块、包路径及具体类的极其详细的功能拆解： --- ## 1. AI 智能防御与分析模块 (`com.aluer.ai`) 该模块是系统的“大脑”，利用机器学习算法和大型语言模型（如 DeepSeek）进行实时威胁感知、趋势预测与智能决策。 - **`AIAutonomousService`** (自主防御核心) - 通过正则匹配和流量模式识别潜在威胁（如 SQL 注入、DDoS 攻击）。 - 在检测到威胁时，自动执行防御动作（如动态封禁恶意 IP、启用限流）。 - **`AIStrategyEngine`** (智能策略引擎) - 根据检测到的威胁严重程度（Severity），动态匹配并下发最佳防御策略（例如：“暴力破解”对应“临时封禁+启用验证码”）。 - **`DeepSeekClient`** (AI 接口集成) - 将服务器的异常指标、告警日志发送至 DeepSeek AI 进行深度分析。 - 自动生成易于理解的健康报告、根本原因分析（RCA）及修复建议。 - **`AnomalyDetector`** (异常检测器) - 使用孤立森林（Isolation Forest）等算法检测服务器性能指标（如 CPU、内存突增）中的非典型波动。 - **`AttackDetector`** (协同攻击检测) - 关联分析网络连接行为与日志，识别分布式的协同攻击（如慢速连接攻击、僵尸网络扫描）。 - **`TimeSeriesPredictor`** (时间序列预测) - 基于历史运行数据预测未来 TPS 走势，提前预警可能的服务器卡顿或内存溢出崩溃。 - **`AdaptiveThreshold`** (自适应阈值控制器) - 学习服务器的历史负载模式，动态调整各项监控告警的触发阈值，有效降低误报率。 --- ## 2. 核心安全防护系统 (`com.aluer.security`) 系统最庞大的子模块，提供了从网络层（L3/L4）到应用层（L7）的全方位纵深防御体系。 - **`WebApplicationFirewall (WAF)`** (Web 应用防火墙) - 针对 Web 控制面板和 API 接口，提供 SQLi、XSS、路径遍历等常见 Web 攻击过滤，并维护客户端请求信誉度。 - **`DDoSProtectionService`** (DDoS 防护引擎) - 专防分布式拒绝服务攻击，支持识别 SYN Flood、HTTP Flood、UDP 放大攻击及 ICMP Flood，并执行自动 IP 封禁与流量清洗。 - **`IntrusionDetectionService (IDS)` / `IntrusionPreventionSystem (IPS)`** (入侵检测与防御) - 实时扫描服务器内的恶意行为和越权访问，自动阻断非法连接。 - **`SIEMService`** (安全信息与事件管理) - 关联不同来源的碎片化事件（如“多次登录失败”+“异常权限变更”），识别出复杂的横向移动或权限提升攻击序列。 - **`IPReputationService` / `GeoIPService`** (IP 信誉与地理位置) - 基于全局 IP 黑名单及地理位置库进行流量过滤（如一键屏蔽特定国家或高风险云服务商的流量）。 - **`HoneypotService`** (蜜罐诱捕系统) - 通过暴露诱饵端口或伪造的脆弱接口，吸引并捕获扫描者和攻击者，收集威胁情报。 - **`ZeroTrustArchitectureService`** (零信任架构) - 实施严格的持续身份验证与最小权限校验，确保内部和外部调用的绝对安全。 - **`AdvancedMalwareDetectionService`** (高级恶意软件扫描) - 定期扫描服务器内的可疑文件（如被植入后门的插件）及玩家上传的内容。 - **`FirewallService`** / **`NetworkMonitorService`** (防火墙与网络监控) - 管理底层系统防火墙规则（iptables/ufw），监控进出站流量异常。 --- ## 3. 监控与指标采集模块 (`com.aluer.monitor` / `com.aluer.metrics`) 负责全天候收集服务器的运行状态，为 AI 决策和控制台提供数据支撑。 - **`ResourceMonitor`** (系统资源监控) - 采集底层系统的 CPU 使用率、内存消耗、磁盘 I/O 以及当前 TPS 和在线玩家数。 - **`LogMonitor`** (日志实时分析) - 实时追踪 Minecraft 服务端（PaperMC）的 `latest.log`，精准捕获异常崩溃堆栈或安全违规日志。 - **`ProcessMonitor`** (进程守护) - 监控 Minecraft 核心进程的存活状态，在检测到异常崩溃时触发自动重启机制。 - **`ConnectionMonitor`** (网络连接监控) - 统计并分析入站网络连接的频率，快速检测连接洪水（Connection Flood）或 CC 攻击。 - **`MetricsCollectionService`** (统一指标服务) - 将各个 Monitor 采集的数据进行标准化和汇总聚合，供前端 Dashboard 和 AI 模型读取。 --- ## 4. 自动化运维与核心调度 (`com.aluer.service` / `com.aluer.schedule`) 统筹全局，确保各模块有序运转，并执行具体的自动化操作。 - **`ServerGuardService`** (系统总控台) - 作为 Spring Boot 的启动核心入口，调度所有监控任务，处理告警分发，协调安全模块与 AI 模块的工作流。 - **`AutoExecutor`** (指令自动化执行器) - 接收 AI 或安全模块的决策结果，自动将其转化为服务器指令（如踢出玩家、封禁 IP）并执行。 - **`RconClient`** (远程控制台客户端) - 通过安全的 RCON 协议与 Minecraft 服务端通信，无缝下发管理指令。 - **`ScheduledTaskService`** (计划任务引擎) - 管理所有周期性任务，例如：定时备份世界数据、清理过期日志、定期生成数据统计报表。 --- ## 5. Web API 与交互终端 (`com.aluer.web` / `com.aluer.terminal`) 提供用户友好的交互界面与第三方集成接口。 - **`DashboardController`** (Web 面板 API) - 提供 RESTful API 接口（如 `/api/status`, `/api/performance`），向前端 Web 界面或 Pterodactyl 等第三方系统暴露实时监控数据、安全日志及配置管理能力。 - **`AITerminal`** (AI 命令行终端) - 提供基于 Spring Shell 的交互式控制台。允许管理员通过自然语言（如 `ai 帮我分析一下现在的卡顿原因`）与 AI 助手对话，执行复杂的服务器管理操作。 --- ## 6. 辅助管理与合规模块 涵盖服务器日常管理的各类垂直功能。 - **`com.aluer.anticheat.AntiCheatService`** (反作弊联动) - 联动服务器内的反作弊插件，汇总玩家违规行为，进行智能封禁判定。 - **`com.aluer.vpn.VPNDetectionService`** (代理与 VPN 检测) - 识别并拦截使用代理 IP 或 VPN 的玩家，防止作弊者绕过 IP 封禁。 - **`com.aluer.audit.SecurityAuditService`** (安全审计与日志) - 记录所有管理员的敏感操作指令和安全事件变更，确保符合安全合规要求。 - **`com.aluer.backup.BackupService`** (自动容灾备份) - 定时或在遭受攻击前，自动对世界地图（World）、插件配置及数据库进行打包和异地备份。 - **`com.aluer.chat.ChatFilterService`** (聊天过滤) - 监控游戏内聊天，过滤违规词汇、广告及钓鱼链接。 - **`com.aluer.punishment.PunishmentService`** (惩罚管理) - 统一管理玩家的封禁（Ban）、踢出（Kick）及禁言（Mute）记录。 --- ## 6.5. 通知与报告模块 (`com.aluer.notification`) - **`WebhookService`** (Webhook 通知服务) - 支持 Discord 和 Slack 双通道 Webhook 推送。 - 安全告警发生时自动发送 Embed 消息，包含告警类型、严重程度、置信度。 - 支持自定义消息推送，含颜色编码（critical=红色 / warning=橙色 / info=绿色）。 - **`AttackReportService`** (攻击报告服务) - 记录最近 500 条攻击事件到内存环形缓冲区。 - 一键生成 HTML 格式安全事件报告，含时间线、攻击类型、来源 IP、置信度。 - 报告自动保存到可配置目录，文件名含时间戳。 --- ## 7. Web 基础设施层 (`com.aluer.web` / `com.aluer.config`) - **`HealthService`** (健康检查服务) - 组件级健康探针：逐一检查 RCON 连接、DeepSeek API、邮件服务、安全引擎、自愈编排。 - 系统资源信息汇总：JVM 内存使用、堆内存、CPU 负载、运行时间。 - 兼容 Kubernetes liveness / readiness probe 格式。 - **`RequestLoggingFilter`** (请求日志过滤器) - 拦截所有 HTTP 请求，记录慢请求（>1s）和服务器错误（5xx）。 - 不影响正常请求性能（debug 级别日志）。 - **`CorsConfig`** (跨域配置) - 允许 `/api/**` 路径的跨域请求，支持所有 Origin、常用 HTTP 方法和预检缓存。 ## 8. 数据模型与配置管理 (`com.aluer.model` / `com.aluer.config`) - **`ServerGuardConfig`** (全局参数配置) - 映射 `application.yml` 中的参数，包括：各类安全触发阈值、DeepSeek API 密钥、数据库连接及告警邮箱配置等。 - **`AlertEvent`** (告警数据模型) - 标准化告警事件结构，包含：告警类型、严重程度、置信度、AI 根因分析及推荐修复动作。 - **`MetricsData`** (性能指标模型) - 封装服务器在特定时间点的快照数据，用于历史数据回溯和 AI 时序预测。 --- ## 9. 超进化安全模块 (`com.aluer.security`) — v3.1 新增 以下20个安全服务模块为超级进化 (Super Evolution) 版本新增，覆盖身份认证、网络攻防、应用安全、数据保护和运维响应全维度： ### 9.1 身份与访问控制 - **`JwtAuthService`** (JWT认证服务) - 基于 HMAC-SHA256 的 JWT token 创建、验证、吊销。 - 支持自定义 Claims、过期时间、自动清理。 - 常量时间签名比对防止时序攻击。 - **`BruteForceProtectionService`** (反暴力破解服务) - 三层时间窗口检测 (60s/600s/3600s)。 - 渐进式登录延迟 (1s-15s)，IP 全局阈值监控。 - 自动账号锁定 + 自动解锁。 ### 9.2 Minecraft 专项防护 - **`AntiBotDetectionService`** (反机器人检测) - 6种机器人命名模式识别，10+已知机器人前缀检测。 - 加入速度/多账号/客户端品牌/IP洪水多维度评分。 - Minecraft 登录和状态包频率监控。 - **`AntiGriefDetectionService`** (反破坏检测) - 方块破坏/放置速率监控 (150/min爆破, 200/min放置)。 - 危险方块识别 (TNT/岩浆/水晶/凋零)。 - 隧道挖掘模式检测，容器掠夺监控，聊天刷屏检测。 ### 9.3 网络攻击检测 - **`ReverseShellDetectionService`** (反向Shell检测) - 50+ 反向Shell命令模式匹配 (bash/python/perl/php/ruby/lua/powershell)。 - 混淆命令检测 (base64编码/eval/exec)。 - 进程级Shell指标监控。 - **`ARPSpoofDetectionService`** (ARP欺骗检测) - ARP表周期性扫描与基线对比。 - MAC地址变更/重复MAC/网关欺骗三种攻击检测。 - 自动识别网关IP并重点监控。 - **`DNSTunnelDetectionService`** (DNS隧道检测) - 子域名熵值分析 (Shannon Entropy > 3.8)。 - Base32/Base64编码子域名识别。 - 查询频率/类型/TLD多维度评分，可疑域名TLD黑名单。 - **`ExploitSignatureService`** (漏洞签名检测) - 15+ 已知漏洞签名 (Log4Shell/JNDI/SQL注入/XSS/路径穿越/反序列化)。 - Minecraft 专属漏洞 (Book Exploit/Sign Exploit/Chunk Ban/NBT Traversal)。 - 命令注入和服务端配置篡改检测。 ### 9.4 Web与API安全 - **`SSRFProtectionService`** (SSRF防护) - 内网IP/云元数据端点/危险Scheme检测。 - DNS Rebinding + 十进制IP绕过 + URL编码绕过防护。 - 云厂商元数据地址全覆盖 (AWS/GCP/Azure/阿里云/腾讯云)。 - **`XXEProtectionService`** (XXE防护) - XML实体注入 + 十亿笑 (Billion Laughs) 攻击检测。 - 外部实体引用 + 实体扩展炸弹检测。 - XML自动净化处理。 - **`CSPEnforcementService`** (CSP强制执行) - Content-Security-Policy 头自动生成。 - 8个安全响应头 (CSP/HSTS/X-Frame/X-XSS/Referrer-Policy等)。 - XSS/Clickjacking反射检测。 - **`DatabaseFirewallService`** (数据库防火墙) - SQL注入检测 (UNION/注释/永真条件/堆叠查询/时间盲注)。 - 危险关键字拦截 (DROP/TRUNCATE/ALTER/INTO OUTFILE)。 ### 9.5 数据与内存保护 - **`DataLossPreventionService`** (数据防泄漏) - 12种敏感数据模式 (邮箱/API Key/密码/SSH Key/JWT/身份证/银行卡/电话号码/数据库连接串/MC Token/RCON密码/IP地址)。 - 自动脱敏 (Redaction) 功能，支持日志/聊天/配置文件扫描。 - **`MemoryProtectionService`** (内存保护) - JVM堆/非堆内存实时监控，GC过载检测。 - 内存泄漏模式识别 (连续5次以上堆使用率上升)。 - 自动GC触发和告警。 - **`ProcessInjectionDetectionService`** (进程注入检测) - 进程线程数量异常尖峰检测。 - /proc/{pid}/maps 新内存映射监控，非标准native库检测。 - /proc/{pid}/fd 文件描述符异常增长检测。 - **`SecureFileDeletionService`** (安全文件删除) - DoD 5220.22-M 风格多pass覆写 (0x00/随机/0xFF/0xAA 交替)。 - 文件截断 + fsync + 删除，支持递归目录安全删除。 ### 9.6 安全运维与合规 - **`ForensicsCollectorService`** (取证收集器) - 6种取证数据采集 (进程列表/网络连接/打开文件/系统日志/MC日志/时间戳快照)。 - 取证案件 (Case) 管理，自动保存到 forensics/ 目录。 - **`IncidentResponseService`** (事件响应服务) - 5套预定义响应剧本 (DDoS攻击/暴力破解/入侵检测/MC漏洞利用/数据泄露)。 - 自动化动作执行：限流/IP封禁/取证/备份恢复/Token吊销/密钥轮换。 - **`ThreatHuntingService`** (威胁狩猎服务) - 10种主动狩猎规则 (异常登录时间/可疑命令/持久化机制/横向移动/提权/数据外泄/挖矿/WebShell/后门账号/快速世界切换)。 - 分类：MINECRAFT/COMMAND/HOST/NETWORK/WEB。 - **`ComplianceScannerService`** (合规扫描服务) - 7大类20+项合规检查 (文件权限/加密标准/认证要求/审计日志/网络安全/MC服务端安全/备份合规)。 - 自动合规评分 (0-100%) 和修复建议生成。 --- ### 架构总结 AluerIII 采用 **高度解耦的插件式架构**，底层通过 Spring 的依赖注入（DI）机制紧密配合。系统形成了一套 **实时监测 -> AI 深度分析 -> 策略下发 -> 自动防御** 的完整闭环，极大地降低了 Minecraft 服务器运维人员的安全管理成本。