FASTPANELWIKI

CLI

Bases de dades

En aquesta pàgina

Obtenció d'una llista de servidors de bases de dades

Ordre

mogwai databases servers list

Sortida d'exemple

ID      NAME                    TYPE            LOCAL   HOST    USERNAME        AVAIL
1       mysql(localhost)        mysql           true            fastuser        true
2       postgresql(localhost)   postgresql      true            fastuser        true

El servidor IDs s'utilitza en altres ordres.

Obtenció d'una llista de bases de dades

Ordre

mogwai databases list

Sortida d'exemple

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 UTC

Sincronització de la llista de bases de dades

Si recentment heu afegit o eliminat bases de dades i encara no han aparegut a FASTPANEL, podeu forçar la sincronització de les llistes

Ordre

mogwai databases sync

Creació d'una base de dades nova

Ordre

mogwai databases create [flags]

Opcions

  • -n, --name=NAME : Nom de la base de dades.
  • -o, --owner="fastuser" :  usuari de FASTPANEL al qual s'afegirà la base de dades.
  • -s, --site=SITE : Lloc web de FASTPANEL al qual s'afegirà la base de dades.
  • -c, --charset="utf8mb4" : Codificació de la base de dades.
  • -u, --username=USERNAME : Nom d'usuari de la base de dades.
  • -p, --password=PASSWORD : Contrasenya de l'usuari de la base de dades.

Ordre d'exemple

mogwai databases create --server=1 -n db1 -o fastuser -s example.com -u dbuser -p dbpassword1

Aquesta ordre crearà una base de dades anomenada db1 al servidor de bases de dades predeterminat (--server=1) i la "vincularà" al lloc example.com.

Correu electrònic

En aquesta pàgina

Obtenció d'una llista de dominis de correu electrònic

Ordre

mogwai emails domains list

Sortida d'exemple

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:00

El domini IDs s'utilitza en altres ordres.

Afegir un domini de correu electrònic

Ordre

mogwai emails domains create

Opcions

  • --domain=DOMAIN : Nom del domini de correu electrònic.
  • -o, --owner="fastuser" : L'usuari de FASTPANEL al qual s'afegirà el domini de correu electrònic.

Exemple de creació d'un domini de correu electrònic example1.com sota l'usuari fastuser

mogwai emails domains create --domain=example1.com -o fastuser

Obtenció d'una llista de bústies de correu

Ordre

mogwai emails boxes list

Opcions

  • --domain=DOMAIN : Nom del domini de correu

Ordre d'exemple

mogwai emails boxes list --domain example.com

Sortida d'exemple

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:00

El valor ID de la sortida de l'ordre s'utilitza en altres ordres.

Creació d'una bústia de correu

Ordre

mogwai emails boxes create

Opcions

  • --domain=DOMAIN : Nom del domini de correu electrònic.
  • -l, --login=LOGIN : El nom de la bústia de correu, sense el domini.
  • -p, --password=PASSWORD : La contrasenya de la bústia de correu.

Ordre d'exemple

mogwai emails boxes create  --domain=example.com --login=user --password=MySecretPassword123

Aquesta ordre crearà una bústia de correu anomenada user@example.com amb la contrasenya MySecretPassword123.

Supressió d'una bústia de correu

Ordre

mogwai emails boxes delete

Opcions

  • -b, --box=BOX : L'ID de la bústia de correu..

Ordre d'exemple

mogwai emails boxes delete -b 1

Aquesta ordre suprimirà la bústia de correu amb l'ID 1.

Importació de bústies de correu i correus electrònics

Ordre

mogwai emails boxes import[sync] [<flags>]

Opcions

  • -i, --import_config=IMPORT_CONFIG : Camí al fitxer de llista d'importació
  • --force : Només per al mode import: esborra les bústies de correu existents.

Per importar correu, heu de preparar una llista de bústies de correu al servidor en el format següent:

IMAP_HOST;SOURCE_ADDR;SOURCE_PASSWORD;DEST_ADDR

Opcions

  • IMAP_HOST : Adreça del servidor de correu IMAP.
  • SOURCE_ADDR : Bústia de correu al servidor d'origen.
  • SOURCE_PASSWORD : Contrasenya per a la connexió IMAP a la bústia de correu del servidor d'origen. Alguns serveis, com ara Google, requereixen crear una contrasenya d'aplicació per a l'accés IMAP https://support.google.com/accounts/answer/185833?hl=en
  • DEST_ADDR : Bústia de correu al servidor FASTPANEL a la qual es transfereixen els missatges.

