Wie richten Sie ein Minecraft-Servernetzwerk mit Velocity und BungeeCord ein?
In dieser Anleitung richten Sie ein Proxy-Netzwerk ein, das mehrere Minecraft-Server wie eine Lobby (in der die Spieler warten), Survival und Minigames unter einer einzigen IP-Adresse zusammenführt. Sie konfigurieren Schritt für Schritt Velocity, die moderne Wahl, sehen, wie Sie dasselbe Netzwerk mit BungeeCord aufbauen, und sichern mit Firewall-Regeln den kritischsten Punkt ab: dass die Backend-Server nur über den Proxy erreichbar sind.
Bevor Sie beginnen
- Ein VDS: Das Beispiel-Startskript von PaperMC gibt Velocity 1 GB Arbeitsspeicher. Da aber jeder Backend-Server ein eigener Java-Prozess ist, planen Sie für ein Netzwerk aus drei Servern wie Lobby, Survival und Minigames mindestens 8 GB RAM ein. Die Familie AMD Ryzen 9 9950X VDS bietet Optionen mit 2–64 GB DDR5-RAM; alle Optionen finden Sie auf der Seite Minecraft-Server.
- Java: Velocity benötigt mindestens Java 25, aktuelle BungeeCord-Builds mindestens Java 17. Eine einzige Java-25-Installation deckt beide Proxys sowie aktuelle Paper-Versionen ab.
- Mindestens zwei laufende Paper-Server: Wenn Sie noch keinen Server haben, beginnen Sie mit der Anleitung Minecraft-Server von Grund auf einrichten; weitere Themen finden Sie auf der Seite Minecraft-Anleitungen. Das Modern Forwarding von Velocity ist ab Paper 1.14 integriert; Spigot unterstützt es nicht.
- Serverzugang: Mit einem Linux-VDS verbinden Sie sich per SSH (22), mit einem Windows-VDS per RDP (3389). Die Firewall verwalten Sie selbst innerhalb des Betriebssystems.
- Sicherheitsbewusstsein: In einem Proxy-Netzwerk laufen die Backend-Server mit
online-mode=false; wenn Sie Schritt 6 überspringen, kann jeder unter einem beliebigen Spielernamen direkt einem Backend-Server beitreten.
Beide Proxys erfüllen dieselbe Aufgabe; der Unterschied liegt im Sicherheitsmodell und im Plugin-Ökosystem.
| Merkmal | Velocity | BungeeCord |
|---|---|---|
| Entwickler | PaperMC | SpigotMC |
| Java-Voraussetzung | Mindestens Java 25 | Mindestens Java 17 |
| Standardport | 25565 | 25577 |
| Konfigurationsdatei | velocity.toml | config.yml |
| Weiterleitung der Spielerdaten | modern (mit geheimem Schlüssel), legacy, bungeeguard | ip_forward (ohne Schlüssel; ein Schlüssel erfordert das Plugin BungeeGuard) |
| Plugins | Eigene Plugin-API; BungeeCord-Plugins funktionieren nicht | BungeeCord-Plugins |
| Empfehlung | Neue Installationen | Wenn Sie auf ein BungeeCord-Plugin angewiesen sind, auf das Sie nicht verzichten können |
1. Netzwerk und Ports planen
Das Prinzip eines Proxy-Netzwerks ist einfach: Die Spieler verbinden sich nur mit dem Port des Proxys, und der Proxy leitet sie an die Backend-Server weiter. Der Port des Proxys sollte der einzige nach außen offene Port sein; die Backend-Server sollten nur auf der lokalen Adresse 127.0.0.1 lauschen.
| Komponente | Lauschadresse | Port | Aus dem Internet erreichbar? |
|---|---|---|---|
| Proxy (Velocity oder BungeeCord) | 0.0.0.0 (die IP des VDS) | 25565 TCP | Ja |
| lobby | 127.0.0.1 | 25566 TCP | Nein |
| survival | 127.0.0.1 | 25567 TCP | Nein |
| minigames | 127.0.0.1 | 25568 TCP | Nein |
Die Portnummern sind Beispiele; die Standardkonfiguration von Velocity verwendet die Ports 30066–30068, und jeder freie Port ist geeignet. Legen Sie jeden Server in einen eigenen Ordner, zum Beispiel /opt/mc/proxy, /opt/mc/lobby unter Linux und C:\mc\proxy, C:\mc\lobby unter Windows. Die Adresse, die Sie den Spielern geben, ist die IP des VDS oder ein Domainname, den Sie darauf zeigen lassen; da 25565 der Standardport ist, müssen die Spieler keinen Port eingeben.
2. Java installieren
PaperMC empfiehlt die Distribution Amazon Corretto 25. Führen Sie unter Ubuntu/Debian diese Befehle der Reihe nach aus:
sudo apt-get update
sudo apt-get install ca-certificates apt-transport-https gnupg wget
wget -O - https://apt.corretto.aws/corretto.key | sudo gpg --dearmor -o /usr/share/keyrings/corretto-keyring.gpg && \
echo "deb [signed-by=/usr/share/keyrings/corretto-keyring.gpg] https://apt.corretto.aws stable main" | sudo tee /etc/apt/sources.list.d/corretto.list
sudo apt-get update
sudo apt-get install -y java-25-amazon-corretto-jdk libxi6 libxtst6 libxrender1
Laden Sie unter Windows das Installationsprogramm Amazon Corretto 25 x64 Windows JDK herunter (https://corretto.aws/downloads/latest/amazon-corretto-25-x64-windows-jdk.msi) und installieren Sie es mit den Standardoptionen. Öffnen Sie auf beiden Systemen ein neues Terminal und prüfen Sie die Installation:
java -version
Die erste Zeile der Ausgabe sollte mit openjdk version "25 beginnen, und die letzte Zeile sollte 64-Bit enthalten. Verwenden Sie keine Java-Pakete mit -headless im Namen; PaperMC rät davon ab.
3. Backend-Server (Paper) vorbereiten
Öffnen Sie im Ordner jedes Backend-Servers die Datei server.properties und passen Sie drei Zeilen gemäß Ihrer Planung an (Beispiel für lobby):
server-port=25566
server-ip=127.0.0.1
online-mode=false
online-mode=false ist erforderlich, weil die Authentifizierung der Mojang-Konten jetzt der Proxy übernimmt und der Backend-Server keine zweite Authentifizierung durchführen kann. server-ip=127.0.0.1 macht den Server nur innerhalb desselben Rechners erreichbar; die Sicherheitsseite von PaperMC empfiehlt diese Methode, wenn alle Server auf einem Rechner laufen.
Die Übergabe der echten IP und UUID des Spielers vom Proxy an den Backend-Server nennt man IP-Forwarding. Damit das funktioniert, müssen Sie auch auf dem Backend-Server die Einstellung aktivieren, die zu Ihrem Proxy-Typ passt.
Für Velocity (Modern Forwarding) füllen Sie auf jedem Backend-Server den Abschnitt proxies der Datei config/paper-global.yml wie folgt aus:
proxies:
velocity:
enabled: true
online-mode: true
secret: "CONTENTS-OF-THE-forwarding.secret-FILE"
Der Wert secret muss exakt dem Inhalt der Datei forwarding.secret entsprechen, die in Schritt 4 im Proxy-Ordner erzeugt wird, und der Wert online-mode muss mit online-mode in velocity.toml übereinstimmen. Stellen Sie außerdem sicher, dass in der Datei spigot.yml die Einstellung settings.bungeecord auf false bleibt. Die Forwarding-Modi werden auf der PaperMC-Seite zur Weiterleitung der Spielerdaten ausführlich erklärt.
Für BungeeCord setzen Sie dagegen in der Datei spigot.yml settings.bungeecord: true und lassen in config/paper-global.yml den Wert proxies.bungee-cord.online-mode gleich der Einstellung online_mode Ihres Proxys (true). Die Installationsseite von SpigotMC verlangt außerdem, connection-throttle in bukkit.yml auf -1 zu setzen. Aktivieren Sie nicht beide Forwarding-Methoden gleichzeitig; bleibt bungeecord: true eingeschaltet, während Velocity Modern Forwarding verwendet, können sich die Spieler nicht anmelden.
Starten Sie anschließend jeden Backend-Server neu.
4. Velocity installieren und konfigurieren
Laden Sie die neueste stabile Velocity-Version von https://papermc.io/downloads/velocity herunter und legen Sie sie in den Proxy-Ordner; die offizielle Installationsanleitung finden Sie auf der Einstiegsseite von PaperMC zu Velocity. Erstellen Sie unter Linux eine Datei start.sh mit den von PaperMC empfohlenen Flags:
#!/bin/sh
java -Xms1G -Xmx1G -XX:+UseG1GC -XX:G1HeapRegionSize=4M -XX:+UnlockExperimentalVMOptions -XX:+ParallelRefProcEnabled -XX:+AlwaysPreTouch -XX:MaxInlineLevel=15 -jar velocity*.jar
Machen Sie das Skript unter Linux mit chmod u+x start.sh ausführbar und starten Sie es mit ./start.sh. Schreiben Sie unter Windows der Reihe nach Folgendes in eine Datei start.bat: @echo off, dieselbe java-Zeile, aber mit der Endung -jar velocity.jar, und pause; benennen Sie außerdem die heruntergeladene Datei in velocity.jar um. Beim ersten Start werden die Dateien velocity.toml und forwarding.secret erzeugt; sobald Sie in der Konsole Listening on ...:25565 und danach die Zeile Done sehen, geben Sie shutdown ein, um den Proxy zu stoppen.
Bearbeiten Sie nun die Datei velocity.toml. Die wichtigen Zeilen:
bind = "0.0.0.0:25565"
motd = "<#09add3>Your Network Name"
show-max-players = 500
online-mode = true
player-info-forwarding-mode = "modern"
forwarding-secret-file = "forwarding.secret"
[servers]
lobby = "127.0.0.1:25566"
survival = "127.0.0.1:25567"
minigames = "127.0.0.1:25568"
try = [
"lobby"
]
[forced-hosts]
"survival.example.com" = [
"survival"
]
Bedeutung der Zeilen:
bind: Adresse und Port, auf denen der Proxy lauscht;0.0.0.0bedeutet, dass auf allen IPs des VDS gelauscht wird.online-mode = true: Die Spieler werden bei Mojang authentifiziert. Wenn Sie den Wert auffalsesetzen, öffnen Sie das gesamte Netzwerk für Cracked-Accounts.player-info-forwarding-mode = "modern": Die echte IP und UUID des Spielers werden mit dem geheimen Schlüssel signiert und an den Backend-Server weitergeleitet. Der Standardwert ist"NONE"; ändern Sie diese Zeile daher unbedingt.forwarding-secret-file: Die Datei mit dem geheimen Schlüssel. Die Datei muss UTF-8-kodiert und darf nicht leer sein; kopieren Sie ihren Inhalt in das Feldsecretaus Schritt 3 und geben Sie ihn an niemanden weiter.[servers]undtry: Die Server im Netzwerk sowie die Server, die der Reihe nach versucht werden, wenn ein Spieler beitritt oder von einem Server gekickt wird. Setzen Sie die Lobby an die erste Stelle.[forced-hosts]: Leitet einen Spieler, der sich über einen bestimmten Domainnamen verbindet, direkt auf den zugehörigen Server; optional.
Speichern Sie die Datei und starten Sie den Proxy neu. Später können Sie die Konfiguration mit /velocity reload neu laden, entweder in der Konsole oder im Spiel mit einem Konto, das die Berechtigung velocity.command.reload besitzt; enthält die Datei einen Syntaxfehler, übernimmt der Befehl keine Änderungen.
5. Alternative: dasselbe Netzwerk mit BungeeCord aufbauen
Wenn Sie sich für BungeeCord entschieden haben, laden Sie den neuesten Build von dem Build-Server herunter, der auf der BungeeCord-Installationsseite von SpigotMC verlinkt ist (https://ci.md-5.net/job/BungeeCord/), und legen Sie ihn als BungeeCord.jar in den Proxy-Ordner. Startskript (Linux):
#!/bin/sh
cd "$( dirname -- "$0" )"
java -Xms512M -Xmx512M -jar BungeeCord.jar
Schreiben Sie unter Windows der Reihe nach diese Zeilen in eine Datei start.bat: @echo off, java -Xms512M -Xmx512M -jar BungeeCord.jar und pause. Beim ersten Start wird config.yml erzeugt; passen Sie die wichtigen Abschnitte gemäß Ihrer Planung an:
online_mode: true
ip_forward: true
listeners:
- host: 0.0.0.0:25565
query_port: 25565
motd: '&1Your Network Name'
max_players: 500
priorities:
- lobby
force_default_server: false
servers:
lobby:
address: 127.0.0.1:25566
restricted: false
survival:
address: 127.0.0.1:25567
restricted: false
minigames:
address: 127.0.0.1:25568
restricted: false
Die Zeile ip_forward: true ist Pflicht: Laut SpigotMC führen online-mode-UUIDs, Namensänderungen und IP-Banns bei ausgeschalteter Einstellung zu gravierenden Dateninkonsistenzen. Der Standardport ist 25577; wir haben den Wert host auf 25565 gesetzt, damit die Spieler keinen Port eingeben müssen. priorities entspricht der try-Liste von Velocity; einem Server mit restricted: true können nur Spieler mit der Berechtigung bungeecord.server.<servername> beitreten.
Das Forwarding von BungeeCord arbeitet ohne geheimen Schlüssel; für zusätzlichen Schutz kann das Plugin BungeeGuard verwendet werden. Die Firewall aus Schritt 6 ist bei BungeeCord noch wichtiger.
6. Backend-Server nur vom Proxy aus erreichbar machen
Da die Backend-Server mit online-mode=false laufen, kann sich ohne Zugriffsbeschränkung jemand auf Ihrem Server als beliebiger Spieler ausgeben, das Team eingeschlossen. Der geheime Schlüssel beim Modern Forwarding ist eine zweite Schutzschicht, ersetzt aber keine Firewall. Es gibt zwei Fälle.
Alle Server auf demselben VDS: Dank der Einstellung server-ip=127.0.0.1 aus Schritt 3 sind die Backend-Server aus dem Internet nicht sichtbar; aktivieren Sie trotzdem die Firewall und erlauben Sie nur die benötigten Ports. Unter Ubuntu (erlauben Sie zuerst den SSH-Port, sonst sperren Sie sich aus):
sudo ufw allow 22
sudo ufw allow 25565
sudo ufw enable
sudo ufw status verbose
Öffnen Sie unter Windows Server den Proxy-Port mit PowerShell; die Windows-Firewall blockiert andere eingehende Verbindungen bereits standardmäßig:
New-NetFirewallRule -DisplayName "Minecraft proxy 25565" -Direction Inbound -Protocol TCP -LocalPort 25565 -Action Allow
Backend-Server auf einem separaten VDS: Lassen Sie auf diesem Rechner die Zeile server-ip leer und erlauben Sie den Port des Backend-Servers in der Firewall nur von der IP des Proxys. In diesem Beispiel lautet die IP des Proxys 203.0.113.10:
sudo ufw allow 22
sudo ufw allow proto tcp from 203.0.113.10 to any port 25566
sudo ufw enable
New-NetFirewallRule -DisplayName "Lobby proxy only" -Direction Inbound -Protocol TCP -LocalPort 25566 -RemoteAddress 203.0.113.10 -Action Allow
Unter Windows kann die Firewall beim ersten Start von Java eine Berechtigungsabfrage anzeigen. Erteilen Sie in dieser Abfrage auf dem VDS des Backend-Servers keinen Zugriff; sonst wird für java.exe eine Zulassungsregel ohne Portbeschränkung angelegt, und die obige Beschränkung wird wirkungslos. Tragen Sie auf der Proxy-Seite in velocity.toml oder config.yml die Adresse dieses Servers mit der echten IP des Backend-VDS statt 127.0.0.1 ein.
7. Testen
Starten Sie zuerst die Backend-Server, dann den Proxy. Checkliste:
- Prüfen Sie in der Proxy-Konsole, ob die Zeile
Listening onPort 25565 anzeigt. - Verbinden Sie sich im Minecraft-Client mit der IP des VDS (ohne Portangabe); Sie sollten in der Lobby landen.
- Geben Sie im Spiel
/server survivalein; der Server sollte wechseln. In Velocity steht/serverallen offen;/glist allzeigt die Spielerliste pro Server und erfordert eine Berechtigung. - Prüfen Sie in der Lobby-Konsole die Beitrittszeile des Spielers: Die IP sollte die echte Adresse des Spielers sein, nicht
127.0.0.1; andernfalls funktioniert das Forwarding nicht. - Versuchen Sie, sich von außen direkt mit
IP:25566zu verbinden. Die Verbindung sollte abgelehnt werden oder in ein Timeout laufen; kommen Sie hinein, kehren Sie zu Schritt 6 zurück.
Übersicht der Einstellungen
Die Einstellungen, die Sie bei einer Velocity-Installation auf einem einzelnen VDS geändert haben:
| Datei | Einstellung | Wert |
|---|---|---|
velocity.toml | bind | "0.0.0.0:25565" |
velocity.toml | online-mode | true |
velocity.toml | player-info-forwarding-mode | "modern" |
velocity.toml | [servers] | lobby = "127.0.0.1:25566" usw. |
server.properties (jeder Backend-Server) | server-ip / online-mode | 127.0.0.1 / false |
config/paper-global.yml | proxies.velocity.enabled / online-mode / secret | true / true / Inhalt von forwarding.secret |
spigot.yml | settings.bungeecord | false (true bei BungeeCord) |
Häufige Fehler
- Der Spieler landet nicht in der Lobby und erhält einen Verbindungsfehler: Der Backend-Server ist nicht gestartet, lauscht auf dem falschen Port, oder die Adresse unter
[servers]ist falsch; prüfen Sie Adresse und Port in der Konsole des Backend-Servers. - Der Paper-Backend-Server kickt Spieler mit „Unable to verify player details“: Der Wert
secretinpaper-global.ymlstimmt nicht exakt mit der Dateiforwarding.secretüberein. Kopieren Sie den Wert aus der Datei, statt ihn von Hand einzugeben; achten Sie auf Unterschiede bei Leerzeichen und Zeilenenden. - Die Meldung „This server requires you to connect with Velocity.“: Auf dem Backend-Server ist Modern Forwarding aktiv, aber der Proxy leitet nicht weiter; prüfen Sie, ob
velocity.tomldie Zeileplayer-info-forwarding-mode = "modern"enthält. Diese Meldung sieht auch jemand, der den Proxy umgeht und sich direkt mit dem Backend-Server verbindet; ist das Backend von außen erreichbar, prüfen Sie die Regeln aus Schritt 6. - Spigot/Paper meldet „If you wish to use IP forwarding, please enable it in your BungeeCord config as well!“: In
spigot.ymlistbungeecord: trueaktiv, aber der Proxy leitet nicht weiter. Setzen Sie bei BungeeCordip_forward: true; wenn Sie Velocity mit Modern Forwarding verwenden, setzen Siebungeecordauffalse. - Inventare und Fortschritt der Spieler wurden zurückgesetzt: Solange das Forwarding aus ist oder sich die
online-mode-Werte von Proxy und Backend-Server unterscheiden, wird der Spieler mit einer anderen UUID erkannt. Gleichen Sie die Werte an; alte Daten stellen Sie aus einem Backup wieder her. - Der Proxy startet nicht, mit
UnsupportedClassVersionErroroder dem Fehler „requires Java 17 or above“: Die Java-Version ist zu alt. Velocity benötigt mindestens Java 25 und BungeeCord mindestens Java 17; prüfen Sie dies mitjava -version. - Die SSH-Verbindung brach nach dem Aktivieren der Firewall ab: Port 22 wurde vor
ufw enablenicht erlaubt. Verbinden Sie sich über die VNC-Konsole im Kundenbereich und führen Siesudo ufw allow 22aus.
Häufig gestellte Fragen
Sollte ich Velocity oder BungeeCord wählen?
Wenn Sie ein neues Netzwerk aufbauen, wählen Sie Velocity: Es bringt Modern Forwarding mit geheimem Schlüssel von Haus aus mit und wird vom PaperMC-Team entwickelt. Wählen Sie BungeeCord nur, wenn Sie auf ein BungeeCord-Plugin ohne Velocity-Entsprechung angewiesen sind.
Erlaubt online-mode=false auf den Backend-Servern Cracked-Logins?
Nicht, solange der Proxy auf online-mode = true steht; die Authentifizierung übernimmt der Proxy. Das Risiko ist jemand, der einen Backend-Server direkt erreichen kann. Deshalb sollten Sie das Netzwerk nicht ohne server-ip=127.0.0.1 und Firewall-Regeln in Betrieb nehmen.
Wie viele Backend-Server kann ich auf einem VDS betreiben?
RAM und CPU setzen die Grenze: Planen Sie 1 GB für den Proxy und mindestens 2 GB für jeden Paper-Server ein und lassen Sie Reserven für das Betriebssystem. Den Arbeitsspeicher weisen Sie jedem Server über den Wert -Xmx in seinem Startskript zu; Einzelheiten finden Sie in der Anleitung zur RAM-Zuweisung.
Wie erzeuge ich die Datei forwarding.secret?
Velocity legt diese Datei beim ersten Start im Proxy-Ordner an. Wenn Sie den Inhalt ändern möchten, schreiben Sie eine einzelne Zeile mit nicht vorhersehbarem Text hinein; die Datei muss UTF-8-kodiert und darf nicht leer sein. Wenn Sie sie ändern, tragen Sie denselben Wert auch in die Datei paper-global.yml jedes Backend-Servers ein und starten Sie alle neu.
Verwandte Anleitungen
- Minecraft-Server von Grund auf einrichten: Paper unter Windows und Linux
- Vanilla, Spigot, Paper, Purpur und Folia: Welche Software sollten Sie wählen?
- Ports auf einem Minecraft-Server öffnen (25565, 19132, Proxy)
- RAM für den Minecraft-Server zuweisen: Xms, Xmx und Aikar's Flags
- Port auf einem VDS öffnen: Windows-Firewall, ufw und firewalld
Kommentare0
Noch keine Kommentare
Schreiben Sie den ersten Kommentar und teilen Sie Ihre Gedanken.
Bitte melden Sie sich an oder registrieren Sie sich, um einen Kommentar zu hinterlassen.