AuthCore

模组

· 作者 Ded3ec

AuthCore 是一个高性能、服务器端的 Minecraft Fabric 登录与安全框架,适用于 1.16+ 版本。它通过全面管理玩家会话,保护离线和在线服务器免受机器人和破坏者的侵害。

0 本站下载 0 关注 更新于 1 周前

最新 1.0.2 · 26.3 · NeoForge

一键开服(送7天)
AuthCore Banner

面向 Minecraft 服务器的堡垒级框架。一个统一的代码库,支持 Fabric、Forge 和 NeoForge 上的 1.16.0 → 26.x+ 版本。
适用于 Minecraft 服务器的服务端身份验证方案,在在线模式(online-mode)和离线模式(cracked)环境下均可运行,经过加固以抵御绕过攻击,在高并发负载下无竞态条件,并专为支撑 50 万+ 注册账户 及数千名同时在线玩家而设计,资源消耗平稳且无峰值波动。

快速开始 • 什么是 AuthCore? • Jar 矩阵 • 命令 • 配置 • 安全模型 • 文档 • 社区


? 目录

点击展开 / 折叠内容

? 什么是 AuthCore?

AuthCore 是一个通用的、面向 Minecraft 服务器的服务端身份验证与安全框架。 它解决了每位服务器运营商最终都会面临的问题:仅靠 Minecraft 自带的账户系统无法保护你的服务器。离线模式服务器完全没有密码保护,混合社区(正版与破解玩家共存)难以安全服务,而在两种模式下,机器人农场、凭证填充和会话劫持都是持续存在的威胁。

AuthCore 通过以下单一框架提供解决方案:

  • 玩家身份验证:支持 /register 和 /login 命令、独立账户密码、TOTP 双因素认证(2FA)以及邮箱恢复;或者自动向 Mojang 会话服务器验证正版账户,让合法玩家无需输入密码即可登录。
  • 兼容在线与离线模式(allow-offline-players):在在线模式服务器上,已验证的正版玩家自动登录,而离线/破解玩家则使用密码进行身份验证;在离线模式服务器上,所有玩家均享有完整的密码保护。
  • 防御接入路径:采用 7 层检测堆栈、基于风险评分的验证码、暴力破解锁定、速率限制、蜜罐机制以及 CIDR IP 规则。
  • 可扩展性:O(1) 的 UUID 键值查找、有界缓存、零每刻工作负载,以及在热路径上不查询数据库,从而在加入风暴期间保持内存和 CPU 占用平稳。

每个发布的 Jar 包都具备双重角色:既是原生的 Fabric / Forge / NeoForge 服务器模组,也是 BungeeCord / Velocity 代理插件,并通过 Redis 实现全网单点登录(SSO)。玩家无需安装任何内容:AuthCore 100% 为服务端组件。


? 5 分钟快速入门

graph LR
    A[选择 Jar 文件] --> B[放入 mods/ 或 plugins/ 目录]
    B --> C[启动服务器]
    C --> D[自动生成配置与数据库]
    D --> E[玩家加入并认证]
  1. 选择合适的 Jar 文件:通过 Modrinth 或 GitHub Releases 中的 Jar 矩阵,根据你的服务器加载器和 Minecraft 版本选择匹配的 jar。
  2. 安装:将 jar 文件直接放入服务器的 mods/ 目录(或代理的 plugins/ 目录)。
  3. 启动服务器:AuthCore 开箱即用,无需任何配置。嵌入式 SQLite 数据库 (authCore-db.sqlite) 会自动在 config/authcore/database/ 下生成。
  4. 首次加入体验:
    • 正版玩家:异步验证 Mojang 会话服务器,具备后台重试容错能力。自动登录,无需密码。
    • 盗版/离线玩家:被限制在安全的 Limbo 大厅中,提示使用交互式聊天按钮或命令:/register <password> <confirm> 或 /login <password>。
  5. 管理:运行 /authcore validate 以测试配置完整性。如需远程管理,可启用可选的 Web 面板(默认禁用),并通过访问 http://127.0.0.1:25570 并使用你的访问令牌进行管理。

[!NOTE] 初次接触 AuthCore?请查阅完整的 服务器管理员指南,获取可视化的逐步教程、权限设置以及代理拓扑结构说明。


? 我该选哪个 Jar?

每个编译好的 jar 均承担双重角色:作为原生服务器模组(Fabric、Forge 或 NeoForge)以及 BungeeCord/Velocity 代理插件(启动时自动检测)。请选择对应你 Minecraft 版本范围和加载器的 jar:

