ProxyTracer LogoProxyTracer
Skip to Content
Documentation社区平台与 CMSMinecraft 服务端

Minecraft 服务器 (Paper, Velocity & Bungee)

在 VPN 和代理连接进入游戏世界前将其拦截。

ProxyTracer 对照高精度的 ProxyTracer API 核验进服玩家 IP，允许您对恶意连接执行拦截（Block）、警告（Warn）或记录（Log）。完美遏制封禁绕过、虚假小号多开与基于 VPN 的假人压测突袭。

效果预览

游戏内踢出界面控制台警告
Minecraft Kick ScreenConsole Warning Log

为什么选择 ProxyTracer？

  • 实时检测： 对照 ProxyTracer 持续更新的住宅代理与商业 VPN 威胁库进行精准核验。
  • 多平台原生支持： 为单端服务器（Paper/Spigot）与多端代理网络群（Velocity 或 BungeeCord/Waterfall）提供专用原生集成插件。
  • 极致性能： 内置内存级缓存机制，有效节省 API 调用额度并确保老玩家瞬间连接进服。
  • 智能白名单： 提供针对受信任玩家名称与网络 IP 网段的白名单绕过指令支持。
  • Discord 联动警报： 将拦截到的 VPN 玩家进服记录直接同步输出至管理员管理频道。
  • 品牌化踢出界面： 向被拦截玩家展示带有 proxytracer.com 官方指引的专业拦截提示页面。

我应该下载哪一个 Jar 文件？

您的环境配置安装这个 jar存放位置操作
单独的 Paper / Spigot / Purpur 服务器proxytracer-bukkit-1.4.0.jar游戏服务端 plugins/ 目录 下载
Velocity 代理网络群proxytracer-velocity-1.4.0.jar代理端 plugins/ 目录 (不要安装在 Paper 上) 下载
BungeeCord / Waterfall 网络proxytracer-bungee-1.4.0.jar代理端 plugins/ 目录 (不要安装在 Paper 上) 下载
架构黄金法则： 在能获取到真实客户端 IP 的位置安装 ProxyTracer。若您运行的是代理网络群（Velocity 或 BungeeCord），仅需且只能在网关代理端安装插件。切勿同时在 Bukkit 子服与 Velocity 代理端开启拦截模式（这将导致重复扣费与冗余检查）。

60 秒极速部署

  1. 获取免费 API 密钥：ProxyTracer.com/dashboard
  2. 根据您的服务器架构，从 Releases 下载对应的 Jar 插件文件。
  3. 将下载的 jar 文件放入服务端的 plugins/ 目录中并启动服务器一次。
  4. 直接在游戏内或通过控制台设置您的 API 密钥： 
    /proxytracer set your_api_key_here
    (这将自动把密钥写入配置文件并重新加载插件)。
  5. 通过运行 /proxytracer status 验证连接状态

核心配置说明

mode: "block"          # 检测到代理时的处置策略：block | warn | log
 
api:
  base-url: "https://api.proxytracer.com/v1"
  key: "proxy_your_key_here"
  on-error: "allow"    # API 离线时的故障开放（Fail-open）策略：allow | block | warn
  timeout-ms: 2000
 
notifications:
  in-game: false       # 向在线管理员发送彩色游戏内聊天提醒 (proxytracer.notify)
 
cache:
  enabled: true
  ttl-minutes: 1440    # 将 IP 检测结果缓存 24 小时
  max-entries: 10000
 
discord:
  enabled: false
  webhook-url: ""
  notify-blocked: true

命令与权限节点

所有命令均以 /proxytracer 开头：

  • /proxytracer notify <on|off|toggle> — 为管理员开启/关闭游戏内彩色聊天通知。
  • /proxytracer notify add|remove|list [player] — 添加/删除/列出有权限接收游戏内通知的管理员（自动保存至 config.yml）。
  • /proxytracer set <api_key> — 直接设置 API 密钥，保存至 config.yml 并重新加载。
  • /proxytracer status — 检查配置状态、API 凭证及游戏内通知状态。
  • /proxytracer check <ip> — 手动查询 IP 地址。
  • /proxytracer cache clear — 清除本地 IP 缓存。
  • /proxytracer reload — 重新加载配置文件。
  • /proxytracer whitelist name add|remove|list [player] — 豁免指定玩家的检测。
  • /proxytracer whitelist ip add|remove|list [ip] — 豁免指定网络 IP 的检测。

权限节点说明：

  • proxytracer.admin — 允许访问重载、状态和管理命令。
  • proxytracer.bypass — 拥有此权限的玩家在登入前可绕过检测。
  • proxytracer.notify — 当 VPN 用户记录或警告时，管理员会收到游戏内警报。

(注：默认情况下，这些权限仅分配给服务器 OP。要赋予其他玩家或管理组，请使用类似 LuckPerms 的权限管理插件)。

兼容性与运行环境要求

  • Java 版本： Java 17 或更高版本（已在 Java 17、21 及 22 下充分测试）。插件针对 Java 17 编译。
  • 服务器软件支持： Paper / Spigot / Purpur (1.13 到 1.21.x)、Velocity (3.x) 以及 BungeeCord / Waterfall (现代版本)。
  • API 访问： 在 proxytracer.com 注册获取的有效免费或付费 API 密钥。

故障排查：真实 IP 异常 (127.0.0.1)

如果您的日志显示每个进入游戏的玩家都通过 127.0.0.1 连接，ProxyTracer API 将无法扫描。这说明您的主机网络布局或前置代理隐藏了真实的玩家 IP。

排查与修复方案：

  1. 对于代理网络（Velocity / Bungee）： 仅在网关代理（Velocity/Bungee）上部署 ProxyTracer。确保玩家信息转发功能已开启（在 velocity.toml 中 player-info-forwarding-mode = "modern"，或在 Bungee 的 config.yml 中 ip_forward: true），以便后端的游戏节点收到真实的 IP。
  2. 对于共享主机（如 TickHosting 面板代理）： 如果您的主机通过 Proxy Protocol 转发连接头信息，请在 Paper 配置中启用它（config/paper-global.yml 中的 proxies.proxy-protocol: true）并重启。警告：除非您的主机明确支持此协议，否则不要打开它；配置错误将导致所有玩家无法加入。

定价与 API 额度

ProxyTracer Minecraft 插件 100% 免费开源。进行检测需要连接 ProxyTracer API：

- 免费版： 每月 100 次检测，适合小型生存服和开发测试。
- 入门版 (€3/月)： 非常适合发展中的公开服务器。
- 专业版 (€9/月) / 扩展版 (€39/月)： 专为成熟的大型网络服设计。

创建您的密钥并选择套餐：ProxyTracer

最后更新于
Flarum 论坛