Minecraft-Server auf einem VPS hosten: Ubuntu 24.04

Was Sie erstellen

Einen dauerhaft laufenden Minecraft-Java-Edition-Server: Paper auf Ubuntu 24.04, ausgeführt als dedizierter minecraft-Benutzer unter systemd mit Restart=on-failure, aktivierter Whitelist und geöffnetem Port 25565 in beiden Firewalls zwischen Ihren Spielern und der JVM. Backups werden so erstellt, dass die Welt, die sie schützen sollen, nicht beschädigt wird. Der Server selbst besteht aus einer JAR-Datei und einem java-Befehl. Alles, was einen Server, auf dem Ihre Freunde ein Jahr spielen können, von einem Server unterscheidet, der am ersten Wochenende ausfällt, betrifft diesen Befehl. Darum geht es in diesem Leitfaden.

Zwei wichtige Hinweise, bevor Sie Geld ausgeben. Erstens benötigt Minecraft viel Arbeitsspeicher und verwendet überwiegend einen einzelnen Thread. Ein VPS mit 1 GB RAM kann keinen spielbaren Server ausführen. Ein schneller Kern ist besser als vier langsame. Zweitens geht es hier um die Java Edition. Bedrock-Spieler, Konsolen, Smartphones und die Windows-Bedrock-App können keinem Java-Server beitreten. Für Bedrock benötigen Sie eine andere Serversoftware mit UDP auf Port 19132 oder das Geyser-Plugin. Das ist nicht Bestandteil dieses Leitfadens.

Sie benötigen einen frischen Ubuntu-24.04-KVM-VPS mit root- oder sudo-Zugriff sowie etwa dreißig Minuten.

Sizing: Was ein Server für Freunde tatsächlich benötigt

RAM ist die entscheidende Größe. Die realistischen Werte liegen niedriger, als es die Modpack-Foren nahelegen:

• 2 GB reichen für Vanilla mit 2–5 Spielern bei moderater Sichtweite. Das Spiel ist nutzbar, aber ohne Reserven.
• 4 GB sind die komfortable Größe für einen Server für Freunde: ungefähr zehn gleichzeitig aktive Spieler auf Paper mit einigen Plugins und ausreichend verbleibendem Speicher für das Betriebssystem.
• 8 GB und mehr sind für Modpacks und mehr als 20 Spieler vorgesehen. In diesem Bereich sollten Sie außerdem auf eine hohe Single-Core-CPU-Leistung achten, weil die Hauptspielschleife auf einem Thread läuft.

Die Welt wächst ebenfalls auf dem Datenträger, wenn die Spieler sie erkunden. Eine viel bereiste Survival-Welt erreicht mehrere Gigabyte. Lassen Sie daher Reserven für die Welt und ihre Backups.

Vanilla oder Paper? Paper ist ein direkter Ersatz für die offizielle JAR-Datei: dieselben Welten, dieselben Clients und keine clientseitigen Mods erforderlich. Paper überarbeitet die langsamsten Serverpfade, darunter das Laden von Chunks, die Verarbeitung von Entitäten und Hopper, und stellt eine Plugin-API bereit. Der einzige Grund für den Einsatz von Vanilla sind bitgenaue Vanilla-Mechaniken für technische Redstone-Farmen, die durch die Optimierungen von Paper verändert werden können. Für alle anderen bietet Paper mehr Spieler pro Gigabyte. Alles Folgende funktioniert mit beiden Varianten.

Schritt 1: Java 21 installieren

Minecraft 1.20.5 und alle nachfolgenden Releases, einschließlich aller 1.21.x-Releases, erfordern Java 21. Ubuntu 24.04 stellt Java in den Standard-Repositories bereit. Die headless-Variante lässt Desktop-Bibliotheken weg, die ein Server nicht benötigt:

sudo apt update && sudo apt install -y openjdk-21-jre-headless
java -version

Das erwartete Ergebnis: In der ersten Zeile steht openjdk version "21.0.x". Wenn dort 17 oder 11 steht, ist ein anderes JRE installiert und wird bevorzugt verwendet. Beheben Sie das mit sudo update-alternatives --config java und wählen Sie den Eintrag aus, der java-21 enthält.

