FASTPANELWIKI

CLI

Baze de date

Pe această pagină

Obținerea unei liste de servere de baze de date

Comandă

mogwai databases servers list

Exemplu de ieșire

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

Serverul IDs este utilizat în alte comenzi.

Obținerea unei liste de baze de date

Comandă

mogwai databases list

Exemplu de ieșire

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

Sincronizarea listei de baze de date

Dacă ați adăugat sau eliminat recent baze de date și acestea nu au apărut încă în FASTPANEL, puteți forța sincronizarea listelor

Comandă

mogwai databases sync

Crearea unei noi baze de date

Comandă

mogwai databases create [flags]

Opțiuni

  • -n, --name=NAME : Numele bazei de date.
  • -o, --owner="fastuser" :  utilizatorul FASTPANEL căruia îi va fi adăugată baza de date.
  • -s, --site=SITE : Site-ul din FASTPANEL la care va fi adăugată baza de date.
  • -c, --charset="utf8mb4" : Codificarea bazei de date.
  • -u, --username=USERNAME : Numele de utilizator al bazei de date.
  • -p, --password=PASSWORD : Parola utilizatorului bazei de date.

Exemplu de comandă

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

Această comandă va crea o bază de date numită db1 pe serverul de baze de date implicit (--server=1) și o va „lega” de site-ul example.com.

E-mail

Pe această pagină

Obținerea unei liste de domenii de e-mail

Comandă

mogwai emails domains list

Exemplu de ieșire

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

Domeniile IDs sunt utilizate în alte comenzi.

Adăugarea unui domeniu de e-mail

Comandă

mogwai emails domains create

Opțiuni

  • --domain=DOMAIN : Numele domeniului de e-mail.
  • -o, --owner="fastuser" : Utilizatorul FASTPANEL la care va fi adăugat domeniul de e-mail.

Exemplu de creare a unui domeniu de e-mail example1.com sub utilizatorul fastuser

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

Obținerea unei liste de căsuțe poștale

Comandă

mogwai emails boxes list

Opțiuni

  • --domain=DOMAIN : Numele domeniului de e-mail

Exemplu de comandă

mogwai emails boxes list --domain example.com

Exemplu de ieșire

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

ID din ieșirea comenzii este utilizat în alte comenzi.

Crearea unei căsuțe poștale

Comandă

mogwai emails boxes create

Opțiuni

  • --domain=DOMAIN : Numele domeniului de e-mail.
  • -l, --login=LOGIN : Numele căsuței poștale, fără domeniu.
  • -p, --password=PASSWORD : Parola pentru căsuța poștală.

Exemplu de comandă

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

Această comandă va crea o căsuță poștală numită user@example.com cu parola MySecretPassword123.

Ștergerea unei căsuțe poștale

Comandă

mogwai emails boxes delete

Opțiuni

  • -b, --box=BOX : ID-ul căsuței poștale..

Exemplu de comandă

mogwai emails boxes delete -b 1

Această comandă va șterge căsuța poștală cu ID-ul 1.

Importul căsuțelor poștale și al e-mailurilor

Comandă

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

Opțiuni

  • -i, --import_config=IMPORT_CONFIG : Calea către fișierul listei de import
  • --force : Numai pentru modul import - șterge căsuțele poștale existente.

Pentru a importa e-mailuri, trebuie să pregătiți o listă de căsuțe poștale pe server în formatul:

IMAP_HOST;SOURCE_ADDR;SOURCE_PASSWORD;DEST_ADDR

Opțiuni

  • IMAP_HOST : Adresa serverului de e-mail IMAP.
  • SOURCE_ADDR : Căsuța poștală de pe serverul sursă.
  • SOURCE_PASSWORD : Parola pentru conexiunea IMAP la căsuța poștală de pe serverul sursă. Unele servicii, cum ar fi Google, necesită crearea unei parole de aplicație pentru accesul IMAP https://support.google.com/accounts/answer/185833?hl=en
  • DEST_ADDR : Căsuța poștală de pe serverul FASTPANEL către care sunt transferate mesajele.

