NoProxy - 最强反作弊插件

NoProxy 是一款帮助服务器管理员从源头阻止使用代理/VPN 的玩家连接的插件。通过拦截使用代理/VPN（通常是机器人）的用户连接，可以为您服务器的玩家群体提供更少干扰的游戏体验。NoProxy 利用 proxycheck.io 来验证连接到您服务器的 IP 地址是否来自代理或 VPN。

💡快速开始

安装 NoProxy 并首次启动插件后，它会提示未找到有效的 API 密钥，这完全正常！请按以下步骤配置：

• 进入插件文件夹下的 NoProxy 目录，编辑 config.yml 文件。
• 在文件顶部找到 API-KEY: 这一行，其默认值需要更改为您从 proxycheck.io 获取的 API 密钥（可在 proxycheck.io/dashboard 找到）。
• 保存更改后，重新加载或重启您的服务器，插件即可正常运行。

可选：启用 VPN 检测

如果您希望同时阻止使用 VPN 的用户连接，需要在 config.yml 中启用 check-vpn 选项。该设置位于您填入 API 密钥那行的下方。请注意： check-vpn 默认是关闭的。

🔧核心特性

精准检测

• 利用 proxycheck.io API v2 版本，确保准确识别连接用户的真实性。

丰富通知

• 当攻击开始、结束，或有用户尝试使用代理连接时，您都会收到警报。

分层防护

• 您可以选择：仅踢出使用代理的玩家；或将其 IP 封禁于服务器之外；更进一步，还可将其 IP 加入 IPTables 规则，使其甚至无法 ping 通服务器。

地堡模式

• 当服务器遭受攻击时，地堡模式将阻止所有传入连接，仅允许特定白名单内的连接。这既能缓解攻击，也能节省您在 proxycheck.io 上的查询额度。

国家/地区封锁

• 阻止来自您指定国家/地区的所有连接。

完全控制

• 自定义 NoProxy 验证流程的每个阶段，确保机器人永远无法登录您的服务器。

✨IPTables 支持（高级功能）

从 0.6 版本开始，NoProxy 以基础形式支持 IPTables。这意味着如果您的服务器遭受机器人攻击，机器人的 IP 将被彻底阻止，甚至无法 ping 通服务器（对机器人而言，服务器显示为完全离线）。

优势与风险

• 优势：在遭受攻击时，可显著降低服务器的 CPU 使用率。
• 风险：启用 IPTables 功能后，Java 必须以 root 权限运行。这并不推荐，开发者对因此造成的任何损害不承担责任，请自行承担风险！

安装与配置

与大多数插件不同，在 config.yml 中启用 IPTables 前，必须先安装一个名为 ipset 的软件包。ipset 能将 IP 列表存储在内存中，从而一次性添加大量 IP 规则而不会显著影响性能。

• 在基于 Debian/Ubuntu 的系统上安装：

  apt-get install ipset

• 在基于 CentOS 的系统上安装：

  yum install ipset

（如果您使用其他 Linux 发行版，请自行搜索安装方法。）

安装 ipset 后，只需在 config.yml 中将 iptables-enabled 设置为 true，NoProxy 便会处理其余事项。请注意： 截至 0.6 版本，无法通过 Spigot 服务器命令移除特定 IP，必须通过命令行操作。

❓BungeeCord 版本特性

NoProxy 的 BungeeCord 版本引入了多项新功能，但为了使其正常工作，强烈建议（甚至可以说是必需） 使用 MySQL。

主要功能

