Installer et Configurer txAdmin sur un VPS

Verfasst von · Veröffentlicht am · Aktualisiert am

Guide pas-à-pas pour installer FXServer et le panel txAdmin sur un VPS Linux, y accéder pour la première fois et le sécuriser.

Voir les offres VPS Serveur FiveM géré (Gamost)

txAdmin est le panel d'administration officiel de FXServer, le moteur des serveurs FiveM et RedM. Il est développé par CitizenFX et directement intégré à chaque build de FXServer depuis plusieurs années, il n'y a plus rien à télécharger séparément. Ce guide couvre l'installation sur un VPS Linux nu (auto-hébergement), à distinguer d'un serveur FiveM géré comme celui de Gamost, notre filiale gaming, où txAdmin est déjà préinstallé et configuré.

À la fin de ce guide, votre panel sera accessible depuis votre navigateur, protégé par un pare-feu correctement configuré, avec un compte administrateur créé et un premier serveur FiveM déployé.

Prérequis

  • Un VPS Linux (Ubuntu 22.04/24.04 ou Debian 12 recommandés) avec accès root SSH. 2 vCPU et 4 Go RAM minimum pour un serveur RP avec quelques dizaines de joueurs
  • Une clé de licence Cfx.re gratuite, à générer sur keymaster.fivem.net (nécessite un compte Cfx.re lié à Steam ou Discord)
  • Un client SSH (le terminal suffit sous Linux/macOS, PuTTY ou Windows Terminal sous Windows)

Étape 1 : préparer le VPS

  1. Connectez-vous en SSH : ssh root@votre-ip
  2. Mettez à jour le système : apt update && apt upgrade -y
  3. Créez un utilisateur dédié non-root : adduser fxserver && usermod -aG sudo fxserver, puis reconnectez-vous avec ce compte
  4. Installez les dépendances système : sudo apt install -y curl wget xz-utils ca-certificates

Étape 2 : télécharger et lancer FXServer

txAdmin est intégré au binaire FXServer, l'installer revient simplement à télécharger le bon build et à le lancer une première fois.

  1. Créez le dossier du serveur : mkdir -p ~/fivem-server && cd ~/fivem-server
  2. Téléchargez le dernier build Linux depuis runtime.fivem.net : wget https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/fx.tar.xz
  3. Extrayez l'archive : tar xf fx.tar.xz
  4. Lancez FXServer une première fois : ./run.sh
  5. Comme aucun server.cfg n'existe encore, FXServer démarre automatiquement en mode setup txAdmin et affiche dans le terminal l'URL et le PIN à saisir pour finaliser la configuration depuis votre navigateur

Étape 3 : premier accès au panel (le fameux port 40120)

C'est le point qui génère le plus de confusion : txAdmin n'écoute pas sur le port du jeu (30120) mais sur son propre port, 40120 par défaut.

  1. Ouvrez dans votre navigateur : http://votre-ip:40120
  2. Si la page ne charge pas, le pare-feu du VPS bloque probablement le port, voir la section sécurisation ci-dessous avant toute chose
  3. Saisissez le PIN affiché dans le terminal SSH pour vous authentifier à la configuration initiale
  4. Créez votre compte administrateur (identifiant + mot de passe fort, 2FA disponible)
  5. Choisissez une recipe de déploiement : "cfx-default" pour une base vanilla, ou collez l'URL d'une recipe communautaire (QBCore, ESX Legacy, etc.) pour partir d'un framework RP complet
  6. Collez votre clé de licence Cfx.re obtenue à l'étape prérequis, puis validez : txAdmin télécharge et configure automatiquement les fichiers serveur

Étape 4 : sécuriser l'accès au panel