Wenn Sie diese Prüfung überspringen, tritt später der am häufigsten gesuchte Fehler bei Minecraft-Servern auf. Mit Java 17 wird die Server-JAR sofort mit folgender Meldung beendet:

Error: LinkageError occurred while loading main class net.minecraft.bundler.Main
	java.lang.UnsupportedClassVersionError: net/minecraft/bundler/Main has been
	compiled by a more recent version of the Java Runtime (class file version 65.0),
	this version of the Java Runtime only recognizes class file versions up to 61.0

Die Versionsnummern zeigen den Versionskonflikt: Die Classfile-Version 65.0 steht für Java 21, 61.0 für Java 17 und 60.0 für Java 16. Unabhängig davon, welches Paar angezeigt wird, ist die Lösung identisch: Installieren Sie das neuere JRE und führen Sie update-alternatives erneut aus.

Schritt 2: ein dedizierter Benutzer, niemals root

Der Server führt Plugin-Code aus und verarbeitet Netzwerkeingaben von jedem, der den Port erreichen kann. Wenn dabei etwas schiefgeht, hat ein Angreifer mit root-Rechten die Kontrolle über Ihren VPS. Mit minecraft beschränkt sich der Schaden auf eine Spielwelt.

sudo adduser --system --group --home /opt/minecraft minecraft

--system erstellt ein Konto ohne Passwort, das sich nicht über SSH anmelden kann. /opt/minecraft wird als Home- und Arbeitsverzeichnis verwendet. Alle weiteren Befehle, die den Server betreffen, werden unter diesem Benutzer ausgeführt.

Schritt 3: Server-JAR aus der offiziellen Quelle herunterladen

Eine Server-JAR sollten Sie ausschließlich an zwei Stellen beziehen: von der offiziellen Server-Downloadseite auf minecraft.net für Vanilla und von der Downloadseite auf papermc.io für Paper. Drittanbieter-„Download-Hubs“, die Server-JARs neu verpacken, sind seit Langem ein Verbreitungsweg für Malware. Eine Server-JAR enthält beliebigen Code, den Sie anschließend rund um die Uhr auf einem aus dem Internet erreichbaren System ausführen.

Kopieren Sie den Download-Link für den aktuellen Build von der offiziellen Seite. Die URL ändert sich mit jeder Version und jedem Build. Ein fest codierter Link würde daher schnell veralten. Führen Sie anschließend Folgendes aus:

cd /opt/minecraft
sudo -u minecraft wget -O server.jar 'PASTE-THE-COPIED-URL-HERE'

Das erwartete Ergebnis ist eine server.jar mit einer Größe von ungefähr 50 MB, die minecraft gehört und mit ls -lh /opt/minecraft/server.jar bestätigt wurde.

Schritt 4: erster Start, die EULA und den eigenen Benutzer als Operator eintragen

Starten Sie den Server einmal interaktiv, bevor Sie systemd konfigurieren. Nur eine aktive Konsole erfüllt beim ersten Start zwei wichtige Aufgaben.

cd /opt/minecraft
sudo -u minecraft java -Xms1G -Xmx1G -jar server.jar nogui

Der Prozess wird innerhalb weniger Sekunden beendet. Paper wendet vorher noch einige zusätzliche Patches an. Anschließend endet das Log mit der Zeile, die bei jedem ersten Start erscheint:

[ServerMain/INFO]: You need to agree to the EULA in order to run the server. Go to eula.txt for more info.

Das ist kein Fehler, sondern eine Lizenzprüfung. Beim Start wurde neben der JAR-Datei eula.txt erstellt. Lesen Sie die verlinkte EULA, falls Sie das noch nicht getan haben. Setzen Sie anschließend das Flag:

sudo -u minecraft sed -i 's/eula=false/eula=true/' /opt/minecraft/eula.txt

Führen Sie denselben java-Befehl erneut aus. Diesmal erstellt der Server die Welt. Beim ersten Start dauert das ein bis zwei Minuten. Danach bleibt er bei folgendem Status:

[Server thread/INFO]: Done (9.204s)! For help, type "help"

