Comment configurer un serveur FiveM sur Linux : artifacts, systemd et ufw

Vous avez un VPS Linux (Ubuntu ou Debian) et vous voulez un serveur FiveM dessus. Le processus est court : obtenez les fichiers du serveur, démarrez-les, gardez-les en fonctionnement, et ouvrez les ports. Ce guide couvre chaque étape avec des commandes que vous pouvez copier.

#Avant de commencer

Vous avez besoin d'une clé de licence de portal.cfx.re, consultez l'erreur de clé de licence si vous ne l'avez pas encore créée. Installez les outils que vous allez utiliser :

sudo apt update
sudo apt install -y wget git xz-utils screen

Créez un utilisateur séparé, pour que le serveur ne s'exécute pas en tant que root :

sudo adduser fivem
sudo su - fivem

Tout ce qui suit est fait en tant qu'utilisateur.

#Télécharger l'artifact

Le programme serveur (« artifacts ») pour Linux provient de Cfx.re :

https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/

Ouvrez cette page, choisissez la version recommandée, et copiez le lien vers fx.tar.xz. Ensuite :

mkdir -p ~/fivem/server
cd ~/fivem/server
wget https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/<build>/fx.tar.xz
tar xf fx.tar.xz
rm fx.tar.xz

Remplacez <build> par le chemin que vous avez copié. Après extraction, vous devriez voir un run.sh dans le dossier.

#Obtenir les données du serveur

Les « données du serveur » c'est où votre server.cfg et vos ressources vivent. Les ressources de base Cfx.re sont sur GitHub :

cd ~/fivem
git clone https://github.com/citizenfx/cfx-server-data.git server-data

Créez la config dans server-data/server.cfg :

endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

sv_hostname "My FiveM server"
sv_maxclients 32
sv_licenseKey "cfxk_your_key_here"

ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap

#Démarrer : txAdmin ou simple

Avec txAdmin (recommandé). Exécutez run.sh sans arguments. txAdmin démarre, imprime un PIN et une adresse web, et vous finissez la configuration dans le navigateur sur le port 40120 :

cd ~/fivem/server
bash run.sh

txAdmin garde ses données dans un dossier txData, généralement dans le dossier à partir duquel vous l'avez démarré, alors démarrez-le toujours à partir du même endroit. Dans le panneau, vous pouvez utiliser une recette pour déployer un serveur de base, ou le pointer vers le dossier server-data que vous avez cloné.

Sans txAdmin. Démarrez à partir du dossier server-data et passez la config :

cd ~/fivem/server-data
bash ../server/run.sh +exec server.cfg

Vous obtenez la console simple dans votre terminal. Appuyez sur Ctrl+C pour l'arrêter.

Si vous perdez votre mot de passe txAdmin plus tard, consultez txAdmin mot de passe oublié.

#Le garder en fonctionnement avec screen

Le moyen rapide de garder le serveur actif après la déconnexion de SSH est screen :

screen -S fivem
cd ~/fivem/server
bash run.sh

Détachez avec Ctrl+A, puis D. Le serveur continue à fonctionner. Réattachez plus tard :

screen -r fivem

Cela fonctionne, mais rien ne redémarre le serveur si la machine redémarre ou si le processus meurt.

#Le garder en fonctionnement avec systemd

Un service systemd démarre le serveur au boot et le redémarre après un crash. Créez le fichier en tant que root (ou avec sudo) :

sudo nano /etc/systemd/system/fivem.service

[Unit]
Description=FiveM server
After=network.target

[Service]
Type=simple
User=fivem
WorkingDirectory=/home/fivem/fivem/server
ExecStart=/bin/bash /home/fivem/fivem/server/run.sh
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target

Cela démarre txAdmin, qui gère le serveur de jeu lui-même. Ensuite, activez-le et démarrez-le :

sudo systemctl daemon-reload
sudo systemctl enable fivem
sudo systemctl start fivem

Commandes utiles :

sudo systemctl status fivem
sudo journalctl -u fivem -f
sudo systemctl restart fivem

La ligne journalctl affiche la sortie en direct, c'est où vous lisez le PIN txAdmin au premier démarrage.

Conseil : avec systemd il n'y a pas de console interactive. Exécutez-le avec txAdmin et utilisez la console en direct txAdmin, c'est la raison de préférer txAdmin sur Linux.

#Ouvrir les ports avec ufw

sudo ufw allow OpenSSH
sudo ufw allow 30120/tcp
sudo ufw allow 30120/udp
sudo ufw allow 40120/tcp
sudo ufw enable

Autorisez SSH avant d'activer ufw, sinon vous vous verrouillez vous-même. La règle 40120 est pour txAdmin : si vous gérez le serveur uniquement à partir du VPS via un tunnel SSH, vous pouvez la laisser de côté. Vérifiez aussi le panneau de pare-feu de votre fournisseur d'hébergement. La vérification complète du réseau, y compris le test avec F8 connect, est dans Le serveur FiveM ne s'affiche pas : port forwarding et pare-feu.

#Mise à jour plus tard

Pour mettre à jour, arrêtez le service, remplacez le contenu de ~/fivem/server par un nouvel artifact, et redémarrez-le. Votre txData et server-data restent en place. Les détails sont dans mise à jour des artifacts serveur FiveM.

#Liste de contrôle