FASTPANELWIKI

Démarrage rapide

Configuration NAT

Sur cette page

NAT est un mécanisme de traduction d'adresses réseau qui traduit les adresses IP des paquets. NAT permet aux serveurs d'un réseau local de fonctionner avec des serveurs sur un réseau externe.

Si le serveur avec FASTPANEL® possède une adresse IP privée et que NAT est configuré sur le réseau local, afin d'assurer un fonctionnement correct avec les domaines DNS, les sites web et les services de messagerie, vous devez configurer le mappage des adresses IP privées et publiques du serveur.

Pour configurer le mappage des adresses IP :

  1. Ouvrez le menu latéral gauche → "Gestion IP" → "Mappage IP"

  2. Cliquez sur "Ajouter"

  3. Pour les adresses IP locales, saisissez l'adresse IP publique correspondante

  4. Cliquez sur "Enregistrer"

Après avoir configuré le mappage des adresses, les adresses IP internes seront converties en adresses IP externes lors de la création des domaines DNS.

Liste des ports à rediriger

Pour le bon fonctionnement des principaux services, vous devez configurer la redirection des ports suivants :

  • FASTPANEL: 8888, 7777

  • FTP: 21, 65000-65500

  • SSH: 22

  • SFTP: 2222

  • HTTP, HTTPS: 80, 443

  • IMAP, IMAPS: 143, 993

  • POP3, POP3S: 110, 995

  • SMTP, SMTPS: 25, 587, 465

  • DNS(si bind9 est utilisé) : 53

Les autres services, tels que MySQL, fonctionnent généralement uniquement sur des IP locales et ne nécessitent pas d'accès public.

Configurer des clés SSH

Sur cette page

Dans FASTPANEL®, vous pouvez ajouter des clés SSH pour les utilisateurs afin de simplifier et de sécuriser l’accès au serveur.

Les clés SSH (authentification par clé publique) offrent un moyen sûr et pratique d’accéder à un serveur sans utiliser de mots de passe, à l’aide d’une paire de clés privée et publique. Au lieu de saisir un mot de passe à chaque fois, le client utilise la clé privée, tandis que le serveur la vérifie à l’aide de la clé publique, ce qui améliore à la fois la sécurité et la facilité d’utilisation.

Création d’une paire de clés

avertissement

Conservez votre clé privée en lieu sûr et ne la partagez jamais avec qui que ce soit.

Vous devez d’abord générer votre paire de clés privée et publique.

macOS / Linux

Ouvrez un terminal et exécutez :

ssh-keygen

Appuyez sur Entrée pour accepter l’emplacement de fichier par défaut et définissez une phrase secrète si nécessaire.
Vos clés seront enregistrées dans ~/.ssh/id_ed25519 (privée) et ~/.ssh/id_ed25519.pub (publique).

Windows

OpenSSH

Ouvrez PowerShell et exécutez :

ssh-keygen

Appuyez sur Entrée pour accepter l’emplacement de fichier par défaut et définissez une phrase secrète si nécessaire.
Vos clés seront enregistrées dans C:\Users\YourUser\.ssh\id_ed25519 (privée) et C:\Users\YourUser\.ssh\id_ed25519.pub (publique).

PuTTYgen
  1. Téléchargez et installez PuTTYgen.
  2. Lancez PuTTYgen et cliquez sur "Generate".
  1. Déplacez le curseur de votre souris de façon aléatoire sur la fenêtre PuTTYgen jusqu’à ce que le processus de génération soit terminé.
  2. Enregistrez la clé privée (.ppk) et copiez le texte de la clé publique.

Ajouter une clé publique au panneau

Ouvrez FASTPANEL® et cliquez sur votre nom d’utilisateur dans le coin supérieur droit de l’écran. Sélectionnez ensuite "SSH Keys".

Cliquez sur le bouton "Add SSH key".

  • Dans le premier champ, collez votre clé publique (elle commence généralement par ssh-ed25519 ou ssh-rsa, selon l’algorithme que vous avez choisi) depuis la section précédente.

  • Dans le deuxième champ, vous pouvez ajouter une description pour aider à distinguer la clé.

Après cela, vous pourrez vous connecter à votre serveur via SSH en utilisant les identifiants du propriétaire du site, sans saisir de mot de passe.

Activer l’accès SSH et gérer les clés existantes

Si vous devez gérer les clés d’autres utilisateurs ou supprimer des clés pour l’utilisateur actuel, accédez à "Management" → "Users". Cliquez sur les trois points à côté de l’utilisateur dont vous souhaitez gérer les clés.