Jar 工件 Minecraft 版本 加载器 目标 Java 时代与架构
authcore-1.16-1.18-fabric-<v>.jar 1.16.0 – 1.18.2 Fabric 17 Intermediary 映射时代
authcore-1.16-1.18-forge-<v>.jar 1.16.0 – 1.18.2 Forge 17 Intermediary 映射时代
authcore-1.19-1.21-fabric-<v>.jar 1.19.0 – 1.21.11 Fabric 21 Intermediary 映射时代
authcore-1.19-1.21-neoforge-<v>.jar 1.19.0 – 1.21.11 NeoForge 21 Intermediary 映射时代
authcore-26.1-26.3-fabric-<v>.jar 26.1 – 26.3+ & Snapshots Fabric 25 未混淆时代(官方 Mojang 名称,向前兼容)
authcore-26.1-26.3-neoforge-<v>.jar 26.1 – 26.3+ & Snapshots NeoForge 25 未混淆时代(官方 Mojang 名称,向前兼容)

[!TIP] 为什么提供范围 Jar? Minecraft 26.0+ 完全采用未混淆代码,且 Fabric intermediary 从 26.x 起已被弃用(参见 Fabric 公告)。每个范围 Jar 都通过我们的并行 Docker 测试套件在其版本区间内的所有端点上进行了严格验证。


? 架构与认证生命周期

flowchart TD
    subgraph Connect["1. 握手与威胁拦截"]
        Join([玩家加入服务器]) --> DetectProxy["检测代理与转发\n(BungeeCord / Velocity HMAC)"]
        DetectProxy --> Intercept["ClientGuard 检查\n数据包洪水 · 幽灵异常 · 视角差异"]
        Intercept --> RateLimit{"超出速率限制\n或被拒绝 IP CIDR?"}
        RateLimit -->|是| KickDrop["断开连接 / 蜜罐警报"]
        RateLimit -->|否| Limbo["将玩家锚定在 Limbo\n静止物品栏 · 零漂移 · 限流传送"]
    end

    subgraph AuthEval["2. 认证与验证"]
        Limbo --> CheckMode{"服务器/账户模式"}
        CheckMode -->|正版自动登录| MojangCheck["异步 Mojang 会话验证\n(对 Mojang API 故障具有容错性)"]
        MojangCheck -->|已验证| PassAuth["绕过密码认证"]
        CheckMode -->|离线/盗版| PromptAuth["显示动态标题/动作栏\n提示 /register 或 /login"]
        PromptAuth --> CaptchaCheck{"触发风险评分?"}
        CaptchaCheck -->|高风险| TaskCaptcha["执行动作验证码\n(潜行 / 跳跃 / 转头)"]
        CaptchaCheck -->|正常| CredentialCheck["验证哈希 (Argon2id/BCrypt/SCRAM)\n或 TOTP 2FA / 邮箱 OTP"]
        TaskCaptcha --> CredentialCheck
    end

    subgraph SessionBind["3. 会话绑定与游戏内释放"]
        CredentialCheck -->|成功| PassAuth
        PassAuth --> SessionIssue["发放会话令牌 & Redis SSO 广播"]
        SessionIssue --> RestoreState["恢复玩家位置、物品栏和能力"]
        RestoreState --> InGame([授予完整游戏访问权限])
    end

?️ 检测绕过抗性

AuthCore 部署了7 层纵深防御安全栈,旨在使自动化客户端绕过、僵尸网络攻击和凭据填充攻击在数学上和实践中都变得不可行:

层级 机制 缓解的威胁向量
1. 会话绑定 每个服务器独立的随机 32 字节同伴证明密钥,在重载时轮换 同伴伪造、重放攻击、会话令牌窃取
2. 数据包序列验证 严格的 HELLO → SETTINGS → READY 登录状态机 无头客户端跳过初始化数据包、乱序利用漏洞
3. 行为画像 ClientGuard 风险引擎:客户端品牌异常、幽灵客户端、标签页探测 宏注入、自动化扫描器、数据包洪水攻击
4. 视角模式分析 摄像机旋转增量方差(变异系数画像) 俯仰/偏航角冻结或摄像机运动呈机械线性的机器人客户端
5. 登录时间分布 IP 级登录时间戳 CV 分析(60 秒滚动窗口,≥3 个样本) 同步僵尸网络、脚本化凭证填充突发流量
6. 农场指纹识别 检测在 5 秒内从同一 IP 连接 ≥3 个不同用户名的情况 分布式代理轮换器、大规模小号农场协同操作
7. 登录情报 设备指纹、GeoIP 国家警报,以及严格的 2FA 尝试限制(5 次/分钟/IP) 账户接管、凭证复用、暴力破解攻击

