Connection Guard

插件

· 作者 gerolndnr

免费、开源的反 VPN 和国家规则。每项决策都有详细解释,并提供可选的免费控制面板。

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

最新 0.6.1 · 26.3 · Bukkit / BungeeCord

一键开服(送7天)

Connection Guard:阻止 VPN、代理和 Tor 用户访问你的 Minecraft 服务器

Connection Guard 阻止使用 VPN、代理和 Tor 的用户进入你的 Minecraft 服务器,并明确告知你原因。 它首先检查服务器上已签名的自有 VPN 列表,然后依次调用免费检测服务,并对每一个决定进行解释。免费且采用 MIT 许可证,一个 JAR 文件即可兼容 Paper、Spigot、BungeeCord 和 Velocity。

官网 · 下载 · 基准测试 · 仪表盘 · 文档 · Discord

公开测量的结果

Connection Guard 在公开的 mc-antivpn-bench 套件中与另外五种反 VPN 插件进行了对比。以下是部分结果:在一次登录波中有多少玩家触发了查询、误拒情况以及 VPN/Tor/代理的检测覆盖率。该套件由 Connection Guard 的作者维护;方法、每个产品的版本以及原始日志均为公开状态。

Connection Guard 基准测试亮点:1,000 名玩家中有 999 名被查询,310 个家庭/移动地址中有 2 个被拒绝,观察到的 VPN/Tor/代理覆盖率为 99.7%(363/364);开发构建版

选定结果,2026 年 10 月 8–13 日。 Keyless on Velocity/Java 25;负载对比使用了重放的 API 和免费配额。CG 开发提交哈希:76665cc(负载),46821a2(检测)。这些测量针对的是开发构建版,而非已发布的 0.6.1 JAR;其完整的综合基准测试仍在进行中。检测覆盖了 364 个仍列出的 VPN/Tor/代理地址中的 363 个,另有 14 个过期的代理根据公布规则被排除。VPN/Tor 标签与 Intel 列表重叠;这衡量的是样本覆盖率,而非对未见过 IP 的独立准确性。KauriVPN 在准入后进行检查。方法、版本及所有结果。

0.6.1 版本更新内容

确认了 Blackbox 的处理逻辑,审查了来自 FoxGate/ProxyShield/VPNGuard/KauriVPN/AdvancedAntiVPN 的迁移流程,引入了内存优先的持久化缓存、自由选择的 TEXT Webhook 变量、本地可选的策略捕获/重放、明确的 LOCAL_ONLY/共享 API 预算配置文件以及仪表盘提供商排序。不声称具有改进的比较准确率或性能。

功能介绍

  • Connection Guard Intel。 每日更新并已在你的服务器上检查的已签名 VPN 服务器、Tor 出口节点和隐私中继列表。在获取列表时不会发送任何玩家的 IP、名称或 UUID。本地查询没有 API 配额限制;只要拥有新鲜有效的列表,当检测 API 不可用时,列出的 VPN/Tor 地址仍会被阻止。缺失、过期或未列出的条目会继续故障转移。默认放行 iCloud Private Relay,或者如果你愿意,也可以将其视为 VPN 处理。列表是公开的。
  • 依次调用的检测服务。 对于新的 0.6.1 安装,优先使用本地的 Tor/Intel,然后是 zowi,Blackbox 通过新鲜的 Intel HOSTING 数据进行确认,最后是 IPQuery。ProxyCheck 默认关闭,你可以用自己的密钥启用它作为最后的后备选项;ip-check.net 和 IP-API 保持为可选开启。确定的阳性或阴性结果会停止整个链条。当某个到达的服务失败或其本地限额耗尽时,将尝试下一个选定的来源;这不保证具有同等的检测覆盖率。zowi 在本地仍限制为每分钟 60 次请求,并由 FoxGate 的开发者运营。整个登录过程的 5,000 毫秒预算和尝试次数限制保持不变。如果你有密钥,可以添加 IPHub、VPNAPI、IPQualityScore 或你自己的 REST 服务。
  • 国家规则。 阻止你列出的国家,或仅允许这些国家,每种情况都可以设置自己的消息。
  • 自定义例外。 永久或暂时允许、禁止或豁免某个 IP、CIDR 范围或已验证的玩家:/cg allow add 192.0.2.0/24 vpn 2h School network。
  • 你的响应方式。 拒绝连接、在聊天中警告工作人员、发布到 Discord Webhook 或执行控制台命令。
  • 从第一次登录开始保护。 新安装默认以 ENFORCE 模式启动,立即拒绝阳性 VPN/代理/Tor 信号;Blackbox 匹配默认需要新鲜的本地 Intel HOSTING 确认;未确认的条目继续故障转移。设置 operation.mode: OBSERVE 仅记录 Connection Guard 本应拒绝的对象。
  • 安全变更。 策略支持版本控制并可回滚,阴影模式会在做出任何决定之前将新策略与实际登录进行比较。
  • 自我解释。 /cg explain <IP> 显示为何允许或拒绝某条连接,/cg doctor 检查你的设置,/cg providers 显示每个服务的健康状况和限制。
  • 玩家的语言。 消息提供英语、德语和西班牙语版本。