Contingut d'exemple del fitxer

imap.gmail.com;test@gmail.comu;password;test@example.com
imap.gmail.com;test1@gmail.com;password;test1@example.com

Hi ha dos modes disponibles:

Mode d'importació

mogwai emails boxes import

En aquest mode, tots els missatges es copien completament; les bústies de correu del servidor FASTPANEL no han d'estar creades o han d'estar buides: quan s'executa l'ordre, FASTPANEL crea les bústies de correu necessàries. Si ja existeixen bústies de correu amb contingut, es mostrarà un error. Podeu utilitzar l'indicador --force; aleshores, la bústia de correu es buidarà.

Exemple d'execució de l'ordre amb una llista de bústies de correu emmagatzemada al fitxer /root/import.txt i utilitzant la clau --force

mogwai emails boxes import --import_config=/root/import.txt --force

Mode de sincronització

mogwai emails boxes sync

En aquest mode, el tauler de control descarrega missatges del servidor d'origen sense suprimir res. S'ha d'utilitzar si han aparegut missatges nous a la bústia de correu original després de la primera importació, i també s'han de transferir.

Ordre d'exemple

mogwai emails boxes sync --import_config=/root/import.txt

Descripció

En aquesta pàgina

FASTPANEL proporciona una interfície de línia d'ordres (CLI) implementada mitjançant la utilitat mogwai (/usr/local/bin/mogwai). La utilitat només funcionarà quan s'executi com a root.

Ajuda

Per veure una llista de les ordres disponibles, utilitzeu:

mogwai --help

Per obtenir més informació sobre una ordre específica, utilitzeu:

mogwai command --help

Per veure una llista d'ordres amb descripcions, utilitzeu:

mogwai --help-long

Llocs web

En aquesta pàgina

Llistar els llocs d'un servidor

Ordre

mogwai sites list

Exemple de sortida

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.com

Nota: Els llocs IDs d'aquesta llista s'utilitzen en altres ordres.

Crear un lloc nou

Ordre

mogwai sites create --server-name=SERVER-NAME --owner=OWNER [<flags>]

Opcions

  • --owner : Usuari del sistema FASTPANEL que serà el propietari del lloc.
  • --server-name=SERVER-NAME : Nom de domini del lloc.
  • -a, --alias=ALIAS : Àlies per al lloc, com ara subdominis www. Es poden especificar diversos àlies.
  • --ip=IP : Adreça IP del servidor on s'executarà el lloc. Es poden especificar diverses adreces IP.
  • -h, --handler=HANDLER : Gestor de backend. Pot ser:
    • PHP: cgi,mpm_itk,php_fpm,fcgi;
    • Node.js: standalone,pm2;
    • Systemd: systemd.
  • --handler_version=HANDLER_VERSION : Versió de PHP o Node.js (p. ex. 8.2, 8.3, 20.15.1).
  • --create-user : Crear un usuari per al lloc.

Exemple d'ordre

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.3

Suprimir un lloc

Ordre

mogwai sites delete --id=ID

El lloc ID es pot obtenir amb l'ordre mogwai sites list.

Exemple d'ordre

mogwai sites delete --id=987

Aquesta ordre suprimirà el lloc amb l'ID 987

Modificar la configuració del lloc

Ordre

mogwai sites update --id=ID [<flags>]

El lloc ID es pot obtenir amb l'ordre mogwai sites list.

