Accéder à txAdmin en localhost pour tester son serveur FiveM
Par Benjamin D. · PDG
· Lecture 8 min
Sommaire
txAdmin en localhost s'ouvre dans un navigateur à l'adresse http://127.0.0.1:40120, après avoir démarré FXServer.exe et saisi le PIN à quatre chiffres affiché dans la console. Cette interface web pilote FXServer depuis ta propre machine : déploiement de recette, console live, gestion des joueurs et des ressources, le tout avant la moindre mise en ligne publique.
À quoi sert l'interface web de txAdmin sur ta machine
txAdmin est livré directement dans les artifacts FXServer. Tu n'as rien à installer en plus : le binaire, lancé sans fichier de configuration, ouvre un panneau web sur ta boucle locale et attend tes instructions. C'est ce panneau qui écrit le server.cfg, télécharge les ressources d'une recette et supervise le processus du jeu.
En local, il joue le rôle de banc d'essai. Tu vérifies qu'un framework démarre, qu'une ressource ne crache pas d'erreur au chargement, que la base de données répond, sans exposer quoi que ce soit à Internet. Une fois la maquette stable, le passage vers un hébergement FiveM se résume à transférer le dossier de données et à réadapter les endpoints.
Le panneau couvre aussi la partie administration : liste des admins, permissions, système de bans et de warns, redémarrages planifiés, sauvegarde du server.cfg. Ces réglages se testent bien plus confortablement sur ta machine que sous la pression d'une communauté connectée.
Accéder au panel txAdmin en localhost : port 40120 et adresse 127.0.0.1
Le panneau écoute par défaut sur le port TCP 40120, uniquement en HTTP. Trois adresses mènent au même endroit depuis ta machine : http://127.0.0.1:40120, http://localhost:40120 et l'IP locale de ta carte réseau. Aucune de ces trois n'est accessible depuis l'extérieur tant que tu ne rediriges rien sur ta box.
Démarrer FXServer et repérer l'URL dans la console
Décompresse les artifacts dans un dossier court, sans accent ni espace, puis exécute le binaire depuis une invite de commandes pour garder les logs sous les yeux.
cd C:\FXServer\server
FXServer.exeLa console affiche alors une bannière txAdmin avec l'URL du panneau et le code d'accès temporaire. Laisse cette fenêtre ouverte : la fermer tue le processus et coupe le panneau en même temps que le jeu.
Changer le port d'écoute par défaut
Si 40120 est déjà pris par un autre logiciel, passe le convar au démarrage. La valeur est libre au-dessus de 1024, évite simplement celles utilisées par tes autres services.
FXServer.exe +set txAdminPort 40125
FXServer.exe +set serverProfile dev +set txAdminPort 40125Le dossier txData et les profils
txAdmin crée un dossier txData à côté du binaire. Il contient admins.json, la configuration globale et un sous-dossier par profil. Un profil équivaut à une instance : configuration, ressources, base de données déclarée, historique des actions. Travailler avec un profil dev distinct du profil de production évite d'écraser une configuration qui tourne.
| Port | Protocole | Usage |
|---|---|---|
| 40120 | TCP | Interface web txAdmin |
| 30120 | TCP + UDP | Trafic de jeu et endpoint HTTP FXServer |
| 3306 | TCP | MariaDB ou MySQL local pour ESX, QBCore, vRP |
Le PIN d'authentification et le compte administrateur maître
Au tout premier démarrage, aucun compte n'existe. txAdmin génère un code à quatre chiffres, l'affiche dans la console et l'accepte pendant cinq minutes. Tu le saisis dans le navigateur, puis tu définis un identifiant et un mot de passe maître, ou tu relies le compte à ton identité Cfx.re.
Récupérer un nouveau code si le délai est dépassé
Le code expire vite et n'est valable qu'une fois. S'il est périmé, arrête le processus avec Ctrl + C dans la console et relance le binaire : un nouveau code apparaît. Si tu as perdu l'accès à un compte maître déjà créé, supprime txData/admins.json puis redémarre pour repartir sur une configuration d'authentification vierge.
del C:\FXServer\server\txData\admins.json
FXServer.exeSécuriser le compte maître
Même sur une machine personnelle, un mot de passe long reste la base : ce compte peut exécuter des commandes arbitraires dans la console du jeu. Ajoute ensuite des comptes secondaires avec des permissions limitées pour tes modérateurs, plutôt que de partager l'accès maître. Le fichier admins.json se lit en clair, ne le mets jamais dans un dépôt Git public.
Pare-feu Windows et accès depuis le réseau local
Le trafic vers 127.0.0.1 ne traverse pas le filtre du pare-feu Windows. Tant que tu ouvres le panneau depuis la machine qui exécute FXServer, aucune règle n'est nécessaire, et une alerte de blocage n'a rien à voir avec le panneau lui-même.
Autoriser FXServer sur le réseau privé
La boîte de dialogue qui apparaît au premier lancement concerne le composant réseau du jeu. Coche « Réseaux privés » et laisse « Réseaux publics » décoché : cela suffit pour qu'un autre PC de ton logement rejoigne la partie de test. Si tu as cliqué trop vite sur Annuler, la règle se recrée dans Pare-feu Windows Defender, section Règles de trafic entrant.
Règles netsh pour un test à plusieurs
En ligne de commande, avec une invite en administrateur :
netsh advfirewall firewall add rule name="FXServer TCP" dir=in action=allow protocol=TCP localport=30120
netsh advfirewall firewall add rule name="FXServer UDP" dir=in action=allow protocol=UDP localport=30120
netsh advfirewall firewall add rule name="txAdmin Web" dir=in action=allow protocol=TCP localport=40120 remoteip=localsubnetLe paramètre remoteip=localsubnet limite l'interface web à ton réseau domestique. C'est la précaution minimale : le panneau parle en HTTP, sans chiffrement, et n'a rien à faire sur une IP publique en clair. Pour y accéder à distance plus tard, un tunnel SSH est la bonne réponse.
ssh -L 40120:127.0.0.1:40120 utilisateur@ip-de-la-machineTester une session FiveM avant la mise en ligne
Une fois le déploiement terminé et le processus démarré depuis le panneau, le jeu écoute sur 30120. Lance le client FiveM, ouvre la console avec F8 et connecte-toi en direct.
connect 127.0.0.1
connect 127.0.0.1:30120Se connecter en direct connect depuis le client
L'onglet « Direct Connect » du client accepte la même adresse. Ton instance locale n'apparaît pas dans la liste publique tant que sv_master1 n'est pas actif et que la clé de licence Cfx.re n'est pas renseignée dans server.cfg. Pour du test pur, garde sv_maxClients bas et ajoute une ligne set sv_endpointPrivacy true.
Vérifier les ressources et la console live
La page Live Console reproduit la sortie du processus en temps réel et accepte les commandes serveur. C'est là que tu repères une ressource qui refuse de démarrer, un handler SQL mal configuré ou un script qui log en boucle. La page Resources permet de relancer une ressource isolée sans redémarrer l'ensemble.
refresh
ensure mon_script
stop mon_script
restart mon_scriptPour les frameworks type ESX ou QBCore, installe MariaDB en local et importe le dump SQL avant de démarrer, sinon la moitié des ressources échouera silencieusement. La chaîne de connexion se déclare dans server.cfg via set mysql_connection_string. La documentation officielle FiveM détaille la syntaxe attendue.
Diagnostiquer les erreurs de connexion à l'interface web
Connexion refusée sur 127.0.0.1
Un ERR_CONNECTION_REFUSED signifie que rien n'écoute sur le port demandé : le processus est arrêté, ou il a démarré sur un autre numéro. Vérifie l'occupation du port, puis remonte au programme concerné.
netstat -ano | findstr :40120
tasklist /FI "PID eq 12345"Autre piste fréquente : un antivirus qui met le binaire en quarantaine, ou un proxy système qui intercepte les requêtes locales. Désactive temporairement le proxy pour les adresses locales dans les options réseau de Windows et recharge la page.
Le déploiement de recette reste bloqué
Une recette qui plafonne à une étape de téléchargement vient presque toujours d'un dépôt Git inaccessible ou d'un dossier cible non vide. Choisis un chemin vierge, sans OneDrive ni synchronisation cloud, et relance le déploiement. Les logs détaillés se trouvent dans txData/, ils nomment précisément la ressource fautive.
- Panneau accessible mais jeu injoignable : le processus FXServer est arrêté, regarde l'état dans la console live.
- PIN refusé : code expiré ou déjà consommé, redémarre le binaire.
- Page blanche : cache navigateur, force le rechargement avec
Ctrl + F5. - Port occupé au démarrage : une instance fantôme tourne encore, termine le processus dans le gestionnaire des tâches.
Ces réflexes de diagnostic restent identiques une fois le projet migré sur une machine distante, avec en plus les règles ufw côté Linux. Les mêmes logiques s'appliquent d'ailleurs à un Serveur RedM, qui utilise la même base FXServer et le même panneau. D'autres tutoriels d'administration sont regroupés sur le Blog Nexus Games, et le catalogue complet est visible depuis Tous nos serveurs de jeux.
Conclusion
Garde le panneau sur la boucle locale pendant toute la phase de test : pas de règle de pare-feu, pas d'exposition inutile, et un cycle de correction beaucoup plus rapide. L'erreur à ne pas commettre en premier, c'est d'ouvrir 40120 vers Internet en HTTP avec un mot de passe faible : un tunnel SSH règle le problème en une commande. Sauvegarde txData et ton dump SQL avant chaque migration, tu récupéreras ta configuration à l'identique.
FAQ
Peut-on faire tourner deux instances txAdmin sur la même machine ?
Oui, à condition de séparer trois éléments : le profil, le port du panneau et le port de jeu. Lance chaque instance avec +set serverProfile nom_du_profil, un +set txAdminPort différent, et modifie endpoint_add_tcp ainsi que endpoint_add_udp dans chaque server.cfg. Chaque profil garde ses propres ressources, sa base de données et sa liste d'administrateurs, sans interférence entre les deux.
FXServer démarre-t-il sans clé de licence Cfx.re ?
Le panneau web s'ouvre et permet de configurer le déploiement, mais le processus de jeu refusera de se lancer tant que la ligne sv_licenseKey reste vide ou invalide. La clé se génère depuis le portail keymaster de Cfx.re en associant une IP ou un identifiant de machine. Renseigne-la dans server.cfg, puis relance le processus depuis la page d'accueil du panneau.
Comment sauvegarder la configuration de txAdmin avant une migration ?
Copie l'intégralité du dossier txData : il regroupe admins.json, les paramètres globaux, le server.cfg, les ressources et l'historique des sanctions. Exporte séparément ta base de données avec mysqldump -u root -p nom_base > backup.sql. Sur la nouvelle machine, replace le dossier au même niveau que le binaire, réimporte le dump, puis corrige les chemins absolus et les endpoints réseau avant le premier démarrage.