免费的仪表盘(可选)

打开插件在控制台中打印的高亮链接,使用 Discord 登录,即可关联服务器。简短的设置助手会与你一起选择服务、国家和模式。从 0.6.1 开始,可以重新排序服务,选择顺序/并行检查,并为每位玩家管理 1–16 次尝试;无效更改将被完全拒绝,并保留 config.yml。更改将在下一次同步时生效至在线服务器;/cg cloud sync 可请求在后台立即同步。

包含检查、拒绝、24 小时图表和提供商配额的网络概览

一目了然地查看所有服务器。 跨整个网络的检查、拒绝、VPN 比率、服务健康状况和限制,数据保留长达 13 个月。

一条被拒绝的连接,附带一句话的原因说明以及让该玩家入场的按钮

每一个决定,都有解释。 用一句话说明玩家被拒绝的原因,包括是哪个名单或服务做出的判定。在这里可以直接让玩家进入一小时、一天、一周或永久;允许该 IP 地址;或者信任其互联网服务提供商。明确的 DENY(拒绝)优先级高于 ALLOW(允许)。

设置界面预览:展示新规则在过去七天内会拒绝哪些人

切换前心中有数。 在保存新设置之前,仪表板会基于当时记录的判定结果,估算这些设置在过去 7 天的登录中本应如何决策。缺少提供商判定、托管访问规则以及其他插件会影响估算的准确性。

你还将获得团队访问权限,包含所有者(owner)、管理员(admin)和查看者(viewer)角色,并在服务器下线、服务出现异常、限额不足或拒绝率激增时收到 Discord 警报。

隐私与关闭方法。云端链接默认开启。 登录过程绝不会等待仪表板的响应。

  • 在链接服务器之前: 仅发送匿名的安装信息和平台信息、总量统计、服务健康状况以及匿名错误报告,不包含玩家 IP、名称或 UUID。错误报告仅包含受限的异常类型和 Connection Guard 堆栈元数据,排除异常消息和凭据;它们通过 Cloud 功能启用,且升级时无可选项。错误报告详情。
  • 在链接服务器并接受处理协议之后: 个别判定结果(包括 IP 地址和已验证的 UUID)将在欧盟境内存储 30 天。
  • 要关闭它, 可使用以下任一方式:cloud.enabled: false、/cg cloud disable 或 CONNECTIONGUARD_CLOUD=false。仅关闭错误报告:cloud.error-reports: false。

详细发送内容。仪表板也是开源的 (AGPL)。

快速开始

  1. 下载 JAR 文件并将其放入 plugins/ 目录:在你的服务器上,或者如果你在运行网络代理,则放在代理服务器上。
  2. 重启服务器。Connection Guard 将立即使用 Connection Guard Intel 和无密钥服务进行保护,无需任何 API 密钥。全新安装时国家查找功能默认关闭;当你添加国家规则后,仪表板会自动开启该功能。
  3. 打开控制台中的链接以在仪表板中完成设置,或直接编辑 config.yml。