架构安全保证

  • 默认失败关闭(Fail-Closed):代理认证强制要求 Redis 同步;空的 trusted-proxies 列表会自动禁用不安全的代理数据摄入。
  • 密码学独立性:二进制文件中不存在硬编码密钥;证明秘密在首次启动时使用高熵 CSPRNG 动态生成。
  • 状态完整性与内存保护:所有检测数据和 IP 追踪映射均强制执行基数上限,并在每个刻自动清理,以抵御内存耗尽攻击。
  • 无单点故障:每个防御层独立执行;即使攻击者绕过客户端品牌检查,数据包时序和行为分析仍保持活跃。

?️ 命令

玩家命令

指令 语法与用法 用途
/register /register <密码> [<确认>] [<2fa>] 创建并绑定新的玩家账号,强制执行密码规则
/login /login <密码> [<2fa>] 验证账号身份并退出临时大厅

| /account | /account logout · set-password <new> · codes | 管理当前会话、更新密码或生成一次性恢复代码 | | /account | /account email <address> · nickname <name> | 配置密码恢复邮箱或设置本地化显示昵称 |

| /account | /account set-mode online\|offline | 在自动 Mojang 登录和密码登录之间切换玩家的认证模式 | | /account | /account recover <email> [<code> <new-password>] | 通过一次性 SMTP 邮件验证进行自助密码恢复 | | /account | /account unregister | 永久删除账户凭据(受服务器策略限制) | | /discord | /discord link · /discord unlink | 生成 Discord 账户链接代码以与 DiscordSRV 或面板同步 |

管理员命令

需要 Minecraft OP 等级 3+、LuckPerms 权限节点,或通过服务器控制台执行。每个命令的权限节点和 OP 等级均可在 commands.conf 中配置。

命令 语法与用法 用途
/authcore reload /authcore reload 热重载所有分块配置文件和语言文件
/authcore validate /authcore validate 对配置文件和数据库连接执行试运行验证
/authcore compat /authcore compat 生成系统报告:加载器环境、配置版本、DiscordSRV/InteractiveChat 状态
/authcore import /authcore import authme <file> 导入旧版 AuthMe SQLite 数据库(非破坏性;旧哈希在登录时自动升级)
/authcore whois /authcore whois <player> 检查详细的账户状态:UUID、注册日期、IP、2FA 状态、上次模式
/authcore history /authcore history <player> 检查玩家最近 10 次登录尝试,包含计算出的风险评分和 GeoIP 数据
/authcore list /authcore list players · list online/offline-players 查询基于数据库的玩家账户并支持过滤
/authcore destroy-session /authcore destroy-session <player> 在所有网络实例中使当前会话失效,并将该玩家踢出服务器
/authcore set-password /authcore set-password <player> <new> (别名: resetpw) 管理员重置玩家的密码
/authcore set-mode /authcore set-mode online|offline <player> 覆盖账户的认证模式
/authcore delete /authcore delete player <player> 删除账户并从数据库中清除记录
/authcore set-spawn /authcore set-spawn limbo <x> <y> <z> 设置未认证滞留大厅的确切世界坐标
/authcore backup /authcore backup · export 触发即时数据库快照备份或导出完整的 JSON 转储
/authcore maintenance /authcore maintenance on|off 切换维护模式以限制服务器访问权限仅针对管理员
/authcore map-image map-image show|clear <player> · map-image qr <player> <text> · map-image captcha <player> · map-image captcha-verify <player> <code> 给玩家一张显示渲染后的 128x128 图像的地图(测试图案、生成的二维码或验证码代码)并将其收回;登出或崩溃时会自动清理。默认启用(lobby.map-image)
/authcore simulate /authcore simulate 在实时服务器内运行内置的自我测试/模拟套件(共 18 项检查:哈希处理、实时数据库、着陆几何结构、会话流程、代理网关、SRG 运行时、有界缓存、地图渲染、地图给予/收回生命周期、地图内容/二维码/验证码)。仅限所有者使用,默认禁用 (commands.admin.simulate)

⚙️ 配置

