CLI
Bases de données
Sur cette page
Obtenir une liste des serveurs de bases de données
Commande
mogwai databases servers listExemple de sortie
ID NAME TYPE LOCAL HOST USERNAME AVAIL
1 mysql(localhost) mysql true fastuser true
2 postgresql(localhost) postgresql true fastuser trueLe serveur IDs est utilisé dans d'autres commandes.
Obtenir une liste des bases de données
Commande
mogwai databases listExemple de sortie
ID NAME SERVER_NAME LOCAL HOST CHARSET OWNER SIZE CREATE_AT
1 db1 mysql(localhost) localhost true utf8mb4 user 0 2024-05-28 10:03:03.227413266 +0000 UTC
2 database43s mysql(localhost) localhost true utf8mb4 user82 0 2024-05-28 10:07:15.001640584 +0000 UTCSynchronisation de la liste des bases de données
Si vous avez récemment ajouté ou supprimé des bases de données, et qu'elles n'apparaissent pas encore dans FASTPANEL, vous pouvez forcer la synchronisation des listes
Commande
mogwai databases syncCréer une nouvelle base de données
Commande
mogwai databases create [flags]Options
-n,--name=NAME: Nom de la base de données.-o,--owner="fastuser": utilisateur FASTPANEL auquel la base de données sera ajoutée.-s,--site=SITE: Site web dans FASTPANEL auquel la base de données sera ajoutée.-c,--charset="utf8mb4": Encodage de la base de données.-u,--username=USERNAME: Nom d'utilisateur de la base de données.-p,--password=PASSWORD: Mot de passe de l'utilisateur de la base de données.
Exemple de commande
mogwai databases create --server=1 -n db1 -o fastuser -s example.com -u dbuser -p dbpassword1Cette commande créera une base de données nommée db1 sur le serveur de bases de données par défaut (--server=1) et la « liera » au site example.com.
Sur cette page
Obtenir une liste des domaines e-mail
Commande
mogwai emails domains listExemple de sortie
ID NAME FALLBACK DKIM ENABLED OWNER_ID OWNER CREATE_AT
1 example.com true true 1 example_com_usr 2024-01-04 15:46:02+03:00Le domaine IDs est utilisé dans d'autres commandes.
Ajout d'un domaine e-mail
Commande
mogwai emails domains createOptions
--domain=DOMAIN: Nom du domaine e-mail.-o,--owner="fastuser": L'utilisateur FASTPANEL auquel le domaine e-mail sera ajouté.
Exemple de création d'un domaine e-mail example1.com sous l'utilisateur fastuser
mogwai emails domains create --domain=example1.com -o fastuserObtenir une liste des boîtes mail
Commande
mogwai emails boxes listOptions
--domain=DOMAIN: Nom du domaine de messagerie
Exemple de commande
mogwai emails boxes list --domain example.comExemple de sortie
ID ADDRESS ALIASES REDIRECTS SIZE QUOTA ENABLED OWNER_ID OWNER CREATE_AT
1 user@example.com 0 0 true 4 example_com_usr 2024-02-08 11:13:01+03:00Le ID de la sortie de la commande est utilisé dans d'autres commandes.
Création d'une boîte mail
Commande
mogwai emails boxes createOptions
--domain=DOMAIN: Nom du domaine e-mail.-l,--login=LOGIN: Le nom de la boîte mail, sans le domaine.-p,--password=PASSWORD: Le mot de passe de la boîte mail.
Exemple de commande
mogwai emails boxes create --domain=example.com --login=user --password=MySecretPassword123Cette commande créera une boîte mail nommée user@example.com avec le mot de passe MySecretPassword123.
Suppression d'une boîte mail
Commande
mogwai emails boxes deleteOptions
-b,--box=BOX: L'ID de la boîte mail..
Exemple de commande
mogwai emails boxes delete -b 1Cette commande supprimera la boîte mail avec l'ID 1.
Importation de boîtes mail et d'e-mails
Commande
mogwai emails boxes import[sync] [<flags>]Options
-i,--import_config=IMPORT_CONFIG: Chemin vers le fichier de liste d'importation--force: Uniquement pour le modeimport- efface les boîtes mail existantes.
Pour importer le courrier, vous devez préparer une liste de boîtes mail sur le serveur au format suivant :
IMAP_HOST;SOURCE_ADDR;SOURCE_PASSWORD;DEST_ADDROptions
IMAP_HOST: Adresse du serveur de messagerie IMAP.SOURCE_ADDR: Boîte mail sur le serveur source.SOURCE_PASSWORD: Mot de passe pour la connexion IMAP à la boîte mail sur le serveur source. Certains services, tels que Google, exigent la création d'un mot de passe d'application pour l'accès IMAP https://support.google.com/accounts/answer/185833?hl=enDEST_ADDR: Boîte mail sur le serveur FASTPANEL vers laquelle les messages sont transférés.
Exemple de contenu de fichier
imap.gmail.com;test@gmail.comu;password;test@example.com
imap.gmail.com;test1@gmail.com;password;test1@example.comDeux modes sont disponibles :
Mode d'importation
mogwai emails boxes importDans ce mode, tous les messages sont copiés intégralement, les boîtes mail sur le serveur FASTPANEL ne doivent pas être créées ou doivent être vides - lorsque la commande est exécutée, FASTPANEL crée les boîtes mail nécessaires. Si des boîtes mail contenant déjà du contenu existent, une erreur sera affichée. Vous pouvez utiliser l'indicateur --force - la boîte mail sera alors vidée.
Exemple d'exécution de la commande avec une liste de boîtes mail stockée dans le fichier /root/import.txt et utilisation de la clé --force
mogwai emails boxes import --import_config=/root/import.txt --forceMode de synchronisation
mogwai emails boxes syncDans ce mode, le Panneau de contrôle télécharge les messages depuis le serveur source sans rien supprimer. Il doit être utilisé si de nouveaux messages sont apparus dans la boîte mail d'origine après la première importation et doivent également être transférés.
Exemple de commande
mogwai emails boxes sync --import_config=/root/import.txtDescription
Sur cette page
FASTPANEL fournit une interface en ligne de commande (CLI) implémentée via l'utilitaire mogwai (/usr/local/bin/mogwai). L'utilitaire fonctionne uniquement lorsqu'il est exécuté en tant que root.
Aide
Pour voir une liste des commandes disponibles, utilisez :
mogwai --helpPour en savoir plus sur une commande spécifique, utilisez :
mogwai command --helpPour voir une liste des commandes avec leurs descriptions, utilisez :
mogwai --help-longSites web
Sur cette page
Liste des sites sur un serveur
Commande
mogwai sites listExemple de sortie
ID SERVER_NAME ALIASES OWNER MODE PHP_VERSION IPS DOCUMENT_ROOT
1 example.com www.example.com example_com_usr mpm_itk 82 127.0.0.1 /var/www/example_com_usr/data/www/example.comRemarque : Les IDs du site de cette liste sont utilisés dans d'autres commandes.
Créer un nouveau site
Commande
mogwai sites create --server-name=SERVER-NAME --owner=OWNER [<flags>]Options
--owner: Utilisateur du système FASTPANEL qui sera propriétaire du site.--server-name=SERVER-NAME: Nom de domaine du site.-a,--alias=ALIAS: Alias pour le site, tels que les sous-domaines www. Plusieurs alias peuvent être spécifiés.--ip=IP: Adresse IP du serveur sur lequel le site sera exécuté. Plusieurs adresses IP peuvent être spécifiées.-h,--handler=HANDLER: Gestionnaire backend. Peut être :- PHP :
cgi,mpm_itk,php_fpm,fcgi; - Node.js :
standalone,pm2; - Systemd :
systemd.
- PHP :
--handler_version=HANDLER_VERSION: Version de PHP ou Node.js (par ex.8.2,8.3,20.15.1).--create-user: Créer un utilisateur pour le site.
Exemple de commande
mogwai sites create --server-name=example.com --owner=user --create-user --alias=www.example.com --ip=127.0.0.1 --handler=fcgi --handler_version=7.3Supprimer un site
Commande
mogwai sites delete --id=IDLe site ID peut être obtenu à partir de la commande mogwai sites list.
Exemple de commande
mogwai sites delete --id=987Cette commande supprimera le site avec l'ID 987
Modifier les paramètres du site
Commande
mogwai sites update --id=ID [<flags>]Le site ID peut être obtenu à partir de la commande mogwai sites list.
Options
-i,--id=ID: ID du site.-a,--add-alias=ADD-ALIAS: Ajouter un alias, plusieurs alias peuvent être spécifiés.--del-alias=DEL-ALIAS: Supprimer un alias, plusieurs alias peuvent être spécifiés.--add-ip=ADD-IP: Ajouter une adresse IP à partir des paramètres du site, plusieurs adresses IP peuvent être spécifiées.--del-ip=DEL-IP: Supprimer une adresse IP des paramètres du site, plusieurs adresses IP peuvent être spécifiées.-h,--handler=HANDLER: Gestionnaire backend. Peut être :- PHP :
cgi,mpm_itk,php_fpm,fcgi; - Node.js :
standalone,pm2; - Systemd :
systemd.
- PHP :
--handler_version=HANDLER_VERSION: Version de PHP ou Node.js (par ex.8.2,8.3,20.15.1).--gzip: Activer la compression.--no-gzip: Désactiver la compression.--gzip-comp-level=LEVEL: Définir le niveau de compression, 1-9.--expires=EXPIRES: Définir la durée de mise en cache du contenu statique.--worker-count=WORKER-COUNT: Définir le nombre de workers pour PHP-FPM
Vous pouvez également mettre à jour les paramètres de plusieurs sites sur un serveur à l'aide de la commande
mogwai sites batch-update- Pour modifier les paramètres de tous les sites, utilisez l'indicateur
-a. - Pour modifier les paramètres des sites sélectionnés, spécifiez plusieurs indicateurs
--idavec leurIDs.
Exemple de commande
mogwai sites update --id=1 -a www1.example.com -h cgi --handler_version=5.6Cette commande ajoutera un alias www1.example.com, remplacera le handler par cgi et la version de PHP par 5.6 pour le site avec l’ID 3
Exemple de commande
mogwai sites batch-update -h cgi --handler_version=5.6 --id 3 --id 2Cette commande changera le gestionnaire PHP pour les sites avec les ID 2 et 3
Transfert d’utilisateurs entre les serveurs FASTPANEL
Sur cette page
Introduction
Cet article décrit le processus de transfert des comptes utilisateurs et de leurs données associées (sites web, bases de données, e-mail, etc.) d’un serveur FASTPANEL à un autre à l’aide de l’utilitaire de migration intégré.
Termes clés
- Serveur source - Le serveur depuis lequel les données sont transférées.
- Serveur de destination - Le serveur vers lequel les données sont transférées.
Remarques importantes
-
Par défaut, la migration fonctionne correctement uniquement pour les sites avec une configuration FASTPANEL standard.
-
Les sites avec des modifications de configuration manuelle ne peuvent être transférés que si l’indicateur
-mest utilisé pour le mappage des adresses IP. -
Si un mot de passe chiffré pour le propriétaire d’une base de données n’est pas disponible, la base de données ne sera pas transférée.
-
Si un site web n’est pas transféré, ses bases de données associées ne seront pas transférées non plus.
-
Seules les bases de données locales peuvent être transférées.
Processus de migration
Connexion
Le serveur de destination se connecte au serveur source via SSH. Lors de la première connexion, le serveur de destination installe une clé SSH sur le serveur source (soit fournie à l’avance, soit générée à partir d’un mot de passe).
Étapes de la migration
- Installation des modules
- Collecte d’informations sur les objets transférables
- Création des utilisateurs
- Transfert des certificats SSL
- Création des sites web, des comptes FTP, des domaines de messagerie et des comptes de messagerie
- Création des bases de données et des utilisateurs de bases de données
- Transfert des fichiers de site web et des fichiers des boîtes mail
- Transfert des tâches cron
Le transfert de fichiers est exécuté à l’aide de rsync. Les bases de données sont transférées en créant un dump via un tunnel SSH.
Commande pour démarrer la migration
La commande est exécutée sur le serveur de destination en tant qu’utilisateur disposant des privilèges root :
/usr/local/fastpanel2/fastpanel transfer run [SSH_PARAMETERS] [IP_PARAMETERS] [ADDITIONAL_OPTIONS]Indicateurs de ligne de commande
Connexion SSH
--remote_host="SOURCE_IP" - Adresse IP du serveur source.--remote_port="SSH_PORT" - Port SSH.--remote_username="SSH_USER" - Utilisateur (doit être root).--remote_password="USER_PASSWORD" - Mot de passe pour l’utilisateur SSH spécifié.--ssh_key_path="PATH_TO_KEY" - Chemin vers la clé SSH privée sur le serveur de destination pour se connecter au serveur source. Si une clé est utilisée, le mot de passe (--remote_password) n’est pas nécessaire.
Adresses IP
Vous devez utiliser un seul des indicateurs suivants pour gérer les adresses IP des sites pendant le transfert. L’indicateur -m est prioritaire.
-
-i"IP_ADDRESS_ON_DESTINATION" - Assigne l’adresse IP spécifiée à tous les sites transférés sur le serveur de destination. Pour spécifier plusieurs adresses IP (par exemple, s’il y en avait plusieurs sur la source), répétez l’indicateur pour chaque IP source qui doit être transférée. -
-m"SOURCE_IP,DESTINATION_IP" - Méthode recommandée. Établit un mappage direct : tous les sites utilisant SOURCE_IP sur le serveur source utiliseront DESTINATION_IP sur le serveur de destination. Cet indicateur peut être spécifié plusieurs fois pour différentes paires d’IP. Obligatoire pour transférer les sites avec des modifications manuelles de configuration, car il permet de remplacer correctement les adresses IP dans les directives listen.
Paramètres supplémentaires
--users="USER_LIST" - Transfère uniquement les utilisateurs spécifiés (séparés par des virgules). S’il n’est pas spécifié, tous les utilisateurs sont transférés.--disable_disk_quota- Désactive le transfert des quotas de disque des utilisateurs.--with_user_data- Inclut la copie de l’intégralité du contenu des répertoires personnels des utilisateurs (à l’exception du sous-répertoirelogs/). À utiliser avec précaution, car cela peut augmenter considérablement le temps de transfert et la quantité de données transférées.--only_data- Transfère uniquement les données (fichiers de site web, fichiers de messagerie, dumps de bases de données). Utile si la migration initiale de la structure (utilisateurs, sites, BDD, etc.) a réussi, mais que des erreurs se sont produites lors de l’étape de copie des fichiers ou des dumps. Permet de relancer uniquement la partie copie des données.--transfer_timeout- Définit le délai d’expiration de l’opération (60 minutes par défaut).
Exemple de commande
Transférez tous les utilisateurs du serveur 11.22.33.44 vers le serveur actuel. Sur l’ancien serveur, les sites utilisaient les IP 11.22.33.44 et 11.22.33.55 ; sur le nouveau serveur, ils doivent utiliser respectivement 99.88.77.66 et 99.88.77.67. Connexion via SSH avec un mot de passe.
/usr/local/fastpanel2/fastpanel transfer run \
--remote_host=11.22.33.44 \
--remote_username=root \
--remote_password=YourSourceRootPassword \
-m 11.22.33.44,99.88.77.66 \
-m 11.22.33.55,99.88.77.67Problèmes possibles et types d’erreurs
Une erreur dans le journal de migration n’indique pas toujours un problème critique, mais peut signaler la raison pour laquelle un objet spécifique n’a pas été transféré.
-
Conflits : surviennent lorsqu’il est impossible de transférer un objet en raison de la configuration actuelle du serveur de destination (par exemple, un utilisateur ou un site du même nom existe déjà) ou si la configuration du site sur le serveur source est inconnue du panneau (par exemple, en raison de modifications manuelles importantes).
-
Mot de passe enregistré manquant : Comme mentionné précédemment, les utilisateurs de bases de données MySQL sans mot de passe enregistré dans FASTPANEL sur le serveur source ne peuvent pas être transférés.
-
Paramètres manuels et adresses IP : Si un site sur le serveur source comporte des modifications manuelles de la configuration du serveur web et que l’indicateur
-mn’est pas utilisé pendant la migration pour mapper son adresse IP, un tel site ne sera pas transféré, car le panneau ne sait pas quelle adresse IP spécifier dans la configuration sur le serveur de destination.
Utilisateurs
Sur cette page
Création d’un nouvel utilisateur
Commande
mogwai users create --username=USERNAME --password=PASSWORD [--role="USER"]Options
-u,--username=USERNAME: Indiquez le nom d’utilisateur du nouvel utilisateur.-p,--password=PASSWORD: Indiquez le mot de passe du nouvel utilisateur.-r,--role="USER": Indiquez le rôle du nouvel utilisateur. Les rôles pris en charge sont RESELLER et USER. Le rôle par défaut est USER.
Informations d’utilisation
Pour créer un nouvel utilisateur avec le nom d’utilisateur testuser, le mot de passe My$ecretPassword123 et le rôle RESELLER, utilisez la commande suivante :
mogwai users create --username=testuser --password=My$ecretPassword123 --role="RESELLER"Notes supplémentaires
- Les noms d’utilisateur doivent être uniques et ne peuvent pas contenir d’espaces ni de points.
- Les mots de passe doivent comporter au moins 8 caractères. Nous recommandons d’utiliser au moins une lettre majuscule, une lettre minuscule, un chiffre et un caractère spécial.
FASTPANEL