Dans la section ouverte, vous pouvez :

  1. Ajouter une nouvelle clé.
  2. Supprimer une clé existante.
  3. Activer ou désactiver l’accès SSH pour l’utilisateur.

Définir l’adresse du panneau

Sur cette page

Introduction

En plus de l’accès standard à FASTPANEL® par adresse IP, vous pouvez également définir comme adresse du panneau n’importe quel domaine ou sous-domaine pointant vers votre serveur sur lequel FASTPANEL® est installé.

Pour commencer, veuillez vous assurer qu’un enregistrement A valide existe pour le nom de domaine que vous souhaitez utiliser comme adresse du panneau. Vous pouvez le vérifier à l’aide des commandes suivantes :

Windows :

nslookup example.com

Linux/MacOS :

host example.com

Si l’enregistrement A est correct, vous verrez la sortie suivante :

example.com has address $IP_ADDRESS

Où, à la place de $IP_ADDRESS, l’adresse IP de votre serveur doit être indiquée. Si une autre adresse est présente, veuillez la corriger dans le compte de votre fournisseur DNS et attendre la mise à jour du cache DNS. Ce processus prend généralement de 20 à 60 minutes.

Définition de l’adresse du panneau

Pour définir l’un de vos domaines ou sous-domaines comme adresse du panneau, accédez à « Settings » -> « Main » -> « Panel addresses », puis cliquez sur le bouton bleu « Add address ».

Dans la fenêtre suivante, ajoutez le domaine que vous souhaitez utiliser comme adresse du panneau, puis cliquez sur "Save".

Après cela, FASTPANEL® sera disponible à l’adresse suivante :

example.com:8888

Accès direct

Pour configurer l’accès direct sans spécifier le port 8888, cliquez sur l’icône en forme de crayon à côté de l’adresse du panneau définie :

Activez ensuite la case à cocher "Direct access" et sélectionnez les adresses IP que vous souhaitez utiliser pour ce nom de domaine :

Et cliquez sur "Save".

Certificat SSL pour l’adresse du panneau

Pour l’adresse du panneau, vous pouvez émettre un certificat SSL gratuit de Let's Encrypt, un certificat payant existant ou un certificat autosigné. Pour ce faire, cliquez sur le texte bleu "SSL" à côté de l’adresse du panneau :

Ensuite, dans la fenêtre qui s’ouvre, sélectionnez le type de certificat :

Et cliquez sur "Save".

Problèmes possibles

Veuillez noter qu’il est préférable d’utiliser comme adresse FASTPANEL® un domaine qui n’est pas derrière Cloudflare, car cela peut provoquer des problèmes avec FASTPANEL® lors d’un accès par nom de domaine en raison de limitations du côté de Cloudflare.

Si des problèmes surviennent lors de l’utilisation d’un tel domaine, veuillez vérifier s’ils se reproduisent lors de l’accès au panneau par adresse IP. Sinon, veuillez désactiver le proxy pour le nom de domaine utilisé comme adresse FASTPANEL® dans la section DNS de Cloudflare.

Comment désinstaller FASTPANEL®

important

Si vous souhaitez passer de FASTPANEL® à un autre panneau de contrôle, la réinstallation du système d’exploitation (OS) est la seule façon de procéder. Avant de le faire, il est crucial de sauvegarder toutes les données importantes sur un stockage externe. Cela garantira que vous pourrez restaurer vos projets après la réinstallation.

FASTPANEL® peut être désinstallé sans perturber le fonctionnement des sites. Cependant, cela entraînera des conséquences telles que :

  • Arrêt du renouvellement automatique des certificats SSL de Let's Encrypt émis via FASTPANEL®.
  • Désactivation des tâches de sauvegarde précédemment configurées dans FASTPANEL®.
  • Vous pourrez modifier les paramètres des sites, créer et modifier des utilisateurs, des boîtes mail, des comptes FTP/SFTP, etc. uniquement via une configuration manuelle.

Si vous êtes certain de vouloir désinstaller FASTPANEL® et comprenez parfaitement les conséquences, vous pouvez le faire en exécutant les commandes suivantes dans la console du serveur en tant que root :

Debian/Ubuntu :

apt-get remove fastpanel2 fastpanel2-nginx

CentOS/AlmaLinux/RockyLinux :

yum remove fastpanel2 fastpanel2-nginx

Si vous devez restaurer le fonctionnement de FASTPANEL® à l’avenir, vous pouvez réinstaller les paquets précédemment désinstallés. Cependant, rien ne garantit que le panneau de contrôle reprendra un fonctionnement correct après cela.
Pour installer les paquets FASTPANEL®, utilisez les commandes suivantes :

Debian/Ubuntu :