AuthCore 会在 config/authcore/ 目录内生成所有配置文件。其架构采用每个配置域一个文件的设计,确保版本控制差异清晰,并杜绝凭据泄露到游戏性配置中:

配置文件 配置域范围 主要设置项
settings.conf 根级设置 language、debug-mode、logging、cache-max-users、schema version
session.conf 会话与安全 会话 TTL、账户锁定、SSO、Web 面板、SMTP 邮件、ClientGuard
lobby.conf Limbo 大厅与验证码 Limbo 限制、超时时间、动作验证码调优、防震动间隔
password-rules.conf 密码规则 最小长度、必需字符类别、哈希算法 (Argon2id/BCrypt)
commands.conf 命令权限 命令 LuckPerms 权限节点、别名及 OP 级别覆盖
database.conf 数据库存储 SQLite、MySQL、PostgreSQL 和 Redis 的连接字符串及连接池大小
ip-rules.conf CIDR IP 规则 地址、VPN 范围和 ASN 网络的显式允许/拒绝列表
messages-<lang>.conf 本地化 UI 消息、标题、动作栏、聊天文本(内置英文)

示例配置片段

# settings.conf
language = "en"              # en | zh | es | de | fr | pt | ru
cache-max-users = 20000      # 有界 LRU 缓存大小

# session.conf
session {
    # 服务器在线/离线模式会从 server.properties 自动检测!
    timeout-ms = 3600000     # 活跃会话有效期(60 分钟)

    account-lock {
        enabled = true
        max-failed-logins = 8
        lock-duration-ms = 600000
    }

    security {
        webhook-url = "https://discord.com/api/webhooks/..." # Discord 安全警报
    }

    proxy-support {
        enabled = false       # 置于 Velocity 或 BungeeCord 后端时启用
        protocol = "auto"     # 支持 "auto"、"velocity"、"bungeecord"
    }

    web-panel {
        enabled = false       # REST 管理仪表板(必须提供 token)
        host = "127.0.0.1"
        port = 25570          # 25571 端口上的 HTTPS(可选,自签名证书)
        token = "CHANGE_ME"   # 通过以下命令生成:openssl rand -hex 16
    }

    email {
        enabled = false       # SMTP 恢复代码和登录警报
        host = "smtp.gmail.com"
        port = 587
        username = "admin@example.com"
        password = "app-password"
        from = "AuthCore Security <admin@example.com>"
    }
}

# lobby.conf
lobby {
    movement-correction-radius = 1.5      # 非抖动回弹前的距离
    movement-correction-interval-ms = 600 # 位置校正之间的最小时间
}

在 Configuration Reference 中探索所有约 180 个参数及其默认值和用例。


? 功能设置概览

AuthCore 中的所有功能均为模块化且可选。基本 SQLite 使用无需任何设置。仅激活你的网络所需的功能:

功能 配置块 原理与防护机制 快速设置命令 / 按键
人类行为验证码 lobby.captcha 通过要求可疑登录执行物理任务(潜行/跳跃/观察),消除 99% 的登录机器人 lobby { captcha { enabled = true } }
2FA / MFA (TOTP 和邮件) session.authentication 保护高价值的管理员和玩家账户,防止因密码被盗或泄露而遭受攻击 session { authentication { allow-totp-support = true } }
账户锁定与暴力破解防护 session.account-lock 在多次输入错误密码后临时锁定账户,从而阻止字典攻击 session { account-lock { enabled = true } }
持久会话 session.enable-sessions 通过记住来自同一 IP 的重连验证登录,提升玩家体验 session { enable-sessions = true }
ClientGuard 风险引擎 session.client-guard 使用 0-100 的风险评分检测宏注入、幽灵客户端和数据包洪水攻击 session { client-guard { enabled = true } }
AuthIntelligence session.auth-intelligence 识别凭据填充爆发、多账号农场以及 IP 轮换行为 session { auth-intelligence { ... } }
网络速率限制 session.rate-limit 在不阻塞主线程的情况下,按 IP 地址吸收连接和登录洪水攻击 session { rate-limit { enabled = true } }
CIDR IP 规则 ip-rules.conf 明确允许或禁止特定 IP 地址、VPN 段或 ASN 网络 deny = ["45.155.0.0/16"]
全服单点登录 (SSO) session.sso + Redis 在多服务器代理网络中实现单点登录;一次认证,随处游玩 database { redis { enabled = true } } + sso { enabled = true }
Web 管理面板 session.web-panel 提供安全的令牌认证浏览器界面和 REST API,用于远程管理 session { web-panel { enabled = true; token = "..." } }
蜜罐扫描陷阱 session.honeypot 监听一个虚拟端口,自动捕获并阻止恶意网络扫描器 session { honeypot { enabled = true; port = 25599 } }
混合自动登录 session.authentication 自动登录已验证的 Mojang 账户,同时允许盗版客户端接入 session { authentication { premium-auto-login = true } }
代理转发支持 session.proxy-support 从 BungeeCord 或现代 Velocity HMAC 握手过程中解析真实的客户端 IP 和 UUID session { proxy-support { enabled = true; protocol = "auto" } }
维护模式 session.maintenance 在数据库升级或服务器更新期间,仅允许管理员访问 /authcore maintenance on
自动白名单 session.auto-whitelist 注册后自动将玩家添加到原生原版白名单中 session { auto-whitelist { enabled = true } }
静默封禁 (Shadow-Ban) session.shadow-ban 悄无声息地隔离恶意行为者,不向其发出被检测到的警报 session { shadow-ban { enabled = true } }
自动备份 session.backup 定期捕获用户凭据和数据库表的原子备份 session { backup { interval-hours = 24; keep = 10 } }
Discord 关联 session.discord-link 将 Minecraft 个人资料与 Discord ID 关联,用于社区角色验证 session { discord-link { enabled = true } }
Webhooks 与邮件警报 session.security 将实时安全警报传输到 Discord 频道或管理员收件箱 session { security { webhook-url = "https://..." } }