Opcions

  • -i, --id=ID : ID del lloc.
  • -a, --add-alias=ADD-ALIAS : Afegeix un àlies; es poden especificar diversos àlies.
  • --del-alias=DEL-ALIAS : Suprimeix un àlies; es poden especificar diversos àlies.
  • --add-ip=ADD-IP : Afegeix una adreça IP de la configuració del lloc; es poden especificar diverses adreces IP.
  • --del-ip=DEL-IP : Suprimeix una adreça IP de la configuració del lloc; es poden especificar diverses adreces IP.
  • -h, --handler=HANDLER : Gestor de backend. Pot ser:
    • PHP: cgi,mpm_itk,php_fpm,fcgi;
    • Node.js: standalone,pm2;
    • Systemd: systemd.
  • --handler_version=HANDLER_VERSION : Versió de PHP o Node.js (p. ex. 8.2, 8.3, 20.15.1).
  • --gzip : Activa la compressió.
  • --no-gzip : Desactiva la compressió.
  • --gzip-comp-level=LEVEL : Estableix el nivell de compressió, 1-9.
  • --expires=EXPIRES : Estableix el temps de memòria cau per al contingut estàtic.
  • --worker-count=WORKER-COUNT : Estableix el nombre de workers per a PHP-FPM

També podeu actualitzar la configuració de diversos llocs d'un servidor amb l'ordre

mogwai sites batch-update
  • Per canviar la configuració de tots els llocs, utilitzeu l'indicador -a.
  • Per canviar la configuració dels llocs seleccionats, especifiqueu diversos indicadors --id amb els seus IDs.

Exemple d'ordre

mogwai sites update --id=1 -a www1.example.com -h cgi --handler_version=5.6

Aquesta ordre afegirà un àlies www1.example.com, canviarà el gestor a cgi i la versió de PHP a 5.6 per al lloc amb l'ID 3

Exemple d'ordre

mogwai sites batch-update -h cgi --handler_version=5.6 --id 3 --id 2

Aquesta ordre canviarà el gestor de PHP dels llocs amb ID 2 i 3

Transferència d'usuaris entre servidors FASTPANEL

En aquesta pàgina

Introducció

Aquest article descriu el procés de transferència de comptes d'usuari i de les seves dades associades (llocs web, bases de dades, correu electrònic, etc.) d'un servidor FASTPANEL a un altre mitjançant la utilitat de migració integrada.

Termes clau

  • Servidor d'origen - El servidor des del qual es transfereixen les dades.
  • Servidor de destinació - El servidor al qual es transfereixen les dades.

Notes importants

  • Per defecte, la migració només funciona correctament per als llocs amb una configuració estàndard de FASTPANEL.

  • Els llocs amb canvis de configuració manual només es poden transferir si s'utilitza l'indicador -m per a la correspondència d'adreces IP.

  • Si no hi ha disponible una contrasenya xifrada per al propietari d'una base de dades, la base de dades no es transferirà.

  • Si un lloc web no es transfereix, tampoc no es transferiran les seves bases de dades associades.

  • Només es poden transferir bases de dades locals.

Procés de migració

Connexió