Sie haben jetzt eine aktive Konsole. Verwenden Sie sie für die zweite Aufgabe: Geben Sie op YourMinecraftName ein, also Ihren exakten Ingame-Benutzernamen. Der Server trägt Sie in ops.json ein. Dadurch können Sie später, wenn keine Konsole verbunden ist, alle Administrationsbefehle direkt im Spiel ausführen. Geben Sie anschließend stop ein, um den Server zu speichern und ordnungsgemäß zu beenden.

Schritt 5: server.properties und warum online-mode auf true bleibt

Der erste Start hat außerdem server.properties geschrieben. Die meisten Standardwerte sind geeignet. Diese Zeilen sollten Sie bewusst festlegen:

online-mode=true
white-list=true
enforce-whitelist=true
view-distance=8
max-players=10
motd=A private server for people I actually know

online-mode=true veranlasst den Server, jeden Benutzernamen beim Beitritt gegen die Mojang-Sitzungsserver zu prüfen. Dadurch wird bestätigt, dass der Spieler das Konto besitzt. Wenn Sie den Wert auf false setzen, aktivieren Sie den Schalter für einen „Cracked Server“. Der Server übernimmt dann die Identität des Clients ungeprüft. Jeder kann unter einem beliebigen Namen beitreten, auch unter Ihrem. Da Operatorrechte und Whitelists anhand des Namens zugeordnet werden, erhält ein Angreifer dadurch Ihre Operatorrechte. Der einzige legitime Grund für den Wert false ist der Betrieb hinter einem authentifizierenden Proxy wie Velocity, der die Spieler selbst prüft. Auf einem normalen Server bleibt der Wert immer true.

view-distance ist der wichtigste Leistungsregler in dieser Datei. Der Bedarf an CPU und RAM steigt ungefähr mit dem Quadrat dieses Werts. 8 ist ein sinnvoller Standardwert für einen VPS. 10 ist der Vanilla-Standardwert und deutlich ressourcenintensiver.

white-list=true zusammen mit enforce-whitelist=true schließt den Server für fremde Spieler. Warum das nicht optional ist, wird im folgenden Abschnitt zur Sicherheit erläutert. Fügen Sie Spieler im Spiel mit /whitelist add TheirName als Operator hinzu.

Schritt 6: Speicher-Flags und warum -Xms und -Xmx übereinstimmen sollten

Die JVM reserviert ihren Heap zwischen -Xms (Startgröße) und -Xmx (Obergrenze). Auf einem dedizierten Gameserver setzen Sie beide Werte auf denselben Wert. Der Heap erreicht die Obergrenze ohnehin. Ein schrittweises Vergrößern verursacht während des Spielbetriebs nur zusätzliche Aktivität des Garbage Collectors. Auf einer 4-GB-VPS lautet die passende Einstellung:

/usr/bin/java -Xms3G -Xmx3G -jar server.jar nogui

-Xmx ist nicht der gesamte Speicher, den der Prozess verwendet. Die JVM benötigt zusätzlich Off-Heap-Speicher, Thread-Stacks, JIT-Caches und Direct Buffers. Dafür sollten Sie ungefähr ein halbes Gigabyte oder mehr einplanen. Auch Ubuntu benötigt Speicher. Als Faustregel gilt: -Xmx darf höchstens dem VPS-Arbeitsspeicher abzüglich 1 GB entsprechen. Wenn Sie den Wert zu hoch setzen, tritt einer von zwei Fehlern auf. Schlägt die Speicherreservierung bereits beim Start fehl, verweigert der Server den Start mit:

Error: Could not reserve enough space for object heap

Diese Fehlermeldung ist eindeutig und tritt sofort auf. Die problematischere Variante startet zunächst ordnungsgemäß und beendet sich erst Stunden später. Unter Last füllt sich der Heap, und der OOM-Killer des Kernels beendet den größten Prozess auf dem System: die JVM. Im Server-Log erscheint nichts. Die relevanten Informationen finden Sie in sudo dmesg | grep -i oom, zum Beispiel eine Zeile wie Out of memory: Killed process 1234 (java). Wenn Ihr Dienst scheinbar „zufällig“ neu startet, prüfen Sie diese Stelle zuerst und reduzieren Sie -Xmx.

