CLI
Baze de date
Pe această pagină
Obținerea unei liste de servere de baze de date
Comandă
mogwai databases servers listExemplu de ieșire
ID NAME TYPE LOCAL HOST USERNAME AVAIL
1 mysql(localhost) mysql true fastuser true
2 postgresql(localhost) postgresql true fastuser trueServerul IDs este utilizat în alte comenzi.
Obținerea unei liste de baze de date
Comandă
mogwai databases listExemplu 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 UTCSincronizarea 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 syncCrearea 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 dbpassword1Această 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.
Pe această pagină
Obținerea unei liste de domenii de e-mail
Comandă
mogwai emails domains listExemplu 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:00Domeniile IDs sunt utilizate în alte comenzi.
Adăugarea unui domeniu de e-mail
Comandă
mogwai emails domains createOpț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 fastuserObținerea unei liste de căsuțe poștale
Comandă
mogwai emails boxes listOpțiuni
--domain=DOMAIN: Numele domeniului de e-mail
Exemplu de comandă
mogwai emails boxes list --domain example.comExemplu 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:00ID din ieșirea comenzii este utilizat în alte comenzi.
Crearea unei căsuțe poștale
Comandă
mogwai emails boxes createOpț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=MySecretPassword123Această 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 deleteOpțiuni
-b,--box=BOX: ID-ul căsuței poștale..
Exemplu de comandă
mogwai emails boxes delete -b 1Această 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 modulimport- ș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_ADDROpț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=enDEST_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.comSunt 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 --forceMod 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.txtDescriere
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 --helpPentru a afla mai multe despre o comandă specifică, utilizați:
mogwai command --helpPentru a vedea o listă de comenzi cu descrieri, utilizați:
mogwai --help-longSite-uri web
Pe această pagină
Listarea site-urilor de pe un server
Comandă
mogwai sites listExemplu 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.comNotă: 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.
- PHP:
--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=IDSite-ul ID poate fi obținut din comanda mogwai sites list.
Exemplu de comandă
mogwai sites delete --id=987Această 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.
- PHP:
--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
--idcuIDs-urile lor.
Exemplu de comandă
mogwai sites update --id=1 -a www1.example.com -h cgi --handler_version=5.6Această 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 2Această 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
-mpentru 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 subdirectoruluilogs/). 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.67Probleme 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
-mnu 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.
FASTPANEL