El servidor de destinació es connecta al servidor d'origen mitjançant SSH. Durant la primera connexió, el servidor de destinació instal·la una clau SSH al servidor d'origen (ja sigui proporcionada prèviament o generada a partir d'una contrasenya).

Passos de la migració

  • Instal·lació del mòdul
  • Recollida d'informació sobre objectes transferibles
  • Creació d'usuaris
  • Transferència de certificats SSL
  • Creació de llocs web, comptes FTP, dominis de correu electrònic i comptes de correu electrònic
  • Creació de bases de dades i usuaris de bases de dades
  • Transferència de fitxers de llocs web i bústies de correu electrònic
  • Transferència de tasques cron

La transferència de fitxers s'executa mitjançant rsync. Les bases de dades es transfereixen creant un bolcat a través d'un túnel SSH.

Ordre per iniciar la migració

L'ordre s'executa al servidor de destinació com a usuari amb privilegis de root:

/usr/local/fastpanel2/fastpanel transfer run [SSH_PARAMETERS] [IP_PARAMETERS] [ADDITIONAL_OPTIONS]

Indicadors de la línia d'ordres

Connexió SSH

  • --remote_host="SOURCE_IP" - Adreça IP del servidor d'origen.
  • --remote_port="SSH_PORT" - Port SSH.
  • --remote_username="SSH_USER" - Usuari (ha de ser root).
  • --remote_password="USER_PASSWORD" - Contrasenya per a l'usuari SSH especificat.
  • --ssh_key_path="PATH_TO_KEY" - Camí a la clau SSH privada al servidor de destinació per connectar-se al servidor d'origen. Si s'utilitza una clau, la contrasenya (--remote_password) no és necessària.

Adreces IP

Heu d'utilitzar només un dels indicadors següents per gestionar les adreces IP dels llocs durant la transferència. L'indicador -m té prioritat.

  • -i "IP_ADDRESS_ON_DESTINATION" - Assigna l'adreça IP especificada a tots els llocs transferits al servidor de destinació. Per especificar diverses IP (p. ex., si n'hi havia diverses a l'origen), repetiu l'indicador per a cada IP d'origen que s'hagi de transferir.

  • -m "SOURCE_IP,DESTINATION_IP" - Mètode recomanat. Estableix una correspondència directa: tots els llocs que utilitzen SOURCE_IP al servidor d'origen utilitzaran DESTINATION_IP al servidor de destinació. Aquest indicador es pot especificar diverses vegades per a diferents parells d'IP. Obligatori per transferir llocs amb edicions manuals de la configuració, ja que permet la substitució correcta de les adreces IP a les directives listen.

Configuració addicional

  • --users="USER_LIST" - Transfereix només els usuaris especificats (separats per comes). Si no s'especifica, es transfereixen tots els usuaris.
  • --disable_disk_quota - Desactiva la transferència de les quotes de disc dels usuaris.
  • --with_user_data - Inclou la còpia de tot el contingut dels directoris home dels usuaris (excepte el subdirectori logs/). Utilitzeu-lo amb precaució, ja que això pot augmentar significativament el temps de transferència i la quantitat de dades transferides.
  • --only_data - Transfereix només dades (fitxers de llocs web, fitxers de correu, bolcats de bases de dades). Útil si la migració inicial de l'estructura (usuaris, llocs, BD, etc.) ha estat correcta, però s'han produït errors durant l'etapa de còpia de fitxers o de bolcats. Permet tornar a executar només la part de còpia de dades.
  • --transfer_timeout - Defineix el temps d'espera de l'operació (el valor per defecte és de 60 minuts).

Ordre d'exemple

Transferiu tots els usuaris del servidor 11.22.33.44 al servidor actual. Al servidor antic, els llocs utilitzaven les IP 11.22.33.44 i 11.22.33.55; al servidor nou, haurien d'utilitzar 99.88.77.66 i 99.88.77.67 respectivament. Connexió mitjançant SSH amb contrasenya.

/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.67

Problemes possibles i tipus d'errors

Un error al registre de migració no sempre indica un problema crític, però pot assenyalar el motiu pel qual no s'ha transferit un objecte concret.

  • Conflictes: Es produeixen quan és impossible transferir un objecte a causa de la configuració actual del servidor de destinació (p. ex., ja existeix un usuari o lloc amb el mateix nom) o si la configuració del lloc al servidor d'origen és desconeguda per al tauler (p. ex., a causa d'edicions manuals extenses).

  • Contrasenya desada que falta: Com s'ha esmentat anteriorment, els usuaris de bases de dades MySQL sense una contrasenya desada a FASTPANEL al servidor d'origen no es poden transferir.

  • Configuració manual i adreces IP: Si un lloc del servidor d'origen té edicions manuals de la configuració del servidor web i no s'utilitza l'indicador -m durant la migració per fer la correspondència de la seva adreça IP, aquest lloc no es transferirà perquè el tauler no sap quina IP ha d'especificar a la configuració del servidor de destinació.

Usuaris

En aquesta pàgina

Creació d'un usuari nou

Ordre

mogwai users create --username=USERNAME --password=PASSWORD [--role="USER"]

Opcions

  • -u, --username=USERNAME : Especifica el nom d'usuari per al nou usuari.
  • -p, --password=PASSWORD : Especifica la contrasenya per al nou usuari.
  • -r, --role="USER" : Especifica el rol per al nou usuari. Els rols admesos són RESELLER i USER. El rol per defecte és USER.

Informació d'ús

Per crear un usuari nou amb el nom d'usuari testuser, la contrasenya My$ecretPassword123 i el rol RESELLER, utilitzeu l'ordre següent:

mogwai users create --username=testuser --password=My$ecretPassword123 --role="RESELLER"

Notes addicionals

  • Els noms d'usuari han de ser únics i no poden contenir espais ni punts.
  • Les contrasenyes han de tenir com a mínim 8 caràcters. Us recomanem que utilitzeu com a mínim una lletra majúscula, una lletra minúscula, un número i un caràcter especial.