从 0.5 版本升级? 请备份插件数据目录,停止服务器/代理,替换 JAR 文件,仅保留一个主插件 JAR 并重启。你的模式、服务、排序、密钥和显式限制保持不变;Intel 和新服务仅提供一次,且仅在您选择时才会启用。保留现有配置。运行 /cg doctor 可查看相关通知。当未选择任何策略时,故障转移(Failover)为默认行为;设置 provider.vpn-failover.enabled: false 可恢复并行投票。通过 provider.vpn.<id>.enabled: false 禁用某项服务;Intel 拥有独立的开关 provider.local.connectionguard-intel.enabled。

逐步指南:Paper 和 Spigot · BungeeCord · Velocity

要求

平台 Java
Paper, Spigot, Folia 及兼容服务器(基于 1.8.8 API 构建) Java 8 或更高版本
BungeeCord 和 Waterfall Java 8 或更高版本
Velocity (3.3 API) Java 17 或更高版本

请遵循您的服务器软件的 Java 要求;这些是插件的字节码目标版本。在 Java 25 环境下,于 Paper 26.3、Folia 26.2、Velocity 4.2.0 和 4.2.1-SNAPSHOT 上通过了启动、命令、重载和关闭检查;在 Java 21 环境下,于 Paper 1.21.11 和 Velocity 3.4.0 上也通过了检查。这些测试并未涵盖所有登录场景或中间版本。已测试内容。

命令

命令 功能
/cg doctor 检查您的配置和服务状态
/cg explain <IP> 解释为何允许或拒绝某个连接
/cg providers · /cg stats 查看服务健康状况、限制和统计总数
/cg allow · deny · exempt add <target> <scope> <time> <reason> 管理自定义规则,可设置特定时间或 permanent(永久)
/cg info <IP> · /cg clear <IP> 查询地址信息,清除缓存
/cg cloud status · link · sync · disable 可选仪表板功能;sync 会在后台请求待处理的更改,共享十秒冷却时间
/cg reload 重新加载设置和消息

如果 /cg 已被占用,请使用 /connectionguard。所有命令和权限。

值得了解

  • 检测服务会接收玩家 IP。 每个被调用的服务都会获知加入玩家的 IP 地址,因此请在服务器的隐私信息中注明你使用的服务。Blackbox 由 ipinfo.app 运营,没有书面条款,其列表还涵盖托管和云网络。zowi 由 FoxGate 的开发者运营。ip-check.net 默认关闭,因为它未公布运营商、条款或隐私政策。免费的 IP-API 端点仅用于非商业用途,且使用 HTTP。选择服务。
  • 当多个服务同时挂起时, 登录过程可能达到 5,000 毫秒的整体登录预算上限,而 Connection Guard 会继续尝试可用的服务。实测三个主机同时挂起的案例耗时约 4.52 秒。超时的服务会被暂时跳过,但未测试过的挂起服务仍可能导致后续登录延迟。不承诺低于两秒的通用首次故障限制。
  • 检测并非完美无缺。 标记并不证明某人正在做坏事,因此每次拒绝都可以解释并撤销。合法玩家被标记?
  • 它并非万能。 Connection Guard 不是反作弊系统、完整的反机器人系统或 DDoS 防护。

安全软件不应是黑盒

Connection Guard 会查看你服务器上的每一次登录,因此你应该能够确切了解它的运作方式。它运行的每一项检查和发送的每一个请求都是 MIT 许可下的公开代码,在公共 CI 中构建;GitHub 发布版本附带 SHA-256 校验和。Connection Guard Intel 基于 公共仓库 中的公开源代码构建,任何人都可以运行 基准测试。插件向 connectionguard.net 发送的内容由开放的 仪表板源码 定义,并可通过一行配置关闭。

帮助

在 Discord 上获取帮助 或 提交问题。请包含插件、服务器和 Java 的版本号。欢迎点赞或留下诚实的评价,但绝非必需。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源