Für Paper dokumentiert das Projekt Aikar's flags. Dabei handelt es sich um eine optimierte G1GC-Konfiguration (-XX:+UseG1GC -XX:MaxGCPauseMillis=200 und ein Dutzend weiterer Flags), die die Pausen der Garbage Collection bei größeren Heaps gleichmäßiger verteilt. Erzeugen Sie die vollständige Zeile anhand der Paper-Dokumentation. Bei einem Heap von 2–4 GB ist der Vorteil gering, die Flags sind jedoch unbedenklich.

Schritt 7: eine systemd-Unit mit Restart=on-failure

Ein manuell gestarteter Server wird mit Ihrer SSH-Sitzung beendet und bleibt nach einem Reboot gestoppt. Schreiben Sie /etc/systemd/system/minecraft.service:

[Unit]
Description=Minecraft server (Paper)
After=network-online.target
Wants=network-online.target

[Service]
User=minecraft
Group=minecraft
WorkingDirectory=/opt/minecraft
ExecStart=/usr/bin/java -Xms3G -Xmx3G -jar server.jar nogui
Restart=on-failure
RestartSec=10
TimeoutStopSec=120

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now minecraft
systemctl status minecraft
journalctl -u minecraft -f

Das korrekte Ergebnis: status zeigt active (running), und das Journal, das nun die Konsolenausgabe des Servers enthält, endet erneut bei der Zeile Done.

Diese Unit enthält zwei bewusste Entscheidungen. Restart=on-failure startet den Server nach einem Absturz neu, aber nicht nach einem sauberen stop, sodass Wartungsarbeiten möglich bleiben. Auch TimeoutStopSec=120 ist wichtiger, als es zunächst wirkt: systemctl stop sendet SIGTERM. Der Minecraft-Server fängt dieses Signal ab und speichert vor dem Beenden jede Welt. Bei einer großen Welt nimmt dieser Speichervorgang Zeit in Anspruch. Das Standard-Timeout von systemd kann die JVM während des Speicherns mit SIGKILL beenden. Genau dadurch werden Region-Dateien beschädigt. Geben Sie dem Vorgang zwei Minuten.

Wenn der Dienst ständig neu startet und das Journal Folgendes zeigt:

[Server thread/WARN]: **** FAILED TO BIND TO PORT!
[Server thread/WARN]: The exception was: io.netty.channel.unix.Errors$NativeIoException: bind(..) failed: Address already in use
[Server thread/WARN]: Perhaps a server is already running on that port?

belegt bereits ein anderer Prozess Port 25565. Fast immer läuft Ihr früherer Start im Vordergrund noch in einer anderen SSH-Sitzung. Finden Sie ihn mit sudo ss -tlnp | grep 25565 und beenden Sie diese Instanz. Starten Sie niemals zwei Server auf demselben Port.

Schritt 8: Port 25565 in beiden Firewalls öffnen

Minecraft Java verwendet ausschließlich TCP 25565. UDP wird nur für das optionale Query-Protokoll verwendet und ist standardmäßig deaktiviert. Führen Sie auf dem VPS folgenden Befehl aus:

sudo ufw allow OpenSSH
sudo ufw allow 25565/tcp
sudo ufw enable

Das ist die erste Firewall. Die meisten VPS-Anbieter betreiben zusätzlich eine Firewall auf Netzwerkebene im Control Panel. Diese wird häufig übersehen. Öffnen Sie dort ebenfalls TCP 25565. Wenn nur eine der beiden Firewalls geöffnet ist, bleibt das Fehlerbild unspezifisch: Der Client bleibt bei „Connecting to the server...“ hängen und bricht mit Connection timed out: no further information ab. Es gibt keine Ablehnung, keinen Serverfehler und keinen Eintrag im Journal, weil die Pakete den Server nicht erreicht haben. Prüfen Sie dies von einem Rechner außerhalb des VPS mit nc -vz your.server.ip 25565. succeeded bedeutet, dass beide Firewalls geöffnet sind. Hängt die Prüfung, ist mindestens eine Firewall nicht geöffnet.

Während Sie bereits in ufw arbeiten: Auf demselben System läuft SSH über eine öffentliche IP-Adresse. Innerhalb weniger Stunden entsteht meist eine große Menge an Brute-Force-Einträgen im Log. Richten Sie Fail2ban für SSH unter Ubuntu 24.04 ein, bevor Sie es vergessen.

