FASTPANELWIKI

CLI

Database

In questa pagina

Ottenere un elenco dei server di database

Comando

mogwai databases servers list

Output di esempio

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

Il server IDs è usato in altri comandi.

Ottenere un elenco di database

Comando

mogwai databases list

Output 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 UTC

Sincronizzazione 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 sync

Creazione 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 dbpassword1

Questo comando creerà un database denominato db1 sul server di database predefinito (--server=1) e lo "collegherà" al sito example.com.

Email

In questa pagina

Ottenere un elenco di domini email

Comando

mogwai emails domains list

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

Il dominio IDs viene utilizzato in altri comandi.

Aggiungere un dominio email

Comando

mogwai emails domains create

Opzioni

  • --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 fastuser

Ottenere un elenco di caselle di posta

Comando

mogwai emails boxes list

Opzioni

  • --domain=DOMAIN : Nome del dominio di posta

Comando di esempio

mogwai emails boxes list --domain example.com

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

Il ID dell'output del comando viene utilizzato in altri comandi.

Creare una casella di posta

Comando

mogwai emails boxes create

Opzioni

  • --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=MySecretPassword123

Questo comando creerà una casella di posta denominata user@example.com con la password MySecretPassword123.

Eliminare una casella di posta

Comando

mogwai emails boxes delete

Opzioni

  • -b, --box=BOX : L'ID della casella di posta..

Comando di esempio

mogwai emails boxes delete -b 1

Questo 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_ADDR

Opzioni

  • 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=en
  • DEST_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.com

Sono disponibili due modalità:

Modalità importazione

mogwai emails boxes import

In 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 --force

Modalità sincronizzazione

mogwai emails boxes sync

In 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.txt

Descrizione

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 --help

Per saperne di più su un comando specifico, utilizzare:

mogwai command --help

Per visualizzare un elenco dei comandi con descrizioni, utilizzare:

mogwai --help-long

Siti web

In questa pagina

Elenco dei siti su un server

Comando

mogwai sites list

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

Nota: 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.
  • --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.3

Eliminazione di un sito

Comando

mogwai sites delete --id=ID

Il ID del sito può essere ottenuto dal comando mogwai sites list.

Esempio di comando

mogwai sites delete --id=987

Questo 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.
  • --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 --id con i rispettivi IDs.

Esempio di comando

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

Questo 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 2

Questo 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 -m per 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 sottodirectory logs/). 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.67

Possibili 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 -m per 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.