apt-get update
apt-get install fastpanel2 fastpanel2-nginx
/usr/local/fastpanel2/updater

CentOS/AlmaLinux/RockyLinux :

yum makecache
yum install fastpanel2 fastpanel2-nginx
/usr/local/fastpanel2/updater

Comment installer FASTPANEL®

important

Le panneau ne peut être installé que sur un système d’exploitation propre, sans logiciel préinstallé. L’installation sur un serveur avec des logiciels préconfigurés n’est pas possible !

Pour installer FASTPANEL®, un serveur virtuel (VPS) ou dédié avec accès root est requis.

Le matériel du serveur doit répondre aux exigences système minimales :

RAM : 1G
Espace libre : 5Gb
CPU : 1 cœur, 1 Ghz

Les systèmes d’exploitation pris en charge sont les suivants (architecture 64 bits uniquement) :

Debian : 9, 10, 11, 12

Ubuntu : 18.04, 20.04, 22.04, 24.04

CentOS : 7

AlmaLinux : 8

Rocky Linux : 8


Une fois qu’un des systèmes d’exploitation pris en charge est installé, il est nécessaire d’effectuer les actions suivantes :

  1. Connectez-vous au serveur via SSH en utilisant le mot de passe root :

    ssh root@your.server
  2. Installez les dernières mises à jour du système d’exploitation ainsi que l’utilitaire wget, requis pour exécuter le script d’installation du panneau de contrôle. Après cela, redémarrez le serveur :

    Debian / Ubuntu :

    apt-get update && apt-get upgrade && apt-get install ca-certificates wget && reboot

    CentOS / AlmaLinux / Rocky Linux :

    yum makecache && yum update && yum install ca-certificates wget && reboot
  3. Une fois le serveur redémarré, lancez le processus d’installation de FASTPANEL® en exécutant la commande suivante :

    astuce

    Lors de l’installation du panneau, vous pouvez choisir la version de MySQL. Vous pouvez en savoir plus dans cet article.

    wget https://repo.fastpanel.direct/install_fastpanel.sh -O - | bash -
  4. Une fois FASTPANEL® installé, vous recevrez un message avec les données d’accès :

    Félicitations ! FASTPANEL installé avec succès et disponible pour vous à l’adresse https://1.2.3.4:8888
    Identifiant : fastuser
    Mot de passe : password

FASTPANEL Extended est activée par défaut pour tout le monde. Aucune activation de licence n’est nécessaire.

Comment mettre à jour FASTPANEL®

Sur cette page

Par défaut, FASTPANEL® est mis à jour automatiquement selon la planification définie par le planificateur Cron. Vous n'avez pas besoin d'effectuer d'actions supplémentaires pour que le panneau soit mis à jour.

Mise à jour manuelle

Si, pour une raison quelconque, il est nécessaire de forcer une mise à jour, exécutez la commande console suivante via SSH :

/usr/local/fastpanel2/app/updater

Un fichier exécutable sera lancé, ce qui mettra FASTPANEL® à jour vers la dernière version.

Comment réinitialiser le mot de passe

Sur cette page

Introduction

FASTPANEL® propose deux méthodes différentes pour modifier le mot de passe de n’importe quel utilisateur :

Modifier le mot de passe via FASTPANEL lui-même

Cette méthode convient si le mot de passe précédent est connu (l’accès au panneau n’est pas perdu).

Pour utiliser cette option, vous devez vous connecter à FASTPANEL® et aller dans le menu "Management" → "Users", puis cliquer sur "Change Password"

Dans la fenêtre modale qui s’ouvre, saisissez votre ancien mot de passe, puis saisissez deux fois un nouveau mot de passe, puis cliquez sur le bouton "Save"

Modifier le mot de passe via SSH

Cette méthode convient si le mot de passe précédent est inconnu (l’accès au panneau est perdu). Pour modifier le mot de passe via SSH, l’ancien mot de passe n’est pas requis.

Pour utiliser cette option, vous devez :

  1. Connectez-vous à votre serveur via SSH en utilisant votre root-password :

    ssh root@your.server
  2. Utilisez une commande passwd user_name

    Par exemple, pour modifier le mot de passe de l’utilisateur nommé fastuser, la commande doit ressembler à ceci :

    passwd fastuser

    Après avoir exécuté la commande, il vous sera demandé de saisir et de confirmer un nouveau mot de passe

    remarque

    aucun caractère ne sera affiché à l’écran pendant la saisie et la confirmation du nouveau mot de passe.

  3. Si la modification du mot de passe a réussi, vous obtiendrez le message suivant :

    passwd: password updated successfully

Après cela, vous pourrez vous connecter au panneau en utilisant votre nouveau mot de passe