
# Installer un serveur FiveM sur Windows Server

FiveM est la plateforme de modification multijoueur la plus populaire pour GTA V. Ce guide vous accompagne pour créer votre propre serveur FiveM sur Windows Server avec txAdmin.

---

## 📋 Avant de commencer

<Prerequisites>

✅ **VPS Windows Server** avec au moins 4 Go de RAM
✅ **Connexion Bureau à distance (RDP)** configurée
✅ **Visual C++ Redistributable** 2019 ou plus récent
✅ **Compte CFX.re** créé sur [keymaster.fivem.net](https://keymaster.fivem.net)
✅ **Clé de licence** FiveM (gratuite sur Keymaster)

</Prerequisites>

<InfoBox>
💡 **Recommandation AtmosNode :** Un VPS avec Ryzen 9 9950X3D, 8 Go RAM DDR5 et NVMe Gen5 offre des performances optimales pour 32-64 joueurs.
</InfoBox>

---

<StepSection number="1" title="Obtenir votre clé de licence FiveM">

Avant toute installation, vous devez obtenir une clé de licence gratuite.

<SubSection title="Créer un compte et générer la clé">

<CodeBlock title="Étapes sur Keymaster">

1. Rendez-vous sur [keymaster.fivem.net](https://keymaster.fivem.net)
2. Connectez-vous avec votre compte CFX.re (ou créez-en un)
3. Cliquez sur "New Server" ou "Generate License Key"
4. Remplissez les informations :
   - **Label** : Nom de votre serveur (ex: "Mon Serveur RP France")
   - **Server IP** : L'IP de votre VPS Windows
   - **Server Type** : Sélectionnez "Server Provider Hosted"
5. Cliquez sur "Generate"
6. Copiez la clé générée (format: `cfxk_xxxxx...`)

</CodeBlock>

<WarningBox>
⚠️ **Important**

Ne partagez JAMAIS votre clé de licence publiquement. Une clé par serveur est nécessaire. Conservez-la en lieu sûr !
</WarningBox>

</SubSection>

</StepSection>

---

<StepSection number="2" title="Préparer le serveur Windows">

Connectez-vous à votre VPS Windows via Bureau à distance et préparez l'environnement.

<SubSection title="Installation des prérequis">

<CodeBlock title="Télécharger Visual C++ Redistributable">

1. Téléchargez [Visual C++ Redistributable 2019+](https://aka.ms/vs/17/release/vc_redist.x64.exe)
2. Exécutez l'installateur
3. Suivez les instructions d'installation
4. Redémarrez si nécessaire

</CodeBlock>

</SubSection>

<SubSection title="Créer la structure de dossiers">

<CodeBlock title="Créer les dossiers nécessaires">

```powershell
# Ouvrir PowerShell en tant qu'Administrateur
# Créer le dossier principal FiveM
mkdir C:\FiveM
cd C:\FiveM

# Créer les sous-dossiers
mkdir server
mkdir server-data
mkdir txData
```

</CodeBlock>

<ToolDescription>

**Structure des dossiers :**

- **C:\FiveM\server** → Fichiers du serveur FiveM (artifacts)
- **C:\FiveM\server-data** → Configuration et ressources du serveur
- **C:\FiveM\txData** → Données txAdmin (panel d'administration)

</ToolDescription>

</SubSection>

</StepSection>

---

<StepSection number="3" title="Télécharger FiveM Server (Artifacts)">

Téléchargez la dernière version du serveur FiveM.

<CodeBlock title="Télécharger les artifacts">

1. Rendez-vous sur [runtime.fivem.net/artifacts/fivem/build_server_windows/master/](https://runtime.fivem.net/artifacts/fivem/build_server_windows/master/)
2. Téléchargez la **dernière version recommandée** (en haut de la liste)
3. Extrayez le contenu dans `C:\FiveM\server\`

</CodeBlock>

<InfoBox>
💡 **Astuce :** Utilisez la version "Latest Recommended" plutôt que "Latest" pour plus de stabilité. Les builds recommandés sont testés et validés.
</InfoBox>

<SubSection title="Vérifier l'installation">

<CodeBlock>

Votre dossier `C:\FiveM\server\` doit contenir :
- `FXServer.exe`
- `fxserver.exe`
- Plusieurs fichiers `.dll`
- Dossiers `citizen/`, `alpine/`, etc.

</CodeBlock>

</SubSection>

</StepSection>

---

<StepSection number="4" title="Configurer le pare-feu Windows">

Autorisez les ports nécessaires pour que les joueurs puissent se connecter.

<CodeBlock title="Ouvrir les ports dans le pare-feu">

```powershell
# Ouvrir PowerShell en tant qu'Administrateur

# Port principal FiveM (30120)
New-NetFirewallRule -DisplayName "FiveM Server" -Direction Inbound -Protocol TCP -LocalPort 30120 -Action Allow
New-NetFirewallRule -DisplayName "FiveM Server UDP" -Direction Inbound -Protocol UDP -LocalPort 30120 -Action Allow

# Port txAdmin (40120)
New-NetFirewallRule -DisplayName "txAdmin Panel" -Direction Inbound -Protocol TCP -LocalPort 40120 -Action Allow
```

</CodeBlock>

<WarningBox>
⚠️ **Ports à configurer**

Si vous utilisez un pare-feu externe (OVH, Hetzner, etc.), pensez également à ouvrir ces ports dans le panel de votre hébergeur !
</WarningBox>

</StepSection>

---

<StepSection number="5" title="Installer et démarrer txAdmin">

txAdmin est le panel d'administration web officiel de FiveM, facilitant grandement la gestion du serveur.

<CodeBlock title="Lancer txAdmin pour la première fois">

```powershell
# Se placer dans le dossier serveur
cd C:\FiveM\server

# Lancer txAdmin
.\FXServer.exe +set citizen_dir C:\FiveM\server\citizen +set sv_licenseKey VOTRE_CLE_LICENCE +set txAdminPort 40120
```

</CodeBlock>

<InfoBox>
💡 **Note :** Remplacez `VOTRE_CLE_LICENCE` par la clé obtenue à l'étape 1.
</InfoBox>

<SubSection title="Configuration initiale de txAdmin">

<CodeBlock title="Accéder à txAdmin">

1. Ouvrez votre navigateur
2. Allez sur : `http://VOTRE_IP_VPS:40120`
3. Créez un compte administrateur txAdmin
4. Suivez l'assistant de configuration

</CodeBlock>

<CodeBlock title="Options de configuration recommandées">

**Type de déploiement :**
- Pour débuter : Sélectionnez "Popular Template" → Choisissez "ESX Legacy" ou "QBCore"
- Pour avancé : Sélectionnez "Custom" et configurez manuellement

**Configuration serveur :**
- **Server Name** : Nom de votre serveur (visible dans la liste)
- **Max Clients** : 32, 48 ou 64 selon votre RAM
- **Server Locale** : `fr_FR` pour le français

</CodeBlock>

</SubSection>

<SubSection title="Finaliser l'installation">

<SuccessBox>
✅ Une fois la configuration terminée, txAdmin va télécharger les ressources nécessaires et démarrer automatiquement votre serveur !
</SuccessBox>

</SubSection>

</StepSection>

---

<StepSection number="6" title="Configurer server.cfg">

Le fichier `server.cfg` contient toutes les configurations de votre serveur.

<CodeBlock title="Éditer server.cfg">

```powershell
# Le fichier se trouve dans C:\FiveM\server-data\
notepad C:\FiveM\server-data\server.cfg
```

</CodeBlock>

<CodeBlock title="Configuration recommandée server.cfg">

```bash
# Informations de base
sv_licenseKey "VOTRE_CLE_LICENCE"
sv_hostname "^1Mon Serveur RP France ^7| ^2Recrutement Ouvert"
sv_projectName "Mon Serveur RP"
sv_projectDesc "Serveur Roleplay français sérieux"

# Limites
sv_maxclients 48
sv_endpointprivacy true

# Paramètres Steam
steam_webApiKey "VOTRE_CLE_STEAM_API"
sv_steamPunishWithIdentifier true

# Discord
sv_discordAppId "VOTRE_APP_ID_DISCORD"

# Paramètres de connexion
sv_enforceGameBuild 2802

# Tags serveur (visibles dans la liste)
sets tags "roleplay, français, esx, whitelist"
sets locale "fr-FR"
sets banner_connecting "https://votresite.com/banner.png"
sets banner_detail "https://votresite.com/banner_detail.png"

# OneSync (OBLIGATOIRE pour +32 joueurs)
set onesync on
set onesync_enableInfinity 1
set onesync_enableBeyond 1
set onesync_population 1

# Performance
set sv_filterRequestControl 4
set sv_maxUploadSize 50

# Admins (identifiant Steam)
add_ace group.admin command allow
add_ace group.admin command.quit deny
add_principal identifier.steam:VOTRE_STEAM_ID group.admin

# Ressources à charger
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap
ensure rconlog

# Votre framework
ensure es_extended  # Pour ESX
# ensure qb-core     # Pour QBCore
```

</CodeBlock>

<ToolDescription>

**Paramètres importants :**

- **sv_maxclients** → Nombre maximum de joueurs (32, 48, 64...)
- **sv_enforceGameBuild** → Version GTA V requise (2802 = dernière)
- **onesync** → Obligatoire pour plus de 32 joueurs
- **steam_webApiKey** → Clé API Steam (optionnel, obtenue sur [steamcommunity.com/dev/apikey](https://steamcommunity.com/dev/apikey))

</ToolDescription>

</StepSection>

---

<StepSection number="7" title="Ajouter des ressources">

Installez des scripts et mods pour personnaliser votre serveur.

<SubSection title="Structure des ressources">

<CodeBlock title="Emplacement des ressources">

```
C:\FiveM\server-data\resources\
├── [core]/          # Ressources essentielles
├── [esx]/           # Framework ESX
├── [qb]/            # Framework QBCore
├── [standalone]/    # Scripts indépendants
└── [maps]/          # Cartes personnalisées
```

</CodeBlock>

</SubSection>

<SubSection title="Installer une ressource">

<CodeBlock title="Étapes d'installation">

1. Téléchargez la ressource (GitHub, forum FiveM, etc.)
2. Extrayez le dossier dans `C:\FiveM\server-data\resources\`
3. Ajoutez `ensure nom_de_la_ressource` dans `server.cfg`
4. Redémarrez le serveur ou tapez `restart nom_de_la_ressource` dans la console

</CodeBlock>

<InfoBox>
💡 **Sources de ressources fiables :**
- [GitHub FiveM-ESX](https://github.com/esx-framework)
- [Forum CFX.re](https://forum.cfx.re/c/development/releases/7)
- [QBCore GitHub](https://github.com/qbcore-framework)
</InfoBox>

</SubSection>

<SubSection title="Ressources essentielles recommandées">

<CommandList>

**Framework de base**
```
ESX Legacy ou QBCore (choix obligatoire)
```

**HUD et interface**
```
esx_hud, esx_status, esx_basicneeds
```

**Métiers de base**
```
esx_policejob, esx_ambulancejob, esx_mecanojob
```

**Économie**
```
esx_shops, esx_clotheshop, esx_vehicleshop
```

**Administration**
```
txAdmin (déjà installé), vMenu ou qb-adminmenu
```

</CommandList>

</SubSection>

</StepSection>

---

<StepSection number="8" title="Optimiser les performances">

Améliorez les performances de votre serveur pour une expérience fluide.

<SubSection title="Configuration server.cfg optimisée">

<CodeBlock title="Ajouts pour les performances">

```bash
# Optimisation réseau
set sv_pureLevel 1
set sv_enforceGameBuild 2802

# Streaming optimisé
set sv_enableNetworkedPhoneExplosions 1
set sv_enableNetworkedSounds 1

# OneSync optimisé
set onesync_distanceCullVehicles 1000
set onesync_distanceCull 450.0
set onesync_logLevel 0

# Limites de spawn
set sv_entityLockdown true
set sv_filterRequestControl 4
```

</CodeBlock>

</SubSection>

<SubSection title="Limiter les ressources gourmandes">

<WarningBox>
⚠️ **Scripts à surveiller**

Certains scripts peuvent fortement impacter les performances :
- Scripts de trafic/IA trop chargés
- Trop de véhicules custom (streaming excessif)
- MLO (Map Load Objects) en trop grand nombre
- Scripts mal optimisés avec boucles infinies
</WarningBox>

</SubSection>

<SubSection title="Monitoring des performances">

<CodeBlock title="Commandes de monitoring">

```bash
# Dans la console txAdmin ou F8 en jeu (admin)
resmon          # Moniteur de ressources
txAdmin-data    # Statistiques serveur
perf            # Afficher les performances
```

</CodeBlock>

</SubSection>

</StepSection>

---

<StepSection number="9" title="Configurer le démarrage automatique">

Faites en sorte que votre serveur redémarre automatiquement.

<SubSection title="Créer un script de démarrage">

<CodeBlock title="Créer start_server.bat">

```batch
@echo off
title FiveM Server - AtmosNode
cd /d C:\FiveM\server

:loop
echo Demarrage du serveur FiveM...
FXServer.exe +exec server.cfg
echo.
echo Le serveur s'est arrete. Redemarrage dans 5 secondes...
timeout /t 5
goto loop
```

Enregistrez ce fichier sous `C:\FiveM\start_server.bat`

</CodeBlock>

</SubSection>

<SubSection title="Ajouter au démarrage de Windows">

<CodeBlock title="Créer une tâche planifiée">

1. Ouvrez "Planificateur de tâches" Windows
2. Cliquez sur "Créer une tâche"
3. **Général** :
   - Nom : "FiveM Server AutoStart"
   - Cochez "Exécuter même si l'utilisateur n'est pas connecté"
   - Cochez "Exécuter avec les privilèges les plus élevés"
4. **Déclencheurs** :
   - Nouveau → "Au démarrage"
5. **Actions** :
   - Nouveau → "Démarrer un programme"
   - Programme : `C:\FiveM\start_server.bat`
6. Cliquez sur "OK"

</CodeBlock>

<SuccessBox>
✅ Votre serveur FiveM démarrera automatiquement au démarrage de Windows !
</SuccessBox>

</SubSection>

</StepSection>

---

<StepSection number="10" title="Gérer votre serveur avec txAdmin">

Utilisez txAdmin pour administrer facilement votre serveur.

<CommandList>

**Accéder au panel**
```
http://VOTRE_IP_VPS:40120
```

**Redémarrer le serveur**
```
Bouton "Restart Server" dans txAdmin
```

**Voir les logs en direct**
```
Onglet "Live Console" dans txAdmin
```

**Gérer les ressources**
```
Onglet "Resources" → Start/Stop/Restart
```

**Backup automatique**
```
Onglet "Settings" → "Automated Backups"
```

</CommandList>

<ReferenceTable>

**Raccourcis txAdmin utiles :**

| Action | Commande console |
|--------|------------------|
| Redémarrer serveur | `restart` ou `txAdmin-resource restart` |
| Arrêter serveur | `quit` ou `stop` |
| Redémarrer ressource | `restart nom_ressource` |
| Charger ressource | `ensure nom_ressource` |
| Décharger ressource | `stop nom_ressource` |
| Voir joueurs | `status` |
| Kick joueur | `kick [id] [raison]` |
| Ban joueur | `txAdmin-ban [id] [durée] [raison]` |

</ReferenceTable>

</StepSection>

---

## 💬 Besoin d'aide ?

Si vous rencontrez des difficultés avec votre serveur FiveM :

<HelpCards>

<HelpCard title="📚 Forum CFX.re" link="https://forum.cfx.re">
Communauté officielle FiveM
</HelpCard>

<HelpCard title="💬 Discord AtmosNode" link="https://discord.gg/atmosnode">
Support VPS 24/7
</HelpCard>

<HelpCard title="🎫 Support AtmosNode" link="https://client.atmosnode.com">
Ticket d'assistance technique
</HelpCard>

</HelpCards>

---

<Congratulations>

**🎮 Félicitations !**

Votre serveur FiveM est maintenant opérationnel sur Windows Server ! Personnalisez-le avec des ressources, invitez vos amis et créez votre propre univers Roleplay !

</Congratulations>


Guide complet pour installer et configurer un serveur FiveM sur Windows Server. Installation, configuration txAdmin, optimisation et gestion des ressources.

Installer un serveur FiveM sur Windows Server


# Installer un serveur Minecraft sur Debian

Créez votre propre **serveur Minecraft Java Edition** sur Debian ou Ubuntu. Ce guide couvre l'installation vanilla, les optimisations et la gestion de votre serveur.

---

## 📋 Avant de commencer

<Prerequisites>

✅ **VPS Linux** Debian 11/12 ou Ubuntu 20.04/22.04
✅ **Minimum 2 Go RAM** (4 Go recommandé pour 10+ joueurs)
✅ **Accès SSH** avec droits sudo
✅ **Java 17** ou supérieur (installé dans ce guide)
✅ **Port 25565** disponible

</Prerequisites>

<InfoBox>
💡 **Recommandation AtmosNode :** Un VPS avec Ryzen 9 9950X3D, 4 Go RAM DDR5 et NVMe Gen5 offre d'excellentes performances pour 20-30 joueurs simultanés.
</InfoBox>

---

<StepSection number="1" title="Mise à jour du système">

Commencez par mettre à jour votre système Debian/Ubuntu.

<CodeBlock title="Mettre à jour les paquets">

```bash
# Mettre à jour la liste des paquets
sudo apt update

# Mettre à jour le système
sudo apt upgrade -y
```

</CodeBlock>

</StepSection>

---

<StepSection number="2" title="Installer Java (OpenJDK 17)">

Minecraft nécessite Java pour fonctionner. Installez OpenJDK 17, la version recommandée.

<CodeBlock title="Installation de Java 17">

```bash
# Installer OpenJDK 17
sudo apt install openjdk-17-jre-headless -y

# Vérifier l'installation
java -version
```

</CodeBlock>

<SuccessBox>
✅ Vous devriez voir quelque chose comme : `openjdk version "17.0.x"`
</SuccessBox>

<InfoBox>
💡 **Versions de Java selon Minecraft :**
- Minecraft 1.17 et inférieur : Java 8 ou 11
- Minecraft 1.18 à 1.20.4 : Java 17
- Minecraft 1.20.5+ : Java 21 recommandé
</InfoBox>

</StepSection>

---

<StepSection number="3" title="Créer un utilisateur dédié">

Pour des raisons de sécurité, créez un utilisateur dédié pour Minecraft.

<CodeBlock title="Créer l'utilisateur minecraft">

```bash
# Créer l'utilisateur
sudo useradd -r -m -U -d /opt/minecraft -s /bin/bash minecraft

# Se connecter en tant qu'utilisateur minecraft
sudo su - minecraft
```

</CodeBlock>

<WarningBox>
⚠️ **Bonne pratique**

Ne jamais exécuter un serveur Minecraft en tant que root ! Utilisez toujours un utilisateur dédié avec des permissions limitées.
</WarningBox>

</StepSection>

---

<StepSection number="4" title="Télécharger le serveur Minecraft">

Téléchargez la dernière version du serveur Minecraft Java Edition.

<SubSection title="Créer la structure de dossiers">

<CodeBlock>

```bash
# Créer le dossier du serveur
mkdir -p ~/server
cd ~/server
```

</CodeBlock>

</SubSection>

<SubSection title="Télécharger le serveur">

<CodeBlock title="Télécharger Minecraft Vanilla">

```bash
# Télécharger la dernière version (1.21.1 au moment de l'écriture)
wget https://piston-data.mojang.com/v1/objects/59353fb40c36d304f2035d51e7d6e6baa98dc05c/server.jar -O minecraft_server.jar

# Ou pour une version spécifique, visitez :
# https://www.minecraft.net/en-us/download/server
```

</CodeBlock>

<InfoBox>
💡 **Astuce :** Vérifiez toujours la dernière URL sur [minecraft.net/download/server](https://www.minecraft.net/en-us/download/server) pour obtenir la version la plus récente.
</InfoBox>

</SubSection>

</StepSection>

---

<StepSection number="5" title="Accepter l'EULA et première exécution">

Avant de démarrer le serveur, vous devez accepter l'EULA (End User License Agreement).

<CodeBlock title="Première exécution pour générer les fichiers">

```bash
# Lancer le serveur une première fois
java -Xmx1024M -Xms1024M -jar minecraft_server.jar nogui
```

</CodeBlock>

<CodeBlock title="Accepter l'EULA">

```bash
# Le serveur va s'arrêter et créer un fichier eula.txt
# Modifier le fichier pour accepter l'EULA
nano eula.txt

# Changer "eula=false" en "eula=true"
# Sauvegarder avec Ctrl+O puis Entrée, quitter avec Ctrl+X
```

</CodeBlock>

<WarningBox>
⚠️ **Important**

En acceptant l'EULA, vous acceptez les conditions d'utilisation de Minecraft. Lisez-les sur [account.mojang.com/terms](https://account.mojang.com/terms).
</WarningBox>

</StepSection>

---

<StepSection number="6" title="Configurer le pare-feu">

Autorisez le port Minecraft (25565) dans votre pare-feu.

<CodeBlock title="Configuration UFW (Ubuntu/Debian)">

```bash
# Autoriser le port Minecraft
sudo ufw allow 25565/tcp

# Vérifier le statut
sudo ufw status
```

</CodeBlock>

<InfoBox>
💡 **Note :** Si vous avez un pare-feu externe (panel AtmosNode, OVH, etc.), pensez aussi à ouvrir le port 25565 dans votre interface de gestion.
</InfoBox>

</StepSection>

---

<StepSection number="7" title="Configurer server.properties">

Personnalisez les paramètres de votre serveur.

<CodeBlock title="Éditer server.properties">

```bash
# Éditer le fichier de configuration
nano server.properties
```

</CodeBlock>

<CodeBlock title="Configuration recommandée">

```properties
# Informations du serveur
server-name=Mon Serveur Minecraft
motd=§aBienvenue sur mon serveur ! §7| §eJoueurs : {ONLINE}/{MAX}
server-ip=
server-port=25565

# Paramètres de jeu
gamemode=survival
difficulty=normal
hardcore=false
pvp=true
max-players=20

# Monde
level-name=world
level-seed=
generate-structures=true
spawn-protection=16
view-distance=10
simulation-distance=10

# Performance
max-tick-time=60000
max-world-size=29999984

# Whitelist et sécurité
white-list=false
enforce-whitelist=false
online-mode=true
enable-command-block=false

# RCON (administration à distance)
enable-rcon=false
rcon.password=
rcon.port=25575
```

</CodeBlock>

<ToolDescription>

**Paramètres importants :**

- **max-players** → Nombre maximum de joueurs (ajustez selon votre RAM)
- **view-distance** → Distance de rendu (10 = 160 blocs, réduit pour économiser la RAM)
- **simulation-distance** → Distance de calcul des entités (10 recommandé)
- **online-mode** → Vérification Mojang (true = comptes premium uniquement)
- **white-list** → Activation de la whitelist (true = seuls les joueurs autorisés peuvent rejoindre)

</ToolDescription>

</StepSection>

---

<StepSection number="8" title="Créer un script de démarrage">

Créez un script pour faciliter le démarrage du serveur.

<CodeBlock title="Créer start.sh">

```bash
# Créer le script
nano start.sh
```

</CodeBlock>

<CodeBlock title="Contenu du script">

```bash
#!/bin/bash

# Configuration RAM (ajustez selon votre VPS)
MIN_RAM="2G"
MAX_RAM="4G"

# Démarrage du serveur
java -Xms$MIN_RAM -Xmx$MAX_RAM \
  -XX:+UseG1GC \
  -XX:+ParallelRefProcEnabled \
  -XX:MaxGCPauseMillis=200 \
  -XX:+UnlockExperimentalVMOptions \
  -XX:+DisableExplicitGC \
  -XX:+AlwaysPreTouch \
  -XX:G1HeapWastePercent=5 \
  -XX:G1MixedGCCountTarget=4 \
  -XX:G1MixedGCLiveThresholdPercent=90 \
  -XX:G1RSetUpdatingPauseTimePercent=5 \
  -XX:SurvivorRatio=32 \
  -XX:+PerfDisableSharedMem \
  -XX:MaxTenuringThreshold=1 \
  -Dusing.aikars.flags=https://mcflags.emc.gs \
  -Daikars.new.flags=true \
  -jar minecraft_server.jar nogui
```

</CodeBlock>

<CodeBlock title="Rendre le script exécutable">

```bash
# Permissions d'exécution
chmod +x start.sh
```

</CodeBlock>

<InfoBox>
💡 **Flags d'optimisation Aikar :** Ces paramètres JVM sont conçus spécifiquement pour optimiser les performances de Minecraft. Plus d'infos sur [aikar.co/flags](https://aikar.co/2018/07/02/tuning-the-jvm-g1gc-garbage-collector-flags-for-minecraft/).
</InfoBox>

</StepSection>

---

<StepSection number="9" title="Utiliser Screen pour gérer le serveur">

Screen permet de laisser le serveur tourner en arrière-plan.

<SubSection title="Installer Screen">

<CodeBlock>

```bash
# Retourner en root pour installer screen
exit

# Installer screen
sudo apt install screen -y

# Revenir en utilisateur minecraft
sudo su - minecraft
cd ~/server
```

</CodeBlock>

</SubSection>

<SubSection title="Démarrer avec Screen">

<CodeBlock title="Commandes Screen">

```bash
# Créer une session screen nommée "minecraft"
screen -S minecraft

# Démarrer le serveur
./start.sh

# Détacher la session : Ctrl+A puis D
# Le serveur continue de tourner en arrière-plan

# Pour revenir à la session
screen -r minecraft

# Lister toutes les sessions
screen -ls
```

</CodeBlock>

</SubSection>

</StepSection>

---

<StepSection number="10" title="Configurer le démarrage automatique">

Créez un service systemd pour démarrer automatiquement le serveur.

<CodeBlock title="Créer le service systemd">

```bash
# Retourner en root
exit

# Créer le fichier service
sudo nano /etc/systemd/system/minecraft.service
```

</CodeBlock>

<CodeBlock title="Contenu du service">

```ini
[Unit]
Description=Minecraft Server
After=network.target

[Service]
User=minecraft
Group=minecraft
WorkingDirectory=/opt/minecraft/server
ExecStart=/opt/minecraft/server/start.sh
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target
```

</CodeBlock>

<CodeBlock title="Activer et démarrer le service">

```bash
# Recharger systemd
sudo systemctl daemon-reload

# Activer au démarrage
sudo systemctl enable minecraft

# Démarrer le serveur
sudo systemctl start minecraft

# Vérifier le statut
sudo systemctl status minecraft

# Voir les logs en direct
sudo journalctl -u minecraft -f
```

</CodeBlock>

<SuccessBox>
✅ Votre serveur Minecraft démarre maintenant automatiquement au démarrage du VPS !
</SuccessBox>

</StepSection>

---

<StepSection number="11" title="Commandes d'administration utiles">

<CommandList>

**Arrêter le serveur proprement**
```bash
sudo systemctl stop minecraft
```

**Redémarrer le serveur**
```bash
sudo systemctl restart minecraft
```

**Voir les logs**
```bash
sudo journalctl -u minecraft -n 50
```

**Accéder à la console (avec screen)**
```bash
sudo su - minecraft
screen -r minecraft
```

**Sauvegarder le monde**
```bash
# Dans la console Minecraft
save-all
```

**Ajouter un joueur à la whitelist**
```bash
# Dans la console Minecraft
whitelist add NomDuJoueur
whitelist on
```

</CommandList>

<ReferenceTable>

**Commandes Minecraft console :**

| Commande | Description |
|----------|-------------|
| `whitelist add <joueur>` | Ajouter à la whitelist |
| `whitelist remove <joueur>` | Retirer de la whitelist |
| `op <joueur>` | Donner les droits admin |
| `deop <joueur>` | Retirer les droits admin |
| `kick <joueur>` | Expulser un joueur |
| `ban <joueur>` | Bannir un joueur |
| `pardon <joueur>` | Débannir un joueur |
| `stop` | Arrêter le serveur |
| `save-all` | Sauvegarder le monde |
| `list` | Liste des joueurs connectés |

</ReferenceTable>

</StepSection>

---

<StepSection number="12" title="Optimisation des performances">

<SubSection title="Ajustement de la RAM">

<CodeBlock title="RAM selon nombre de joueurs">

```bash
# 1-5 joueurs : 2 Go RAM
MIN_RAM="1G"
MAX_RAM="2G"

# 5-10 joueurs : 3-4 Go RAM
MIN_RAM="2G"
MAX_RAM="4G"

# 10-20 joueurs : 4-6 Go RAM
MIN_RAM="3G"
MAX_RAM="6G"

# 20+ joueurs : 6-8 Go RAM
MIN_RAM="4G"
MAX_RAM="8G"
```

</CodeBlock>

<WarningBox>
⚠️ **Important**

N'allouez jamais TOUTE la RAM de votre VPS à Minecraft ! Laissez au moins 1 Go pour le système d'exploitation.
</WarningBox>

</SubSection>

<SubSection title="Optimisation de server.properties">

<CodeBlock title="Paramètres pour meilleures performances">

```properties
# Réduire la distance de vue
view-distance=8
simulation-distance=8

# Limiter les entités
max-players=15

# Désactiver les fonctionnalités gourmandes si nécessaire
spawn-monsters=true
spawn-animals=true
spawn-npcs=true
```

</CodeBlock>

</SubSection>

</StepSection>

---

<StepSection number="13" title="Alternatives : Paper et Spigot">

Pour de meilleures performances, considérez **Paper** ou **Spigot** au lieu de Vanilla.

<SubSection title="Installer Paper (Recommandé)">

<CodeBlock title="Télécharger Paper">

```bash
# Se connecter en tant qu'utilisateur minecraft
sudo su - minecraft
cd ~/server

# Télécharger Paper (version 1.21.1)
wget https://api.papermc.io/v2/projects/paper/versions/1.21.1/builds/119/downloads/paper-1.21.1-119.jar -O paper.jar

# Modifier start.sh pour utiliser paper.jar au lieu de minecraft_server.jar
nano start.sh
# Remplacer "minecraft_server.jar" par "paper.jar"
```

</CodeBlock>

<InfoBox>
💡 **Avantages de Paper :**
- Meilleures performances (jusqu'à 50% plus rapide)
- Support des plugins Bukkit/Spigot
- Optimisations anti-lag intégrées
- Configuration avancée avec paper.yml
</InfoBox>

</SubSection>

<SubSection title="Installer Spigot">

<CodeBlock title="Compiler Spigot avec BuildTools">

```bash
# Installer Git (si pas déjà fait)
sudo apt install git -y

# Se connecter en utilisateur minecraft
sudo su - minecraft
mkdir ~/buildtools && cd ~/buildtools

# Télécharger BuildTools
wget https://hub.spigotmc.org/jenkins/job/BuildTools/lastSuccessfulBuild/artifact/target/BuildTools.jar

# Compiler Spigot (prend 5-10 minutes)
java -jar BuildTools.jar --rev 1.21.1

# Copier vers le dossier serveur
cp spigot-*.jar ~/server/spigot.jar
```

</CodeBlock>

</SubSection>

</StepSection>

---

<StepSection number="14" title="Sauvegardes automatiques">

Créez des sauvegardes régulières de votre monde.

<CodeBlock title="Script de backup">

```bash
# Créer le script de backup
sudo nano /usr/local/bin/minecraft-backup.sh
```

</CodeBlock>

<CodeBlock title="Contenu du script">

```bash
#!/bin/bash

# Configuration
BACKUP_DIR="/opt/minecraft/backups"
SERVER_DIR="/opt/minecraft/server"
DATE=$(date +%Y-%m-%d_%H-%M-%S)
BACKUP_FILE="minecraft-backup-$DATE.tar.gz"

# Créer le dossier de backup
mkdir -p $BACKUP_DIR

# Créer l'archive (exclure les backups et logs)
tar -czf "$BACKUP_DIR/$BACKUP_FILE" \
    -C $SERVER_DIR \
    --exclude='backups' \
    --exclude='logs' \
    world world_nether world_the_end server.properties ops.json whitelist.json

# Garder seulement les 7 derniers backups
cd $BACKUP_DIR
ls -t | tail -n +8 | xargs -r rm

echo "Backup créé : $BACKUP_FILE"
```

</CodeBlock>

<CodeBlock title="Automatiser avec cron">

```bash
# Rendre le script exécutable
sudo chmod +x /usr/local/bin/minecraft-backup.sh

# Ajouter au crontab (backup toutes les 6 heures)
sudo crontab -e

# Ajouter cette ligne :
0 */6 * * * /usr/local/bin/minecraft-backup.sh
```

</CodeBlock>

</StepSection>

---

## 💬 Besoin d'aide ?

Si vous rencontrez des difficultés avec votre serveur Minecraft :

<HelpCards>

<HelpCard title="📚 Wiki Minecraft" link="https://minecraft.wiki">
Documentation officielle
</HelpCard>

<HelpCard title="💬 Discord AtmosNode" link="https://discord.gg/atmosnode">
Support VPS 24/7
</HelpCard>

<HelpCard title="🎫 Support AtmosNode" link="https://client.atmosnode.com">
Ticket d'assistance technique
</HelpCard>

</HelpCards>

---

<Congratulations>

**⛏️ Félicitations !**

Votre serveur Minecraft est maintenant opérationnel sur Debian ! Partagez l'IP de votre serveur avec vos amis et commencez à construire votre monde !

**Pour vous connecter :** Ouvrez Minecraft → Multijoueur → Ajouter un serveur → `VOTRE_IP_VPS:25565`

</Congratulations>


Guide complet pour installer et configurer un serveur Minecraft Java Edition sur Debian/Ubuntu. Installation, optimisation et gestion avec Screen.

Installer un serveur Minecraft sur Debian


# Premiers pas avec votre VPS Linux

Félicitations ! 🎉 Vous venez de recevoir votre VPS Linux AtmosNode. Ce guide vous accompagne pas à pas pour prendre en main votre serveur en toute sécurité.

---

## 📋 Avant de commencer

<Prerequisites>

✅ **Email de bienvenue** reçu avec vos identifiants
✅ **Adresse IP** de votre VPS
✅ **Mot de passe root** ou clé SSH
✅ **Client SSH** installé sur votre ordinateur

</Prerequisites>

---

<StepSection number="1" title="Connexion SSH à votre VPS">

La première étape consiste à vous connecter à distance à votre serveur via SSH (Secure Shell).

<SubSection title="Sur Windows">

**Option A : PowerShell / Windows Terminal** (Recommandé)

```bash
ssh root@VOTRE_IP_VPS
```

<InfoBox>
💡 **Astuce :** Remplacez `VOTRE_IP_VPS` par l'adresse IP fournie dans votre email de bienvenue.
</InfoBox>

**Option B : PuTTY**

1. Téléchargez PuTTY depuis [putty.org](https://www.putty.org/)
2. Entrez l'IP de votre VPS dans "Host Name"
3. Port : `22`
4. Cliquez sur "Open"

</SubSection>

<SubSection title="Sur macOS / Linux">

Ouvrez votre Terminal et exécutez :

```bash
ssh root@VOTRE_IP_VPS
```

</SubSection>

<SubSection title="Première connexion">

Lors de votre première connexion, vous verrez ce message :

```
The authenticity of host '123.456.789.0' can't be established.
Are you sure you want to continue connecting (yes/no)?
```

<SuccessBox>
✅ Tapez **`yes`** et appuyez sur Entrée. C'est normal pour une première connexion !
</SuccessBox>

</SubSection>

</StepSection>

---

<StepSection number="2" title="Mise à jour du système">

**Première règle de sécurité** : toujours mettre à jour le système avant toute configuration.

<CodeBlock title="Sur Ubuntu / Debian">

```bash
apt update && apt upgrade -y
```

</CodeBlock>

<CodeBlock title="Sur CentOS / Rocky Linux">

```bash
yum update -y
```

</CodeBlock>

<InfoBox>
ℹ️ Cette commande met à jour tous les paquets installés. Cela peut prendre quelques minutes.
</InfoBox>

</StepSection>

---

<StepSection number="3" title="Création d'un utilisateur sécurisé">

<WarningBox>
⚠️ **Bonne pratique de sécurité**

Ne travaillez jamais directement avec le compte **root** ! Créez un utilisateur dédié pour vos opérations quotidiennes.
</WarningBox>

<CodeBlock title="Créer un nouvel utilisateur">

```bash
# Créer l'utilisateur (remplacez 'votrenom' par votre nom)
adduser votrenom

# Ajouter les privilèges administrateur (sudo)
usermod -aG sudo votrenom
```

</CodeBlock>

<CodeBlock title="Tester le nouvel utilisateur">

Déconnectez-vous et reconnectez-vous avec votre nouveau compte :

```bash
# Tapez 'exit' pour vous déconnecter
exit

# Reconnectez-vous avec le nouvel utilisateur
ssh votrenom@VOTRE_IP_VPS
```

</CodeBlock>

</StepSection>

---

<StepSection number="4" title="Configuration du pare-feu">

Protégez votre VPS en activant un pare-feu pour bloquer les connexions non autorisées.

<SubSection title="Avec UFW (Ubuntu/Debian)">

<CodeBlock title="Installation et configuration">

```bash
# Installer UFW
sudo apt install ufw -y

# Autoriser SSH (IMPORTANT : À faire AVANT d'activer !)
sudo ufw allow 22/tcp

# Activer le pare-feu
sudo ufw enable

# Vérifier le statut
sudo ufw status
```

</CodeBlock>

<WarningBox>
⚠️ **Attention :** Autorisez toujours SSH (port 22) **AVANT** d'activer le pare-feu, sinon vous serez bloqué !
</WarningBox>

</SubSection>

<SubSection title="Avec FirewallD (CentOS/Rocky)">

<CodeBlock title="Installation et configuration">

```bash
# Démarrer firewalld
sudo systemctl start firewalld
sudo systemctl enable firewalld

# Autoriser SSH
sudo firewall-cmd --permanent --add-service=ssh
sudo firewall-cmd --reload

# Vérifier
sudo firewall-cmd --list-all
```

</CodeBlock>

</SubSection>

</StepSection>

---

<StepSection number="5" title="Sécurisation SSH">

Renforcez la sécurité de votre accès SSH en modifiant la configuration.

<CodeBlock title="Éditer la configuration SSH">

```bash
sudo nano /etc/ssh/sshd_config
```

</CodeBlock>

<CodeBlock title="Modifications recommandées">

```bash
# Désactiver la connexion root directe
PermitRootLogin no

# Désactiver l'authentification par mot de passe (après avoir configuré les clés SSH)
# PasswordAuthentication no

# Changer le port SSH (optionnel mais recommandé)
# Port 2222
```

</CodeBlock>

<InfoBox>
💡 **Astuce :** Gardez l'authentification par mot de passe activée tant que vous n'avez pas configuré l'authentification par clé SSH !
</InfoBox>

<CodeBlock title="Redémarrer SSH">

```bash
sudo systemctl restart sshd
```

</CodeBlock>

</StepSection>

---

<StepSection number="6" title="Installation des outils essentiels">

Installez les utilitaires de base pour faciliter l'administration de votre serveur.

<CodeBlock title="Sur Ubuntu/Debian">

```bash
sudo apt install -y curl wget git vim htop net-tools unzip
```

</CodeBlock>

<CodeBlock title="Sur CentOS/Rocky">

```bash
sudo yum install -y curl wget git vim htop net-tools unzip
```

</CodeBlock>

<ToolDescription>

**Outils installés :**

- **curl/wget** → Télécharger des fichiers depuis internet
- **git** → Système de contrôle de version
- **vim** → Éditeur de texte avancé
- **htop** → Moniteur système interactif
- **net-tools** → Utilitaires réseau (ifconfig, netstat...)
- **unzip** → Décompresser des archives

</ToolDescription>

</StepSection>

---

<StepSection number="7" title="Configuration du hostname">

Donnez un nom personnalisé à votre serveur pour le reconnaître facilement.

<CodeBlock title="Définir le hostname">

```bash
# Définir le hostname
sudo hostnamectl set-hostname mon-vps-atmos

# Vérifier la configuration
hostnamectl
```

</CodeBlock>

</StepSection>

---

<StepSection number="8" title="Mises à jour automatiques">

Activez les mises à jour automatiques de sécurité pour protéger votre système en continu.

<SubSection title="Sur Ubuntu/Debian">

<CodeBlock>

```bash
# Installer unattended-upgrades
sudo apt install unattended-upgrades -y

# Activer les mises à jour automatiques
sudo dpkg-reconfigure --priority=low unattended-upgrades
```

</CodeBlock>

</SubSection>

<SubSection title="Sur CentOS/Rocky">

<CodeBlock>

```bash
# Installer yum-cron
sudo yum install yum-cron -y

# Activer et démarrer
sudo systemctl enable --now yum-cron
```

</CodeBlock>

</SubSection>

</StepSection>

---

<StepSection number="9" title="Surveillance du système">

Apprenez les commandes essentielles pour surveiller votre VPS.

<CommandList>

**Espace disque utilisé**
```bash
df -h
```

**Utilisation de la RAM**
```bash
free -h
```

**Moniteur système interactif**
```bash
htop
```

**Liste des processus**
```bash
ps aux
```

**État des services**
```bash
systemctl status
```

</CommandList>

<ReferenceTable>

**Commandes de surveillance :**

| Commande | Description |
|----------|-------------|
| `df -h` | Espace disque disponible (format lisible) |
| `free -h` | Mémoire RAM utilisée et disponible |
| `htop` | Moniteur interactif des processus |
| `uptime` | Temps de fonctionnement et charge système |
| `top` | Statistiques système en temps réel |
| `systemctl status` | État de tous les services |

</ReferenceTable>

</StepSection>

---

## 💬 Besoin d'aide ?

Si vous rencontrez des difficultés, notre équipe est là pour vous aider :

<HelpCards>

<HelpCard title="📚 FAQ" link="/fr/faq" />

<HelpCard title="💬 Discord" link="https://discord.gg/atmosnode">
Support communautaire 24/7
</HelpCard>

<HelpCard title="🎫 Ticket support" link="https://client.atmosnode.com" />

</HelpCards>

---

<Congratulations>

**🎉 Félicitations !**

Votre VPS Linux est maintenant correctement configuré et sécurisé.
Explorez nos autres tutoriels pour installer vos applications et services !

</Congratulations>


Guide complet pour bien démarrer avec votre VPS Linux AtmosNode. Connexion SSH, configuration de base et sécurisation.

Premiers pas avec votre VPS Linux


# Sécuriser votre VPS Linux

Maintenant que votre VPS est opérationnel, il est temps de renforcer sa sécurité. Ce guide vous accompagne pour protéger votre serveur contre les menaces courantes.

---

## 📋 Avant de commencer

<Prerequisites>

✅ Avoir un VPS Linux fonctionnel
✅ Accès SSH avec un utilisateur non-root
✅ Droits sudo configurés
✅ Avoir complété le guide [Premiers pas avec votre VPS Linux](/fr/wiki/getting-started/premiers-pas-vps-linux)

</Prerequisites>

---

<StepSection number="1" title="Configurer l'authentification par clés SSH">

L'authentification par clés SSH est **beaucoup plus sécurisée** que les mots de passe.

<SubSection title="Sur votre ordinateur local - Windows (PowerShell)">

<CodeBlock title="Générer une paire de clés SSH">

```bash
# Générer une paire de clés SSH
ssh-keygen -t ed25519 -C "votre-email@exemple.com"

# Appuyez sur Entrée pour accepter l'emplacement par défaut
# Définissez une passphrase (optionnel mais recommandé)
```

</CodeBlock>

<InfoBox>
💡 **Astuce :** La clé ed25519 est plus sécurisée et plus rapide que RSA. Si votre système ne la supporte pas, utilisez `ssh-keygen -t rsa -b 4096`.
</InfoBox>

<CodeBlock title="Copier la clé publique vers votre VPS">

```bash
type $env:USERPROFILE\.ssh\id_ed25519.pub | ssh votrenom@VOTRE_IP_VPS "cat >> ~/.ssh/authorized_keys"
```

</CodeBlock>

</SubSection>

<SubSection title="Sur votre ordinateur local - macOS / Linux">

<CodeBlock title="Générer et copier la clé">

```bash
# Générer une paire de clés SSH
ssh-keygen -t ed25519 -C "votre-email@exemple.com"

# Copier la clé vers votre VPS
ssh-copy-id votrenom@VOTRE_IP_VPS
```

</CodeBlock>

</SubSection>

<SubSection title="Tester l'authentification par clé">

<CodeBlock>

```bash
# Se connecter au VPS (ne devrait plus demander de mot de passe)
ssh votrenom@VOTRE_IP_VPS
```

</CodeBlock>

<SuccessBox>
✅ Si la connexion fonctionne sans mot de passe, votre clé SSH est correctement configurée !
</SuccessBox>

</SubSection>

</StepSection>

---

<StepSection number="2" title="Désactiver l'authentification par mot de passe">

Une fois les clés SSH configurées, désactivez l'authentification par mot de passe.

<WarningBox>
⚠️ **ATTENTION**

Avant de désactiver l'authentification par mot de passe, vérifiez que vous pouvez vous connecter avec votre clé SSH ! Gardez une session SSH ouverte en backup.
</WarningBox>

<CodeBlock title="Éditer la configuration SSH">

```bash
# Éditer la configuration SSH
sudo nano /etc/ssh/sshd_config
```

</CodeBlock>

<CodeBlock title="Modifications à apporter">

```bash
# Désactiver l'authentification par mot de passe
PasswordAuthentication no

# Désactiver l'authentification par challenge-response
ChallengeResponseAuthentication no

# Désactiver complètement la connexion root
PermitRootLogin no

# Autoriser uniquement votre utilisateur (optionnel)
AllowUsers votrenom
```

</CodeBlock>

<CodeBlock title="Redémarrer le service SSH">

```bash
sudo systemctl restart sshd
```

</CodeBlock>

</StepSection>

---

<StepSection number="3" title="Changer le port SSH par défaut">

Changer le port SSH réduit les tentatives d'intrusion automatisées.

<CodeBlock title="Modifier la configuration SSH">

```bash
# Éditer la configuration SSH
sudo nano /etc/ssh/sshd_config
```

</CodeBlock>

<CodeBlock title="Changer le port">

```bash
# Port par défaut : 22
Port 2222
```

</CodeBlock>

<InfoBox>
💡 **Astuce :** Choisissez un port entre 1024 et 65535. Évitez les ports communs comme 2222, préférez quelque chose comme 49152.
</InfoBox>

<SubSection title="Mettre à jour le pare-feu - UFW (Ubuntu/Debian)">

<CodeBlock>

```bash
# Autoriser le nouveau port
sudo ufw allow 2222/tcp

# Supprimer l'ancien port
sudo ufw delete allow 22/tcp

# Recharger UFW
sudo ufw reload
```

</CodeBlock>

</SubSection>

<SubSection title="Mettre à jour le pare-feu - FirewallD (CentOS/Rocky)">

<CodeBlock>

```bash
# Ajouter le nouveau port
sudo firewall-cmd --permanent --add-port=2222/tcp

# Supprimer l'ancien port
sudo firewall-cmd --permanent --remove-service=ssh

# Recharger le firewall
sudo firewall-cmd --reload
```

</CodeBlock>

</SubSection>

<CodeBlock title="Redémarrer SSH et se reconnecter">

```bash
# Redémarrer SSH
sudo systemctl restart sshd

# Pour vous reconnecter avec le nouveau port
ssh -p 2222 votrenom@VOTRE_IP_VPS
```

</CodeBlock>

</StepSection>

---

<StepSection number="4" title="Installer et configurer Fail2ban">

Fail2ban protège votre serveur contre les attaques par force brute en bannissant temporairement les IP suspectes.

<SubSection title="Installation">

<CodeBlock title="Sur Ubuntu / Debian">

```bash
sudo apt update
sudo apt install fail2ban -y
```

</CodeBlock>

<CodeBlock title="Sur CentOS / Rocky Linux">

```bash
sudo yum install epel-release -y
sudo yum install fail2ban -y
```

</CodeBlock>

</SubSection>

<SubSection title="Configuration de Fail2ban">

<CodeBlock title="Créer le fichier de configuration">

```bash
# Créer un fichier de configuration local
sudo cp /etc/fail2ban/jail.conf /etc/fail2ban/jail.local
sudo nano /etc/fail2ban/jail.local
```

</CodeBlock>

<CodeBlock title="Configuration recommandée">

```ini
[DEFAULT]
# Durée de bannissement (en secondes) - 1 heure
bantime = 3600

# Durée de la fenêtre de détection (10 minutes)
findtime = 600

# Nombre de tentatives avant bannissement
maxretry = 5

# Action à effectuer (bannir l'IP)
banaction = iptables-multiport

[sshd]
enabled = true
port = 2222
logpath = %(sshd_log)s
backend = %(sshd_backend)s
maxretry = 3
bantime = 86400
```

</CodeBlock>

<ToolDescription>

**Explication de la configuration :**

- **bantime = 86400** → Bannir pendant 24 heures
- **findtime = 600** → Surveiller sur une fenêtre de 10 minutes
- **maxretry = 3** → Bannir après 3 tentatives échouées
- **port = 2222** → Si vous avez changé le port SSH

</ToolDescription>

<CodeBlock title="Démarrer Fail2ban">

```bash
# Démarrer et activer Fail2ban
sudo systemctl start fail2ban
sudo systemctl enable fail2ban

# Vérifier le statut
sudo systemctl status fail2ban
```

</CodeBlock>

</SubSection>

<SubSection title="Vérifier Fail2ban">

<CommandList>

**Statut de la protection SSH**
```bash
sudo fail2ban-client status sshd
```

**Voir toutes les jails actives**
```bash
sudo fail2ban-client status
```

</CommandList>

<ReferenceTable>

**Commandes utiles Fail2ban :**

| Commande | Description |
|----------|-------------|
| `sudo fail2ban-client status sshd` | Statut de la jail SSH |
| `sudo fail2ban-client set sshd unbanip IP` | Débannir une IP |
| `sudo fail2ban-client reload` | Recharger la configuration |
| `sudo tail -f /var/log/fail2ban.log` | Voir les logs en temps réel |

</ReferenceTable>

</SubSection>

</StepSection>

---

<StepSection number="5" title="Configurer un pare-feu avancé">

Configurez votre pare-feu pour n'autoriser que les services nécessaires.

<SubSection title="Configuration UFW (Ubuntu/Debian)">

<CodeBlock>

```bash
# Réinitialiser UFW (optionnel)
sudo ufw --force reset

# Politique par défaut : refuser tout le trafic entrant
sudo ufw default deny incoming
sudo ufw default allow outgoing

# Autoriser SSH (avec le nouveau port)
sudo ufw allow 2222/tcp

# Autoriser HTTP et HTTPS (si vous avez un serveur web)
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp

# Limiter les connexions SSH (protection anti-bruteforce)
sudo ufw limit 2222/tcp

# Activer UFW
sudo ufw enable

# Vérifier le statut
sudo ufw status verbose
```

</CodeBlock>

</SubSection>

<SubSection title="Configuration FirewallD (CentOS/Rocky)">

<CodeBlock>

```bash
# Définir la zone par défaut
sudo firewall-cmd --set-default-zone=public

# Autoriser SSH
sudo firewall-cmd --permanent --add-port=2222/tcp

# Autoriser HTTP/HTTPS
sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https

# Limiter les connexions SSH
sudo firewall-cmd --permanent --add-rich-rule='rule service name=ssh limit value=3/m accept'

# Recharger
sudo firewall-cmd --reload

# Vérifier
sudo firewall-cmd --list-all
```

</CodeBlock>

</SubSection>

</StepSection>

---

<StepSection number="6" title="Surveiller les logs système">

Surveillez régulièrement les logs pour détecter les activités suspectes.

<CommandList>

**Dernières tentatives de connexion échouées**
```bash
sudo grep "Failed password" /var/log/auth.log | tail -20
```

**Connexions SSH réussies**
```bash
sudo grep "Accepted" /var/log/auth.log | tail -20
```

**Surveiller les logs en temps réel**
```bash
sudo tail -f /var/log/auth.log
```

</CommandList>

<InfoBox>
💡 **Astuce :** Sur CentOS/Rocky, utilisez `/var/log/secure` au lieu de `/var/log/auth.log`.
</InfoBox>

</StepSection>

---

<StepSection number="7" title="Installer des outils d'audit de sécurité">

<SubSection title="Lynis - Audit de sécurité automatique">

<CodeBlock title="Installation et utilisation">

```bash
# Installation sur Ubuntu/Debian
sudo apt install lynis -y

# Installation sur CentOS/Rocky
sudo yum install lynis -y

# Lancer un audit complet
sudo lynis audit system
```

</CodeBlock>

</SubSection>

<SubSection title="RKHunter - Détection de rootkits">

<CodeBlock title="Installation et utilisation">

```bash
# Installation sur Ubuntu/Debian
sudo apt install rkhunter -y

# Installation sur CentOS/Rocky
sudo yum install rkhunter -y

# Mettre à jour la base de données
sudo rkhunter --update

# Lancer une analyse
sudo rkhunter --check
```

</CodeBlock>

</SubSection>

</StepSection>

---

<StepSection number="8" title="Maintenir le système à jour">

<CodeBlock title="Sur Ubuntu/Debian">

```bash
# Configurer les mises à jour automatiques de sécurité
sudo apt install unattended-upgrades -y
sudo dpkg-reconfigure -plow unattended-upgrades

# Vérifier les mises à jour manuellement
sudo apt update && sudo apt upgrade -y
```

</CodeBlock>

<WarningBox>
⚠️ **Important**

Les mises à jour de sécurité sont cruciales. Configurez les mises à jour automatiques et vérifiez régulièrement que votre système est à jour.
</WarningBox>

</StepSection>

---

<StepSection number="9" title="Configurer les sauvegardes automatiques">

Ne négligez jamais les sauvegardes !

<CodeBlock title="Créer le répertoire et le script">

```bash
# Créer un répertoire pour les backups
mkdir -p ~/backups

# Créer le script de backup
sudo nano /usr/local/bin/backup.sh
```

</CodeBlock>

<CodeBlock title="Script de backup">

```bash
#!/bin/bash

# Configuration
BACKUP_DIR="/home/votrenom/backups"
DATE=$(date +%Y-%m-%d_%H-%M-%S)
BACKUP_FILE="backup_$DATE.tar.gz"

# Créer l'archive
tar -czf "$BACKUP_DIR/$BACKUP_FILE" \
    /etc \
    /home/votrenom \
    --exclude=/home/votrenom/backups

# Garder seulement les 7 derniers backups
cd "$BACKUP_DIR"
ls -t | tail -n +8 | xargs -r rm

echo "Backup créé : $BACKUP_FILE"
```

</CodeBlock>

<CodeBlock title="Automatiser avec cron">

```bash
# Rendre le script exécutable
sudo chmod +x /usr/local/bin/backup.sh

# Ajouter une tâche cron (backup quotidien à 3h du matin)
sudo crontab -e
```

</CodeBlock>

<CodeBlock title="Ligne à ajouter au crontab">

```bash
0 3 * * * /usr/local/bin/backup.sh
```

</CodeBlock>

</StepSection>

---

<StepSection number="10" title="Checklist de sécurité">

<Prerequisites>

**Vérifiez que vous avez bien :**

✅ Configuré l'authentification par clés SSH
✅ Désactivé l'authentification par mot de passe
✅ Désactivé la connexion root
✅ Changé le port SSH par défaut
✅ Installé et configuré Fail2ban
✅ Configuré correctement votre pare-feu
✅ Installé des outils d'audit (Lynis, RKHunter)
✅ Activé les mises à jour automatiques
✅ Configuré des sauvegardes régulières
✅ Surveillé les logs système

</Prerequisites>

</StepSection>

---

## 💬 Besoin d'aide ?

Si vous rencontrez des difficultés :

<HelpCards>

<HelpCard title="📚 FAQ" link="/fr/faq" />

<HelpCard title="💬 Discord" link="https://discord.gg/atmosnode">
Support communautaire 24/7
</HelpCard>

<HelpCard title="🎫 Ticket support" link="https://client.atmosnode.com" />

</HelpCards>

---

<Congratulations>

**🔒 Félicitations !**

Votre VPS est maintenant bien sécurisé. La sécurité est un processus continu : surveillez régulièrement vos logs et maintenez votre système à jour !

</Congratulations>


Guide complet pour renforcer la sécurité de votre VPS Linux. Fail2ban, authentification par clés SSH, et meilleures pratiques de sécurité.

Sécuriser votre VPS Linux


# Installer Node.js sur votre VPS Linux

Ce guide vous explique comment installer Node.js et npm sur votre VPS Linux, que vous utilisiez Ubuntu, Debian, CentOS ou Rocky Linux. Nous verrons plusieurs méthodes d'installation, y compris l'utilisation de **nvm** (Node Version Manager) pour gérer facilement plusieurs versions de Node.js.

---

## 📋 Avant de commencer

<Prerequisites>

✅ Un VPS Linux (Ubuntu, Debian, CentOS, Rocky Linux)
✅ Un accès SSH avec privilèges sudo
✅ Une connexion Internet stable
✅ Au moins 1 GB de RAM disponible

</Prerequisites>

---

<StepSection number="1" title="Installer Node.js avec nvm (Recommandé)">

**nvm** (Node Version Manager) est la méthode recommandée car elle permet de gérer plusieurs versions de Node.js facilement.

<ToolDescription>

**Avantages de nvm :**

- Installer plusieurs versions de Node.js
- Basculer facilement entre les versions
- Installer Node.js sans privilèges root
- Gérer les versions par projet

</ToolDescription>

<SubSection title="Télécharger et installer nvm">

<CodeBlock title="Avec curl">

```bash
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
```

</CodeBlock>

<CodeBlock title="Avec wget">

```bash
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
```

</CodeBlock>

</SubSection>

<SubSection title="Charger nvm dans votre session">

<CodeBlock title="Pour Bash">

```bash
source ~/.bashrc
```

</CodeBlock>

<CodeBlock title="Pour Zsh">

```bash
source ~/.zshrc
```

</CodeBlock>

<CodeBlock title="Vérifier l'installation">

```bash
nvm --version
```

</CodeBlock>

</SubSection>

<SubSection title="Installer Node.js">

<CodeBlock title="Installer la dernière version LTS">

```bash
nvm install --lts
```

</CodeBlock>

<CodeBlock title="Installer une version spécifique">

```bash
# Installer Node.js 20
nvm install 20

# Installer Node.js 18
nvm install 18

# Installer Node.js 16
nvm install 16
```

</CodeBlock>

<CodeBlock title="Définir une version par défaut">

```bash
nvm alias default 20
```

</CodeBlock>

</SubSection>

<SubSection title="Vérifier l'installation">

<CommandList>

**Version de Node.js**
```bash
node --version
```

**Version de npm**
```bash
npm --version
```

</CommandList>

<SuccessBox>
✅ Node.js et npm sont maintenant installés via nvm !
</SuccessBox>

<ReferenceTable>

**Commandes nvm utiles :**

| Commande | Description |
|----------|-------------|
| `nvm list` | Lister les versions installées |
| `nvm ls-remote` | Lister toutes les versions disponibles |
| `nvm use 20` | Utiliser une version spécifique |
| `nvm uninstall 16` | Désinstaller une version |
| `nvm current` | Afficher la version actuelle |

</ReferenceTable>

</SubSection>

</StepSection>

---

<StepSection number="2" title="Installation via le gestionnaire de paquets">

Alternative à nvm : installation directe via les dépôts NodeSource.

<SubSection title="Ubuntu et Debian">

<CodeBlock title="Ajouter le dépôt NodeSource">

```bash
# Mettre à jour les paquets
sudo apt update

# Installer curl si nécessaire
sudo apt install -y curl

# Ajouter le dépôt NodeSource pour Node.js 20
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -

# Installer Node.js et npm
sudo apt install -y nodejs
```

</CodeBlock>

<InfoBox>
💡 **Astuce :** Pour d'autres versions, remplacez `setup_20.x` par `setup_18.x` (Node.js 18) ou `setup_21.x` (Node.js 21).
</InfoBox>

<CodeBlock title="Vérifier l'installation">

```bash
node --version
npm --version
```

</CodeBlock>

</SubSection>

<SubSection title="CentOS, Rocky Linux et AlmaLinux">

<CodeBlock title="Ajouter le dépôt NodeSource">

```bash
# Mettre à jour les paquets
sudo dnf update -y  # ou yum update -y

# Ajouter le dépôt NodeSource pour Node.js 20
curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -

# Installer Node.js et npm
sudo dnf install -y nodejs  # ou yum install -y nodejs
```

</CodeBlock>

<CodeBlock title="Vérifier l'installation">

```bash
node --version
npm --version
```

</CodeBlock>

</SubSection>

</StepSection>

---

<StepSection number="3" title="Configuration post-installation">

<SubSection title="Configurer npm sans sudo">

Par défaut, npm nécessite sudo pour les installations globales. Configurons npm pour utiliser un répertoire local.

<CodeBlock>

```bash
# Créer un répertoire pour les packages globaux
mkdir ~/.npm-global

# Configurer npm pour utiliser ce répertoire
npm config set prefix '~/.npm-global'

# Ajouter le répertoire au PATH
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
```

</CodeBlock>

</SubSection>

<SubSection title="Mettre à jour npm">

<CodeBlock>

```bash
npm install -g npm@latest
```

</CodeBlock>

</SubSection>

<SubSection title="Gestionnaires de paquets alternatifs">

<InfoBox>
💡 **Astuce :** Pour des installations plus rapides, vous pouvez utiliser des gestionnaires de paquets alternatifs.
</InfoBox>

<CodeBlock title="Installer pnpm (plus rapide)">

```bash
npm install -g pnpm
```

</CodeBlock>

<CodeBlock title="Installer Yarn">

```bash
npm install -g yarn
```

</CodeBlock>

</SubSection>

</StepSection>

---

<StepSection number="4" title="Installer les outils de développement">

<SubSection title="Build tools">

<CodeBlock title="Sur Ubuntu/Debian">

```bash
sudo apt install -y build-essential
```

</CodeBlock>

<CodeBlock title="Sur CentOS/Rocky Linux">

```bash
sudo dnf groupinstall "Development Tools" -y
```

</CodeBlock>

</SubSection>

<SubSection title="Git">

<CodeBlock title="Sur Ubuntu/Debian">

```bash
sudo apt install -y git
```

</CodeBlock>

<CodeBlock title="Sur CentOS/Rocky Linux">

```bash
sudo dnf install -y git
```

</CodeBlock>

</SubSection>

</StepSection>

---

<StepSection number="5" title="Tester votre installation">

<SubSection title="Créer une application Node.js simple">

<CodeBlock title="Créer le projet">

```bash
mkdir ~/test-nodejs
cd ~/test-nodejs
nano server.js
```

</CodeBlock>

<CodeBlock title="Code de l'application (server.js)">

```javascript
const http = require('http');

const hostname = '0.0.0.0';
const port = 3000;

const server = http.createServer((req, res) => {
  res.statusCode = 200;
  res.setHeader('Content-Type', 'text/plain');
  res.end('Hello from Node.js on AtmosNode VPS!\n');
});

server.listen(port, hostname, () => {
  console.log(`Server running at http://${hostname}:${port}/`);
});
```

</CodeBlock>

<InfoBox>
ℹ️ Enregistrez et quittez avec Ctrl+X, puis Y, puis Entrée.
</InfoBox>

</SubSection>

<SubSection title="Lancer le serveur">

<CodeBlock title="Démarrer l'application">

```bash
node server.js
```

</CodeBlock>

<CodeBlock title="Tester depuis un autre terminal">

```bash
curl http://localhost:3000
```

</CodeBlock>

<SuccessBox>
✅ Vous devriez voir : `Hello from Node.js on AtmosNode VPS!`
</SuccessBox>

</SubSection>

<SubSection title="Accès depuis l'extérieur">

<WarningBox>
⚠️ **Accès depuis Internet**

Pour accéder à votre application depuis Internet, vous devez ouvrir le port dans votre firewall.
</WarningBox>

<CodeBlock title="Avec UFW">

```bash
sudo ufw allow 3000/tcp
```

</CodeBlock>

<CodeBlock title="Avec FirewallD">

```bash
sudo firewall-cmd --permanent --add-port=3000/tcp
sudo firewall-cmd --reload
```

</CodeBlock>

</SubSection>

</StepSection>

---

<StepSection number="6" title="Gérer les processus avec PM2">

PM2 est un gestionnaire de processus pour maintenir vos applications Node.js en ligne 24/7.

<ToolDescription>

**Fonctionnalités de PM2 :**

- Maintenir vos applications en ligne 24/7
- Redémarrer automatiquement en cas de crash
- Gérer les logs
- Démarrer les applications au boot du serveur
- Mode cluster pour utiliser tous les cœurs CPU

</ToolDescription>

<SubSection title="Installer PM2">

<CodeBlock>

```bash
npm install -g pm2
```

</CodeBlock>

</SubSection>

<SubSection title="Utiliser PM2">

<CommandList>

**Démarrer une application**
```bash
pm2 start server.js
```

**Lister les applications**
```bash
pm2 list
```

**Voir les logs**
```bash
pm2 logs
```

**Arrêter une application**
```bash
pm2 stop server
```

**Redémarrer une application**
```bash
pm2 restart server
```

**Supprimer une application**
```bash
pm2 delete server
```

**Démarrer PM2 au boot**
```bash
pm2 startup
pm2 save
```

</CommandList>

<ReferenceTable>

**Commandes PM2 avancées :**

| Commande | Description |
|----------|-------------|
| `pm2 monit` | Dashboard interactif |
| `pm2 status` | Statistiques système |
| `pm2 start server.js -i max` | Mode cluster (tous les cœurs) |
| `pm2 reload all` | Redémarrage sans interruption |

</ReferenceTable>

</SubSection>

</StepSection>

---

<StepSection number="7" title="Bonnes pratiques de sécurité">

<SubSection title="Ne jamais exécuter Node.js en tant que root">

<CodeBlock title="Créer un utilisateur dédié">

```bash
sudo adduser nodejs
sudo su - nodejs
```

</CodeBlock>

</SubSection>

<SubSection title="Utiliser un reverse proxy (Nginx)">

<CodeBlock title="Installer Nginx">

```bash
# Ubuntu/Debian
sudo apt install -y nginx

# CentOS/Rocky
sudo dnf install -y nginx
```

</CodeBlock>

<CodeBlock title="Configuration Nginx (/etc/nginx/sites-available/nodejs-app)">

```nginx
server {
    listen 80;
    server_name votre-domaine.com;

    location / {
        proxy_pass http://localhost:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
}
```

</CodeBlock>

<CodeBlock title="Activer la configuration">

```bash
sudo ln -s /etc/nginx/sites-available/nodejs-app /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
```

</CodeBlock>

</SubSection>

<SubSection title="Sécuriser les variables d'environnement">

<CodeBlock title="Installer dotenv">

```bash
npm install dotenv
```

</CodeBlock>

<CodeBlock title="Créer un fichier .env">

```bash
DATABASE_URL=your-database-url
API_KEY=your-secret-key
```

</CodeBlock>

<CodeBlock title="Utiliser dans le code">

```javascript
require('dotenv').config();
const apiKey = process.env.API_KEY;
```

</CodeBlock>

</SubSection>

<SubSection title="Mettre à jour régulièrement">

<CommandList>

**Vérifier les vulnérabilités**
```bash
npm audit
```

**Corriger automatiquement**
```bash
npm audit fix
```

**Mettre à jour Node.js avec nvm**
```bash
nvm install node --reinstall-packages-from=current
```

</CommandList>

</SubSection>

</StepSection>

---

<StepSection number="8" title="Checklist de vérification">

<Prerequisites>

**Vérifiez que vous avez bien :**

✅ Node.js est installé et fonctionne (`node --version`)
✅ npm est installé et fonctionne (`npm --version`)
✅ nvm est configuré pour gérer les versions (si utilisé)
✅ Les outils de build sont installés
✅ PM2 est installé pour la gestion des processus
✅ Un reverse proxy Nginx est configuré
✅ Les applications Node.js ne s'exécutent pas en tant que root
✅ Les packages npm sont à jour sans vulnérabilités
✅ Les variables d'environnement sensibles sont sécurisées
✅ PM2 démarre automatiquement au boot du système

</Prerequisites>

</StepSection>

---

## 🎓 Ressources utiles

<ToolDescription>

**Documentation officielle :**

- **Node.js** : https://nodejs.org/docs
- **npm** : https://docs.npmjs.com
- **nvm** : https://github.com/nvm-sh/nvm
- **PM2** : https://pm2.keymetrics.io/docs
- **Node.js Best Practices** : https://github.com/goldbergyoni/nodebestpractices

</ToolDescription>

---

## 💬 Besoin d'aide ?

Si vous rencontrez des difficultés :

<HelpCards>

<HelpCard title="📚 FAQ" link="/fr/faq" />

<HelpCard title="💬 Discord" link="https://discord.gg/atmosnode">
Support communautaire 24/7
</HelpCard>

<HelpCard title="🎫 Ticket support" link="https://client.atmosnode.com" />

</HelpCards>

---

<Congratulations>

**🎉 Félicitations !**

Node.js est maintenant installé et configuré sur votre VPS ! Vous êtes prêt à développer et déployer vos applications JavaScript côté serveur.

</Congratulations>


Guide complet pour installer Node.js et npm sur Ubuntu, Debian, CentOS et Rocky Linux. Apprenez à utiliser nvm pour gérer plusieurs versions de Node.js.

Installer Node.js sur votre VPS Linux


# Installer phpMyAdmin pour Pterodactyl

Gérez facilement vos bases de données MySQL avec phpMyAdmin directement depuis votre serveur Pterodactyl.

---

## 📋 Avant de commencer

<Prerequisites>

✅ Un serveur avec Pterodactyl Panel installé
✅ MySQL/MariaDB configuré et fonctionnel
✅ Nginx ou Apache installé
✅ Accès root ou sudo au serveur
✅ Un nom de domaine ou sous-domaine (recommandé)

</Prerequisites>

---

<StepSection number="1" title="Installer phpMyAdmin">

<SubSection title="Sur Ubuntu / Debian">

<CodeBlock title="Installation des paquets">

```bash
# Mettre à jour les paquets
sudo apt update

# Installer phpMyAdmin
sudo apt install phpmyadmin php-mbstring php-zip php-gd php-json php-curl -y
```

</CodeBlock>

<InfoBox>
💡 **Astuce :** Lors de l'installation, sélectionnez **"apache2"** avec la barre d'espace même si vous utilisez Nginx (nous configurerons Nginx manuellement).
</InfoBox>

<ToolDescription>

**Pendant l'installation :**

1. Sélectionnez le serveur web : **apache2** (appuyez sur espace puis Entrée)
2. Configurer la base de données : **Oui**
3. Définissez un mot de passe pour phpMyAdmin

</ToolDescription>

</SubSection>

<SubSection title="Sur CentOS / Rocky Linux">

<CodeBlock>

```bash
# Installer le dépôt EPEL
sudo yum install epel-release -y

# Installer phpMyAdmin
sudo yum install phpmyadmin -y
```

</CodeBlock>

</SubSection>

</StepSection>

---

<StepSection number="2" title="Configurer phpMyAdmin">

<SubSection title="Activer les extensions PHP nécessaires">

<CodeBlock>

```bash
# Activer mbstring
sudo phpenmod mbstring

# Redémarrer PHP-FPM
sudo systemctl restart php8.1-fpm
```

</CodeBlock>

<InfoBox>
💡 **Note :** Remplacez `php8.1-fpm` par votre version de PHP (`php7.4-fpm`, `php8.2-fpm`, etc.).
</InfoBox>

</SubSection>

<SubSection title="Créer un lien symbolique">

<CodeBlock title="Option 1 : Lien vers Pterodactyl">

```bash
# Créer un lien vers le répertoire web de Pterodactyl
sudo ln -s /usr/share/phpmyadmin /var/www/pterodactyl/public/phpmyadmin
```

</CodeBlock>

<CodeBlock title="Option 2 : Répertoire séparé (recommandé)">

```bash
# Créer un dossier dédié
sudo mkdir -p /var/www/phpmyadmin
sudo cp -r /usr/share/phpmyadmin/* /var/www/phpmyadmin/
sudo chown -R www-data:www-data /var/www/phpmyadmin
```

</CodeBlock>

</SubSection>

</StepSection>

---

<StepSection number="3" title="Configurer Nginx">

Créez une configuration Nginx pour phpMyAdmin.

<CodeBlock title="Créer le fichier de configuration">

```bash
sudo nano /etc/nginx/sites-available/phpmyadmin
```

</CodeBlock>

<CodeBlock title="Configuration recommandée">

```nginx
server {
    listen 80;
    server_name phpmyadmin.votredomaine.com;

    root /var/www/phpmyadmin;
    index index.php index.html;

    # Logs
    access_log /var/log/nginx/phpmyadmin-access.log;
    error_log /var/log/nginx/phpmyadmin-error.log;

    # Sécurité - Bloquer l'accès aux fichiers sensibles
    location ~ ^/(libraries|setup/frames|setup/libs) {
        deny all;
        return 404;
    }

    location / {
        try_files $uri $uri/ =404;
    }

    location ~ \.php$ {
        fastcgi_pass unix:/run/php/php8.1-fpm.sock;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    # Bloquer l'accès aux fichiers cachés
    location ~ /\. {
        deny all;
    }
}
```

</CodeBlock>

<WarningBox>
⚠️ **Important**

Remplacez `phpmyadmin.votredomaine.com` par votre propre domaine et `php8.1-fpm.sock` par votre version de PHP.
</WarningBox>

<CodeBlock title="Activer la configuration">

```bash
# Créer le lien symbolique
sudo ln -s /etc/nginx/sites-available/phpmyadmin /etc/nginx/sites-enabled/

# Tester la configuration Nginx
sudo nginx -t

# Redémarrer Nginx
sudo systemctl restart nginx
```

</CodeBlock>

</StepSection>

---

<StepSection number="4" title="Sécuriser phpMyAdmin avec SSL">

Utilisez Certbot pour obtenir un certificat SSL gratuit.

<CodeBlock title="Installer Certbot">

```bash
# Installer Certbot
sudo apt install certbot python3-certbot-nginx -y

# Obtenir un certificat SSL
sudo certbot --nginx -d phpmyadmin.votredomaine.com
```

</CodeBlock>

<SuccessBox>
✅ Certbot configurera automatiquement Nginx pour utiliser HTTPS et rediriger HTTP vers HTTPS.
</SuccessBox>

</StepSection>

---

<StepSection number="5" title="Créer un utilisateur MySQL dédié">

Pour plus de sécurité, créez un utilisateur MySQL spécifique pour phpMyAdmin.

<CodeBlock title="Se connecter à MySQL">

```bash
# Se connecter à MySQL
sudo mysql -u root -p
```

</CodeBlock>

<CodeBlock title="Créer l'utilisateur dans MySQL">

```sql
-- Créer un utilisateur avec tous les privilèges
CREATE USER 'phpmyadmin_user'@'localhost' IDENTIFIED BY 'mot_de_passe_fort';

-- Accorder tous les privilèges
GRANT ALL PRIVILEGES ON *.* TO 'phpmyadmin_user'@'localhost' WITH GRANT OPTION;

-- Appliquer les changements
FLUSH PRIVILEGES;

-- Quitter
EXIT;
```

</CodeBlock>

<InfoBox>
💡 **Astuce :** Remplacez `mot_de_passe_fort` par un mot de passe complexe et unique.
</InfoBox>

</StepSection>

---

<StepSection number="6" title="Renforcer la sécurité">

<SubSection title="Configurer l'authentification HTTP">

Ajoutez une couche de sécurité supplémentaire avec l'authentification HTTP.

<CodeBlock title="Créer le fichier de mots de passe">

```bash
# Installer apache2-utils
sudo apt install apache2-utils -y

# Créer un fichier de mots de passe
sudo htpasswd -c /etc/nginx/.htpasswd admin_user
```

</CodeBlock>

<CodeBlock title="Modifier la configuration Nginx">

```bash
sudo nano /etc/nginx/sites-available/phpmyadmin
```

</CodeBlock>

<CodeBlock title="Ajouter l'authentification">

```nginx
location / {
    auth_basic "Zone Restreinte";
    auth_basic_user_file /etc/nginx/.htpasswd;
    try_files $uri $uri/ =404;
}
```

</CodeBlock>

<CodeBlock title="Redémarrer Nginx">

```bash
sudo systemctl restart nginx
```

</CodeBlock>

</SubSection>

<SubSection title="Changer l'URL d'accès">

Modifiez l'URL par défaut pour plus de sécurité.

<CodeBlock title="Modifier la configuration">

```bash
sudo nano /etc/nginx/sites-available/phpmyadmin
```

</CodeBlock>

<CodeBlock title="Changez le chemin d'accès">

```nginx
location /mon-panel-secret {
    auth_basic "Zone Restreinte";
    auth_basic_user_file /etc/nginx/.htpasswd;
    alias /var/www/phpmyadmin;
    index index.php;

    location ~ \.php$ {
        fastcgi_pass unix:/run/php/php8.1-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $request_filename;
        include fastcgi_params;
    }
}
```

</CodeBlock>

</SubSection>

<SubSection title="Restreindre l'accès par IP">

Limitez l'accès à phpMyAdmin à certaines adresses IP.

<CodeBlock>

```nginx
location /phpmyadmin {
    # Autoriser uniquement ces IPs
    allow 123.456.789.0;
    allow 192.168.1.0/24;
    deny all;

    auth_basic "Zone Restreinte";
    auth_basic_user_file /etc/nginx/.htpasswd;
    try_files $uri $uri/ =404;
}
```

</CodeBlock>

</SubSection>

</StepSection>

---

<StepSection number="7" title="Configuration avancée de phpMyAdmin">

Éditez le fichier de configuration pour optimiser phpMyAdmin.

<CodeBlock title="Éditer la configuration">

```bash
sudo nano /etc/phpmyadmin/config.inc.php
```

</CodeBlock>

<CodeBlock title="Paramètres recommandés">

```php
// Augmenter le timeout de session
$cfg['LoginCookieValidity'] = 3600;

// Forcer HTTPS
$cfg['ForceSSL'] = true;

// Masquer les bases de données système
$cfg['Servers'][$i]['hide_db'] = '^(information_schema|performance_schema|mysql|sys)$';

// Limiter le nombre de lignes affichées
$cfg['MaxRows'] = 50;

// Activer le mode compression
$cfg['ZipDump'] = true;
$cfg['GZipDump'] = true;
```

</CodeBlock>

</StepSection>

---

<StepSection number="8" title="Vérification et test">

Testez votre installation phpMyAdmin.

<ReferenceTable>

**Checklist de vérification :**

| Élément | Statut |
|---------|--------|
| phpMyAdmin accessible via HTTPS | ✅ |
| Authentification HTTP fonctionne | ✅ |
| Connexion MySQL réussie | ✅ |
| Certificat SSL valide | ✅ |
| Bases de données Pterodactyl visibles | ✅ |

</ReferenceTable>

<CodeBlock title="Accéder à phpMyAdmin">

```
https://phpmyadmin.votredomaine.com
```

</CodeBlock>

<ToolDescription>

**Connectez-vous avec :**

- Utilisateur : `phpmyadmin_user` (ou votre utilisateur MySQL)
- Mot de passe : celui que vous avez défini

</ToolDescription>

<SubSection title="Dépannage">

<CodeBlock title="Erreur 403 Forbidden">

```bash
# Vérifier les permissions
sudo chown -R www-data:www-data /var/www/phpmyadmin
sudo chmod -R 755 /var/www/phpmyadmin
```

</CodeBlock>

<CodeBlock title="Erreur PHP-FPM">

```bash
# Vérifier que PHP-FPM fonctionne
sudo systemctl status php8.1-fpm

# Redémarrer si nécessaire
sudo systemctl restart php8.1-fpm
```

</CodeBlock>

<CodeBlock title="Erreur de connexion MySQL">

```bash
# Vérifier que MySQL fonctionne
sudo systemctl status mysql

# Tester la connexion
mysql -u phpmyadmin_user -p
```

</CodeBlock>

</SubSection>

</StepSection>

---

## 💬 Besoin d'aide ?

Si vous rencontrez des difficultés :

<HelpCards>

<HelpCard title="📚 FAQ" link="/fr/faq" />

<HelpCard title="💬 Discord" link="https://discord.gg/atmosnode">
Support communautaire 24/7
</HelpCard>

<HelpCard title="🎫 Ticket support" link="https://client.atmosnode.com" />

</HelpCards>

---

<Congratulations>

**🎉 Félicitations !**

phpMyAdmin est maintenant installé et sécurisé sur votre serveur Pterodactyl. Vous pouvez gérer vos bases de données facilement et en toute sécurité !

</Congratulations>


Guide complet pour installer et configurer phpMyAdmin sur votre panel Pterodactyl. Gérez facilement vos bases de données MySQL.

Documentation & Guides

Catégories

Gaming

Getting Started

Tutorials

Tous les articles

Installer un serveur FiveM sur Windows Server

Installer un serveur Minecraft sur Debian

Premiers pas avec votre VPS Linux

Sécuriser votre VPS Linux

Installer Node.js sur votre VPS Linux

Installer phpMyAdmin pour Pterodactyl