Aller au contenu
+90 850 303 07 52 [email protected]
Assistance Espace client
Sur une sélection d'offres d'hébergement annuelles et de VDS sur 3 mois, nom de domaine .com / .com.tr offert la première année · Voir les offres

Guides

Des guides pas à pas pour installer et gérer votre propre serveur, serveur de jeu ou site web, rédigés par l'équipe qui exploite notre infrastructure à Istanbul.

FiveM

Comment installer la base de données FiveM : MariaDB et HeidiSQL au lieu de XAMPP

26 août 2026 17 min de lecture Mis à jour :
Partager cet article

Dans ce guide, vous allez apprendre à installer la base de données de votre serveur FiveM avec MariaDB autonome au lieu de XAMPP, sur un VDS Windows ou Linux. Vous verrez étape par étape comment créer un utilisateur dédié au serveur de jeu, vous connecter en toute sécurité avec HeidiSQL, écrire la chaîne de connexion oxmysql, garder le port 3306 fermé vers l'extérieur, puis réaliser et restaurer des sauvegardes automatiques. Les exemples reprennent les mêmes noms que le guide d'installation de QBCore (la base de données et l'utilisateur qbcore).

Avant de commencer

Sur les serveurs roleplay, les personnages, l'argent, les inventaires et les véhicules sont stockés dans une base de données SQL, et non dans les fichiers du jeu ; les ressources FiveM se connectent à cette base via oxmysql. Pour l'installation, il vous faut :

  • Un VDS : Windows Server ou Ubuntu/Debian. La base de données tournera sur la même machine que le serveur de jeu. Pour des offres prêtes à l'emploi, consultez la page Location de serveur FiveM ; la gamme que HanHosting recommande pour FiveM est le VDS AMD Ryzen 9 9950X.
  • Un accès administrateur : Administrator via RDP sous Windows ; root ou un utilisateur disposant des droits sudo via SSH sous Linux.
  • Un FXServer fonctionnel : si vous ne l'avez pas encore installé, suivez d'abord le guide d'installation de FXServer.
  • Un mot de passe robuste : la documentation d'oxmysql demande d'éviter les caractères ; , / ? : @ & = + $ # dans la chaîne de connexion. Choisissez un mot de passe long, composé uniquement de lettres et de chiffres.

Pourquoi pas XAMPP ? Les anciens guides vous font installer XAMPP, puis démarrer Apache et MySQL avec « Start ». XAMPP est un ensemble de développement, et la seule partie dont FiveM a besoin est la base de données. La documentation d'oxmysql recommande de ne pas installer XAMPP uniquement pour la base de données et d'installer directement MariaDB ; Qbox, de son côté, ne prend pas du tout en charge XAMPP.

SujetXAMPPMariaDB autonome
Usage prévuD'après la FAQ d'Apache Friends, prévu uniquement comme environnement de développement, pas pour la productionLogiciel serveur ; fonctionne comme un service à démarrage automatique sous Windows et sous le nom mariadb.service sous Linux
Version de MariaDBLe paquet XAMPP 8.2.12 actuel fournit MariaDB 10.4.32 ; la série 10.4 ne figure plus dans la liste des versions actuelles de mariadb.orgSéries LTS actuelles : 10.11, 11.4, 11.8 et 12.3
Sécurité par défautD'après la FAQ, root n'a pas de mot de passe et la base de données est accessible depuis le réseauroot est protégé dès l'installation ; la connexion à distance de root est désactivée
Composants supplémentairesApache, PHP, phpMyAdminAucun (le paquet Windows inclut également HeidiSQL)

1. Installer MariaDB

Linux (Ubuntu/Debian) : installez le paquet depuis le dépôt de la distribution, lancez le script de sécurisation et vérifiez la version :

sudo apt-get update
sudo apt-get install mariadb-server
sudo mariadb-secure-installation
mariadb --version

Le script vous demande s'il faut supprimer les utilisateurs anonymes et la base de données test, et s'il faut désactiver la connexion à distance de root ; répondez oui. Dans les paquets Debian et Ubuntu, root se connecte avec l'authentification unix_socket : sudo mariadb ouvre la console SQL sans demander de mot de passe, si bien qu'il n'est généralement pas nécessaire de définir un mot de passe root distinct. Si vous comptez utiliser Qbox, la version doit être au moins la 10.9.0 ; si la version du dépôt est plus ancienne, ajoutez le dépôt de paquets propre à MariaDB et installez une LTS actuelle.

Windows : sur la page mariadb.org/download, téléchargez le paquet MSI pour Windows d'une série LTS (p. ex. 12.3) et exécutez-le. Pendant l'installation :

  • Définissez un mot de passe robuste pour root. Laissez la case Enable access from remote machines for 'root' user décochée.
  • Laissez activée l'installation en tant que service ; le nom de service par défaut est MariaDB.
  • Gardez le réseau (networking) activé, sur le port 3306. oxmysql se connecte à la base de données via TCP.
  • Le composant HeidiSQL est sélectionné par défaut ; vous n'avez pas besoin de le télécharger séparément.

2. Créer la base de données et l'utilisateur FiveM

Ne connectez pas FiveM avec un root sans mot de passe comme le font les anciens guides : root dispose de tous les privilèges sur toutes les bases de données, et la fuite d'un fichier server.cfg exposerait tout le contenu du serveur. Créez un utilisateur distinct qui n'a de privilèges que sur sa propre base de données. Exécutez les commandes dans la console sudo mariadb sous Linux, ou sous Windows dans l'onglet de requête d'une session ouverte en tant que root dans HeidiSQL (les paramètres de connexion se trouvent à l'étape 4) :

CREATE DATABASE qbcore CHARACTER SET utf8mb4;
CREATE USER 'qbcore'@'localhost' IDENTIFIED BY 'YOUR_PASSWORD';
GRANT ALL PRIVILEGES ON qbcore.* TO 'qbcore'@'localhost';
SHOW GRANTS FOR 'qbcore'@'localhost';
  • utf8mb4 garantit que les caractères accentués (é, è, à, ç) et les emojis sont stockés correctement.
  • 'localhost' n'autorise que les connexions provenant de la même machine ; cet utilisateur ne peut pas se connecter depuis Internet.
  • qbcore.* limite les privilèges à cette base de données. Comme les scripts créent et modifient leurs propres tables, accorder tous les privilèges sur cette base est la solution pratique.
  • Si vous utilisez ESX, choisissez vos propres noms (p. ex. esx). Le cœur d'ESX, es_extended, déclare lui aussi oxmysql comme dépendance ; les étapes s'appliquent telles quelles.
  • Pour changer le mot de passe, exécutez ALTER USER 'qbcore'@'localhost' IDENTIFIED BY 'NEW_PASSWORD'; et mettez aussi à jour la chaîne dans server.cfg.

3. Garder l'accès distant fermé

Si la base de données se trouve sur la même machine que le serveur de jeu, rien ne justifie que le port 3306 soit ouvert sur Internet ; un port de base de données ouvert est une cible directe pour les attaques par force brute (essais répétés de mots de passe). Mettez en place deux couches de protection : MariaDB ne doit écouter que sur 127.0.0.1, et le pare-feu ne doit contenir aucune règle d'autorisation pour 3306.

Linux : dans le paquet Debian et Ubuntu, le fichier /etc/mysql/mariadb.conf.d/50-server.cnf est fourni avec bind-address = 127.0.0.1. Vérifiez l'adresse d'écoute :

sudo ss -tlnp | grep 3306

Vous devez voir 127.0.0.1:3306 dans la sortie. Si vous voyez 0.0.0.0:3306 ou *:3306, trouvez le réglage avec grep -r bind-address /etc/mysql/, remplacez la valeur par 127.0.0.1 et redémarrez le service avec sudo systemctl restart mariadb. N'ajoutez pas de règle comme ufw allow 3306.

Windows : vérifiez l'adresse d'écoute dans un PowerShell administrateur :

netstat -an | findstr :3306

Si bind-address est laissé vide, MariaDB écoute sur toutes les adresses, et sur une installation Windows ce réglage n'est généralement pas défini. Si vous voyez 0.0.0.0:3306 ou [::]:3306 dans la sortie, ouvrez le « Notepad » (Bloc-notes) en tant qu'administrateur et, dans le fichier C:\Program Files\MariaDB 12.3\data\my.ini (le nom du dossier dépend de la version), ajoutez cette ligne sous l'en-tête [mysqld] :

bind-address=127.0.0.1

Redémarrez ensuite le service avec Restart-Service MariaDB et répétez la commande netstat ; seul 127.0.0.1:3306 doit rester. Si les règles de trafic entrant du « Windows Defender Firewall » (pare-feu Windows Defender) contiennent une règle d'autorisation pour 3306 ou pour MariaDB, désactivez-la. Pour plus de détails, consultez le guide du pare-feu et de l'ouverture de ports.

4. Se connecter avec HeidiSQL et importer un fichier SQL

HeidiSQL est un client de base de données qui sert à examiner les tables, à corriger les données des joueurs et à exécuter les fichiers SQL des scripts (la version actuelle est la 12.21 ; il existe aussi des versions pour Linux et macOS). Sous Windows, il est fourni avec MariaDB ; si vous voulez l'installer séparément, vous pouvez l'obtenir sur heidisql.com ou avec la commande winget install HeidiSQL.HeidiSQL. L'utilisation générale du programme est traitée dans le guide HeidiSQL ; vous ne trouverez ici que les étapes nécessaires pour FiveM.

Sur un VDS Windows : connectez-vous au serveur via RDP, ouvrez-y HeidiSQL et créez une nouvelle session dans le gestionnaire de sessions :

  • Network type : MariaDB or MySQL (TCP/IP)
  • Hostname/IP : 127.0.0.1
  • User et Password : qbcore et son mot de passe (root pour les tâches d'administration comme la création d'utilisateurs)
  • Port : 3306

Depuis votre ordinateur vers un VDS Linux : au lieu d'ouvrir le port 3306, utilisez un tunnel SSH ; HeidiSQL fait passer la connexion par SSH jusqu'à l'intérieur du serveur. Sélectionnez MariaDB or MySQL (SSH tunnel) comme Network type. Dans l'onglet SSH tunnel, saisissez l'adresse IP du VDS comme hôte SSH, le port 22, votre nom d'utilisateur et votre mot de passe SSH (ou votre fichier de clé privée), et indiquez un port local libre dans le champ Local port (HeidiSQL propose 3307 par défaut). Dans l'onglet Settings, saisissez le nom d'hôte 127.0.0.1, le port 3306 et votre utilisateur de base de données. Si vous découvrez les connexions SSH, consultez le guide SSH avec PuTTY.

Importer un fichier SQL : la plupart des scripts sont fournis avec un fichier .sql qui crée leurs tables. Sélectionnez la base de données qbcore dans la liste de gauche et exécutez le fichier avec File → Run SQL file... ; choisissez UTF-8 comme encodage (Encoding). La documentation de HeidiSQL avertit que l'option « Auto detect » peut entraîner des données corrompues. Pour voir d'abord le contenu, vous pouvez ouvrir le fichier dans un onglet de requête avec Load SQL file....

5. Écrire la chaîne de connexion oxmysql dans server.cfg

oxmysql est la ressource par laquelle les ressources FiveM se connectent à la base de données ; qb-core et es_extended l'exigent comme dépendance. Si vous avez installé le serveur avec la recette txAdmin, elle est déjà en place. Si vous l'installez manuellement, téléchargez le dernier paquet publié depuis la page Releases du dépôt overextended/oxmysql sur GitHub et extrayez-le dans resources ; ne clonez pas le dépôt. Ajoutez ensuite ce qui suit à server.cfg :

set mysql_connection_string "mysql://qbcore:[email protected]:3306/qbcore"
set mysql_slow_query_warning 150

ensure oxmysql
ensure qb-core
  • La documentation d'oxmysql demande de définir cette variable uniquement avec set et précise que la chaîne de connexion doit être définie avant le démarrage des autres ressources.
  • Le second format valide : user=qbcore;password=YOUR_PASSWORD;host=127.0.0.1;port=3306;database=qbcore. Si votre mot de passe contient l'un des caractères spéciaux mentionnés plus haut, la documentation conseille d'essayer l'autre format.
  • Dans la documentation, la ligne d'oxmysql figure en haut de la liste sous la forme start oxmysql ; au démarrage du serveur, ensure lance lui aussi une ressource qui n'a pas encore été démarrée : il remplit donc la même fonction.
  • Le localhost du guide QBCore fonctionne aussi sur la plupart des installations ; toutefois, comme MariaDB n'écoute que sur 127.0.0.1, écrire 127.0.0.1 est plus précis, car sur certains systèmes localhost est d'abord résolu en adresse IPv6 (::1).
  • mysql_slow_query_warning est le seuil à partir duquel un avertissement est affiché dans la console pour les requêtes lentes (l'exemple de la documentation est 150).

6. Réaliser des sauvegardes et les automatiser

Les offres VDS de HanHosting n'incluent pas de sauvegarde automatique ; la sauvegarde de la base de données relève de votre responsabilité. Comme toutes les données des joueurs se trouvent dans cette base, faites au moins une sauvegarde par jour. mariadb-dump exporte la base de données dans un seul fichier .sql ; l'option --single-transaction sauvegarde les tables InnoDB à un instant cohérent sans verrouiller les applications, ce qui vous permet de sauvegarder pendant que le serveur tourne.

Sauvegarde manuelle (HeidiSQL) : faites un clic droit sur la base de données et ouvrez la commande Export database as SQL ; cochez les cases Drop et Create pour les tables et l'option INSERT pour les données, puis écrivez la sortie dans un seul fichier .sql.

Sauvegarde automatique sous Linux : comme root se connecte sans mot de passe via unix_socket, vous n'avez pas besoin de conserver de mot de passe dans le script. Créez le dossier et le script :

sudo mkdir -p /root/db-backup
sudo nano /usr/local/bin/fivem-db-backup.sh

Écrivez ceci dans le fichier :

#!/bin/bash
mariadb-dump --single-transaction qbcore | gzip > /root/db-backup/qbcore-$(date +%F_%H%M).sql.gz
find /root/db-backup -name 'qbcore-*.sql.gz' -mtime +14 -delete

Rendez le script exécutable, testez-le une fois manuellement et ouvrez les tâches planifiées de root :

sudo chmod 700 /usr/local/bin/fivem-db-backup.sh
sudo /usr/local/bin/fivem-db-backup.sh
sudo crontab -e

Ajoutez à la fin du fichier une ligne pour qu'il s'exécute chaque nuit à 04:30 :

30 4 * * * /usr/local/bin/fivem-db-backup.sh

La dernière ligne du script supprime les sauvegardes de plus de 14 jours. Le format de date reste dans le script, car un signe % écrit dans une ligne crontab est transformé en saut de ligne.

Sauvegarde automatique sous Windows : créez le dossier C:\backup et placez-y deux fichiers. backup.cnf garde le mot de passe hors de la ligne de commande ; la documentation de MariaDB considère comme non sécurisé le fait de passer le mot de passe en ligne de commande :

[client]
user=qbcore
password=YOUR_PASSWORD

backup.ps1 :

$date = Get-Date -Format "yyyy-MM-dd_HHmm"
$file = "C:\backup\qbcore-$date.sql"
& "C:\Program Files\MariaDB 12.3\bin\mariadb-dump.exe" --defaults-extra-file=C:\backup\backup.cnf --single-transaction "--result-file=$file" qbcore
Get-ChildItem C:\backup\qbcore-*.sql | Where-Object { $_.LastWriteTime -lt (Get-Date).AddDays(-14) } | Remove-Item

--defaults-extra-file doit être la première option. Au lieu de rediriger la sortie avec >, utilisez --result-file ; la documentation de MariaDB le recommande sous Windows pour que les fins de ligne ne soient pas modifiées. Exécutez d'abord le script manuellement et vérifiez que le fichier est créé, puis créez la tâche (« Command Prompt », l'invite de commandes, ouverte en tant qu'administrateur) :

powershell.exe -NoProfile -ExecutionPolicy Bypass -File C:\backup\backup.ps1
schtasks /create /tn "FiveM DB Backup" /tr "powershell.exe -NoProfile -ExecutionPolicy Bypass -File C:\backup\backup.ps1" /sc daily /st 04:30 /ru System

-ExecutionPolicy Bypass ne s'applique qu'à cette session ; il ne modifie pas le réglage global du système. Comme backup.cnf contient un mot de passe, gardez le dossier en dehors du répertoire de FXServer.

Mettre une copie hors du serveur : une sauvegarde située sur le même disque est perdue avec les données en cas de panne de disque ou de réinstallation accidentelle (formatage). Copiez régulièrement le dossier de sauvegarde via SFTP vers l'espace de sauvegarde cloud ou vers votre propre ordinateur.

7. Restaurer une sauvegarde

Avant la restauration, arrêtez le serveur FiveM depuis txAdmin afin qu'aucune donnée ne soit écrite pendant l'import. Par défaut, mariadb-dump écrit une ligne DROP TABLE avant chaque table (dans HeidiSQL, c'est la case Drop qui s'en charge) ; autrement dit, les tables existantes sont remplacées par leur état dans la sauvegarde. Si la base de données n'existe pas encore (par exemple si vous migrez vers un nouveau serveur), effectuez d'abord l'étape 2.

Linux :

sudo zcat /root/db-backup/qbcore-DATE.sql.gz | sudo mariadb qbcore

Windows (« Command Prompt ») :

"C:\Program Files\MariaDB 12.3\bin\mariadb.exe" -u qbcore -p qbcore -e "source C:/backup/qbcore-DATE.sql"

-p demande le mot de passe ; le qbcore final est le nom de la base de données. Dans HeidiSQL, vous pouvez aussi sélectionner la base de données et exécuter le fichier de sauvegarde avec File → Run SQL file... en encodage UTF-8. Vérifiez vos sauvegardes de temps en temps en les chargeant dans une base de données de test vide.

Exemple de configuration

RéglageValeurEmplacement
Nom de la base de données et jeu de caractèresqbcore, utf8mb4CREATE DATABASE
Utilisateur FiveM'qbcore'@'localhost'CREATE USER
PrivilègesALL PRIVILEGES ON qbcore.*GRANT
Adresse d'écoutebind-address = 127.0.0.1Linux : 50-server.cnf ; Windows : data\my.ini
Port3306, fermé dans le pare-feuValeur par défaut de MariaDB
Chaîne de connexionmysql://qbcore:[email protected]:3306/qbcoreserver.cfg (set)
Avertissement de requête lente150server.cfg (set mysql_slow_query_warning)
SauvegardeChaque nuit à 04:30, conservation 14 jours, copie hors du serveurcron / « Task Scheduler » (planificateur de tâches)

Erreurs fréquentes

  • Access denied for user 'qbcore'@'localhost' : le mot de passe ou le nom d'utilisateur est incorrect, ou l'utilisateur a été créé avec un autre hôte. Vérifiez avec SHOW GRANTS FOR 'qbcore'@'localhost'; et, si nécessaire, redéfinissez le mot de passe avec ALTER USER.
  • Le message d'erreur mentionne 'qbcore'@'127.0.0.1' : le serveur n'associe pas la connexion au compte localhost. D'après la documentation de MariaDB, sous Linux, une connexion arrivant par 127.0.0.1 n'est pas toujours considérée comme « localhost » ; si skip_name_resolve est activé, seules les adresses IP sont utilisées. Créez aussi le même utilisateur pour 'qbcore'@'127.0.0.1' et accordez-lui les mêmes privilèges.
  • ECONNREFUSED ou « connection refused » : MariaDB n'est pas en cours d'exécution. Vérifiez son état avec sudo systemctl status mariadb sous Linux, ou l'entrée MariaDB dans la liste « Services » sous Windows. Si l'erreur contient ::1:3306, localhost a été résolu en adresse IPv6 ; écrivez 127.0.0.1 dans la chaîne.
  • Le service MariaDB ne démarre pas, ou le port 3306 semble occupé : le MySQL de XAMPP ou une autre base de données tourne peut-être en arrière-plan. Trouvez le PID du processus qui utilise le port avec netstat -ano | findstr :3306 et vérifiez dans le « Task Manager » (Gestionnaire des tâches) de quel programme il s'agit.
  • Les caractères accentués s'affichent en « ? » ou sont illisibles : la base de données n'a pas été créée avec utf8mb4, ou le fichier SQL a été importé avec un mauvais encodage. Créez les nouvelles bases de données avec CHARACTER SET utf8mb4 et choisissez UTF-8 lors de l'import dans HeidiSQL.
  • « Table 'qbcore.players' doesn't exist » : le fichier .sql du framework ou du script n'a pas été importé. Exécutez-le comme à l'étape 4.

Questions fréquentes

J'ai déjà tout installé avec XAMPP. Comment transférer les données ?

Arrêtez le serveur FiveM, connectez-vous avec HeidiSQL à la base de données de XAMPP (dans XAMPP, l'utilisateur par défaut est root et le mot de passe est vide), puis utilisez Export database as SQL pour exporter un seul fichier .sql. Après avoir vérifié que le fichier s'ouvre, arrêtez MySQL depuis le XAMPP Control Panel ; si vous n'utilisez XAMPP pour rien d'autre, désinstallez-le. Installez MariaDB comme aux étapes 1 à 3, importez le fichier comme à l'étape 7 et mettez à jour la chaîne de connexion dans server.cfg avec le nouvel utilisateur.

Ces étapes sont-elles nécessaires lors d'une installation avec la recette txAdmin ?

Les étapes 1 à 3 le sont, car la recette n'installe pas MariaDB. Dans la section Show/Hide Database options (advanced) de l'assistant d'installation, vous saisissez les informations créées ici dans les champs Database Host, Database Port, Database Username, Database Password et Database Name (avec 127.0.0.1 comme hôte) ; la recette QBCore exécute elle-même le fichier SQL. L'interrupteur Delete Database est activé par défaut et supprime une base de données du même nom avec toutes ses données ; désactivez-le si la base contient des données. Les détails figurent dans le guide QBCore.

Quelle version de MariaDB choisir ?

Choisissez l'une des séries à support à long terme (LTS). Les séries actuelles sur mariadb.org sont 10.11, 11.4, 11.8 et 12.3, et ce sont toutes des LTS. Qbox exige au moins MariaDB 10.9.0 et recommande la 12.3 LTS. Sous Windows, choisissez la 12.3 pour une nouvelle installation. Sous Linux, la version du dépôt de la distribution suffit pour QBCore et ESX ; pour Qbox, elle doit être au moins la 10.9.

Faut-il déplacer la base de données sur un serveur séparé ?

Pour un seul serveur FiveM, ce n'est pas nécessaire dans la plupart des cas. Une connexion à MariaDB sur le même VDS ne passe pas par le réseau, et vous n'avez pas du tout besoin d'ouvrir le port 3306. Si vous utilisez un serveur séparé, vous devez ouvrir le port, n'autoriser que l'adresse IP du serveur de jeu dans le pare-feu et créer l'utilisateur pour cette IP au lieu de 'localhost'.

Guides associés

Pour d'autres guides FiveM, parcourez la page Guides FiveM.

Commentaires0

Pas encore de commentaire

Soyez le premier à partager votre avis.

Rejoignez la discussion

Veuillez vous connecter ou vous inscrire pour laisser un commentaire.

Ne manquez aucun article

Recevez nos derniers tutoriels, guides et actualités produit dans votre boîte de réception.

Votre abonnement à notre newsletter est confirmé.