
🛠 Comment installer aaPanel en 2026 : un guide étape par étape et une analyse honnête
Vous avez acheté un VPS et vous voyez un écran noir avec un curseur clignotant. Pour configurer un site web, une base de données et un certificat SSL via le terminal, vous avez besoin de dizaines de commandes dans le bon ordre. Faites une seule erreur dans une ligne de configuration et votre site est hors ligne pendant que vous épluchez les logs pour en trouver la cause.
aaPanel supprime cette barrière: le panneau de contrôle pour serveur Linux s’installe avec une seule commande et remplace le terminal par une interface navigateur. Sites, bases de données, versions multiples de PHP, Docker, pare-feu, certificats SSL: tout se configure à la souris.
Voici le processus d’installation, de la connexion SSH jusqu’à votre premier site, à jour à la mi-2026. Nous aborderons aussi ce que la plupart des tutoriels passent sous silence: le port du panneau n’est plus le 8888 depuis longtemps, CentOS 7 ne peut pas être installé, et «gratuit et open source» est une simplification marketing. Nous commençons par cela parce que la moitié des guides dans les résultats de recherche répètent encore des informations de 2021.
💡 Aperçu rapide:
- Connectez-vous à votre serveur en SSH en tant que root et exécutez une seule commande universelle
- En quelques minutes, vous obtenez une adresse de panneau en HTTPS avec un port aléatoire, un identifiant et un mot de passe
- À la première connexion, vous choisissez votre environnement: LNMP (Nginx) ou LAMP (Apache)
- Changez immédiatement le mot de passe, activez la 2FA et fermez les ports inutiles
- Depuis le panneau, vous gérez les sites, les bases de données, Docker, le pare-feu et les certificats
Ce qui est obsolète dans les anciens guides
Avant de copier des commandes issues de tutoriels vieux de trois ans, vérifiez cette liste. Les erreurs ici coûtent cher.
Ce que disent les anciens guides | La réalité en 2026 |
|---|---|
«Installez sur CentOS 7 ou Ubuntu» | CentOS 7 est mort (fin de vie le 30/06/2024). L’installateur vous en avertit et attend 10 secondes avant de démarrer |
«Ouvrez le port 8888» | Le port est généré aléatoirement (plage 10000-65535). Le port fixe 8888 n’existe plus |
Le panneau s’ouvre via | HTTPS activé par défaut (certificat auto-signé) |
Des scripts séparés pour chaque distribution | Un seul script universel |
Version 6.x | Branche stable 8.0.x |
Surtout en ce qui concerne le port: même des tutoriels récents en anglais de 2025-2026 continuent d’écrire «8888». C’est une erreur directe et vous n’accéderez tout simplement pas au panneau.
Qu’est-ce que aaPanel et à qui s’adresse-t-il
aaPanel est un panneau de gestion de serveur Linux basé sur le web, développé par une équipe chinoise (la version internationale du panneau chinois BT Panel). Il fonctionne au-dessus du système d’exploitation et remplace la ligne de commande par une interface navigateur: sites, FTP, bases de données, versions multiples de PHP, pare-feu, Docker, planificateur de tâches.
La version gratuite couvre toutes les tâches de base. La version Pro payante ajoute des comptes multi-utilisateurs et l’intégration de la facturation, ce qui est pertinent pour les hébergeurs.
Voici à quoi ressemble le cycle d’installation complet sur un vrai VPS.
Regard honnête sur la licence
aaPanel est présenté comme «gratuit et open source», mais c’est une simplification. Le panneau est distribué sous sa propre licence (AAPANEL Open Source License Agreement), pas sous MIT, GPL ou Apache. Points clés: le code source des plugins payants est fermé, vous pouvez modifier le code pour un usage personnel, mais publier des forks est interdit.
La description exacte: pas open source au sens classique, mais code source disponible avec des restrictions. Utilisez-le gratuitement, oui. Forkez-le et publiez votre propre version, non.
L’installateur envoie également le nombre d’installations aux développeurs et, en cas d’échec, les dernières lignes du journal d’installation. Techniquement, il s’agit d’un rapport d’erreur, pas d’une porte dérobée, mais vous devez le savoir.
Regard honnête sur la sécurité
Au cours de la période 2025-2026, plusieurs vulnérabilités critiques ont été corrigées dans aaPanel, notamment CVE-2026-29859, un téléchargement arbitraire de fichier avec exécution de code noté 9,8 sur 10 sans authentification. Il y a également eu une RCE via l’archiveur (CVE-2025-48702), que le développeur a corrigée en deux jours.
La conclusion n’est pas «n’installez pas», mais «mettez à jour rapidement et n’exposez pas le panneau à Internet tel quel». Un panneau de contrôle serveur est un point d’entrée avec des privilèges root. Les sections ci-dessous concernant le changement de port, la 2FA et le pare-feu ne sont pas optionnelles.
Systèmes d’exploitation supportés
Liste actuelle (issue de la documentation et du code de l’installateur):
OS | Versions |
|---|---|
Ubuntu | 22.04 LTS (recommandé), 24.04 LTS |
Debian | 11, 12, 13 |
AlmaLinux | 8, 9, 10 |
Rocky Linux | 8, 9, 10 |
CentOS | 9, 10 (Stream) |
Non supportés: CentOS 6, openSUSE, les systèmes 32 bits et les versions non-LTS d’Ubuntu (l’installateur les rejette).
Prérequis: 1 cœur, 512 Mo de RAM, 1 Go de disque. En pratique, au moins 1 Go de RAM. Si le swap est absent, l’installateur créera automatiquement un fichier swap de 1 Go.
⚠️ Système propre uniquement. Si Apache, Nginx, PHP ou MySQL tournent déjà sur le serveur, l’installateur écrasera leurs configurations et cassera les sites en production. La migration se fait via un nouveau VPS: sauvegarde, installation propre, importation.
Étape 1: Préparer le serveur
Connectez-vous en SSH en tant qu’utilisateur avec les privilèges root (l’installation n’est possible qu’en root):
1 ssh root@your_server_ip
Mettez à jour les paquets. Pour Ubuntu et Debian:
1 apt update && apt upgrade -y
Pour AlmaLinux et Rocky Linux:
1 dnf update -y
Assurez-vous qu’aucun environnement web n’existe:
1 which nginx; which apache2; which mysqld
Sur un serveur propre, les trois commandes ne renverront aucun résultat. Si vous trouvez un chemin de fichier, supprimez le paquet avant d’exécuter l’installateur.
Étape 2: Exécuter le script d’installation
La commande actuelle de la page de téléchargement officielle est universelle pour toutes les distributions:
1 URL=https://www.aapanel.com/script/install_panel_en.sh && if [ -f /usr/bin/curl ];then curl -ksSO $URL ;else wget --no-check-certificate -O install_panel_en.sh $URL;fi;bash install_panel_en.sh
Le script détectera le système d’exploitation et récupérera les dépendances automatiquement. N’utilisez pas les anciennes adresses comme install_6.0_en.sh ou install-ubuntu_7.0_en.sh issues d’instructions obsolètes.
Confirmez l’installation dans le répertoire /www en saisissant Y. Aucune autre intervention n’est nécessaire: le script déploiera le serveur web, la base de données, PHP et l’interface du panneau elle-même. Cela prend quelques minutes.
Étape 3: Sauvegarder les identifiants
Une fois terminé, le terminal affichera trois éléments:
- Adresse du panneau au format
https://IP:PORT/random_path - Nom d’utilisateur
- Mot de passe

