Palworld-Server per RCON und REST API aus der Ferne verwalten
In dieser Anleitung aktivieren Sie die REST API (eine Verwaltungsschnittstelle, die über HTTP arbeitet), um Ihren Palworld Dedicated Server zu verwalten, ohne das Spiel zu betreten. Bei Bedarf schalten Sie zusätzlich die ältere RCON-Schnittstelle ein, verbinden sich von Ihrem eigenen Computer aus, ohne die Verwaltungsports ins Internet zu öffnen, und senden Befehle für Ankündigungen, Kicks, Banns und das Speichern. Im letzten Schritt richten Sie ein Skript für zeitgesteuerte Neustarts ein, das die Spieler vorab warnt.
Bevor Sie beginnen
- Ein installierter und mindestens einmal gestarteter Palworld-Server. Falls Sie ihn noch nicht installiert haben, folgen Sie zuerst der Anleitung zur Installation eines Palworld Dedicated Servers; die Pfade und der Dienstname
palworldin dieser Anleitung entsprechen dem dortigen Aufbau. Passende Pakete für den Server finden Sie auf der Seite Palworld-Server. - Zugriff per Remotedesktop (RDP) auf einen Windows-Server bzw. per SSH auf einen Linux-Server. IP-Adresse und anfängliches Administratorpasswort Ihres VDS finden Sie auf der Dienstdetailseite im Kundenbereich und in der Aktivierungs-E-Mail.
- Die Möglichkeit, die Datei
PalWorldSettings.inizu bearbeiten. Speicherort und Syntaxregeln der Datei werden in der Anleitung zu den Servereinstellungen erklärt.
Palworld bietet zwei Schnittstellen für die Fernverwaltung: die empfohlene REST API und RCON (Remote Console). Laut Version 1.0.4 der offiziellen Serverdokumentation ist RCON veraltet (deprecated) und wird mit einem künftigen Update nicht mehr funktionieren; deshalb stützt sich diese Anleitung auf die REST API. Einen Vergleich beider Schnittstellen finden Sie in der Übersichtstabelle nach den Schritten.
Die offizielle REST-API-Seite weist darauf hin, dass diese Schnittstellen nicht dafür ausgelegt sind, direkt ins Internet geöffnet zu werden, und empfiehlt die Nutzung im lokalen Netzwerk. Die Methoden in dieser Anleitung halten sich an diese Regel: Die Ports bleiben nach außen geschlossen, und Anfragen werden vom Server selbst oder über einen verschlüsselten SSH-Tunnel gesendet.
Schritt 1: Schnittstellen in der Konfigurationsdatei aktivieren
Fahren Sie den Server zunächst sauber herunter: Melden Sie sich im Spiel mit /AdminPassword als Administrator an und geben Sie dann /Save und anschließend /Shutdown 30 ein. Führen Sie unter Linux zusätzlich sudo systemctl stop palworld aus, damit der Dienst während der Bearbeitung nicht wieder startet. Suchen Sie dann in der Zeile OptionSettings die folgenden Werte und ändern Sie sie:
…,AdminPassword="LangesGeheimesPasswort",…,RCONEnabled=False,RCONPort=25575,…,RESTAPIEnabled=True,RESTAPIPort=8212,…
Wenn Sie die Datei wie in der offiziellen Dokumentation durch Kopieren des Inhalts von DefaultPalWorldSettings.ini erstellt haben, sind diese Schlüssel bereits in der Zeile vorhanden; ändern Sie nur ihre Werte und fügen Sie denselben Schlüssel nicht ein zweites Mal hinzu. Beispielwerte:
| Schlüssel | Beispielwert | Hinweis |
|---|---|---|
AdminPassword | Ein langer, nicht zu erratender Wert aus Buchstaben und Ziffern | Nicht leer lassen; dieses Passwort wird auch für die Fernverbindung verwendet. Nicht-ASCII-Zeichen wie Umlaute und ß sowie Zeichen mit Sonderbedeutung in der Shell wie $ und ! verursachen Probleme in Befehlen. Verwenden Sie nicht denselben Wert wie bei ServerPassword. |
RESTAPIEnabled | True | Aktiviert die REST API. |
RESTAPIPort | 8212 | Wenn Sie ihn ändern, passen Sie auch den Port in den Befehlen an. |
RCONEnabled | False | Nur auf True setzen, wenn Sie ein Werkzeug nutzen, das RCON erfordert. |
RCONPort | 25575 | Ohne Wirkung, solange RCON deaktiviert ist. |
Speichern Sie die Datei und starten Sie den Server: unter Windows mit der bei der Installation erstellten start.bat, unter Linux mit sudo systemctl start palworld. Änderungen an den Einstellungen werden beim Neustart des Servers wirksam.
Die REST API nutzt für die Authentifizierung HTTP Basic Auth. Die offizielle Dokumentation nennt keinen Benutzernamen; in Community-Werkzeugen lautet der Benutzername admin, das Passwort ist der Wert von AdminPassword. Der Test in Schritt 3 bestätigt das auf Ihrem eigenen Server.
Schritt 2: Ports zum Internet hin geschlossen halten
Die Firewall wird innerhalb des Betriebssystems verwaltet und liegt in Ihrer Verantwortung. Nach außen sollten nur die Ports des Spiels (8211 UDP aus der Installationsanleitung, bei Bedarf 27015 UDP) sowie SSH (22) oder RDP (3389) für die Verwaltung offen sein; legen Sie für 8212 und 25575 keine Zulassungsregel an. Befolgen Sie nicht den im Internet häufig zu lesenden Rat, „Port 25575 TCP nach außen zu öffnen“. Die REST API arbeitet mit einfachem HTTP, der Datenverkehr wird also nicht verschlüsselt; wer das Passwort kennt oder abfängt, kann Ihren Server herunterfahren und Spieler bannen.
Prüfen Sie unter Ubuntu den Status:
sudo ufw status
Sehen Sie in der Ausgabe Status: inactive, ist die Firewall ausgeschaltet. Fügen Sie wie in der Installationsanleitung zuerst die Regeln sudo ufw allow 22/tcp und sudo ufw allow 8211/udp hinzu und aktivieren Sie die Firewall dann mit sudo ufw enable.
Wenn Sie sich direkt von einem Computer mit fester IP-Adresse verbinden müssen, öffnen Sie den Port nur für diese Adresse. Im Beispiel steht 198.51.100.25 für Ihre eigene IP-Adresse. Unter Windows in einer PowerShell mit Administratorrechten:
New-NetFirewallRule -DisplayName "Palworld REST API (einzelne IP)" -Direction Inbound -Protocol TCP -LocalPort 8212 -RemoteAddress 198.51.100.25 -Action Allow
Unter Ubuntu:
sudo ufw allow proto tcp from 198.51.100.25 to any port 8212
Auch bei dieser Methode ist der Datenverkehr unverschlüsselt, und die IP-Adresse von Heimanschlüssen kann sich ändern. Auf Linux-Servern ist der SSH-Tunnel aus Schritt 4 sicherer.
Schritt 3: Ersten Test auf dem Server selbst durchführen
Führen Sie auf dem Linux-Server bei bestehender SSH-Verbindung Folgendes aus (ist curl nicht installiert, zuerst sudo apt install curl):
curl -s -u admin:LangesGeheimesPasswort http://127.0.0.1:8212/v1/api/info
Auf dem Windows-Server in PowerShell:
$kimlik = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes('admin:LangesGeheimesPasswort'))
$h = @{ Authorization = "Basic $kimlik" }
Invoke-RestMethod -Uri http://127.0.0.1:8212/v1/api/info -Headers $h
Erscheinen in der Antwort die Felder version, servername, description und worldguid, funktioniert die API. Die Antwort 401 bedeutet, dass Passwort oder Benutzername falsch sind; ein Verbindungsfehler zeigt, dass die API nicht aktiviert ist.
Schritt 4: Von Ihrem eigenen Computer per SSH-Tunnel verbinden
Ein SSH-Tunnel leitet einen Port auf Ihrem Computer über eine verschlüsselte SSH-Verbindung an einen Port auf dem Server weiter. So bleibt 8212 nach außen geschlossen, während Sie die API von Ihrem eigenen Computer aus nutzen. Führen Sie für einen Linux-VDS auf Ihrem Computer (unter Windows 10/11 in PowerShell, unter macOS und Linux im Terminal) Folgendes aus; ersetzen Sie 203.0.113.10 durch die IP-Adresse Ihres VDS:
ssh -N -L 8212:127.0.0.1:8212 [email protected]
-L leitet den lokalen Port 8212 an den Port 8212 innerhalb des Servers weiter, -N hält nur den Tunnel offen, ohne einen entfernten Befehl auszuführen. Der Tunnel läuft, solange das Fenster geöffnet bleibt; mit Strg+C beenden Sie ihn. Wenn Sie auch RCON nutzen, ergänzen Sie den Befehl um -L 25575:127.0.0.1:25575.
Wird der Befehl ssh unter Windows nicht gefunden, fügen Sie den OpenSSH-Client in den Einstellungen im Bereich „Optionale Features“ hinzu oder in einer PowerShell mit Administratorrechten mit diesem Befehl:
Add-WindowsCapability -Online -Name OpenSSH.Client~~~~0.0.1.0
Listen Sie bei geöffnetem Tunnel in einem zweiten Fenster die verbundenen Spieler auf. In Windows PowerShell 5.1 ruft die Eingabe von curl den Befehl Invoke-WebRequest auf; geben Sie deshalb curl.exe ein:
curl.exe -s -u admin:LangesGeheimesPasswort http://127.0.0.1:8212/v1/api/players
Unter Windows Server ist der SSH-Server standardmäßig nicht aktiviert. Auf einem Windows-VDS ist es am einfachsten, sich per Remotedesktop zu verbinden und die Befehle direkt auf dem Server auszuführen.
Schritt 5: Server über die REST API verwalten
Die Basisadresse in der offiziellen Dokumentation hat die Form http://localhost:8212/v1/api; die Beispiele verwenden dieselbe Adresse mit 127.0.0.1, und die folgenden Endpunkte (Endpoints) werden an diese Adresse angehängt. Anfragen mit Body benötigen den Header Content-Type: application/json.
| Anfrage | JSON-Body | Funktion |
|---|---|---|
GET /info | — | Version, Servername und Beschreibung |
GET /players | — | Verbundene Spieler: name, userId, ip, ping, level |
GET /metrics | — | Server-FPS, Spielerzahl, Laufzeit in Sekunden |
GET /settings | — | Vom Server verwendete Einstellungen (nur lesbar) |
GET /game-data | — | Momentaufnahme mit einer Liste aller Objekte (Actors) in der Welt zum Zeitpunkt der Anfrage |
POST /announce | {"message":"…"} | Ankündigung an alle Spieler |
POST /kick | {"userid":"…","message":"…"} | Wirft den Spieler vom Server |
POST /ban | {"userid":"…","message":"…"} | Bannt den Spieler |
POST /unban | {"userid":"…"} | Hebt den Bann auf |
POST /save | — | Speichert die Welt |
POST /shutdown | {"waittime":30,"message":"…"} | Wartet waittime lang und fährt den Server dann herunter; message ist optional |
POST /stop | — | Stoppt den Server erzwungen; rufen Sie vorher /save auf |
Den Wert userid finden Sie in der Antwort von /players im Feld userId; bei Steam-Spielern beginnt er mit steam_. Bei den Anfragen kick und ban ist message optional. Beispielanfragen unter Linux oder über den Tunnel:
curl -s -u admin:LangesGeheimesPasswort -H "Content-Type: application/json" -d '{"message":"Server geht in 10 Minuten in die Wartung"}' http://127.0.0.1:8212/v1/api/announce
curl -s -u admin:LangesGeheimesPasswort -H "Content-Type: application/json" -d '{"userid":"steam_00000000000000000","message":"Regelverstoß"}' http://127.0.0.1:8212/v1/api/ban
curl -s -u admin:LangesGeheimesPasswort -X POST http://127.0.0.1:8212/v1/api/save
Mit -d sendet curl die Anfrage als POST. Verwenden Sie unter Windows für Anfragen mit Body die Variable $h aus Schritt 3 zusammen mit Invoke-RestMethod:
Invoke-RestMethod -Uri http://127.0.0.1:8212/v1/api/announce -Method Post -Headers $h -ContentType "application/json; charset=utf-8" -Body '{"message":"Server geht in 10 Minuten in die Wartung"}'
charset=utf-8 sorgt dafür, dass Nicht-ASCII-Zeichen wie Umlaute korrekt übertragen werden. Ohne -ContentType sendet PowerShell den POST-Body als application/x-www-form-urlencoded, und die Anfrage wird nicht als JSON gelesen.
Schritt 6: Bei Bedarf mit einem RCON-Client verbinden
Aktivieren Sie RCON nur, wenn Sie ein Werkzeug nutzen, das die REST API noch nicht unterstützt. Setzen Sie RCONEnabled=True, starten Sie den Server neu und öffnen Sie wie in Schritt 4 auch für Port 25575 einen Tunnel. Geben Sie im Client als Adresse 127.0.0.1, als Port 25575 und als Passwort den Wert von AdminPassword ein; die offizielle Einstellungsliste enthält keinen eigenen Parameter für ein RCON-Passwort. Die offizielle RCON-Seite verweist für die Art, wie Befehle gesendet werden, auf die Dokumentation des jeweiligen Clients; die Liste der Spielbefehle finden Sie in der Anleitung zu Adminrechten und Spielbefehlen. Da RCON mit einem Update nicht mehr funktionieren wird, sollten Sie die Umstellung Ihrer Werkzeuge auf die REST API einplanen.
Schritt 7: Zeitgesteuerten Neustart und automatische Ankündigung einrichten
Auf Servern, die lange laufen, kann die Speichernutzung ansteigen; ein regelmäßiger Neustart setzt sie zurück. Die folgenden Skripte warnen die Spieler 5 und 1 Minute vorher, speichern die Welt, fahren den Server herunter und starten ihn wieder.
Erstellen Sie die Datei unter Linux mit sudo nano /usr/local/bin/palworld-restart.sh:
#!/bin/sh
API="http://127.0.0.1:8212/v1/api"
KIMLIK="admin:LangesGeheimesPasswort"
JSON="Content-Type: application/json"
curl -s -u "$KIMLIK" -H "$JSON" -d '{"message":"Server wird in 5 Minuten neu gestartet"}' "$API/announce"
sleep 240
curl -s -u "$KIMLIK" -H "$JSON" -d '{"message":"Server wird in 1 Minute neu gestartet"}' "$API/announce"
sleep 50
curl -s -u "$KIMLIK" -X POST "$API/save"
curl -s -u "$KIMLIK" -H "$JSON" -d '{"waittime":10,"message":"Neustart läuft"}' "$API/shutdown"
sleep 15
while systemctl is-active --quiet palworld; do sleep 5; done
systemctl start palworld
Da das Skript ein Passwort enthält, sollte nur root es lesen können; fügen Sie anschließend einen Cronjob hinzu, der täglich um 05:00 Uhr läuft:
sudo chmod 700 /usr/local/bin/palworld-restart.sh
echo '0 5 * * * root /usr/local/bin/palworld-restart.sh' | sudo tee /etc/cron.d/palworld-restart
Die Uhrzeit richtet sich nach der Zeitzone des Servers; prüfen Sie sie mit dem Befehl date. Die while-Zeile wartet, bis der Server vollständig heruntergefahren ist. Die letzte Zeile ist notwendig: Der Dienst aus der Installationsanleitung verwendet Restart=on-failure, und systemd startet einen sauber beendeten Dienst nicht von selbst neu. Falls der Dienst inzwischen von selbst neu gestartet wurde, startet systemctl start keine zweite Instanz.
Erstellen Sie unter Windows den Ordner C:\palapi und speichern Sie darin die Datei restart.ps1. Speichern Sie Skripte, die Nicht-ASCII-Zeichen wie Umlaute enthalten, in der Kodierung UTF-8 (mit BOM); Windows PowerShell 5.1 liest Dateien ohne BOM mit der alten ANSI-Kodierung.
$kimlik = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes('admin:LangesGeheimesPasswort'))
$h = @{ Authorization = "Basic $kimlik" }
$api = "http://127.0.0.1:8212/v1/api"
$tur = "application/json; charset=utf-8"
Invoke-RestMethod -Uri "$api/announce" -Method Post -Headers $h -ContentType $tur -Body '{"message":"Server wird in 5 Minuten neu gestartet"}'
Start-Sleep -Seconds 240
Invoke-RestMethod -Uri "$api/announce" -Method Post -Headers $h -ContentType $tur -Body '{"message":"Server wird in 1 Minute neu gestartet"}'
Start-Sleep -Seconds 50
Invoke-RestMethod -Uri "$api/save" -Method Post -Headers $h
Invoke-RestMethod -Uri "$api/shutdown" -Method Post -Headers $h -ContentType $tur -Body '{"waittime":10,"message":"Neustart läuft"}'
Start-Sleep -Seconds 15
while (Get-Process -Name 'PalServer*' -ErrorAction SilentlyContinue) { Start-Sleep -Seconds 5 }
Start-Process -FilePath "C:\steamcmd\steamapps\common\PalServer\start.bat"
Planen Sie die Aufgabe in einer Eingabeaufforderung mit Administratorrechten:
schtasks /create /tn "Palworld Neustart" /tr "powershell.exe -NoProfile -ExecutionPolicy Bypass -File C:\palapi\restart.ps1" /sc daily /st 05:00 /it
/it sorgt dafür, dass die Aufgabe nur läuft, während Sie angemeldet sind; das Serverfenster öffnet sich so in Ihrer Remotedesktop-Sitzung. Sie können das Remotedesktop-Fenster schließen, verwenden Sie in Windows aber nicht die Option Sign out (Abmelden); bei abgemeldeter Sitzung läuft die Aufgabe nicht. Die while-Zeile verhindert, dass der neue Server startet, bevor der alte Serverprozess vollständig beendet ist. Fragt der Befehl nach einem Passwort, geben Sie das Passwort des Windows-Kontos ein, mit dem Sie verbunden sind.
Übersicht der Einstellungen und Ports
Die Unterschiede der beiden Schnittstellen (Angaben zu Status, Port und Zeichen laut Version 1.0.4 der offiziellen Dokumentation):
| Merkmal | REST API | RCON |
|---|---|---|
| Status | Empfohlene Schnittstelle | Veraltet; wird mit einem künftigen Update nicht mehr funktionieren |
| Standardport | 8212 TCP (unverschlüsseltes HTTP) | 25575 TCP |
| Einstellungsschlüssel | RESTAPIEnabled, RESTAPIPort | RCONEnabled, RCONPort |
| Passwort | AdminPassword (HTTP Basic Auth) | AdminPassword |
| Verbindungswerkzeug | curl, PowerShell oder jedes Werkzeug, das HTTP-Anfragen senden kann | Ein separater RCON-Client |
| Multibyte-Zeichen (z. B. japanische, chinesische Namen) | Unterstützt | Verlorene Buchstaben in Spielernamen sind ein bekanntes Problem |
| Sicherer Zugriff | Vom Server selbst oder per SSH-Tunnel; 8212 nicht ins Internet öffnen | Vom Server selbst oder per SSH-Tunnel; 25575 nicht ins Internet öffnen |
Häufige Fehler
401 Unauthorized: Passwort oder Benutzername sind falsch, oder der Server wurde nach der Änderung vonAdminPasswordnicht neu gestartet.- Verbindung abgelehnt:
RESTAPIEnabled=Truewurde nicht gespeichert, versehentlich wurdeDefaultPalWorldSettings.inibearbeitet, der Port ist falsch, oder der SSH-Tunnel wurde geschlossen. 400 Bad Request: Der JSON-Body ist fehlerhaft (fehlendes Anführungszeichen oder fehlende geschweifte Klammer), der HeaderContent-Typefehlt, oder das Pflichtfelduseridbzw.waittimewurde nicht angegeben.- Nicht-ASCII-Zeichen wie Umlaute werden in Ankündigungen falsch angezeigt: In PowerShell fehlt
charset=utf-8, oder die.ps1-Datei wurde ohne BOM gespeichert. - Der Server ist nach dem geplanten Herunterfahren nicht wieder gestartet: Die letzten Zeilen des Skripts (Warteschleife und Startbefehl) fehlen. Prüfen Sie unter Linux
sudo systemctl status palworld, unter Windows das Ergebnis der letzten Ausführung in der Aufgabenplanung („Task Scheduler“). - Das RCON-Werkzeug kann sich nach einem Update nicht mehr verbinden: RCON wird gerade abgekündigt; ersetzen Sie Ihr Werkzeug durch die REST API.
Häufig gestellte Fragen
Kann ich RCON noch verwenden?
Laut offizieller Dokumentation wird RCON mit einem künftigen Update nicht mehr funktionieren. In der aktuellen Version lässt es sich aktivieren, für neue Installationen sollten Sie aber die REST API verwenden; Ankündigungen, Kicks, Banns, Speichern und Herunterfahren erledigen Sie mit HTTP-Anfragen.
Muss ich einen Port öffnen, um den Server von meinem eigenen Computer aus zu verwalten?
Nein. Auf einem Linux-VDS genügt der SSH-Tunnel aus Schritt 4; 8212 und 25575 bleiben geschlossen. Auf einem Windows-VDS verbinden Sie sich per Remotedesktop und führen die Befehle auf dem Server aus.
Kann ich mit der REST API Einstellungen ändern?
Nein. Die offizielle Liste der Endpunkte enthält keine Anfrage, die Einstellungen ändert; GET /settings zeigt die Einstellungen nur an. Um Einstellungen zu ändern, müssen Sie die Datei PalWorldSettings.ini bearbeiten und den Server neu starten.
Ersetzt das die Schaltfläche „Neu starten“ im Kundenbereich?
Die Energiefunktionen im Kundenbereich starten nicht das Spiel, sondern den gesamten VDS neu. Senden Sie vorher eine /save-Anfrage. Ist Ihre SSH- oder RDP-Verbindung abgebrochen, erreichen Sie den Server über die VNC-Konsole im Kundenbereich. Stürzt der Server ab, lesen Sie die Anleitung zu Abstürzen und RAM-Optimierung.
Ersetzt der zeitgesteuerte Neustart ein Backup?
Nein. /save speichert die Welt nur auf derselben Festplatte. Bei VDS-Paketen sind automatische Backups nicht enthalten; kopieren Sie den Ordner Pal/Saved regelmäßig an einen Ort außerhalb des Servers, zum Beispiel per SFTP in Ihren Cloud-Backup-Speicher.
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.