Stellen Sie nun die Verbindung her: Multiplayer, Direct Connection und die IP-Adresse des Servers. Da Sie sich in Schritt 4 selbst mit op-Rechten versehen haben, funktionieren Befehle im Spiel sofort: /whitelist add FriendName für jeden Spieler und /gamemode creative, falls das vorgesehen ist.

Schritt 9: Whitelist, weil das Internet Port 25565 findet

Einen Minecraft-Server offen im Internet zu betreiben, ist kein theoretisches Risiko: Massenscanner durchsuchen den gesamten IPv4-Adressraum kontinuierlich nach Port 25565, Hobbyprojekte zum Griefing haben auf diese Weise Hunderttausende offene Server erfasst, und ein Server ohne Whitelist erhält innerhalb weniger Tage, manchmal innerhalb weniger Stunden, unerwünschte Besucher. Die Whitelist aus Schritt 5 ist die Lösung: online-mode=true bestätigt die Identität, die Whitelist beschränkt den Zugang auf die von Ihnen ausgewählten Identitäten. Dieses Paar bildet das gesamte Sicherheitsmodell und reicht für einen Server für Freunde aus.

Für den Konsolenzugriff ohne das Spiel, skriptgesteuerte Backups und einen Cronjob aktivieren Sie RCON in server.properties (enable-rcon=true, ein starkes rcon.password, Port 25575) und erstellen den kleinen mcrcon-Client aus dessen GitHub-Quellcode direkt auf dem VPS. Er ist nicht in den Ubuntu-Repositories enthalten. Öffnen Sie Port 25575 in keiner Firewall: RCON überträgt das Passwort im Klartext und bleibt daher auf Loopback beschränkt.

Schritt 10: Backups, die die Welt nicht beschädigen

Die wichtigste Regel lautet: Kopieren Sie niemals ein Weltverzeichnis, während der Server darin schreibt. Regionsdateien werden während des Spiels fortlaufend neu geschrieben. Ein tar, das mit einem Schreibvorgang kollidiert, erzeugt ein Archiv mit teilweise geschriebenen Chunks. Wenn Sie es später wiederherstellen, füllt sich genau in dem Moment, in dem ein Backup funktionieren muss, das Log mit Fehlern beim Laden von Chunks, und im Terrain entstehen Lücken. Zwei Vorgehensweisen verhindern das.

Stop-Copy-Start ist die einfache Variante, erfordert jedoch eine Minute Ausfallzeit:

sudo systemctl stop minecraft
sudo mkdir -p /opt/backups
sudo tar czf /opt/backups/world-$(date +%F-%H%M).tgz \
  -C /opt/minecraft world world_nether world_the_end
sudo systemctl start minecraft

(Paper unterteilt die Dimensionen in world, world_nether und world_the_end. Ein Vanilla-Server verwendet für alles world. Legen Sie die beiden anderen dort daher nicht ab.)

Mit Save-off erstellen Sie ein Backup im laufenden Betrieb: Senden Sie über RCON save-off (deaktiviert den automatischen Speichervorgang), anschließend save-all flush (erzwingt das Schreiben aller Daten auf die Festplatte und wartet), erstellen Sie das tar-Archiv und senden Sie danach save-on. Diese Variante gehört in den Cronjob um 5 a.m.

Ein Backup, das auf demselben VPS wie der Server liegt, ist kein Backup. scp oder rclone die Archive vom Server herunter und bewahren Sie mehrere Versionen auf. Da Sie bei einem Ausfall nicht ständig auf die Konsole schauen werden, richten Sie außerdem eine externe Portprüfung ein: Uptime Kuma auf einem anderen Rechner prüft per TCP den Port 25565 und erkennt, dass der Server nicht erreichbar ist, bevor Ihre Spieler es bemerken.

Plugins und Upgrades

Bei Paper besteht ein Plugin aus einer JAR-Datei, die in /opt/minecraft/plugins/ abgelegt wird. Danach wird der Server neu gestartet. Damit ist die Installation abgeschlossen. Beziehen Sie Plugins nur von den offiziellen Projektseiten (Hangar, Modrinth, SpigotMC). Aus demselben Grund wie bei der Server-JAR-Datei: Jedes Plugin ist beliebiger Code, der als Benutzer minecraft ausgeführt wird.