? 语言

AuthCore 内置 7 种语言:英文为默认内置语言,此外还附带 6 种社区翻译语言。活动语言通过在 settings.conf 中设置 language = "en" 来控制:

代码 语言 代码 语言
en English (内置) de Deutsch (德语)
zh 简体中文 fr Français (法语)
es Español (西班牙语) pt Português (葡萄牙语)
ru Русский (俄语)

[!TIP] 自定义本地化:将自定义的 messages-<lang>.conf 文件放入 config/authcore/ 目录中。AuthCore 会自动加载你的字符串,并记录任何缺失的键值以回退至英文模板。


? 代理与网络 (Velocity / BungeeCord)

AuthCore 原生支持现代 Minecraft 代理架构,无论是作为后端模组部署还是直接部署在代理上:

  • 通用 IP 转发自动检测:自动解析 BungeeCord 和 Velocity 的传统 (ip\0uuid\0properties) 握手载荷。真实的远程 IP 地址会立即应用于 GeoIP 查找、会话验证、速率限制和登录智能分析。
  • Velocity 现代身份转发:通过共享的 velocity-secret(在 velocity.toml 中配置)安全读取凭证的高安全性 HMAC 验证 velocity:player_info 登录接收器。
  • 跨模组互通通道 (authcore:auth):发出 AUTH_CHANGED|<uuid>|<username>|<1|0> 网络数据包,允许 AuthCore 与其他后端认证插件共存运行。
  • Redis SSO 枢纽到游戏转移:在枢纽/等待服务器中完成认证的玩家,在被转移到后端游戏节点时保持会话有效,无需重新提示输入密码。
  • Fail-Closed 代理强制执行:当启用代理支持时,绕过代理的直接连接将被直接拒绝。

⚡ 性能

从设计之初就旨在扩展至支持 500,000+ 个注册账户 和 数千个并发登录,且不会出现线程争用或内存峰值:

  • O(1) 无锁用户解析器:热路径事件(数据包拦截、移动检查、物品栏点击和聊天事件)通过基于 UUID 的 ConcurrentHashMap(User.getUser(player))在 O(1) 时间内解析玩家。热路径上零字符串分配,零数据库查询。
  • 无死锁并发:线程安全的内存中规范化用户缓存保证每个账户仅存在一个 User 实例。缓存未命中的数据库获取操作会在细粒度锁下序列化;后台 I/O 操作在有界守护进程池上执行。
  • 平坦的内存曲线与节流数据包:用户活动时间戳每分钟最多更新一次,而不是每个数据包都更新。Limbo 位置校正强制执行最小间隔,防止位置数据包泛滥并消除相机画面抖动。
  • 零每刻工作量:插件不进行基于刻轮询循环。所有生命周期逻辑严格由网络数据包、加入、登录或断开连接触发的事件驱动。
  • 高速缓存优化:SQLite 采用 WAL 日志模式运行,配置为 synchronous=NORMAL 并经过调优的页面缓存。MySQL 和 PostgreSQL 使用具有自动查询准备功能的连接池。

