Skip to content
托管 · 服务器网络与域名

IP 转发和“Unable to authenticate”

为什么代理会将玩家地址传递给后端、转发模式、如何配置密钥,以及认证错误分析。

更新于 2026年8月13日

如果不启用 IP 转发,后端服务器会把所有玩家都视为同一个地址——即代理的地址。所有依赖 IP 的功能都会失效:封禁、限制、防机器人、统计。

Velocity 模式

模式适用场景
modernPaper 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。

无法验证身份错误

当密钥或模式不匹配时会出现此错误:

  1. 代理端与后端的密钥不一致(多余的空格、换行)。
  2. 后端未启用 proxies.velocity.enabled。
  3. 代理模式为 legacy,但后端期望 modern。
  4. 后端在 modern 转发下设置了 online-mode=true。

安全

只有当直接访问被关闭时,后端设置 online-mode=false 才是安全的:否则任何人都能以他人的昵称直接加入。在 Millida 中,网络的后端无法从外部访问——服务器网络。

Minecraft 托管您离线时服务器仍在运行创建服务器