IP 转发和“Unable to authenticate”
为什么代理会将玩家地址传递给后端、转发模式、如何配置密钥,以及认证错误分析。
更新于 2026年8月13日
如果不启用 IP 转发,后端服务器会把所有玩家都视为同一个地址——即代理的地址。所有依赖 IP 的功能都会失效:封禁、限制、防机器人、统计。
Velocity 模式
| 模式 | 适用场景 |
|---|---|
modern | Paper 1.13+——推荐 |
legacy | 兼容旧版 BungeeCord |
bungeeguard | 带保护插件的 Bungee |
none | 仅用于测试 |
配置 modern 模式
在代理端:
player-info-forwarding-mode = "modern"
forwarding-secret-file = "forwarding.secret"
在每个后端(Paper)的 config/paper-global.yml 中:
proxies:
velocity:
enabled: true
online-mode: true
secret: "same_key"
并在后端的 server.properties 中设置 online-mode=false。
无法验证身份错误
当密钥或模式不匹配时会出现此错误:
- 代理端与后端的密钥不一致(多余的空格、换行)。
- 后端未启用
proxies.velocity.enabled。 - 代理模式为
legacy,但后端期望modern。 - 后端在 modern 转发下设置了
online-mode=true。
安全
只有当直接访问被关闭时,后端设置 online-mode=false 才是安全的:否则任何人都能以他人的昵称直接加入。在 Millida 中,网络的后端无法从外部访问——服务器网络。
Minecraft 托管您离线时服务器仍在运行创建服务器
