Sonar 反假人插件

Sonar 反假人插件

> 轻量的反机器人/反压测插件：把新连接先送进一台假服务器做协议与物理行为校验，假人进不来，真人几乎无感。
基本信息

| 项目 | 信息 |
| --- | --- |
| 插件名称 | Sonar |
| 开发者 | jonesdev |
| 最新版本 | 2.1.51（2026-09-06）|
| 许可协议 | GPL-3.0-or-later |
| 兼容版本 | Bukkit/Spigot 1.8.8 – 1.20.6；Paper 1.21 – 26.2；代理端 1.7.2 – 26.2 |
| 运行平台 | Paper、Purpur、Folia、Bukkit/Spigot、Velocity、BungeeCord/Waterfall（各平台独立 jar）|
| 运行环境 | Java 17 或以上；依赖 Netty 4.1 或以上 |
| 数据存储 | 可选 MySQL / MariaDB / PostgreSQL / H2（记录已验证玩家）|
| 前置依赖 | 无 |
| 项目地址 | https://modrinth.com/plugin/sonar |
| 官方文档 | https://docs.jonesdev.xyz/sonar/ |
简介

Sonar 是一款轻量的反机器人（反假人、反压测）插件，核心思路是在玩家真正进入服务器之前完成校验：新连接会先被送到一台轻量假服务器，Sonar 在那里检查对方是否遵守 Minecraft 的物理规则（重力、方块碰撞）、载具交互是否发出合法数据包、以及是否符合原版协议规范。因为校验发生在后端之前，恶意流量根本到不了真实服务器。

它同时通过排队处理入站连接来缓解刷连接类攻击——大量连接无法在同一瞬间涌入。官方把这个插件的设计原则写得很直白：够用、轻量、不折腾，不做 VPN/代理检测，真人玩家不应该被校验流程烦到。需要区分的是，2.x 是免费开源版本，作者另有一个功能更强的 Sonar 3.0（独立项目，含更强校验、网页面板与优先支持）。
核心特性
多层校验：物理行为、载具交互、原版协议逐项检查，覆盖常见与进阶假人
前置拦截：新连接先进入轻量假服务器，恶意流量到不了后端
缓解压测：入站连接排队处理，避免瞬间大量连接涌入
不做 VPN/代理检测：不误伤使用加速器、代理的正常玩家
全平台覆盖：Paper/Purpur/Folia、Bukkit/Spigot 与 Velocity/BungeeCord 代理端都有独立构建
兼容老版本：从 1.7.2 到 26.2 都有构建，老服同样可用
可记录已验证玩家：支持 MySQL / MariaDB / PostgreSQL / H2 存储
配置可控：可设置校验时机（始终 / 仅攻击时）、失败次数与 IP 封禁时长、对基岩版玩家的校验开关等
环境要求

| 项目 | 要求 |
| --- | --- |
| 服务端 | Paper 1.21+、Bukkit/Spigot 1.8.8+、Velocity 3.6.0+、BungeeCord 1.20+ |
| Minecraft | Java 版 1.7.2 – 26.2 |
| Java 版本 | Java 17 或以上 |
| 依赖 | Netty 4.1 或以上（1.7.2 – 1.8.8 的老服务端建议使用已更新依赖的分支）|
| 数据库 | 非必需，可选 MySQL / MariaDB / PostgreSQL / H2 |
| 注意 | 使用代理端时只在代理端装一次，不要每个子服都装 |
安装方法
按服务端类型下载对应 jar（如 Sonar-Bukkit.jar）
放入 plugins/ 目录并重启服务端
按需调整配置：校验时机、失败次数与封禁时长、是否校验基岩版玩家等
观察日志中的校验记录，确认拦截已生效

> 使用 BungeeCord 或 Velocity 时，Sonar 只需装在代理端一次，装到每个后端服反而会重复校验。
使用提示
装在代理端（Velocity/BungeeCord）可一次性覆盖所有子服，运维上最省事
校验发生在进入后端之前，排查问题时看的是 Sonar 自己的日志，而不是各子服日志
与反作弊插件职责不同：Sonar 拦假人与压测，反作弊查作弊行为，两者可以同时使用
基岩版（Geyser）玩家的校验可单独开关；官方提醒 UDP 不如 TCP 稳定，出现问题可以关掉这一项
部分魔改客户端（包括作弊客户端）可能干扰校验流程，这属于客户端不遵守原版协议，Sonar 无法修复
需要更强防护、网页面板与更多功能的话，作者另有付费的 Sonar 3.0（独立官网），Modrinth 上的是免费 2.x
相关链接
Modrinth 项目页：https://modrinth.com/plugin/sonar
官方文档（配置与命令）：https://docs.jonesdev.xyz/sonar/
支持版本说明：https://docs.jonesdev.xyz/sonar/supported-versions
源码仓库：https://github.com/jonesdevelopment/sonar
Sonar 3.0 官网：https://sonar.top
Discord 社区：https://sonar.top/discord