CLI
Bases de dades
En aquesta pàgina
Obtenció d'una llista de servidors de bases de dades
Ordre
mogwai databases servers listSortida d'exemple
ID NAME TYPE LOCAL HOST USERNAME AVAIL
1 mysql(localhost) mysql true fastuser true
2 postgresql(localhost) postgresql true fastuser trueEl servidor IDs s'utilitza en altres ordres.
Obtenció d'una llista de bases de dades
Ordre
mogwai databases listSortida 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 UTCSincronització 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 syncCreació 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 dbpassword1Aquesta 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 listSortida 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:00El domini IDs s'utilitza en altres ordres.
Afegir un domini de correu electrònic
Ordre
mogwai emails domains createOpcions
--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 fastuserObtenció d'una llista de bústies de correu
Ordre
mogwai emails boxes listOpcions
--domain=DOMAIN: Nom del domini de correu
Ordre d'exemple
mogwai emails boxes list --domain example.comSortida 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:00El valor ID de la sortida de l'ordre s'utilitza en altres ordres.
Creació d'una bústia de correu
Ordre
mogwai emails boxes createOpcions
--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=MySecretPassword123Aquesta 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 deleteOpcions
-b,--box=BOX: L'ID de la bústia de correu..
Ordre d'exemple
mogwai emails boxes delete -b 1Aquesta 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 modeimport: 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_ADDROpcions
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=enDEST_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.comHi ha dos modes disponibles:
Mode d'importació
mogwai emails boxes importEn 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 --forceMode de sincronització
mogwai emails boxes syncEn 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.txtDescripció
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 --helpPer obtenir més informació sobre una ordre específica, utilitzeu:
mogwai command --helpPer veure una llista d'ordres amb descripcions, utilitzeu:
mogwai --help-longLlocs web
En aquesta pàgina
Llistar els llocs d'un servidor
Ordre
mogwai sites listExemple 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.comNota: 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.
- PHP:
--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.3Suprimir un lloc
Ordre
mogwai sites delete --id=IDEl lloc ID es pot obtenir amb l'ordre mogwai sites list.
Exemple d'ordre
mogwai sites delete --id=987Aquesta 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.
- PHP:
--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
--idamb els seusIDs.
Exemple d'ordre
mogwai sites update --id=1 -a www1.example.com -h cgi --handler_version=5.6Aquesta 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 2Aquesta 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
-mper 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 subdirectorilogs/). 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.67Problemes 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
-mdurant 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.
FASTPANEL