Exemplu de conținut al fișierului

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

Sunt disponibile două moduri:

Mod import

mogwai emails boxes import

În acest mod, toate mesajele sunt copiate integral, căsuțele poștale de pe serverul FASTPANEL nu trebuie să fie create sau trebuie să fie goale - atunci când comanda este executată, FASTPANEL creează căsuțele poștale necesare. Dacă există deja căsuțe poștale cu conținut, va fi afișată o eroare. Puteți utiliza indicatorul --force - atunci căsuța poștală va fi golită.

Exemplu de rulare a comenzii cu o listă de căsuțe poștale stocată în fișierul /root/import.txt și utilizând cheia --force

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

Mod sincronizare

mogwai emails boxes sync

În acest mod, Panoul de control descarcă mesaje de pe serverul sursă fără a șterge nimic. Ar trebui utilizat dacă au apărut mesaje noi în căsuța poștală originală după primul import, care trebuie de asemenea transferate.

Exemplu de comandă

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

Descriere

Pe această pagină

FASTPANEL oferă o interfață de linie de comandă (CLI) implementată prin utilitarul mogwai (/usr/local/bin/mogwai). Utilitarul va funcționa numai când este rulat ca root.

Ajutor

Pentru a vedea o listă de comenzi disponibile, utilizați:

mogwai --help

Pentru a afla mai multe despre o comandă specifică, utilizați:

mogwai command --help

Pentru a vedea o listă de comenzi cu descrieri, utilizați:

mogwai --help-long

Site-uri web

Pe această pagină

Listarea site-urilor de pe un server

Comandă

mogwai sites list

Exemplu de ieșire

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

Notă: Site-ul IDs din această listă este utilizat în alte comenzi.

Crearea unui site nou

Comandă

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

Opțiuni

  • --owner : Utilizator din sistemul FASTPANEL care va deține site-ul.
  • --server-name=SERVER-NAME : Numele de domeniu al site-ului.
  • -a, --alias=ALIAS : Aliasuri pentru site, cum ar fi subdomeniile www. Pot fi specificate mai multe aliasuri.
  • --ip=IP : Adresa IP a serverului pe care va rula site-ul. Pot fi specificate mai multe adrese IP.
  • -h, --handler=HANDLER : Handler backend. Poate fi:
    • PHP: cgi,mpm_itk,php_fpm,fcgi;
    • Node.js: standalone,pm2;
    • Systemd: systemd.
  • --handler_version=HANDLER_VERSION : Versiunea PHP sau Node.js (de ex. 8.2, 8.3, 20.15.1).
  • --create-user : Creează un utilizator pentru site.

Exemplu de comandă

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

Ștergerea unui site

Comandă

mogwai sites delete --id=ID

Site-ul ID poate fi obținut din comanda mogwai sites list.

Exemplu de comandă

mogwai sites delete --id=987

Această comandă va șterge site-ul cu ID-ul 987

Modificarea setărilor site-ului

Comandă

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

Site-ul ID poate fi obținut din comanda mogwai sites list.

Opțiuni

  • -i, --id=ID : ID-ul site-ului.
  • -a, --add-alias=ADD-ALIAS : Adaugă un alias; pot fi specificate mai multe aliasuri.
  • --del-alias=DEL-ALIAS : Șterge un alias; pot fi specificate mai multe aliasuri.
  • --add-ip=ADD-IP : Adaugă o adresă IP din setările site-ului; pot fi specificate mai multe adrese IP.
  • --del-ip=DEL-IP : Șterge o adresă IP din setările site-ului; pot fi specificate mai multe adrese IP.
  • -h, --handler=HANDLER : Handler backend. Poate fi:
    • PHP: cgi,mpm_itk,php_fpm,fcgi;
    • Node.js: standalone,pm2;
    • Systemd: systemd.
  • --handler_version=HANDLER_VERSION : Versiunea PHP sau Node.js (de ex. 8.2, 8.3, 20.15.1).
  • --gzip : Activează compresia.
  • --no-gzip : Dezactivează compresia.
  • --gzip-comp-level=LEVEL : Setează nivelul de compresie, 1-9.
  • --expires=EXPIRES : Setează timpul de cache pentru conținutul static.
  • --worker-count=WORKER-COUNT : Setează numărul de workeri pentru PHP-FPM

