# Velocity 的 AntiVPN 和反机器人插件：配置 Kordon

代理端是做 VPN 防护最方便的地方：每个玩家都要经过它，后面的 Paper 服务器无需改动。下面是在 Velocity 上配置 Kordon 的完整流程，从下载文件到给管理员分配权限。

更新于: 2026-10-27

## 概要

- Kordon 支持 Velocity 3.4 及以上版本，包括 4.x 分支。需要 Java 21 或更高版本。
- 插件只装在代理端上。后面的服务器上什么都不用装。
- 没有配置文件：所有设置都在面板中完成，代理端只保存服务器密钥。
- 没有权限插件时，Velocity 不给玩家任何权限，所以 `/kordon` 命令的使用权限要通过 LuckPerms 授予。
- 有多个代理端时，每个代理端都要安装插件。Kordon 检测其中多少个代理端取决于你的套餐。

## 准备工作

[Minecraft 反 VPN 插件 Kordon AntiVPN](https://kordonlabs.com/zh) 支持代理端接受的所有客户端版本，从 1.8 到最新版本。除了检测 VPN，它还能用攻击模式帮代理端挡住一波波机器人，所有套餐都可以使用攻击模式。

Velocity 3.4 或更高版本；4.x 分支也可以。Java 21 或更高版本。Velocity 4 本身就要求 Java 25，所以只要你的代理端能启动，Kordon 也能启动。

如果安装后控制台显示 `UnsupportedClassVersionError`，说明代理端运行在旧版 Java 上，你需要更新 Java。

Kordon 会自动识别通过 Geyser 和 Floodgate 进服的基岩版玩家。你不需要为他们做任何设置。

## 安装

1. [注册账号](https://panel.kordonlabs.com/register)，并在面板中添加你的服务器。
2. 打开服务器的**插件**页面，下载 `Kordon.jar`。你的服务器密钥已经写入这个文件。
3. 把文件放进 `velocity.toml` 旁边的 `plugins` 文件夹。
4. 完全重启 Velocity，然后查看控制台。

插件连接成功后，控制台会打印一行信息，包括服务器名称、模式，以及 Kordon 不可用时的处理方式。新服务器默认处于观察模式：

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

大约一分钟后，面板会显示“插件在线”。

如果你从 SpigotMC 或 Hangar 下载的是通用版 `Kordon.jar`，里面没有密钥。请在代理端控制台用命令连接。密钥同样在**插件**页面，不需要重启：

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

> 不要在 `plugins` 文件夹里同时放两个 Kordon 文件，例如旧版和新版。它们会冲突，控制台会在启动时发出警告。

## 权限和命令

在安装权限插件（通常是 LuckPerms）之前，Velocity 不给玩家任何权限。要让管理员使用 Kordon 命令，请给他 `kordon.command`，再加上他需要的命令对应的权限：

```
/lpv user Steve permission set kordon.command true
/lpv user Steve permission set kordon.command.whitelist true
/lpv user Steve permission set kordon.command.lookup true
/lpv user Steve permission set kordon.notify true
```

各命令的作用：

- `/kordon status` 显示与 Kordon 的连接状态、防护模式和在线人数；
- `/kordon lookup <nickname>` 显示 Kordon 掌握的玩家信息；要查看和搜索 IP，管理员还需要 `kordon.command.lookup.ip`；
- `/kordon whitelist add` 和 `/kordon blacklist add` 把昵称、IP 或 IP 段加入名单，可选期限为 `1d`、`7d`、`30d` 或 `never`；
- `kordon.notify` 权限会开启 Kordon 在聊天中发送的管理员通知。

`kordon.command` 不包括 `/kordon link`，这条命令请留给所有者。代理端控制台可以执行所有命令。在 Velocity 上，所有玩家都能在聊天中看到 `/kordon` 的命令提示，但没有权限就无法执行。如果你完全不想要游戏内命令，可以在面板“插件”下的“游戏内命令”中关闭。这个开关也会关闭控制台中的名单和查询命令。

## 多个代理端

大型群组服会在负载均衡器后面运行多个 Velocity 实例。在每个代理端上安装插件，使用同一个文件和同一个密钥。每个代理端会自动出现在面板“插件”部分的“代理端”标签页中。七天没有发送信号的代理端会从列表中消失。

Kordon 检测多少个代理端取决于你的[套餐](https://kordonlabs.com/zh#pricing)：免费套餐一个，更高的套餐更多。超出上限的代理端会在面板中标出，Kordon 不为它提供服务：那里的插件按“检测不可用时”设置决定是否放行玩家，默认不放行。由你选择哪些代理端计入上限。

## Kordon 不可用时

插件最多等 Kordon 响应三秒钟。没有收到响应时怎么处理，由“检测不可用时”设置决定。默认情况下，无法检测的玩家不能进服。你可以改为“全部放行”。已经在游戏中的玩家不受影响。有一个例外：代理端刚启动后，在 Kordon 第一次响应之前，插件会放行所有人。

## 常见控制台消息

- `Kordon is not linked to a server`：没有密钥，玩家进服时不经检测。用 `/kordon link <key>` 连接插件，或从你自己的**插件**页面下载文件。
- `The Kordon panel does not accept this server's key`：密钥已重新生成，或服务器已被删除。请在面板中获取新密钥。
- `Kordon did not answer`：Kordon 未在三秒内响应。该玩家已按“检测不可用时”设置处理。
- `Kordon.jar was replaced while the proxy was running`：文件在代理端运行时被替换。请重启代理端。
- `A new Kordon version ... is available`：有新版本可用。请在面板中下载。

接下来，选择防护等级，并在观察模式下看看 Kordon 本来会拦截哪些玩家。[如何拦截 VPN 和代理](https://kordonlabs.com/zh/guides/block-vpn-minecraft-server)这篇指南介绍了具体做法。

## 在你的服务器上试试

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

## 更多指南

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