CLI
Database
In questa pagina
Ottenere un elenco dei server di database
Comando
mogwai databases servers listOutput di esempio
ID NAME TYPE LOCAL HOST USERNAME AVAIL
1 mysql(localhost) mysql true fastuser true
2 postgresql(localhost) postgresql true fastuser trueIl server IDs è usato in altri comandi.
Ottenere un elenco di database
Comando
mogwai databases listOutput di esempio
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 UTCSincronizzazione dell'elenco dei database
Se hai aggiunto o rimosso di recente dei database e questi non sono ancora apparsi in FASTPANEL, puoi forzare la sincronizzazione degli elenchi
Comando
mogwai databases syncCreazione di un nuovo database
Comando
mogwai databases create [flags]Opzioni
-n,--name=NAME: Nome del database.-o,--owner="fastuser": utente FASTPANEL a cui verrà aggiunto il database.-s,--site=SITE: Sito web in FASTPANEL a cui verrà aggiunto il database.-c,--charset="utf8mb4": Codifica del database.-u,--username=USERNAME: Nome utente del database.-p,--password=PASSWORD: Password dell'utente del database.
Comando di esempio
mogwai databases create --server=1 -n db1 -o fastuser -s example.com -u dbuser -p dbpassword1Questo comando creerà un database denominato db1 sul server di database predefinito (--server=1) e lo "collegherà" al sito example.com.
In questa pagina
Ottenere un elenco di domini email
Comando
mogwai emails domains listEsempio di output
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:00Il dominio IDs viene utilizzato in altri comandi.
Aggiungere un dominio email
Comando
mogwai emails domains createOpzioni
--domain=DOMAIN: Nome del dominio email.-o,--owner="fastuser": L'utente FASTPANEL a cui verrà aggiunto il dominio email.
Esempio di creazione di un dominio email example1.com per l'utente fastuser
mogwai emails domains create --domain=example1.com -o fastuserOttenere un elenco di caselle di posta
Comando
mogwai emails boxes listOpzioni
--domain=DOMAIN: Nome del dominio di posta
Comando di esempio
mogwai emails boxes list --domain example.comEsempio di output
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:00Il ID dell'output del comando viene utilizzato in altri comandi.
Creare una casella di posta
Comando
mogwai emails boxes createOpzioni
--domain=DOMAIN: Nome del dominio email.-l,--login=LOGIN: Il nome della casella di posta, senza il dominio.-p,--password=PASSWORD: La password della casella di posta.
Comando di esempio
mogwai emails boxes create --domain=example.com --login=user --password=MySecretPassword123Questo comando creerà una casella di posta denominata user@example.com con la password MySecretPassword123.
Eliminare una casella di posta
Comando
mogwai emails boxes deleteOpzioni
-b,--box=BOX: L'ID della casella di posta..
Comando di esempio
mogwai emails boxes delete -b 1Questo comando eliminerà la casella di posta con ID 1.
Importare caselle di posta ed email
Comando
mogwai emails boxes import[sync] [<flags>]Opzioni
-i,--import_config=IMPORT_CONFIG: Percorso del file dell'elenco di importazione--force: Solo per la modalitàimport- cancella le caselle di posta esistenti.
Per importare la posta, è necessario preparare un elenco di caselle di posta sul server nel formato:
IMAP_HOST;SOURCE_ADDR;SOURCE_PASSWORD;DEST_ADDROpzioni
IMAP_HOST: Indirizzo del server di posta IMAP.SOURCE_ADDR: Casella di posta sul server di origine.SOURCE_PASSWORD: Password per la connessione IMAP alla casella di posta sul server di origine. Alcuni servizi, come Google, richiedono la creazione di una password per l'applicazione per l'accesso IMAP https://support.google.com/accounts/answer/185833?hl=enDEST_ADDR: Casella di posta sul server FASTPANEL a cui vengono trasferiti i messaggi.
Esempio di contenuto del file
imap.gmail.com;test@gmail.comu;password;test@example.com
imap.gmail.com;test1@gmail.com;password;test1@example.comSono disponibili due modalità:
Modalità importazione
mogwai emails boxes importIn questa modalità, tutti i messaggi vengono copiati integralmente; le caselle di posta sul server FASTPANEL non devono essere create oppure devono essere vuote: quando il comando viene eseguito, FASTPANEL crea le caselle di posta necessarie. Se esistono già caselle di posta con contenuto, verrà visualizzato un errore. È possibile utilizzare il flag --force: in tal caso la casella di posta verrà svuotata.
Esempio di esecuzione del comando con un elenco di caselle di posta memorizzato nel file /root/import.txt e utilizzo della chiave --force
mogwai emails boxes import --import_config=/root/import.txt --forceModalità sincronizzazione
mogwai emails boxes syncIn questa modalità, il pannello di controllo scarica i messaggi dal server di origine senza eliminare nulla. Deve essere utilizzata se nuovi messaggi sono apparsi nella casella di posta originale dopo la prima importazione e devono essere trasferiti anch'essi.
Comando di esempio
mogwai emails boxes sync --import_config=/root/import.txtDescrizione
In questa pagina
FASTPANEL fornisce un'interfaccia a riga di comando (CLI) implementata tramite l'utilità mogwai (/usr/local/bin/mogwai). L'utilità funziona solo quando viene eseguita come root.
Aiuto
Per visualizzare un elenco dei comandi disponibili, utilizzare:
mogwai --helpPer saperne di più su un comando specifico, utilizzare:
mogwai command --helpPer visualizzare un elenco dei comandi con descrizioni, utilizzare:
mogwai --help-longSiti web
In questa pagina
Elenco dei siti su un server
Comando
mogwai sites listEsempio di output
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: Gli IDs dei siti di questo elenco vengono utilizzati in altri comandi.
Creazione di un nuovo sito
Comando
mogwai sites create --server-name=SERVER-NAME --owner=OWNER [<flags>]Opzioni
--owner: Utente del sistema FASTPANEL che sarà il proprietario del sito.--server-name=SERVER-NAME: Nome di dominio del sito.-a,--alias=ALIAS: Alias per il sito, come i sottodomini www. È possibile specificare più alias.--ip=IP: Indirizzo IP del server su cui verrà eseguito il sito. È possibile specificare più indirizzi IP.-h,--handler=HANDLER: Handler backend. Può essere:- PHP:
cgi,mpm_itk,php_fpm,fcgi; - Node.js:
standalone,pm2; - Systemd:
systemd.
- PHP:
--handler_version=HANDLER_VERSION: Versione PHP o Node.js (ad es.8.2,8.3,20.15.1).--create-user: Crea un utente per il sito.
Esempio di comando
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.3Eliminazione di un sito
Comando
mogwai sites delete --id=IDIl ID del sito può essere ottenuto dal comando mogwai sites list.
Esempio di comando
mogwai sites delete --id=987Questo comando eliminerà il sito con ID 987
Modifica delle impostazioni del sito
Comando
mogwai sites update --id=ID [<flags>]Il ID del sito può essere ottenuto dal comando mogwai sites list.
Opzioni
-i,--id=ID: ID del sito.-a,--add-alias=ADD-ALIAS: Aggiunge un alias, è possibile specificare più alias.--del-alias=DEL-ALIAS: Elimina un alias, è possibile specificare più alias.--add-ip=ADD-IP: Aggiunge un indirizzo IP dalle impostazioni del sito, è possibile specificare più indirizzi IP.--del-ip=DEL-IP: Elimina un indirizzo IP dalle impostazioni del sito, è possibile specificare più indirizzi IP.-h,--handler=HANDLER: Handler backend. Può essere:- PHP:
cgi,mpm_itk,php_fpm,fcgi; - Node.js:
standalone,pm2; - Systemd:
systemd.
- PHP:
--handler_version=HANDLER_VERSION: Versione PHP o Node.js (ad es.8.2,8.3,20.15.1).--gzip: Abilita la compressione.--no-gzip: Disabilita la compressione.--gzip-comp-level=LEVEL: Imposta il livello di compressione, 1-9.--expires=EXPIRES: Imposta il tempo di caching per i contenuti statici.--worker-count=WORKER-COUNT: Imposta il numero di worker per PHP-FPM
Puoi anche aggiornare le impostazioni per più siti su un server utilizzando il comando
mogwai sites batch-update- Per modificare le impostazioni di tutti i siti, usa il flag
-a. - Per modificare le impostazioni dei siti selezionati, specifica più flag
--idcon i rispettiviIDs.
Esempio di comando
mogwai sites update --id=1 -a www1.example.com -h cgi --handler_version=5.6Questo comando aggiungerà un alias www1.example.com, cambierà l'handler in cgi e la versione PHP a 5.6 per il sito con ID 3
Esempio di comando
mogwai sites batch-update -h cgi --handler_version=5.6 --id 3 --id 2Questo comando cambierà l'handler PHP per i siti con ID 2 e 3
Trasferimento di utenti tra FASTPANEL
In questa pagina
Introduzione
Questo articolo descrive il processo di trasferimento degli account utente e dei relativi dati associati (siti web, database, email, ecc.) da un server FASTPANEL a un altro utilizzando l'utilità di migrazione integrata.
Termini chiave
- Server di origine - Il server da cui vengono trasferiti i dati.
- Server di destinazione - Il server verso cui vengono trasferiti i dati.
Note importanti
-
Per impostazione predefinita, la migrazione funziona correttamente solo per i siti con una configurazione FASTPANEL standard.
-
I siti con modifiche di configurazione manuale possono essere trasferiti solo se viene utilizzato il flag
-mper la mappatura degli indirizzi IP. -
Se una password cifrata per un proprietario di database non è disponibile, il database non verrà trasferito.
-
Se un sito web non viene trasferito, anche i database associati non verranno trasferiti.
-
È possibile trasferire solo database locali.
Processo di migrazione
Connessione
Il server di destinazione si connette al server di origine tramite SSH. Durante la prima connessione, il server di destinazione installa una chiave SSH sul server di origine (fornita in precedenza o generata da una password).
Fasi della migrazione
- Installazione del modulo
- Raccolta di informazioni sugli oggetti trasferibili
- Creazione degli utenti
- Trasferimento dei certificati SSL
- Creazione di siti web, account FTP, domini email e account email
- Creazione di database e utenti di database
- Trasferimento dei file dei siti web e delle caselle email
- Trasferimento dei processi cron
Il trasferimento dei file viene eseguito utilizzando rsync. I database vengono trasferiti creando un dump attraverso un tunnel SSH.
Comando per avviare la migrazione
Il comando viene eseguito sul server di destinazione come utente con privilegi di root:
/usr/local/fastpanel2/fastpanel transfer run [SSH_PARAMETERS] [IP_PARAMETERS] [ADDITIONAL_OPTIONS]Flag della riga di comando
Connessione SSH
--remote_host="SOURCE_IP" - Indirizzo IP del server di origine.--remote_port="SSH_PORT" - Porta SSH.--remote_username="SSH_USER" - Utente (deve essere root).--remote_password="USER_PASSWORD" - Password per l'utente SSH specificato.--ssh_key_path="PATH_TO_KEY" - Percorso della chiave SSH privata sul server di destinazione per connettersi al server di origine. Se viene utilizzata una chiave, la password (--remote_password) non è necessaria.
Indirizzi IP
Devi utilizzare solo uno dei seguenti flag per gestire gli indirizzi IP dei siti durante il trasferimento. Il flag -m ha la priorità.
-
-i"IP_ADDRESS_ON_DESTINATION" - Assegna l'indirizzo IP specificato a tutti i siti trasferiti sul server di destinazione. Per specificare più IP (ad esempio, se sul server di origine ce n'erano diversi), ripeti il flag per ogni IP di origine che deve essere trasferito. -
-m"SOURCE_IP,DESTINATION_IP" - Metodo consigliato. Stabilisce una mappatura diretta: tutti i siti che utilizzano SOURCE_IP sul server di origine utilizzeranno DESTINATION_IP sul server di destinazione. Questo flag può essere specificato più volte per diverse coppie di IP. Obbligatorio per trasferire siti con modifiche manuali della configurazione, poiché consente la corretta sostituzione degli indirizzi IP nelle direttive listen.
Impostazioni aggiuntive
--users="USER_LIST" - Trasferisce solo gli utenti specificati (separati da virgole). Se non specificato, vengono trasferiti tutti gli utenti.--disable_disk_quota- Disabilita il trasferimento delle quote disco degli utenti.--with_user_data- Include la copia dell'intero contenuto delle directory home degli utenti (tranne la sottodirectorylogs/). Usare con cautela, poiché ciò può aumentare significativamente il tempo di trasferimento e la quantità di dati trasferiti.--only_data- Trasferisce solo i dati (file dei siti web, file di posta, dump dei database). Utile se la migrazione iniziale della struttura (utenti, siti, DB, ecc.) è riuscita, ma si sono verificati errori durante la fase di copia dei file o dei dump. Consente di rieseguire solo la parte di copia dei dati.--transfer_timeout- Imposta il timeout dell'operazione (il valore predefinito è 60 minuti).
Comando di esempio
Trasferisce tutti gli utenti dal server 11.22.33.44 al server corrente. Sul vecchio server, i siti utilizzavano gli IP 11.22.33.44 e 11.22.33.55; sul nuovo server dovrebbero utilizzare rispettivamente 99.88.77.66 e 99.88.77.67. Connessione tramite SSH con una password.
/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.67Possibili problemi e tipi di errore
Un errore nel log di migrazione non indica sempre un problema critico, ma potrebbe indicare il motivo per cui un oggetto specifico non è stato trasferito.
-
Conflitti: si verificano quando il trasferimento di un oggetto è impossibile a causa della configurazione corrente del server di destinazione (ad esempio, esiste già un utente o un sito con lo stesso nome) oppure se la configurazione del sito sul server di origine è sconosciuta al pannello (ad esempio, a causa di estese modifiche manuali).
-
Password salvata mancante: come già detto, gli utenti di database MySQL senza una password salvata in FASTPANEL sul server di origine non possono essere trasferiti.
-
Impostazioni manuali e indirizzi IP: se un sito sul server di origine presenta modifiche manuali alla configurazione del server web e durante la migrazione non viene utilizzato il flag
-mper mappare il suo indirizzo IP, tale sito non verrà trasferito perché il pannello non sa quale IP specificare nella configurazione sul server di destinazione.
Utenti
In questa pagina
Creazione di un nuovo utente
Comando
mogwai users create --username=USERNAME --password=PASSWORD [--role="USER"]Opzioni
-u,--username=USERNAME: Specifica il nome utente per il nuovo utente.-p,--password=PASSWORD: Specifica la password per il nuovo utente.-r,--role="USER": Specifica il ruolo per il nuovo utente. I ruoli supportati sono RESELLER e USER. Il ruolo predefinito è USER.
Informazioni sull'utilizzo
Per creare un nuovo utente con il nome utente testuser, la password My$ecretPassword123 e il ruolo RESELLER, usa il comando seguente:
mogwai users create --username=testuser --password=My$ecretPassword123 --role="RESELLER"Note aggiuntive
- I nomi utente devono essere univoci e non possono contenere spazi o punti.
- Le password devono contenere almeno 8 caratteri. Si consiglia di utilizzare almeno una lettera maiuscola, una lettera minuscola, un numero e un carattere speciale.
FASTPANEL