Un panel d'administration exposé sans restriction sur Internet est une cible évidente. Trois mesures indispensables :

  • Restreindre le port 40120 avec UFW : ufw allow from VOTRE_IP to any port 40120 puis ufw deny 40120 en règle générale, seule votre IP (ou celle de vos co-admins) accède au panel. Ouvrez aussi le port du jeu : ufw allow 30120/tcp && ufw allow 30120/udp, puis activez : ufw enable
  • Ne jamais désactiver l'authentification même en test rapide : txAdmin propose un mode sans mot de passe pour du dev local, à ne jamais utiliser sur un VPS avec IP publique
  • Passer derrière un reverse-proxy HTTPS (optionnel mais recommandé en production) : Nginx ou Caddy en frontal avec un sous-domaine (ex. panel.mondomaine.fr) et un certificat Let's Encrypt, plutôt que d'exposer ip:40120 en clair. txAdmin gère nativement l'en-tête X-Forwarded-For derrière un proxy

Faire tourner le serveur 24/7

Une fois configuré, FXServer doit rester actif en permanence, y compris après un reboot du VPS. La méthode recommandée est un service systemd plutôt qu'un simple screen ou tmux, plus fiable pour un redémarrage automatique en cas de crash.

  1. Créez le fichier /etc/systemd/system/fivem.service avec un éditeur (nano)
  2. Renseignez : ExecStart=/home/fxserver/fivem-server/run.sh +exec server.cfg, User=fxserver, Restart=always, RestartSec=5
  3. Rechargez systemd : systemctl daemon-reload
  4. Activez le démarrage automatique : systemctl enable --now fivem
  5. Consultez les logs à tout moment : journalctl -u fivem -f

Dépannage : problèmes de connexion courants

  • "Ce site est inaccessible" sur le port 40120 : dans 90% des cas c'est le pare-feu du VPS (UFW) ou un groupe de sécurité cloud qui bloque le port, vérifiez avec ufw status et ajoutez la règle si absente
  • Le PIN affiché dans le terminal ne fonctionne plus : il expire après quelques minutes, relancez ./run.sh pour en générer un nouveau si vous avez dépassé le délai
  • Page blanche ou erreur 502 derrière un reverse-proxy : vérifiez que le proxy transmet bien les en-têtes WebSocket (Upgrade / Connection), txAdmin utilise une connexion temps réel pour la console et les logs
  • Compte administrateur perdu : supprimez ou renommez le dossier txData/<nom-du-serveur>/data/admins.json puis relancez FXServer pour recréer un compte depuis zéro
  • Le serveur de jeu (port 30120) ne répond pas alors que le panel fonctionne : ce sont deux ports distincts avec des règles de pare-feu séparées, une confusion fréquente. Vérifiez que 30120/tcp ET 30120/udp sont bien ouverts, pas seulement le TCP

Häufig gestellte Fragen

txAdmin écoute par défaut sur le port 40120, distinct du port du jeu FiveM qui est 30120 (TCP et UDP). C'est la confusion la plus fréquente chez les nouveaux administrateurs de serveur.

Oui, txAdmin est entièrement gratuit et open-source, développé et maintenu par l'équipe CitizenFX (éditeur de FiveM). Il est intégré directement au binaire FXServer, aucune licence payante n'est requise pour l'utiliser.

Non. Depuis plusieurs années, txAdmin est intégré nativement à chaque build de FXServer. Télécharger et lancer FXServer suffit, aucune installation distincte n'est nécessaire.

Sur un VPS-KVM By-Hoster classique, vous installez et administrez txAdmin vous-même (ce guide). Sur un serveur FiveM géré par Gamost, notre filiale gaming, txAdmin est déjà installé, configuré et mis à jour pour vous, adapté si vous ne voulez pas gérer la couche système.

Vérifiez dans l'ordre : 1) le pare-feu du VPS autorise bien le port 40120 (ufw status), 2) vous utilisez http:// et non https:// si aucun reverse-proxy n'est configuré, 3) le PIN saisi n'a pas expiré (relancez ./run.sh pour un nouveau PIN si besoin).

Oui. txAdmin gère indifféremment FiveM et RedM, les deux reposent sur le même moteur FXServer. La procédure d'installation et le port par défaut (40120) sont identiques.

Pages liées