Notez deux détails qui n’étaient pas présents dans les anciennes versions. Premièrement, https**, pas **http: le certificat est auto-signé, le navigateur affichera donc un avertissement. C’est normal; cliquez sur «Avancé → Continuer». Deuxièmement, le port est aléatoire et l’adresse inclut un chemin aléatoire (entrée de sécurité). Sans l’adresse complète, vous obtiendrez une erreur 404, ce qui est intentionnel.
Ouvrez l’adresse fournie dans votre navigateur et vous verrez le formulaire de connexion du panneau.

Copiez tout dans un gestionnaire de mots de passe avant de fermer le terminal. Si vous le perdez, pas de problème: la commande bt 14 en SSH affichera à nouveau les données de connexion.
N’oubliez pas d’ouvrir le port attribué chez votre hébergeur. Les fournisseurs cloud (Oracle Cloud, AWS, Google Cloud) ont leur propre pare-feu dans le tableau de bord, et il bloque tout sauf le port 22 par défaut.
Étape 4: Choisir l’environnement web
Lors de la première connexion, le panneau proposera une pile:
- LNMP (Nginx + MySQL + PHP), adapté à la plupart des sites
- LAMP (Apache + MySQL + PHP), si vous avez besoin du
.htaccess
L’installation démarrera en arrière-plan. Si vous avez sauté cette étape, les mêmes composants peuvent être installés plus tard via l’App Store dans le menu de gauche.
Étape 5: Paramètres de sécurité initiaux
Faites-le immédiatement, avant de déployer votre premier site. Un panneau de contrôle, c’est un accès root, et les scanners finiront par trouver son adresse.
Changez l’identifiant et le mot de passe. Dans la section Paramètres. Les valeurs générées sont bonnes, mais les utilisateurs les simplifient souvent «pour s’en souvenir». Ne le faites pas.
Activez l’authentification à deux facteurs. Allez dans Paramètres → Vérification en deux étapes, liez une application d’authentification et sauvegardez les codes de secours. Sans second facteur, un mot de passe divulgué signifie un accès complet au serveur.
Restreignez l’accès par IP. Si vous travaillez depuis une seule adresse, n’autorisez la connexion au panneau que depuis celle-ci. C’est plus fort que n’importe quel mot de passe.
Fermez les ports inutiles. Dans la section Sécurité, ne laissez ouvert que ce qui est nécessaire: 80 et 443 pour les sites, 22 pour le SSH, le port du panneau. Tout le reste doit être fermé.
Mettez en place un SSL approprié pour le panneau. Dans les paramètres, liez un domaine et obtenez un certificat Let’s Encrypt pour vous débarrasser de l’avertissement du navigateur et éviter d’envoyer les mots de passe via une connexion auto-signée.
Restez à jour. Étant donné l’historique des vulnérabilités RCE, gardez le panneau sur la version actuelle. Les mises à jour se trouvent dans Paramètres → Version, mais faites d’abord un snapshot du VPS chez votre fournisseur: parfois une mise à jour modifie la configuration de PHP ou Nginx.
Étape 6: Ce qu’il y a à l’intérieur
Les captures d’écran ci-dessous montrent les sections clés du panneau. Le design change selon les versions, mais le contenu et la logique des sections restent les mêmes.
Tableau de bord. Charge CPU, mémoire, disque, trafic réseau en temps réel.