? 低资源服务器(≤ 250 MB RAM / 1 核)

对于超紧凑节点(例如拥有 256MB RAM 的 VPS 或低成本云容器),请在启动脚本中添加以下标志:

java -Xmx192M -Xms64M -XX:+UseSerialGC -XX:TieredStopAtLevel=1 \
     -XX:-UsePerfData -XX:MaxMetaspaceSize=96M -jar fabric-server.jar nogui

优化建议: 将 settings.conf 中的 cache-max-users = 5000 保持默认,使用内置 SQLite 存储(避免外部数据库网络驱动程序),并禁用 Web 面板。


? 多版本与多加载器兼容

AuthCore 利用 Stonecutter 和 Stonecraft 条件编译维护单一统一的代码库:

src/
├── main/java/in/potenfyr/authcore/  --> 共享规范源代码树(Mojang 映射)
│   ├── AuthCoreServer.java          --> 通用引擎:核心引导与生命周期
│   ├── api/                         --> AuthCoreApi 公共开发者 API
│   ├── command/                     --> 跨平台命令处理器 (/register, /login, /account, ...)
│   ├── compat/                      --> 加载器与版本兼容性适配器
│   ├── entrypoint/                  --> 共享加载器入口基类
│   ├── events/                      --> 方块、实体及服务器事件监听器
│   ├── integration/                 --> 第三方模组集成(LuckPerms, DiscordSRV, ...)
│   ├── mixin/                       --> 通用平台 Mixins(仅限登录/认证网络阶段)
│   ├── models/                      --> 用户与会话数据模型,Config/Lobby/Messages
│   ├── network/                     --> Web 面板、Webhooks、SMTP、GeoIP、Redis、代理支持
│   ├── proxy/                       --> BungeeCord 与 Velocity 插件入口点、SSO 会话缓存
│   ├── security/                    --> 哈希与 2FA、速率限制、ClientGuard、验证码、蜜罐、IP 规则
│   └── util/                        --> HOCON 配置引擎、数据库驱动程序、AuthMe 导入器、调度器
├── fabric/java/.../entrypoint/      --> FabricEntry(各加载器轻量入口点)
└── neoforge/java/.../entrypoint/    --> NeoForgeEntry
  • 加载器独立性:轻量入口点(FabricEntry, ForgeEntry, NeoForgeEntry)将原生加载器钩子桥接到 AuthCore 的通用引擎。
  • 非混淆的 26.x 兼容性:前向兼容的 Mojang 映射允许针对现代和未来 Minecraft 版本进行即时构建;未来的快照分支将在构建时自动检测。
  • 非侵入式 Mixins:Mixins 仅触及登录和认证网络阶段,确保与性能优化模组(包括 Lithium, C2ME, Krypton, ModernFix, FerriteCore 和 Spark)零不兼容。

?‍? 从源码构建

Gradle 工具链会自动供应 JDK 17, 21, and 25(每组版本一个),因此任何已安装的 JDK 17+ 均可启动构建。如果偏好便携版 JDK,请运行 test/install-java-and-provided-jars.sh 以自动安装 Adoptium JDK 和 vendored 代理/API jars。请参阅 CONTRIBUTING.md 获取完整的开发者指南。

# 构建所有 6 个范围变体(jars 自动放置到 dist/ 目录)
./gradlew buildAll

# 构建当前活动的变体 (1.21.11-fabric)
./gradlew build

# 构建特定的加载器和版本目标
./gradlew :1.18.2-fabric:build      # -> dist/authcore-1.16-1.18-fabric-1.0.2.jar
./gradlew :1.18.2-forge:build       # -> dist/authcore-1.16-1.18-forge-1.0.2.jar
./gradlew :1.21.11-fabric:build     # -> dist/authcore-1.19-1.21-fabric-1.0.2.jar
./gradlew :1.21.11-neoforge:build   # -> dist/authcore-1.19-1.21-neoforge-1.0.2.jar
./gradlew :26.3-fabric:build        # -> dist/authcore-26.1-26.3-fabric-1.0.2.jar
./gradlew :26.3-neoforge:build      # -> dist/authcore-26.1-26.3-neoforge-1.0.2.jar

? 安全测试

AuthCore 在 test/ 目录下配备了自主安全测试框架,包含 229 项自动化单元测试和密码学检查,以及 18 项模组内模拟套件:

# 编译并执行完整的安全测试套件
./gradlew buildAll
test/run-security-tests.sh

