Comment administrer un serveur Palworld à distance avec RCON et l'API REST ?
Dans ce guide, vous allez activer l'API REST (interface d'administration qui fonctionne en HTTP) pour gérer votre serveur dédié Palworld sans entrer dans le jeu, activer si nécessaire l'ancienne interface RCON, vous connecter depuis votre propre ordinateur sans ouvrir les ports d'administration sur Internet, et envoyer des commandes d'annonce, d'expulsion, de bannissement et de sauvegarde. À la dernière étape, vous mettrez en place un script de redémarrage programmé qui prévient les joueurs à l'avance.
Avant de commencer
- Un serveur Palworld installé et démarré au moins une fois. Si vous ne l'avez pas encore installé, suivez d'abord le guide d'installation d'un serveur dédié Palworld ; les chemins et le nom de service
palworldutilisés ici suivent l'organisation décrite dans ce guide. Les offres adaptées sont présentées sur la page Location de serveur Palworld. - Un accès Bureau à distance (RDP) au serveur Windows ou un accès SSH au serveur Linux. L'adresse IP de votre VDS et le mot de passe administrateur initial figurent sur la page du service dans l'Espace client et dans l'e-mail d'activation.
- La possibilité de modifier le fichier
PalWorldSettings.ini. L'emplacement du fichier et ses règles d'écriture sont expliqués dans le guide des réglages du serveur.
Palworld propose deux interfaces d'administration à distance : l'API REST, recommandée, et le RCON (Remote Console, console à distance). D'après la version 1.0.4 de la documentation officielle du serveur, le RCON est obsolète (deprecated) et cessera de fonctionner lors d'une prochaine mise à jour ; ce guide s'appuie donc sur l'API REST. La comparaison des deux interfaces figure dans le tableau récapitulatif après les étapes.
La page officielle de l'API REST indique que ces interfaces ne sont pas conçues pour être exposées directement sur Internet et recommande de les utiliser sur le réseau local. Les méthodes de ce guide respectent cette règle : les ports restent fermés vers l'extérieur et les requêtes sont envoyées depuis le serveur lui-même ou à travers un tunnel SSH chiffré.
Étape 1 : activer les interfaces dans le fichier de réglages
Arrêtez d'abord proprement le serveur : en jeu, devenez administrateur avec /AdminPassword, puis tapez /Save et /Shutdown 30. Sous Linux, exécutez aussi la commande sudo systemctl stop palworld pour que le service ne redémarre pas pendant la modification. Repérez ensuite ces valeurs dans la ligne OptionSettings et modifiez-les :
…,AdminPassword="MotDePasseLongEtSecret",…,RCONEnabled=False,RCONPort=25575,…,RESTAPIEnabled=True,RESTAPIPort=8212,…
Si vous avez créé le fichier en copiant le contenu de DefaultPalWorldSettings.ini, comme l'indique la documentation officielle, ces clés figurent déjà dans la ligne ; modifiez uniquement leurs valeurs et n'ajoutez pas une seconde fois la même clé. Exemples de valeurs :
| Clé | Valeur d'exemple | Remarque |
|---|---|---|
AdminPassword | Une valeur longue et imprévisible, composée de lettres et de chiffres | Ne la laissez pas vide ; ce mot de passe sert aussi pour la connexion à distance. Les caractères accentués ou spéciaux (é, è, à, ç) et les signes qui ont une signification particulière dans le shell, comme $ et !, posent problème dans les commandes. Ne le rendez pas identique à ServerPassword. |
RESTAPIEnabled | True | Active l'API REST. |
RESTAPIPort | 8212 | Si vous le modifiez, changez aussi le port dans les commandes. |
RCONEnabled | False | Passez-le à True uniquement si vous utilisez un outil qui exige le RCON. |
RCONPort | 25575 | Sans effet lorsque le RCON est désactivé. |
Enregistrez le fichier et démarrez le serveur : sous Windows avec le fichier start.bat créé lors de l'installation, sous Linux avec sudo systemctl start palworld. Les modifications de réglages prennent effet au redémarrage du serveur.
L'API REST utilise l'authentification HTTP Basic Auth (authentification de base). La documentation officielle ne précise pas le nom d'utilisateur ; dans les outils de la communauté, le nom d'utilisateur est admin et le mot de passe est la valeur de AdminPassword. Le test de l'étape 3 permet de le vérifier sur votre propre serveur.
Étape 2 : garder les ports fermés sur Internet
Le pare-feu se gère depuis le système d'exploitation et relève de votre responsabilité. Vers l'extérieur, seuls doivent être ouverts les ports du jeu (8211 UDP du guide d'installation, et 27015 UDP si nécessaire) ainsi que SSH (22) ou RDP (3389) pour l'administration ; n'ajoutez pas de règle d'autorisation pour 8212 et 25575. N'appliquez pas le conseil « ouvrez le port TCP 25575 vers l'extérieur », que l'on trouve souvent sur Internet. L'API REST fonctionne en HTTP simple, donc sans chiffrement du trafic ; quiconque connaît ou intercepte le mot de passe peut arrêter votre serveur et bannir des joueurs.
Sous Ubuntu, vérifiez l'état du pare-feu :
sudo ufw status
Si la sortie affiche Status: inactive, le pare-feu est désactivé. Comme dans le guide d'installation, ajoutez d'abord les règles sudo ufw allow 22/tcp et sudo ufw allow 8211/udp, puis activez-le avec sudo ufw enable.
Si vous devez vous connecter directement depuis un ordinateur doté d'une adresse IP fixe, n'ouvrez le port que pour cette adresse. Dans l'exemple, 198.51.100.25 remplace votre propre adresse IP. Sous Windows, dans PowerShell en tant qu'administrateur :
New-NetFirewallRule -DisplayName "Palworld REST API (IP unique)" -Direction Inbound -Protocol TCP -LocalPort 8212 -RemoteAddress 198.51.100.25 -Action Allow
Sous Ubuntu :
sudo ufw allow proto tcp from 198.51.100.25 to any port 8212
Avec cette méthode, le trafic reste non chiffré et l'adresse IP d'une connexion domestique peut changer. Sur les serveurs Linux, le tunnel SSH de l'étape 4 est plus sûr.
Étape 3 : faire un premier test depuis le serveur lui-même
Sur le serveur Linux, connecté en SSH, exécutez la commande suivante (si curl n'est pas installé, lancez d'abord sudo apt install curl) :
curl -s -u admin:MotDePasseLongEtSecret http://127.0.0.1:8212/v1/api/info
Sur le serveur Windows, dans PowerShell :
$auth = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes('admin:MotDePasseLongEtSecret'))
$h = @{ Authorization = "Basic $auth" }
Invoke-RestMethod -Uri http://127.0.0.1:8212/v1/api/info -Headers $h
Si la réponse contient les champs version, servername, description et worldguid, l'API fonctionne. Une réponse 401 indique que le mot de passe ou le nom d'utilisateur est incorrect ; une erreur de connexion indique que l'API n'est pas activée.
Étape 4 : se connecter depuis votre ordinateur par un tunnel SSH
Un tunnel SSH fait passer un port de votre ordinateur vers un port du serveur à travers une connexion SSH chiffrée. Le port 8212 reste ainsi fermé vers l'extérieur, et vous utilisez quand même l'API depuis votre ordinateur. Pour un VDS Linux, exécutez la commande suivante sur votre ordinateur (PowerShell sous Windows 10/11, terminal sous macOS et Linux), en remplaçant 203.0.113.10 par l'adresse IP de votre VDS :
ssh -N -L 8212:127.0.0.1:8212 [email protected]
-L redirige le port local 8212 vers le port 8212 interne du serveur, et -N maintient uniquement le tunnel ouvert, sans exécuter de commande à distance. Le tunnel fonctionne tant que la fenêtre reste ouverte ; vous le fermez avec Ctrl+C. Si vous utilisez aussi le RCON, ajoutez -L 25575:127.0.0.1:25575 à la commande.
Si la commande ssh est introuvable sous Windows, ajoutez le client OpenSSH depuis Paramètres, section « Fonctionnalités facultatives », ou avec cette commande dans PowerShell en tant qu'administrateur :
Add-WindowsCapability -Online -Name OpenSSH.Client~~~~0.0.1.0
Le tunnel ouvert, affichez la liste des joueurs connectés dans une seconde fenêtre. Dans Windows PowerShell 5.1, taper curl lance la commande Invoke-WebRequest ; tapez donc curl.exe :
curl.exe -s -u admin:MotDePasseLongEtSecret http://127.0.0.1:8212/v1/api/players
Sous Windows Server, le serveur SSH n'est pas activé par défaut. Sur un VDS Windows, le plus simple est de vous connecter en Bureau à distance et d'exécuter les commandes sur le serveur lui-même.
Étape 5 : gérer le serveur avec l'API REST
Dans la documentation officielle, l'adresse de base est de la forme http://localhost:8212/v1/api ; les exemples utilisent la même adresse avec 127.0.0.1, et les points de terminaison (endpoints) ci-dessous s'ajoutent à la fin de cette adresse. Les requêtes avec un corps nécessitent l'en-tête Content-Type: application/json.
| Requête | Corps JSON | Effet |
|---|---|---|
GET /info | — | Version, nom et description du serveur |
GET /players | — | Joueurs connectés : name, userId, ip, ping, level |
GET /metrics | — | FPS du serveur, nombre de joueurs, temps de fonctionnement en secondes |
GET /settings | — | Réglages utilisés par le serveur (lecture seule) |
GET /game-data | — | Instantané contenant la liste de tous les objets (actors) présents dans le monde au moment de la requête |
POST /announce | {"message":"…"} | Annonce à tous les joueurs |
POST /kick | {"userid":"…","message":"…"} | Expulse le joueur du serveur |
POST /ban | {"userid":"…","message":"…"} | Bannit le joueur |
POST /unban | {"userid":"…"} | Lève le bannissement |
POST /save | — | Sauvegarde le monde |
POST /shutdown | {"waittime":30,"message":"…"} | Arrête le serveur après un délai de waittime ; message est facultatif |
POST /stop | — | Force l'arrêt du serveur ; appelez d'abord /save |
La valeur userid se trouve dans la réponse /players, champ userId ; pour les joueurs Steam, elle commence par steam_. Dans les requêtes kick et ban, message est facultatif. Exemples de requêtes sous Linux ou à travers le tunnel :
curl -s -u admin:MotDePasseLongEtSecret -H "Content-Type: application/json" -d '{"message":"Le serveur passe en maintenance dans 10 minutes"}' http://127.0.0.1:8212/v1/api/announce
curl -s -u admin:MotDePasseLongEtSecret -H "Content-Type: application/json" -d '{"userid":"steam_00000000000000000","message":"Infraction au règlement"}' http://127.0.0.1:8212/v1/api/ban
curl -s -u admin:MotDePasseLongEtSecret -X POST http://127.0.0.1:8212/v1/api/save
Avec -d, curl envoie la requête en POST. Sous Windows, pour les requêtes avec un corps, reprenez la variable $h de l'étape 3 avec 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":"Le serveur passe en maintenance dans 10 minutes"}'
charset=utf-8 garantit la bonne transmission des caractères accentués. Sans -ContentType, PowerShell envoie le corps POST au format application/x-www-form-urlencoded et la requête n'est pas lue comme du JSON.
Étape 6 : se connecter avec un client RCON si nécessaire
N'activez le RCON que si vous utilisez un outil qui ne prend pas encore en charge l'API REST. Passez RCONEnabled=True, redémarrez le serveur et ouvrez aussi un tunnel pour le port 25575, comme à l'étape 4. Dans le client, saisissez 127.0.0.1 comme adresse, 25575 comme port et la valeur de AdminPassword comme mot de passe ; la liste officielle des réglages ne comporte pas de paramètre de mot de passe RCON distinct. La page officielle du RCON renvoie à la documentation du client pour la façon d'envoyer les commandes ; la liste des commandes en jeu figure dans le guide sur l'accès administrateur et les commandes en jeu. Le RCON devant cesser de fonctionner avec une mise à jour, prévoyez de faire passer vos outils à l'API REST.
Étape 7 : mettre en place un redémarrage programmé et des annonces automatiques
Sur les serveurs qui restent allumés longtemps, l'utilisation de la mémoire peut augmenter ; un redémarrage régulier la remet à zéro. Les scripts ci-dessous préviennent les joueurs 5 minutes puis 1 minute avant, sauvegardent le monde, arrêtent le serveur et le relancent.
Sous Linux, créez le fichier avec sudo nano /usr/local/bin/palworld-restart.sh :
#!/bin/sh
API="http://127.0.0.1:8212/v1/api"
AUTH="admin:MotDePasseLongEtSecret"
JSON="Content-Type: application/json"
curl -s -u "$AUTH" -H "$JSON" -d '{"message":"Le serveur redémarre dans 5 minutes"}' "$API/announce"
sleep 240
curl -s -u "$AUTH" -H "$JSON" -d '{"message":"Le serveur redémarre dans 1 minute"}' "$API/announce"
sleep 50
curl -s -u "$AUTH" -X POST "$API/save"
curl -s -u "$AUTH" -H "$JSON" -d '{"waittime":10,"message":"Redémarrage en cours"}' "$API/shutdown"
sleep 15
while systemctl is-active --quiet palworld; do sleep 5; done
systemctl start palworld
Comme le script contient le mot de passe, faites en sorte que seul root puisse le lire ; ajoutez ensuite une tâche cron qui l'exécutera chaque jour à 05:00 :
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
L'heure correspond au fuseau horaire du serveur ; vérifiez-le avec la commande date. La ligne while attend que le serveur soit complètement arrêté. La dernière ligne est indispensable : le service du guide d'installation utilise Restart=on-failure, et systemd ne relance pas de lui-même un service qui s'est arrêté proprement. Si le service a entre-temps redémarré de lui-même, systemctl start ne lance pas de seconde instance.
Sous Windows, créez le dossier C:\palapi et enregistrez-y le fichier restart.ps1. Enregistrez les scripts qui contiennent des caractères accentués en UTF-8 (avec BOM) ; Windows PowerShell 5.1 lit les fichiers sans BOM avec l'ancien encodage ANSI.
$auth = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes('admin:MotDePasseLongEtSecret'))
$h = @{ Authorization = "Basic $auth" }
$api = "http://127.0.0.1:8212/v1/api"
$type = "application/json; charset=utf-8"
Invoke-RestMethod -Uri "$api/announce" -Method Post -Headers $h -ContentType $type -Body '{"message":"Le serveur redémarre dans 5 minutes"}'
Start-Sleep -Seconds 240
Invoke-RestMethod -Uri "$api/announce" -Method Post -Headers $h -ContentType $type -Body '{"message":"Le serveur redémarre dans 1 minute"}'
Start-Sleep -Seconds 50
Invoke-RestMethod -Uri "$api/save" -Method Post -Headers $h
Invoke-RestMethod -Uri "$api/shutdown" -Method Post -Headers $h -ContentType $type -Body '{"waittime":10,"message":"Redémarrage en cours"}'
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"
Programmez la tâche dans une invite de commandes ouverte en tant qu'administrateur :
schtasks /create /tn "Palworld restart" /tr "powershell.exe -NoProfile -ExecutionPolicy Bypass -File C:\palapi\restart.ps1" /sc daily /st 05:00 /it
/it fait en sorte que la tâche ne s'exécute que lorsque votre session est ouverte ; la fenêtre du serveur s'ouvre ainsi dans votre session Bureau à distance. Vous pouvez fermer la fenêtre du Bureau à distance, mais n'utilisez pas l'option Sign out (se déconnecter) de Windows : la tâche ne s'exécute pas lorsque la session est fermée. La ligne while empêche le nouveau serveur de démarrer avant l'arrêt complet de l'ancien processus. Si la commande demande un mot de passe, saisissez celui du compte Windows avec lequel vous êtes connecté.
Récapitulatif des réglages et des ports
Différences entre les deux interfaces (le statut, les ports et les informations sur les caractères correspondent à la version 1.0.4 de la documentation officielle) :
| Caractéristique | API REST | RCON |
|---|---|---|
| Statut | Interface recommandée | Obsolète ; cessera de fonctionner lors d'une prochaine mise à jour |
| Port par défaut | 8212 TCP (HTTP non chiffré) | 25575 TCP |
| Clés de réglage | RESTAPIEnabled, RESTAPIPort | RCONEnabled, RCONPort |
| Mot de passe | AdminPassword (HTTP Basic Auth) | AdminPassword |
| Outil de connexion | curl, PowerShell ou tout outil capable d'envoyer des requêtes HTTP | Un client RCON séparé |
| Caractères multi-octets (par ex. noms en japonais ou en chinois) | Pris en charge | La perte de caractères dans les noms de joueurs est un problème connu |
| Accès sécurisé | Depuis le serveur lui-même ou par tunnel SSH ; n'ouvrez pas 8212 sur Internet | Depuis le serveur lui-même ou par tunnel SSH ; n'ouvrez pas 25575 sur Internet |
Erreurs fréquentes
401 Unauthorized: le mot de passe ou le nom d'utilisateur est incorrect, ou le serveur n'a pas été redémarré après la modification deAdminPassword.- Connexion refusée :
RESTAPIEnabled=Truen'a pas été enregistré,DefaultPalWorldSettings.inia été modifié par erreur, le port est incorrect ou le tunnel SSH s'est fermé. 400 Bad Request: le corps JSON est invalide (guillemet ou accolade manquants), l'en-têteContent-Typemanque, ou le champ obligatoireuseridouwaittimen'a pas été fourni.- Les caractères accentués des annonces s'affichent mal :
charset=utf-8manque dans PowerShell, ou le fichier.ps1a été enregistré sans BOM. - Le serveur n'a pas redémarré après l'arrêt programmé : les dernières lignes du script (boucle d'attente et commande de démarrage) manquent. Sous Linux, vérifiez
sudo systemctl status palworld; sous Windows, le résultat de la dernière exécution dans « Task Scheduler » (planificateur de tâches). - L'outil RCON n'arrive plus à se connecter après une mise à jour : le RCON est en cours d'abandon ; remplacez votre outil par l'API REST.
Questions fréquentes
Puis-je encore utiliser le RCON ?
La documentation officielle indique que le RCON cessera de fonctionner lors d'une prochaine mise à jour. Il peut être activé dans la version actuelle, mais utilisez l'API REST pour les nouvelles installations ; vous pouvez y effectuer par requêtes HTTP les annonces, expulsions, bannissements, sauvegardes et arrêts.
Dois-je ouvrir le port pour administrer le serveur depuis mon ordinateur ?
Non. Sur un VDS Linux, le tunnel SSH de l'étape 4 suffit ; 8212 et 25575 restent fermés. Sur un VDS Windows, connectez-vous en Bureau à distance et exécutez les commandes sur le serveur.
Puis-je modifier les réglages avec l'API REST ?
Non. La liste officielle des points de terminaison ne comporte aucune requête qui modifie les réglages ; GET /settings se contente de les afficher. Pour modifier un réglage, vous devez éditer le fichier PalWorldSettings.ini et redémarrer le serveur.
Le bouton « Redémarrer » de l'Espace client peut-il le remplacer ?
Les actions d'alimentation de l'Espace client redémarrent le VDS entier, pas seulement le jeu. Envoyez d'abord une requête /save. Si votre connexion SSH ou RDP est coupée, vous pouvez accéder au serveur par la console VNC de l'Espace client. Si le serveur plante, consultez le guide sur les plantages et l'optimisation de la RAM.
Un redémarrage programmé remplace-t-il une sauvegarde ?
Non. /save enregistre le monde uniquement sur le même disque. Les VDS ne comprennent pas de sauvegardes automatiques ; copiez régulièrement le dossier Pal/Saved hors du serveur, par exemple par SFTP vers votre espace de sauvegarde cloud.
Guides associés
- Comment installer un serveur dédié Palworld (VDS Windows et Linux)
- Réglages du serveur Palworld : comment modifier PalWorldSettings.ini
- Comment devenir administrateur sur un serveur Palworld ? Commandes d'administration
- Sauvegarder et transférer les données de jeu d'un serveur Palworld
- Tous les guides Palworld
Commentaires0
Pas encore de commentaire
Soyez le premier à partager votre avis.
Veuillez vous connecter ou vous inscrire pour laisser un commentaire.