Anti-VPN - 高效屏蔽VPN玩家

Anti-VPN 是一款用于检测并阻止玩家使用 VPN 或代理连接服务器的插件，支持多种检测源和数据库存储，并可通过消息服务实现多服务器间数据同步。

💡重要链接与须知

• 支持 Discord: https://discord.gg/BWshAvM
• Bungee 版本: 请点击 [此处](here) 查找。
• Velocity 版本: 请点击 [此处](here) 查找。
• Wiki (文档): 安装说明和详细文档请查阅 [Wiki](here)。强烈建议阅读 Wiki 以正确配置插件。
• 首次启动: 插件首次运行时可能需要较长时间启动，这属于正常现象，后续启动将恢复正常速度。

🎮数据存储配置

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

存储引擎设置

在 storage 部分配置数据库。每个引擎需要定义：

• 引擎名称: 可自定义（如 engine1）。
• 类型 (type): 可选 mysql、old_mysql、mariadb、postgresql、h2 或 sqlite。
• 启用状态 (enabled): 设置为 true 或 false。
• 连接参数 (connection): 包括地址、数据库名、用户名和密码等。

**示例配置片段**

storage:
  engines:
    engine1:
      type: 'mysql'
      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: 连接池最大连接数。
• min-idle: 连接池最小空闲连接数。
• max-lifetime: 连接最大生命周期（例如 '30minutes'）。
• timeout: 获取连接的超时时间（例如 '5seconds'）。
• order: 定义存储引擎的使用顺序，列表中的第一个可用引擎将被视为主数据源。

🎮消息服务配置

用于在服务器网络间快速共享信息，需在 messaging 部分配置。

消息引擎类型

• 类型 (type): 可选 rabbitmq 或 redis。
• 需要配置地址、端口、虚拟主机（RabbitMQ）和认证信息。

连接池设置

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

🎮VPN 检测源配置

在 sources 部分定义和配置检测服务。插件会按 order 列表顺序尝试查询。

全局设置

• cache-time: 全局结果缓存时间（例如 '6hours'）。建议在避免触发频率限制的前提下尽可能设高。

可用的检测源

每个检测源均可独立启用或禁用，部分需要 API 密钥。以下是部分源及其关键配置：

• proxycheck
• 启用: enabled: true
• API 密钥: key: '' (可选)
• getipintel
• 启用: enabled: true
• 必填联系人邮箱: contact: '[email protected]'
• 风险阈值: threshold: 0.98
• ipqualityscore
• 启用: enabled: false
• 必填 API 密钥: key: ''
• 可配置是否检测代理 (proxy)、移动设备宽松模式 (mobile)、严格等级 (strictness) 等。
• 其他源: 还包括 iptrooper、iphub、iphunter、vpnblocker、ip2proxy、shodan、ipinfo、teoh 等，各有其配置项。

> 注意: 启用过多检测源或源频繁失败可能会影响服务器性能。

🎮操作与算法

在 action 部分定义检测到 VPN 或 MCLeaks 账号后的处理方式。

VPN 处理

• kick-message: 踢出玩家时显示的消息。留空则不踢出。
• commands: 控制台执行的命令列表。可使用 %player%、%uuid%、%ip% 作为占位符。

检测算法

• method: 算法模式，可选 cascade (级联) 或 consensus (共识)。
• 级联模式: 按顺序查询源列表，直到获得第一个有效结果。
• 共识模式: 同时查询所有源，根据有效结果的比例判断。
• min-consensus: 仅用于共识模式。设定判定为 VPN 所需的最小同意比例（0 到 1 之间，例如 0.6 代表 60%）。

MCLeaks 处理

• 独立配置 kick-message 和 commands，用于处理 MCLeaks 账号。

🎮其他核心配置

忽略列表

• ignore: 在此列表中的 IP 地址或范围将不会被检测。默认包含本地网络地址（如 127.0.0.0/8、192.168.0.0/16）。

连接与缓存

• cache-time: 内存中查询结果的缓存时间（例如 '1minute'）。
• threads: 用于网络操作的线程数。
• timeout: API 请求超时时间。
• debug: 设置为 true 可在控制台输出调试信息。

统计与更新

• stats: 控制是否向 bStats 发送匿名使用统计 (usage) 和错误报告 (errors)。
• update: 控制是否自动检查更新 (check) 以及是否通知拥有管理员权限的玩家 (notify)。

🔧命令与权限

命令列表

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

权限节点

• avpn.admin - 允许使用所有 /avpn 命令。
• avpn.bypass - 拥有此权限的玩家将完全绕过检测。

✨注意事项与法律声明

• 捐赠: 请考虑捐赠以支持这款免费插件。
• 隐私与合规 (GDPR): 根据 GDPR，使用本插件时您必须在隐私政策中告知玩家您正在存储 IP 信息。根据 API 数据的使用方式，您可能需要手动从数据库中删除某些数据。

> 免责声明：我是插件开发者，并非律师。此信息仅为“最佳实践”建议，不构成法律意见。

• API 文档: 可在 [Wiki](here) 上找到 API 文档。

未采用的检测服务

部分检测服务因效果未达预期未被纳入默认配置，例如：

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