IP転送と「Unable to authenticate」
プロキシがプレイヤーのアドレスをバックエンドへ渡す理由、転送モード、キーの設定方法、認証エラーの分析について説明します。
更新日 2026年8月13日
IP転送を行わない場合、バックエンドサーバーはすべてのプレイヤーを単一のアドレス、つまりプロキシのアドレスとして認識します。IPに依存するすべての機能が壊れます。BAN、制限、アンチボット、統計などです。
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を設定します。
Unable to authenticateエラー
キーまたはモードが一致しない場合に表示されます:
- プロキシ側とバックエンド側でキーが異なる(余分なスペース、改行)。
- バックエンドで
proxies.velocity.enabledが有効になっていない。 - プロキシのモードが
legacyだが、バックエンドはmodernを期待している。 - バックエンドでmodernフォワーディングを使用しているのに
online-mode=trueになっている。
セキュリティ
バックエンドのonline-mode=falseが安全なのは、直接アクセスが遮断されている場合のみです。そうでなければ、誰でも他人のニックネームで直接参加できてしまいます。Millidaでは、ネットワークのバックエンドに外部から到達することはできません — サーバーネットワーク。
Minecraftホスティングオフラインでもサーバーが稼働サーバーを作成