# 运行端到端本地验证(编译 + 安全套件 + Docker 主机冒烟测试)
./gradlew testAll

审计的组件包括:

  • 哈希算法:Argon2id、BCrypt、SCrypt、PBKDF2、SHA-256、SHA-512,以及旧版哈希透明自动升级。
  • 加密安全性:CSPRNG 盐值唯一性、常量时间比较和时序泄露防护。
  • 漏洞与滥用防御:验证码状态机生命周期、SMTP 令牌过期、摄像头注视模式方差和僵尸网络并发检测。
  • 代理安全性:可信代理源验证、伪造转发拒绝和 Velocity HMAC 验证。
  • 迁移引擎:自动化检查,验证从旧版单文件到拆分配置的迁移过程。
  • 地图图像(新增):调色板发现、地图数据往返、锁定地图行为、给予/收回生命周期(死亡、副手、崩溃恢复、速率限制)、经过两个独立解码器验证的模组内 QR 码编码器、验证码单次使用/过期/尝试次数限制,以及每个入口点的输入边界。地图内容路径是对有界输入的纯计算——无文件、网络、进程或反射访问,也无客户端可控输入——因此不会增加 RCE 或绕过面;QR 载荷从不记录日志。

? Docker 验证(主机测试)

为确保运行时稳定性完美无瑕,我们的测试套件使用官方 Eclipse Temurin JRE 镜像,在真实的 Minecraft 服务器容器中并行启动每个版本范围的 jar 包:

# 在所有加载器目标上执行冒烟矩阵测试
test/docker/run-tests.sh --smoke

# 在所有版本范围端点上执行完整矩阵测试
test/docker/run-tests.sh --all

# 运行特定版本区间
test/docker/run-tests.sh --groups 1.16-1.18 --java 17
test/docker/run-tests.sh --groups 1.19-1.21 --java 21
test/docker/run-tests.sh --groups 26.1-26.3 --java 25

每项自动化测试均验证以下内容:

  1. 干净的服务器启动,0 错误和 0 严重警告。
  2. 横幅准确性(编译版本字符串、目标加载器和 Java 运行时)。
  3. 管理控制台命令执行(/authcore validate、/authcore reload、/authcore backup)。
  4. 配置生成、SQLite 数据库初始化和网络端口绑定。
  5. 模组内模拟套件(18/18 项检查):哈希、实时数据库、着陆几何体、会话流程、代理门控、SRG 运行时、有界缓存、地图渲染、地图给予/收回生命周期以及地图内容/QR 码/验证码。

该矩阵涵盖 17 种(版本,加载器)组合:Fabric 1.16.5/1.17.1/1.18.2/1.19.4/1.20.6/1.21.1/1.21.11/26.1.2/26.2/26.3,Forge 1.18.2 和 NeoForge 1.20.6/1.21.1/1.21.11/26.1.2/26.2/26.3。两个 SKIP 是真正的平台限制(Forge 1.16.5/1.17.1 无法运行 Java-17 jar;NeoForge 不存在于 1.19.4),而非测试套件的缺陷。


? 文档

详细的文档指南托管在 :

指南 描述
? 文档首页 项目门户、版本下载和版本切换器
? 服务器管理员指南 完整的逐步设置指南:jar 选择、安装、命令和故障排除
? 认证流程 加入握手、limbo 锚点、TOTP 验证和会话生命周期的参考
? 配置参考 详尽的参数参考(约 180 个设置),包含默认值和用例场景
? 开发者 API AuthCoreApi 集成指南、事件总线钩子和自定义数据库架构
⚙️ 开发与架构 Gradle 构建管道、Stonecutter 条件编译和测试套件
? Web 管理面板 Web 仪表板配置、TLS/HTTPS 设置和 REST API 端点
? 代理设置指南 配置 Velocity 现代转发、BungeeCord 和 Redis SSO 网络
?️ 安全威胁模型 与 OWASP 和 Minecraft 网络架构对齐的综合威胁模型
? 26.x 构建与迁移 未混淆的 26.x Mojang 映射、前向兼容性和设置的指南
? 更新日志 版本发布、功能添加和安全补丁的完整历史记录

❓ 常见问题