• 检测尝试连接服务器的用户是否使用 VPN。
• 当用户尝试使用代理/VPN 连接时收到通知（0.3 版本中控制通知时长的功能已损坏）。
• 查看来自 proxycheck.io 的查询统计信息。
• 赦免/取消赦免用户，使其免于代理检测（此功能需要 MySQL，并利用异步调度以确保对 BungeeCord 实例的性能影响最小）。赦免基于 UUID。
• 封禁/解封 IP，阻止其连接 BungeeCord 实例（此功能需要 MySQL，并利用异步调度以确保对 BungeeCord 实例的性能影响最小）。IP 在封禁前会进行基本格式验证。
• 首次检测到代理后，其 IP 会被缓存到 RAM 中（以获得最快速度！），并保留一段时间（最长 30 分钟，最短 5 分钟）。当您的 BungeeCord 实例遭受机器人攻击且您不想耗尽查询额度时，此功能非常有用。
• NoProxyBungee 同样利用 proxycheck.io API v2 版本，确保所有代理查询速度最快。

额外权限节点

noproxy.viewkickevent
noproxy.alert

🎮权限节点

Spigot 版本权限

在 Spigot 版的 NoProxy 中，* 表示该节点包含其下的所有子节点。例如，noproxy.list 会赋予用户该特定命令帮助菜单的权限。权限的一般格式为：noproxy.<命令>.<子命令>。

noproxy.help
noproxy.queries
noproxy.banned.*
noproxy.banned.list
noproxy.banned.clear
noproxy.banned.add
noproxy.banned.remove
noproxy.config
noproxy.connections
noproxy.service.*
noproxy.service
noproxy.service.list
noproxy.service.edit
noproxy.list.*
noproxy.list
noproxy.list.add
noproxy.list.remove
noproxy.list.clear
noproxy.list.size
noproxy.cache.*
noproxy.cache
noproxy.cache.list
noproxy.cache.clear

BungeeCord 版本权限

NoProxy for BungeeCord 遵循相同的 noproxy.<命令>.<子命令> 格式，但没有包含性权限（如 noproxy.cache.* 等）。

noproxy.ban
noproxy.ban.list
noproxy.ban.clear
noproxy.ban.size
noproxy.list
noproxy.list.add
noproxy.list.remove
noproxy.list.clear
noproxy.list.size
noproxy.cache
noproxy.cache.list
noproxy.cache.clear
noproxy.config
noproxy.connections
noproxy.help
noproxy.pardon
noproxy.pardon.list
noproxy.queries
noproxy.service
noproxy.service.list
noproxy.service.edit
noproxy.unban
noproxy.unpardon

⭐配置示例 (Spigot config.yml 节选)

############################
# 通用设置 #
############################
# 在此处放置您的 API 密钥
API-KEY: 1111-2222-3333-4444
# 设置为 true 以检查玩家是否使用 VPN
check-vpn: false

############################
# 踢出消息 #
############################
# 玩家使用代理时发送的消息
kick-message: "§4§l连接本服务器前请关闭您的代理！"
# 动作栏通知显示的秒数
kick-notify-time: 3

############################
# IP 封禁 #
############################
# 是否在玩家尝试连接时封禁其代理/VPN 的 IP，必须启用此项才能使下方设置生效
banip-on-attempt: false
# 发送给 IP 被封禁玩家的消息
banip-message: "&6您的 IP &c(ip) &6因被检测为代理已被封禁。请关闭代理后重新连接服务器。"

🔧开发计划

• 添加 1.13 支持（待 Spigot 稳定版发布后）。
• 添加更多检测形式（例如，当玩家/机器人 ping 服务器列表时，检查其 IP 并决定是否阻止）。
• 为 Windows 机器添加防火墙支持。
• 将 Spigot 版 NoProxy 的特性引入 BungeeCord 版本（很可能是 0.7 版本）。随后，为 Spigot 版本添加 MySQL 支持和国家/地区封锁功能，并优化插件（美化帮助菜单，提升后台代码效率）（很可能是 0.75 版本）。再之后，添加自定义代理列表功能，在玩家加入服务器时进行比对（很可能是 0.8 版本）。最终目标是持续提升性能，使插件能够抵御规模越来越大、对服务器性能影响极小的攻击。

欢迎随时联系我，或在讨论区提出任何功能请求！我会尽力回复。

感谢您关注 NoProxy！另外，如果您在使用 NoProxy 时遇到任何问题，请随时给我发送私信，我会尽力提供帮助！