De asemenea, puteți actualiza setările pentru mai multe site-uri de pe un server folosind comanda

mogwai sites batch-update
  • Pentru a modifica setările pentru toate site-urile, utilizați indicatorul -a.
  • Pentru a modifica setările pentru site-urile selectate, specificați mai mulți indicatori --id cu IDs-urile lor.

Exemplu de comandă

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

Această comandă va adăuga un alias www1.example.com, va schimba handlerul la cgi și versiunea PHP la 5.6 pentru site-ul cu ID-ul 3

Exemplu de comandă

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

Această comandă va schimba handlerul PHP pentru site-urile cu ID-urile 2 și 3

Transferul utilizatorilor între FASTPANEL

Pe această pagină

Introducere

Acest articol descrie procesul de transfer al conturilor de utilizator și al datelor asociate acestora (site-uri web, baze de date, e-mail etc.) de pe un server FASTPANEL pe altul folosind utilitarul de migrare încorporat.

Termeni cheie

  • Server sursă - Serverul de pe care sunt transferate datele.
  • Server destinație - Serverul pe care sunt transferate datele.

Note importante

  • În mod implicit, migrarea funcționează corect doar pentru site-urile cu o configurație FASTPANEL standard.

  • Site-urile cu modificări de configurare manuală pot fi transferate doar dacă este utilizat indicatorul -m pentru maparea adreselor IP.

  • Dacă nu este disponibilă o parolă criptată pentru proprietarul bazei de date, baza de date nu va fi transferată.

  • Dacă un site web nu este transferat, nici bazele de date asociate acestuia nu vor fi transferate.

  • Pot fi transferate doar bazele de date locale.

Procesul de migrare

Conectare

Serverul destinație se conectează la serverul sursă prin SSH. La prima conectare, serverul destinație instalează o cheie SSH pe serverul sursă (fie furnizată în prealabil, fie generată dintr-o parolă).

Pașii migrării

  • Instalarea modulului
  • Colectarea informațiilor despre obiectele transferabile
  • Crearea utilizatorilor
  • Transferul certificatelor SSL
  • Crearea site-urilor web, a conturilor FTP, a domeniilor de e-mail și a conturilor de e-mail
  • Crearea bazelor de date și a utilizatorilor bazelor de date
  • Transferul fișierelor site-urilor web și ale căsuțelor poștale de e-mail
  • Transferul sarcinilor cron

Transferul fișierelor se execută folosind rsync. Bazele de date sunt transferate prin crearea unui dump printr-un tunel SSH.

Comanda pentru a porni migrarea

Comanda se execută pe serverul destinație ca utilizator cu privilegii root:

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

Indicatori de linie de comandă

Conexiune SSH

  • --remote_host="SOURCE_IP" - Adresa IP a serverului sursă.
  • --remote_port="SSH_PORT" - Portul SSH.
  • --remote_username="SSH_USER" - Utilizator (trebuie să fie root).
  • --remote_password="USER_PASSWORD" - Parola pentru utilizatorul SSH specificat.
  • --ssh_key_path="PATH_TO_KEY" - Calea către cheia SSH privată de pe serverul destinație pentru conectarea la serverul sursă. Dacă se utilizează o cheie, parola (--remote_password) nu este necesară.

Adrese IP

