Anti-VPN (Bungee) - 高效屏蔽VPN用户

Anti-VPN 是一款强大的 Minecraft 服务器插件，用于检测并阻止使用 VPN 或代理连接的玩家，同时也能识别 MCLeaks 账号。它支持多种检测服务和数据存储后端，并可通过消息服务实现多服务器间的数据同步。

💡重要链接与须知

• 支持 Discord: https://discord.gg/BWshAvM
• Bukkit 版本: 请点击此处查找！
• Velocity 版本: 请点击此处查找！
• Wiki (含安装指南): 请点击此处查看！强烈建议阅读 Wiki。
• 首次运行: 插件首次启动可能需要一些时间，这属于正常现象，后续启动将非常迅速。

🎮数据存储配置

插件需要至少配置一个存储引擎来保存长期数据。

存储引擎设置

在 storage.engines 下配置引擎，例如：

engine1:
  type: 'mysql' # 类型：mysql, old_mysql, mariadb, postgresql, h2, sqlite
  enabled: false
  connection:
    address: '127.0.0.1:3306'
    database: 'anti_vpn'
    username: ''
    password: ''
    options: 'useSSL=false&useUnicode=true&characterEncoding=utf8'
engine2:
  type: 'h2' # 默认启用的嵌入式数据库
  enabled: true
  connection:
    file: 'anti_vpn'

连接池设置

• max-pool-size: 连接池最大连接数，默认为 4。
• min-idle: 连接池最小空闲连接数，默认为 4。
• max-lifetime: 连接最大存活时间，建议比数据库超时设置少 30 秒，默认为 30minutes。
• timeout: 获取连接的超时时间，默认为 5seconds。
• order: 定义存储引擎的使用顺序，例如 - 'engine1'。

🎮消息服务配置

用于在服务器网络间快速共享信息，配置在 messaging.engines 下。

消息引擎类型

• RabbitMQ: 类型为 rabbitmq，需配置地址、虚拟主机和凭证。
• Redis: 类型为 redis，需配置地址和密码。

连接池设置

参数与存储引擎类似，包括 max-pool-size、min-idle、max-lifetime 和 timeout。

🎮VPN 检测源配置

插件支持多个检测源（API），可在 sources 部分配置。启用过多失败率高的源会影响性能。

全局与各源设置

• cache-time: 全局结果缓存时间，默认为 6hours。
• order: 定义检测源的尝试顺序。
• 每个检测源（如 proxycheck、iptrooper）都有独立的 enabled、key（如需）及其他特定参数（如 threshold、block 类型）。

部分检测源说明

• proxycheck: 默认启用，检测率高，可选 API 密钥。
• getipintel: 默认启用，需配置联系邮箱和阈值。
• ipqualityscore: 默认禁用，需 API 密钥，可配置严格度、移动设备检测等。
• 其他源: 如 iphub、iphunter、vpnblocker、ip2proxy、shodan、ipinfo、teoh 等，均需按需启用和配置。

🎮MCLeaks 检测配置

配置位于 mcleaks 部分。

• cache-time: 结果缓存时间，默认为 1day。
• key: 可选的 API 密钥（用于应对高频率请求）。

🎮执行动作配置

配置检测到违规行为后执行的操作，位于 action 部分。

VPN 处理动作

• kick-message: 踢出玩家时显示的消息。留空则不踢出。
• commands: 控制台执行的命令列表，可使用 %player%、%uuid%、%ip% 占位符。
• algorithm.method: 检测算法，可选 Cascade（顺序查询，返回第一个有效结果）或 Consensus（并行查询，计算共识比率）。
• algorithm.min-consensus: 仅 Consensus 模式有效，定义判定为 VPN 所需的最小共识比率（0 到 1 之间）。

MCLeaks 处理动作

• kick-message: 踢出使用 MCLeaks 账号的玩家时的消息。
• commands: 控制台执行的命令列表。

🎮其他核心设置

忽略列表

在 ignore 下配置忽略的 IP 地址或范围（如本地网络 127.0.0.0/8、192.168.0.0/16）。

连接与性能

• cache-time: 内存中查找结果的缓存时间，默认为 1minute。
• threads: 用于网络操作的线程数，默认为 4。
• timeout: API 请求超时时间，默认为 5seconds。
• debug: 设为 true 可在控制台输出调试信息。
• lang: 默认语言（影响控制台输出），例如 'en'。

统计与更新

• stats.usage: 是否向 bStats 发送匿名使用统计。
• stats.errors: 是否匿名发送错误报告以帮助开发者修复问题。
• update.check: 是否自动检查更新。
• update.notify: 是否通知拥有 avpn.admin 权限的玩家。

🔧命令

• /avpn reload - 重载插件配置。这将断开并重新连接配置文件中配置的服务。
• /avpn test <ip> - 通过所有已启用的服务测试一个 IP。注意：此操作会强制检查，每次都会使用 API 查询额度。
• /avpn check <ip> - 使用默认系统检查一个 IP。返回的结果与其他 API 调用完全相同。
• /avpn score <source> - 根据预制的已知 IP 列表对特定检测源进行评分。注意：此操作会强制检查，每次都会使用 API 查询额度。

🔧权限

• avpn.admin - 允许使用 /avpn reload、/avpn test、/avpn check 和 /avpn score 命令。
• avpn.bypass - 拥有此权限的玩家将完全绕过过滤检查。

✨补充信息

• 支持插件: 请考虑捐赠以支持这款免费插件！
• 隐私与合规: 根据 GDPR 法规，使用本插件时您必须在隐私政策中向玩家说明您正在存储 IP 信息。根据 API 数据的使用方式，您可能需要手动从数据库中删除某些数据。
• 免责声明: 开发者是插件作者，并非律师。以上信息仅为“最佳猜测”，不构成法律建议。
• API 文档: 请查阅 Wiki。

未入选的服务

部分检测服务因效果未达标准未被包含在内，例如

• stopforumspam: 错误率 0%，NordVPN 检测率 38.1%，Cryptostorm 检测率 10%，家庭 IP 误报率 0%。