Für ein Server-Upgrade stoppen Sie den Server, erstellen ein Backup, ersetzen server.jar durch den Build für die neue Minecraft-Version und starten den Server wieder. Beachten Sie zwei Punkte. World-Upgrades sind einseitig. Eine Welt, die mit einer neueren Version geöffnet wurde, lässt sich nicht mit einer älteren Version öffnen. Dafür benötigen Sie ebenfalls die Backups. Plugins unterstützen eine neue Minecraft-Version häufig erst nach einigen Tagen oder Wochen. Prüfen Sie daher vor dem Upgrade die Kompatibilität, anstatt bereits am ersten Tag eine neue Version einzusetzen.

Wenn Sie all dies lieber als Container verwalten möchten, einschließlich der Versionsfixierung sowie der Annahme der EULA und der Speicheroptionen als Umgebungsvariablen, führt das weit verbreitete itzg/minecraft-server-Image denselben Paper-Server unter Docker Compose auf Ihrem VPS aus. Die gleichen Regeln für Firewall und Backups gelten weiterhin.

FAQ

Wie viel RAM benötigt ein Minecraft-Server?

Mit 2 GB läuft Vanilla für 2–5 Spieler. 4 GB sind für einen Freundesserver mit ungefähr zehn Spielern auf Paper und einigen Plugins ausreichend. Modpacks und mehr als 20 Spieler benötigen 8 GB oder mehr. Unabhängig von der Größe des VPS sollten Sie -Xmx auf höchstens den gesamten RAM minus 1 GB setzen. Die JVM verwendet auch Speicher außerhalb des Heaps. Ein zu hoher Wert führt zu Error: Could not reserve enough space for object heap oder zu einer vom Betriebssystem unbemerkt ausgelösten OOM-Beendigung.

Warum können meine Freunde keine Verbindung zu meinem Minecraft-Server herstellen?

Ein Hängen des Clients, das mit Connection timed out: no further information endet, weist fast immer auf eine Firewall hin. Es gibt zwei Firewalls: ufw auf dem VPS und die Netzwerk-Firewall Ihres Anbieters im Control Panel. TCP 25565 muss in beiden Firewalls geöffnet sein. Prüfen Sie mit sudo ss -tlnp | grep 25565 auf dem Server, ob der Dienst tatsächlich Verbindungen annimmt. Testen Sie anschließend von außerhalb mit nc -vz your.server.ip 25565.

Sollte ich online-mode=false in server.properties setzen?

Nein. Mit online-mode=false überspringt der Server die Mojang-Authentifizierung vollständig. Dadurch kann sich jeder unter jedem Benutzernamen anmelden, auch unter dem Namen eines Operators, und dessen Berechtigungen übernehmen. Außerdem funktionieren Skins und stabile UUIDs nicht mehr zuverlässig. Der einzige legitime Anwendungsfall ist ein authentifizierender Proxy wie Velocity, der Spieler selbst prüft. Bei einem normalen Server bleibt der Wert true.

Ist Paper besser als der Vanilla-Minecraft-Server?

Für fast alle Anwendungsfälle: ja. Paper ist eine direkt einsetzbare JAR-Datei. Sie lädt Vanilla-Welten, akzeptiert unveränderte Clients, verarbeitet Entities und lädt Chunks deutlich effizienter und bietet zusätzlich das Plugin-Ökosystem. Eine Ausnahme sind technische Redstone-Communitys, die ein bitgenaues Vanilla-Verhalten benötigen. Einige Optimierungen von Paper verändern dieses Verhalten. Auf einem kleinen VPS entspricht die Effizienz von Paper praktisch zusätzlichem kostenlosem RAM.

Wie sichere ich eine Minecraft-Welt, ohne sie zu beschädigen?

Archivieren Sie das Weltverzeichnis niemals, während der Server darin schreibt. Wenn das Kopieren gleichzeitig mit dem Schreiben einer Region-Datei erfolgt, können beschädigte Chunks entstehen, die erst beim Wiederherstellen auffallen. Stoppen Sie entweder den Server, archivieren Sie die Weltverzeichnisse mit tar und starten Sie den Server anschließend wieder. Alternativ können Sie den Server mit save-off, save-all flush, tar und save-on über RCON weiterlaufen lassen. Verschieben Sie das Archiv anschließend vom VPS auf ein anderes System.