Trebuie să utilizați doar unul dintre următorii indicatori pentru a gestiona adresele IP ale site-urilor în timpul transferului. Indicatorul -m are prioritate.

  • -i "IP_ADDRESS_ON_DESTINATION" - Atribuie adresa IP specificată tuturor site-urilor transferate pe serverul destinație. Pentru a specifica mai multe IP-uri (de exemplu, dacă existau mai multe pe sursă), repetați indicatorul pentru fiecare IP sursă care trebuie transferat.

  • -m "SOURCE_IP,DESTINATION_IP" - Metodă recomandată. Stabilește o mapare directă: toate site-urile care folosesc SOURCE_IP pe serverul sursă vor folosi DESTINATION_IP pe serverul destinație. Acest indicator poate fi specificat de mai multe ori pentru perechi IP diferite. Obligatoriu pentru transferul site-urilor cu editări manuale ale configurației, deoarece permite înlocuirea corectă a adreselor IP în directivele listen.

Setări suplimentare

  • --users="USER_LIST" - Transferă doar utilizatorii specificați (separați prin virgulă). Dacă nu este specificat, toți utilizatorii sunt transferați.
  • --disable_disk_quota - Dezactivează transferul cotelor de disc ale utilizatorilor.
  • --with_user_data - Include copierea întregului conținut al directoarelor home ale utilizatorilor (cu excepția subdirectorului logs/). Utilizați cu prudență, deoarece acest lucru poate crește semnificativ timpul de transfer și cantitatea de date transferate.
  • --only_data - Transferă doar datele (fișierele site-urilor web, fișierele de e-mail, dump-urile bazelor de date). Util dacă migrarea inițială a structurii (utilizatori, site-uri, BD etc.) a avut succes, dar au apărut erori în timpul etapei de copiere a fișierelor sau a dump-urilor. Permite rerularea doar a părții de copiere a datelor.
  • --transfer_timeout - Setează timeout-ul operației (implicit este 60 de minute).

Exemplu de comandă

Transferați toți utilizatorii de pe serverul 11.22.33.44 pe serverul curent. Pe serverul vechi, site-urile foloseau IP-urile 11.22.33.44 și 11.22.33.55; pe serverul nou, acestea trebuie să folosească 99.88.77.66 și, respectiv, 99.88.77.67. Conectare prin SSH cu o parolă.

/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

Probleme posibile și tipuri de erori

O eroare din jurnalul de migrare nu indică întotdeauna o problemă critică, ci poate indica motivul pentru care un anumit obiect nu a fost transferat.

  • Conflicte: Apar atunci când transferul unui obiect este imposibil din cauza configurației curente a serverului destinație (de exemplu, există deja un utilizator sau un site cu același nume) sau dacă configurația site-ului de pe serverul sursă este necunoscută pentru panou (de exemplu, din cauza unor editări manuale extinse).

  • Parolă salvată lipsă: După cum s-a menționat mai devreme, utilizatorii bazelor de date MySQL fără o parolă salvată în FASTPANEL pe serverul sursă nu pot fi transferați.

  • Setări manuale și adrese IP: Dacă un site de pe serverul sursă are editări manuale ale configurației serverului web și indicatorul -m nu este utilizat în timpul migrării pentru a mapa adresa sa IP, un astfel de site nu va fi transferat deoarece panoul nu știe ce IP să specifice în configurația de pe serverul destinație.

Utilizatori

Pe această pagină

Crearea unui utilizator nou

Comandă

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

Opțiuni

  • -u, --username=USERNAME : Specificați numele de utilizator pentru utilizatorul nou.
  • -p, --password=PASSWORD : Specificați parola pentru utilizatorul nou.
  • -r, --role="USER" : Specificați rolul pentru utilizatorul nou. Rolurile acceptate sunt RESELLER și USER. Rolul implicit este USER.

Informații de utilizare

Pentru a crea un utilizator nou cu numele de utilizator testuser, parola My$ecretPassword123 și rolul RESELLER, utilizați următoarea comandă:

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

Note suplimentare

  • Numele de utilizator trebuie să fie unice și nu pot conține spații sau puncte.
  • Parolele trebuie să aibă cel puțin 8 caractere. Recomandăm utilizarea a cel puțin unei litere mari, unei litere mici, unei cifre și unui caracter special.