如何为 Minecraft 服务器网络搭建 Velocity 代理

为什么要搭建 Minecraft 服务器网络，以及 Velocity 如何工作

服务器网络让你可以在同一个地址下并行运行不同的游戏模式，为每个模式配置独立的插件和资源，并且重启其中一台服务器时不会把其他服务器上的玩家踢下线。

玩家始终只连接代理。代理通过 Mojang 完成登录验证，然后把玩家转交给某一台后端服务器——也就是存放世界的普通 Paper 服务器。当玩家输入 /server survival 时，Velocity 会把他转移到另一台后端，而不会断开连接。

• 代理非常轻量：它不承载任何世界，所需内存远少于游戏服务器。
• 后端服务器以离线模式运行，依赖代理告诉它们每位玩家的身份。你需要保护的正是这种信任。
• Velocity 4 是当前版本，需要 Java 25，支持从 1.7.2 到最新版本的 Minecraft。

安装 Velocity

1. 从 papermc.io 下载 Velocity 到一个空文件夹。
2. 使用 Java 25 启动一次：

java -Xms512M -Xmx512M -jar velocity.jar

首次启动会生成 velocity.toml 和一个包含随机密钥的 forwarding.secret 文件。用 end 停止代理，然后打开配置文件。

配置 velocity.toml

搭建第一个网络时需要关注的设置：

bind = "0.0.0.0:25565"
motd = "<#09add3>My Network"
online-mode = true
player-info-forwarding-mode = "modern"
forwarding-secret-file = "forwarding.secret"

[servers]
lobby = "203.0.113.10:25566"
survival = "203.0.113.11:25567"
try = ["lobby"]

• bind——玩家连接的地址和端口。
• player-info-forwarding-mode——设为 modern。默认值是 none，会给每位玩家分配离线 UUID；legacy 是旧的 BungeeCord 格式，只适用于 1.12 及更早版本的服务器。
• [servers]——每台后端的名称和地址。玩家使用 /server 时输入的就是这个名称。
• try——玩家登录时进入的服务器，以及被某台后端踢出时转往的服务器。

[forced-hosts] 下的 Forced hosts 可以根据玩家输入的地址把他们送到指定后端——例如 survival.yourserver.com 直接进入生存服。

为 modern forwarding 配置 Paper 后端

在每台 Paper 后端上做三处修改，然后重启：

1. server.properties: online-mode=false——现在由代理负责 Mojang 登录验证。
2. spigot.yml: settings.bungeecord: false。
3. config/paper-global.yml:

proxies:
  velocity:
    enabled: true
    online-mode: true
    secret: 'paste the contents of forwarding.secret here'

这里的 online-mode 必须与 velocity.toml 一致，secret 必须与代理的 forwarding.secret 中的文本完全相同。Modern forwarding 适用于 Minecraft 1.13 及更新版本；Spigot 服务器不支持它，所以请使用 Paper 或 Paper 的分支。

其他后端：Fabric 服务器使用 FabricProxy-Lite 模组并配置相同的密钥，1.20.2 以上的 Forge 服务器需要 ProxyCompatibleForge。BungeeCord 插件无法在 Velocity 上运行。

保护好后端服务器

离线模式的服务器会接受任何玩家名称。只有当玩家无法绕过代理直接访问后端时，这才是安全的。

• Modern forwarding 是你的主要防护。启用了 Velocity forwarding 的 Paper 后端会拒绝任何直接连接的人：没有来自代理的签名数据，登录会被拒绝，并显示 This server requires you to connect with Velocity。
• 妥善保管密钥。任何拿到 forwarding.secret 的人都可以冒充你的代理。切勿公开它；一旦泄露，请在所有地方更换。
• 尽可能为后端配置防火墙。Velocity 官方文档明确指出，modern forwarding 不能替代防火墙。如果代理和后端在同一台机器上，请把每台后端绑定到 127.0.0.1，并以 127.0.0.1:port 的形式列出。
• 切勿让后端在关闭 forwarding 的情况下以离线模式运行。那样任何人都能以任何身份加入，包括以管理员身份。

在 HytHost 上运行 Velocity 网络

网络中的每个部分都是一台独立的服务器：一台用作代理，每个后端各一台。代理所需内存很少，最小的套餐就够用；后端则根据其世界和玩家数量在 Minecraft 主机 页面选择规格。

1. 把一台服务器变成代理。在它的 Version 选项卡中选择 Velocity。面板会自动安装，并把 bind 设置为该服务器自己的端口。请在 Startup 选项卡中确认已选择 Java 25。
2. 自行设置 modern forwarding。面板会写入一个基础的 velocity.toml，其中服务器列表为空。在文件管理器中设置 player-info-forwarding-mode = "modern"，并在 [servers] 下添加你的后端，填写每台后端在其面板中显示的地址和端口。
3. 按照上面 Paper 一节的说明配置每台后端，使用代理的 forwarding.secret。
4. 将域名指向代理，只把这个地址提供给玩家。

每台后端都有自己的公网地址，因此阻止直接加入靠的正是 modern forwarding——不要让后端在关闭 forwarding 的情况下以离线模式运行。若要在整个网络中统一权限，请在每台服务器上运行 LuckPerms，并共用一个 MySQL 数据库；每个套餐都包含数据库。