离线玩家和正版玩家是否都能在线模式服务器上游玩?
可以。AuthCore 内置了混合模式。在在线模式服务器上,请确保 server.properties 中设置了 enable-secure-profile=false,以便没有 Mojang 聊天签名的客户端可以连接。当 allow-offline-players = true(settings.conf 中的默认值)时,盗版玩家和正版玩家均可连接。正版玩家通过异步 Mojang 验证自动认证,而盗版玩家则通过密码进行认证。
AuthCore 是否适用于局域网或离线测试环境?
是的。私有和回环 IP 地址(127.0.0.1、10.x.x.x、192.168.x.x)永远不会转发给外部 Mojang 或 GeoIP API。服务器可以在不需要活跃互联网连接的情况下启动。
与其他模组是否存在已知的不兼容问题?
暂无已知问题。AuthCore 已与性能优化和实用类模组进行了广泛测试,包括 C2ME, Chunky, Lithium, Krypton, Ledger, ModernFix, FerriteCore 和 Spark。
多个服务器可以共享同一个玩家凭据数据库吗?
可以。在 database.conf 中配置共享的 MySQL 或 PostgreSQL 数据库,并在 session.conf 中启用 Redis,以实现跨网络的单点登录(SSO)会话同步和跨服务器安全事件总线。
玩家需要安装客户端模组才能连接吗?
不需要。AuthCore 完全在服务端运行。玩家可以使用原版 Minecraft 客户端或标准的模组客户端进行连接,无需安装任何额外的客户端软件。

?️ 路线图

  • 通用多加载器支持:单一代码库面向 Fabric、Forge 和 NeoForge,覆盖版本 1.16.0 → 26.x+。
  • 7 层纵深防御:行为画像分析、数据包状态机、视线模式分析和蜜罐机制。
  • 多因素认证:支持 TOTP 验证器应用、备用恢复码以及一次性 SMTP 邮件验证。
  • 反滥用引擎:暴力破解锁定、动态验证码、CIDR IP 过滤器和影子封禁。
  • 企业级存储:高性能 SQLite (WAL)、MySQL、PostgreSQL 以及 Redis SSO 事件总线。
  • 浏览器 Web 面板:基于 Token 认证的 REST 管理界面,提供实时指标数据。
  • 代理兼容性:现代 Velocity HMAC 转发、传统 BungeeCord 检测以及“失败即关闭”的安全策略。
  • 自动化测试严谨性:229 项自动化的密码学和安全检查、18 项模组内模拟套件以及 17 个端点的并行 Docker 矩阵测试。
  • 分离式配置架构:独立的域配置文件(lobby.conf、session.conf、database.conf),并支持自动迁移旧版配置。

? 社区与贡献

我们热烈欢迎社区的贡献、错误报告和功能建议!

  • 发现 Bug? 请使用错误报告表单 提交 GitHub Issue;请包含你的 AuthCore 版本、加载器类型以及 Minecraft/Java 版本信息。
  • 有想法? 提交功能请求 Issue,或在 Discussions 中开启讨论线程。
  • 想提交代码? 请先阅读 CONTRIBUTING.md,其中涵盖了 Stonecutter 工作区、实际的构建/测试命令、分支指导原则以及 PR 期望,然后 Fork 仓库并提交 Pull Request。
  • 发现安全漏洞? 请勿公开提交 Issue;请遵循 SECURITY.md 并通过私密渠道报告。
  • 需要社区支持? 加入我们的 Discord!

? 许可证

AuthCore 采用 Apache License 2.0 with the Commons Clause 许可证授权。权威文本见仓库中的 LICENSE 文件。简而言之:

  • ✅ 你可以自由出于任何目的使用、Fork、修改和分发 AuthCore,包括商业用途、整合包以及围绕其构建产品或服务。
  • ❌ 你不得出售该软件本身:AuthCore(或其价值完全或主要源于此的软件/服务)不得作为付费产品进行销售。
  • ? LICENSE 文件具有权威性;本节仅为友好摘要,不构成法律建议或非约束性条款。

由 PotenFYR Studios 构建 · potenfyr.in · PotenFYR Studios 开源生态系统的一部分。

? PotenFYR Studios 社区

贡献让开源社区成为了一个学习、激发灵感和创造的美好之地。你对社区的任何贡献都备受赞赏——请参阅 CONTRIBUTING.md 以及 good first issues。安全相关问题:请使用 SECURITY.md(私密漏洞报告),而非公开 Issue。

AuthCore contributors Contribution snake animation

⭐ Star History

PotenFYR Studios 所有公开仓库的星数历史图表

PotenFYR Studios 的所有公开仓库均在此实时图表中展示,由 star-history.com 提供服务。


footer

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源