# BungeeCord 和 Waterfall 的反 VPN 与反机器人：安装 Kordon

很多服务器网络仍在用 BungeeCord 或 Waterfall。要拦截 VPN，并不需要先迁移到 Velocity：Kordon 用同一个文件就能装上，设置方式也一样。

更新于: 2026-10-27

## 概要

- 支持 BungeeCord、Waterfall，以及 FlameCord、XCord、Travertine 等 BungeeCord API 1.16 或更高版本的分支。
- 需要 Java 21 或更高版本。
- `Kordon.jar` 在 BungeeCord 和 Velocity 上是同一个文件，换代理端时可以继续用。
- 命令权限写在 BungeeCord 自己的 `config.yml` 里，或者通过 LuckPerms 授予。

## 环境要求

[Kordon 的 Minecraft 服务器反 VPN 插件](https://kordonlabs.com/zh)支持代理端接受的所有客户端版本，从 1.8 到最新版本。除了检测 VPN，它还能用攻击模式保护代理端免受成波的机器人冲击，攻击模式在所有套餐中都可用。

需要 BungeeCord、Waterfall 或 API 1.16 及以上的 BungeeCord 分支，以及 Java 21 或更高版本。如果代理端运行在更旧的 Java 上，启动时控制台会显示 `UnsupportedClassVersionError`。

Kordon 只装在代理端上，后面的 Spigot 或 Paper 子服什么都不用装。插件会自动识别来自 Geyser 和 Floodgate 的 Bedrock 玩家。

## 安装

1. [创建账号](https://panel.kordonlabs.com/register)，然后在面板中添加你的服务器。
2. 在服务器的 **插件** 页面下载 `Kordon.jar`，文件里已经包含你的服务器密钥。
3. 把文件放进代理端的 `plugins` 文件夹，和代理端的 `config.yml` 在同一目录下。
4. 重启代理端。

控制台会输出一行连接信息，一分钟内面板会显示“插件在线”：

```
Kordon connected to server "My Server". Mode: monitoring only. If Kordon is unavailable: let nobody in.
```

从 SpigotMC 或 Hangar 下载的通用版 `Kordon.jar`，在代理端控制台用命令连接即可，无需重启：

```
/kordon link <key>
```

> 服务器密钥相当于密码。如果文件或密钥落到别人手里，在面板中生成新密钥，旧密钥会立即失效。

## 命令权限

不用 LuckPerms 时，权限在 BungeeCord 的 `config.yml` 中设置：`groups` 部分把玩家分进某个组，`permissions` 部分列出每个组能做什么。

```
groups:
  Steve:
  - moderator
permissions:
  moderator:
  - kordon.command
  - kordon.command.whitelist
  - kordon.command.lookup
  - kordon.notify
```

用 LuckPerms 的话，一条命令就能做到：

```
/lpb user Steve permission set kordon.command true
```

每个命令都有自己的权限：`kordon.command.whitelist`、`kordon.command.blacklist`、`kordon.command.lookup`、`kordon.command.reload`。`kordon.notify` 权限用于在聊天中接收 Kordon 的管理员通知。`/kordon link` 不包含在通用权限里，最好只留给所有者。较长的命令有简写：`/kordon wl` 和 `/kordon bl`。

## 多个代理端

如果你的网络有多个 BungeeCord 实例，在每个实例上用同一个文件安装插件。这些代理端会自动出现在面板“插件”部分的“代理端”标签页中。能检测多少个代理端取决于你的[套餐](https://kordonlabs.com/zh#pricing)。超出上限的代理端 Kordon 不提供服务，面板上会注明。这类代理端上的插件按照“检测不可用时”设置处理，默认不放行玩家。

## 迁移到 Velocity

PaperMC 已不再开发 Waterfall，并建议迁移到 Velocity。迁移时 Kordon 不需要任何改动：把同一个 `Kordon.jar` 放进新代理端的 `plugins` 文件夹即可。所有设置、列表和进服记录都保存在面板里，原样保留。

如果你是用命令连接插件的，还要复制带有密钥文件的 `plugins/Kordon` 文件夹，或者在新代理端上再执行一次 `/kordon link`。两个代理端同时运行时，各自都计入套餐上限。如果套餐只含一个代理端，第二个就会超出上限，所以在转移玩家之前先关掉旧代理端，或者在面板中选择计入哪一个。Velocity 上的权限设置见 [Velocity 指南](https://kordonlabs.com/zh/guides/velocity-antivpn-plugin)。

## 在你的服务器上试试

从观察模式开始：Kordon 会显示它将拦截哪些人，你准备好后再开启防护。 [创建账号](https://panel.kordonlabs.com/register)

## 更多指南

- [如何在 Minecraft 服务器上拦截 VPN 和代理](https://kordonlabs.com/zh/guides/block-vpn-minecraft-server): 玩家为什么通过 VPN 和代理进服，有哪些拦截办法，以及如何在 BungeeCord 或 Velocity 上一步步配置 Kordon AntiVPN 插件。
- [Velocity 的 AntiVPN 和反机器人插件：配置 Kordon](https://kordonlabs.com/zh/guides/velocity-antivpn-plugin): 如何在 Velocity 3.4 和 4.x 上为 Minecraft 1.8 至 26.x 安装 Kordon AntiVPN 和反机器人插件：Java、LuckPerms 权限、命令、多个代理端。
- [如何限制进入服务器的 Minecraft 版本](https://kordonlabs.com/zh/guides/minecraft-client-version-filter): 如何只让你想要的客户端版本进入 Minecraft 服务器：为什么装了 ViaVersion 后这很重要，如何在 Kordon 中设置版本范围，以及 Bedrock 玩家会怎样。