Sécurité. Section pare-feu: ports ouverts et règles. Gardez ouvert uniquement ce qui est nécessaire.

Paramètres. Changement de l’identifiant et du mot de passe, port du panneau, authentification à deux facteurs, SSL, accès API.

App Store. Un clic pour installer un serveur mail, Node.js, Redis, MongoDB, WordPress Toolkit et des dizaines d’autres composants. Aucun terminal nécessaire.

Docker. Le panneau installe Docker et fournit une interface graphique pour les images et les conteneurs, y compris Compose.

Sauvegarde. Il n’y a pas de sauvegardes automatiques par défaut; la planification se configure manuellement. Spécifiez un stockage externe: une copie locale disparaîtra avec le disque.
aaTerm. Terminal intégré au navigateur: une console sans client SSH séparé lorsque vous devez rapidement corriger quelque chose depuis l’ordinateur de quelqu’un d’autre.
La branche 8.0.x a également ajouté un module d’IA avec des diagnostics serveur et la migration WordPress depuis d’autres panneaux.
Gestion du service et désinstallation
Le panneau se gère avec l’utilitaire bt. Le redémarrage n’affecte que l’interface: les sites et les bases de données continuent de fonctionner.
1 bt stop # stop the panel 2 bt start # start 3 bt restart # restart 4 bt 14 # show login data 5 bt 5 # change password 6 bt 8 # change panel port
Suppression complète du panneau (les sites, bases de données et configurations dans /www/server/ et /www/wwwroot/ sont conservés):
1 sudo bt stop && sudo rm -f /etc/init.d/bt && sudo rm -rf /www/server/panel
Alternatives si aaPanel n’a pas fonctionné
Panneau | Positionnement | Prix |
|---|---|---|
HestiaCP | GPL, pas de télémétrie, serveur mail inclus | Gratuit |
CyberPanel | OpenLiteSpeed + LSCache, WordPress rapide | Gratuit (a eu ses propres CVE critiques) |
CloudPanel | Léger et moderne, pas de serveur mail | Gratuit |
Coolify / Dokploy | PaaS auto-hébergé sur Docker, «git push → site» | Gratuit en auto-hébergement |
Plesk / cPanel | Standard commercial dans l’industrie de l’hébergement | À partir de 18-20 $ par mois, les prix augmentent chaque année |
Si l’origine chinoise et la télémétrie vous préoccupent, regardez du côté d’HestiaCP: même créneau, GPL, pas de «phone home». Si votre serveur est destiné aux conteneurs plutôt qu’à l’hébergement classique, envisagez Coolify.
⁉️🤔 Foire aux questions
Après l’installation, le navigateur n’ouvre pas le panneau. Quel est le problème?
Trois causes par ordre de fréquence. Premièrement: vous essayez le port 8888 d’un ancien guide, qui n’existe plus. Vérifiez le port dans la sortie de l’installateur ou exécutez
bt 14. Deuxièmement: le port est fermé dans le pare-feu de votre fournisseur cloud (pas dansufw, mais dans le panneau Oracle/AWS/Google). Ouvrez-le là-bas. Troisièmement: vous avez oublié le chemin aléatoire à la fin de l’adresse. Sans lui, le panneau renvoie intentionnellement une 404.
aaPanel est-il vraiment gratuit?
La version de base, oui, sans clé de licence et sans limite sur le nombre de sites. Mais «gratuit» ne signifie pas «open source»: la licence est propriétaire, la publication de forks est interdite, le code source des plugins payants est fermé et l’installateur envoie des statistiques aux développeurs. Pour un VPS personnel, ce n’est généralement pas un problème. Sachez simplement à quoi vous vous engagez.
Puis-je installer aaPanel sur un serveur où des sites tournent déjà?
Non. L’installateur écrasera les configurations de Nginx, Apache et PHP et cassera ce qui fonctionne déjà. La bonne méthode: sauvegardez les fichiers et les bases de données, procurez-vous un VPS propre, installez aaPanel, importez les sites via l’interface. Une migration «à chaud» n’est pas possible.
Est-ce sécurisé, compte tenu des vulnérabilités?
Un panneau avec des privilèges root est toujours un risque, et des vulnérabilités RCE critiques dans aaPanel ont été découvertes en 2025 et 2026. Le développeur corrige rapidement, mais les conclusions sont simples: mettez à jour rapidement, activez la 2FA, restreignez la connexion par IP et ne laissez pas le panneau ouvert à tout Internet. Pour un serveur avec des données sensibles, envisagez un panneau avec une licence ouverte et un code auditable.
Existe-t-il une interface en français?
Oui, la langue peut être changée dans les paramètres. Après l’installation, l’interface peut s’ouvrir en anglais ou en chinois. Changez-la immédiatement pendant que l’emplacement des boutons n’est pas encore familier.
En quoi aaPanel est-il meilleur que cPanel?
Le prix et la barrière à l’entrée: cPanel coûte à partir de 18 $ par mois et est conçu pour les hébergeurs avec des centaines de comptes. aaPanel est gratuit, plus léger en ressources et plus simple pour un ou deux serveurs. Mais cPanel est un écosystème mature avec du support et un cycle de sécurité prévisible. Pour un VPS personnel, aaPanel fonctionne bien; pour l’hébergement mutualisé commercial, cPanel.
En résumé
Pour ceux qui débutent avec un VPS et ne veulent pas passer leurs soirées sur des fichiers de configuration, aaPanel est un excellent point de départ: gratuit, s’installe en quelques minutes, couvre les sites, les bases de données, le SSL, le pare-feu et les sauvegardes.
Mais vous devez l’aborder en connaissance de cause. Ce n’est pas un projet GPL, l’installateur communique avec les serveurs du développeur et le panneau a connu des vulnérabilités critiques d’exécution de code à distance corrigées au cours des deux dernières années. Rien de tout cela ne rend aaPanel inutilisable. Cela exige simplement de la discipline: mises à jour, 2FA, restriction de l’accès par IP.
Et le principal enseignement de cet article: le port n’est plus le 8888, l’accès se fait via HTTPS et CentOS 7 ne s’installe pas en 2026. La moitié des guides dans les résultats de recherche ne le savent pas encore.
Installez aaPanel sur un VPS de test et passez quelques soirées avec. Le risque, c’est une demi-heure de votre temps, et l’expérience vous restera. Quel panneau utilisez-vous et pourquoi? Écrivez-le dans les commentaires.



