Prérequis
- Un serveur sous Ubuntu 24.04, Debian 13, AlmaLinux 9 ou Rocky Linux 9 : voir nos VPS au Canada
- Une connexion SSH ouverte en root : Se connecter en SSH à votre VPS
- Un serveur vierge, sans serveur web ni base de données déjà installés
- 2 Go de RAM et 10 Go d'espace disque libre
- L'adresse IP publique de votre poste, pour lui réserver l'accès au panneau
aaPanel est un panneau d'hébergement libre, géré depuis un navigateur. Ce guide l'installe, ouvre le panneau et le réserve à votre adresse. Choisissez votre système ci-dessus. Copiez la commande avec le bouton Copier, collez-la dans votre terminal, et comparez avec le résultat attendu.
1Mettre à jour le système
apt update && apt upgrade -y... 212 upgraded, 8 newly installed, 0 to remove and 4 not upgraded. (les nombres dépendent de l'âge de l'image)
dnf upgrade -y... Complete!
2Lancer l'installateur
L'installateur reçoit tout en options et travaille seul pendant une à quatre minutes. Le mot de passe est d'abord lu au clavier, sans s'afficher, pour ne pas rester dans l'historique du terminal.
wget -q https://www.aapanel.com/script/install_panel_en.shread -s -p 'Mot de passe du panneau : ' MDP; echo
bash install_panel_en.sh -u aapadmin -p "$MDP" -P 7800 --safe-path monchemin -y================================================================== Congratulations! Installed successfully! ================================================================== aaPanel Internet IPv4 Address: https://203.0.113.42:7800/monchemin aaPanel Internal Address: https://203.0.113.42:7800/monchemin username: aapadmin password: (le vôtre) Warning: If you cannot access the panel, release the following port (7800|888|80|443|20|21) in the security group ================================================================== Time consumed: 2 Minute! (entre 1 et 4 minutes selon le système)
-u aapadmin- Le nom du compte administrateur.
-p "$MDP"- Le mot de passe lu à la ligne du dessus.
-P 7800- Le port du panneau.
--safe-path monchemin- Le chemin secret. Le panneau ne répond que sur https://203.0.113.42:7800/monchemin ; à toute autre adresse, il renvoie 404. Choisissez le vôtre.
-y- Aucune question.
L'installateur écrit votre mot de passe en clair dans son journal, lisible par tous les comptes de la machine. Effacez-le.
shred -u /tmp/aapanel-install.log3Ouvrir le panneau
curl -sk -A 'Mozilla/5.0 (X11; Linux x86_64)' -o /dev/null -w '%{http_code}\n' https://127.0.0.1:7800/monchemin200
- Ouvrez https://203.0.113.42:7800/monchemin dans votre navigateur, avec l'adresse IP de votre serveur, le port et le chemin de l'étape 2.
- Le navigateur n'avertit pas : aaPanel a obtenu un certificat Let's Encrypt pour l'adresse IP pendant l'installation.
- Identifiant aapadmin, et le mot de passe que vous avez tapé à l'étape 2.
4Réserver le panneau à votre adresse
Tout Internet peut ouvrir votre panneau
L'installation ouvre le port 7800 à toutes les adresses : le panneau répond à n'importe qui sur Internet qui connaît le chemin, avec pour seule barrière le mot de passe.
ufw status | grep 78007800/tcp ALLOW Anywhere 7800/tcp (v6) ALLOW Anywhere (v6)
firewall-cmd --list-ports20/tcp 21/tcp 22/tcp 80/tcp 443/tcp 7800/tcp 39000-40000/tcp
La suite retire cette règle, puis réserve le port à une seule adresse. Remplacez 198.51.100.7 par l'adresse IP publique de votre poste.
ufw delete allow 7800/tcp
ufw allow from 198.51.100.7 to any port 7800 proto tcpRule deleted Rule deleted (v6) Rule added
firewall-cmd --permanent --remove-port=7800/tcp
firewall-cmd --permanent --add-rich-rule='rule family=ipv4 source address=198.51.100.7 port port=7800 protocol=tcp accept'
firewall-cmd --reloadsuccess success success
ufw status | grep 78007800/tcp ALLOW 198.51.100.7
firewall-cmd --list-rich-rulesrule family="ipv4" source address="198.51.100.7" port port="7800" protocol="tcp" accept
Depuis votre adresse, le panneau répond ; depuis n'importe quelle autre, il ne répond plus, alors que SSH reste joignable par tous.
curl -sk -A 'Mozilla/5.0 (X11; Linux x86_64)' -o /dev/null -w '%{http_code}\n' --max-time 10 https://203.0.113.42:7800/monchemin000 (000 veut dire aucune réponse : c'est le résultat attendu depuis une adresse qui n'est pas la vôtre)
5Changer le mot de passe administrateur
Le mot de passe du panneau se change depuis le serveur, avec le menu bt. Tapez le nouveau mot de passe à l'invite.
bt 5=============================================== EXECUTING =============================================== Pls enter new password: |-Username: aapadmin |-New password: (le vôtre)
Le mot de passe donné à l'installation reste écrit dans un fichier que bt 14 affiche en clair. Effacez-le.
chattr -i /www/server/panel/default.pl && shred -u /www/server/panel/default.pl6Les commandes du quotidien
Le panneau se pilote avec la commande bt et un numéro. Redémarrez-le avec bt 1, pas avec systemctl : après un bt 1, systemctl restart btpanel l'arrête.
btbt 14bt 1bt 2bt 3bt 5bt 22ss -ltnbt===============aaPanel CLI================== (1) Restart panel (8) Change panel port (2) Stop panel (9) Clear panel cache (3) Start panel (10) Clear login limit (4) Reload panel (11) Turn on/off IP + User-Agent Authenticator (5) Change panel password (12) Cancel domain binding limit (6) Change panel username (13) Cancel IP access limit (7) Forcibly change MySQL root password (14) View panel default info (22) Display panel error log (15) Clear system rubbish (23) Turn off BasicAuth Authenticator (16) Repair panel (check for errors and update panel files to the latest version) (24) Turn off Google Authenticator (17) Set log cutting on/off compression (25) Save copy when modify file in panel (18) Set whether to back up the panel automatically (26) Keep/Remove local backup when backing up to cloud storage (27) Turn on/off panel SSL (28) Modify panel security entrance (33) lift the explosion-proof limit on the panel (0) Cancel =============================================== Pls enter command number：
bt 14================================================================== aaPanel default info! ================================================================== aaPanel Internet IPv4 Address: https://203.0.113.42:7800/monchemin aaPanel Internal Address: https://203.0.113.42:7800/monchemin username: aapadmin password: Warning: If you cannot access the panel, release the following port (7800|888|80|443|20|21) in the security group ================================================================== (la ligne password est vide une fois le fichier de l'étape 5 effacé ; avant, elle montre le mot de passe de l'installation)
ss -ltn | awk 'NR>1{print $4}' | sed 's/.*://' | sort -n -u | tr '\n' ' '22 53 7800 (Debian ajoute 25 et 5355 : des services du système)
ss -ltn | awk 'NR>1{print $4}' | sed 's/.*://' | sort -n -u | tr '\n' ' '22 7800 (Rocky ajoute 111 : un service du système)
aaPanel n'installe aucun serveur web avec le panneau : les ports 80 et 443 sont ouverts dans le pare-feu, mais rien n'y répond.
Sur AlmaLinux et Rocky, l'installateur a désactivé SELinux : permissif sur AlmaLinux, désactivé sur Rocky.
Sur Ubuntu et Debian, l'installateur a fait de bash le shell de /bin/sh à la place de dash.
Erreurs fréquentes
L'image du serveur a été construite sur un autre disque et GRUB demande où se réinstaller : choisissez le disque de la machine (celui que lsblk affiche, en général /dev/sda) ; la mise à jour continue ensuite.
L'option -y manque à la commande de l'étape 2. Répondez y, ou relancez avec -y.
L'installateur refuse openSUSE. Il refuse aussi de tourner sur Alpine, qui n'a pas bash. Prenez Ubuntu, Debian, AlmaLinux ou Rocky.
L'installateur ne reconnaît pas Fedora : il tente de compiler Python lui-même et n'y arrive pas. Prenez AlmaLinux ou Rocky.
Sur CentOS Stream 9, l'installation a rendu SSH inutilisable à chaque essai : la connexion est acceptée puis fermée aussitôt. Il ne reste que la console de votre hébergeur. Prenez AlmaLinux ou Rocky, qui passent.
Le panneau répond 404 à tout ce qui n'est pas un navigateur, et à toute adresse sans le chemin secret. Dans le navigateur, vérifiez le chemin ; sur le serveur, bt 14 le réaffiche.
aaPanel n'a pas pu obtenir son certificat Let's Encrypt pendant l'installation. Le chiffrement fonctionne quand même.
L'adresse IP publique de votre poste a changé, ou ce n'est pas celle de la règle. Retrouvez-la dans votre session SSH avec echo $SSH_CLIENT, puis ajoutez-la : ufw allow from VOTRE_IP to any port 7800 proto tcp sur Ubuntu et Debian ; firewall-cmd --permanent --add-rich-rule='rule family=ipv4 source address=VOTRE_IP port port=7800 protocol=tcp accept' suivi de firewall-cmd --reload sur AlmaLinux et Rocky.
Posez-en un nouveau depuis le serveur avec bt 5 (étape 5).
bt 14 les réaffiche.
aaPanel en service
Le panneau répond sur le port 7800, sur son chemin secret, réservé à votre adresse. Pour un panneau qui installe le serveur web et le courriel avec lui, voyez Installer HestiaCP ou Installer CyberPanel.