FASTPANELWIKI

CLI

Duomenų bazės

Šiame puslapyje

Duomenų bazių serverių sąrašo gavimas

Komanda

mogwai databases servers list

Išvesties pavyzdys

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

Serveris IDs naudojamas kitose komandose.

Duomenų bazių sąrašo gavimas

Komanda

mogwai databases list

Išvesties pavyzdys

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

Duomenų bazių sąrašo sinchronizavimas

Jei neseniai pridėjote arba pašalinote duomenų bazes ir jos dar nepasirodė FASTPANEL, galite priverstinai sinchronizuoti sąrašus

Komanda

mogwai databases sync

Naujos duomenų bazės kūrimas

Komanda

mogwai databases create [flags]

Parinktys

  • -n, --name=NAME : Duomenų bazės pavadinimas.
  • -o, --owner="fastuser" :  FASTPANEL naudotojas, kuriam bus pridėta duomenų bazė.
  • -s, --site=SITE : FASTPANEL svetainė, prie kurios bus pridėta duomenų bazė.
  • -c, --charset="utf8mb4" : Duomenų bazės koduotė.
  • -u, --username=USERNAME : Duomenų bazės naudotojo vardas.
  • -p, --password=PASSWORD : Duomenų bazės naudotojo slaptažodis.

Komandos pavyzdys

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

Ši komanda sukurs duomenų bazę pavadinimu db1 numatytajame duomenų bazės serveryje (--server=1) ir „susies“ ją su svetaine example.com.

El. paštas

Šiame puslapyje

El. pašto domenų sąrašo gavimas

Komanda

mogwai emails domains list

Išvesties pavyzdys

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

Domenas IDs naudojamas kitose komandose.

El. pašto domeno pridėjimas

Komanda

mogwai emails domains create

Parinktys

  • --domain=DOMAIN : El. pašto domeno pavadinimas.
  • -o, --owner="fastuser" : FASTPANEL naudotojas, kuriam bus pridėtas el. pašto domenas.

El. pašto domeno example1.com sukūrimo fastuser naudotojui pavyzdys

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

Pašto dėžučių sąrašo gavimas

Komanda

mogwai emails boxes list

Parinktys

  • --domain=DOMAIN : Pašto domeno pavadinimas

Komandos pavyzdys

mogwai emails boxes list --domain example.com

Išvesties pavyzdys

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 iš komandos išvesties naudojamas kitose komandose.

Pašto dėžutės kūrimas

Komanda

mogwai emails boxes create

Parinktys

  • --domain=DOMAIN : El. pašto domeno pavadinimas.
  • -l, --login=LOGIN : Pašto dėžutės pavadinimas, be domeno.
  • -p, --password=PASSWORD : Pašto dėžutės slaptažodis.

Komandos pavyzdys

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

Ši komanda sukurs pašto dėžutę pavadinimu user@example.com su slaptažodžiu MySecretPassword123.

Pašto dėžutės ištrynimas

Komanda

mogwai emails boxes delete

Parinktys

  • -b, --box=BOX : Pašto dėžutės ID..

Komandos pavyzdys

mogwai emails boxes delete -b 1

Ši komanda ištrins pašto dėžutę, kurios ID yra 1.

Pašto dėžučių ir el. laiškų importavimas

Komanda

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

Parinktys

  • -i, --import_config=IMPORT_CONFIG : Kelias iki importo sąrašo failo
  • --force : Tik import režimui – išvalyti esamas pašto dėžutes.

Norėdami importuoti paštą, turite paruošti pašto dėžučių sąrašą serveryje tokiu formatu:

IMAP_HOST;SOURCE_ADDR;SOURCE_PASSWORD;DEST_ADDR

Parinktys

  • IMAP_HOST : IMAP pašto serverio adresas.
  • SOURCE_ADDR : Pašto dėžutė šaltinio serveryje.
  • SOURCE_PASSWORD : IMAP ryšio su pašto dėžute šaltinio serveryje slaptažodis. Kai kurios paslaugos, pvz., Google, reikalauja sukurti programos slaptažodį IMAP prieigai https://support.google.com/accounts/answer/185833?hl=en
  • DEST_ADDR : Pašto dėžutė FASTPANEL serveryje, į kurią perkeliami pranešimai.

Failo turinio pavyzdys

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

Galimi du režimai:

Importavimo režimas

mogwai emails boxes import

Šiuo režimu visi pranešimai nukopijuojami visiškai, pašto dėžutės FASTPANEL serveryje neturi būti sukurtos arba turi būti tuščios – vykdant komandą FASTPANEL sukuria reikiamas pašto dėžutes. Jei pašto dėžutės su turiniu jau egzistuoja, bus parodyta klaida. Galite naudoti vėliavą --force – tada pašto dėžutė bus išvalyta.

Komandos paleidimo su pašto dėžučių sąrašu, saugomu faile /root/import.txt, ir naudojant raktą --force, pavyzdys

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

Sinchronizavimo režimas

mogwai emails boxes sync

Šiuo režimu Valdymo skydas atsisiunčia pranešimus iš šaltinio serverio nieko neištrindamas. Jis turėtų būti naudojamas, jei po pirmojo importavimo pradinėje pašto dėžutėje atsirado naujų pranešimų, kuriuos taip pat reikia perkelti.

Komandos pavyzdys

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

Naudotojai

Šiame puslapyje

Naujo naudotojo kūrimas

Komanda

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

Parinktys

  • -u, --username=USERNAME : Nurodykite naujo naudotojo vardą.
  • -p, --password=PASSWORD : Nurodykite naujo naudotojo slaptažodį.
  • -r, --role="USER" : Nurodykite naujo naudotojo vaidmenį. Palaikomi vaidmenys yra RESELLER ir USER. Numatytasis vaidmuo yra USER.

Naudojimo informacija

Norėdami sukurti naują naudotoją su naudotojo vardu testuser, slaptažodžiu My$ecretPassword123 ir vaidmeniu RESELLER, naudokite šią komandą:

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

Papildomos pastabos

  • Naudotojų vardai turi būti unikalūs ir juose negali būti tarpų ar taškų.
  • Slaptažodžiai turi būti bent 8 simbolių ilgio. Rekomenduojame naudoti bent vieną didžiąją raidę, vieną mažąją raidę, vieną skaičių ir vieną specialųjį simbolį.

Naudotojų perkėlimas tarp FASTPANEL serverių

Šiame puslapyje

Įvadas

Šiame straipsnyje aprašomas naudotojų paskyrų ir su jomis susijusių duomenų (svetainių, duomenų bazių, el. pašto ir kt.) perkėlimo procesas iš vieno FASTPANEL serverio į kitą naudojant integruotą migravimo įrankį.

Pagrindiniai terminai

  • Šaltinio serveris – serveris, iš kurio perkeliami duomenys.
  • Paskirties serveris – serveris, į kurį perkeliami duomenys.

Svarbios pastabos

  • Pagal numatytuosius nustatymus migravimas tinkamai veikia tik svetainėms su standartine FASTPANEL konfigūracija.

  • Svetainės su rankiniais konfigūracijos pakeitimais gali būti perkeltos tik naudojant -m vėliavėlę IP adresų susiejimui.

  • Jei duomenų bazės savininko užšifruotas slaptažodis nepasiekiamas, duomenų bazė nebus perkelta.

  • Jei svetainė neperkeliama, su ja susietos duomenų bazės taip pat nebus perkeltos.

  • Galima perkelti tik vietines duomenų bazes.

Migravimo procesas

Prisijungimas

Paskirties serveris jungiasi prie šaltinio serverio per SSH. Pirmojo prisijungimo metu paskirties serveris įdiegia SSH raktą šaltinio serveryje (iš anksto pateiktą arba sugeneruotą iš slaptažodžio).

Migravimo žingsniai

  • Modulio diegimas
  • Informacijos apie perkeliamus objektus surinkimas
  • Naudotojų kūrimas
  • SSL sertifikatų perkėlimas
  • Svetainių, FTP paskyrų, el. pašto domenų ir el. pašto paskyrų kūrimas
  • Duomenų bazių ir duomenų bazių naudotojų kūrimas
  • Svetainių ir el. pašto dėžučių failų perkėlimas
  • Cron užduočių perkėlimas

Failų perkėlimas vykdomas naudojant rsync. Duomenų bazės perkeliamos sukuriant išklotinę per SSH tunelį.

Komanda migravimui pradėti

Komanda vykdoma paskirties serveryje kaip naudotojui, turinčiam root teises:

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

Komandų eilutės vėliavėlės

SSH ryšys

  • --remote_host="SOURCE_IP" – šaltinio serverio IP adresas.
  • --remote_port="SSH_PORT" – SSH prievadas.
  • --remote_username="SSH_USER" – naudotojas (turi būti root).
  • --remote_password="USER_PASSWORD" – nurodyto SSH naudotojo slaptažodis.
  • --ssh_key_path="PATH_TO_KEY" – kelias iki privataus SSH rakto paskirties serveryje, skirto prisijungti prie šaltinio serverio. Jei naudojamas raktas, slaptažodis (--remote_password) nereikalingas.

IP adresai

Perkėlimo metu svetainių IP adresams valdyti turite naudoti tik vieną iš toliau nurodytų vėliavėlių. Vėliavėlė -m turi prioritetą.

  • -i "IP_ADDRESS_ON_DESTINATION" – priskiria nurodytą IP adresą visoms perkeltoms svetainėms paskirties serveryje. Norėdami nurodyti kelis IP (pvz., jei šaltinyje jų buvo keli), pakartokite vėliavėlę kiekvienam šaltinio IP, kurį reikia perkelti.

  • -m "SOURCE_IP,DESTINATION_IP" – rekomenduojamas metodas. Nustato tiesioginį susiejimą: visos svetainės, naudojančios SOURCE_IP šaltinio serveryje, naudos DESTINATION_IP paskirties serveryje. Šią vėliavėlę galima nurodyti kelis kartus skirtingoms IP poroms. Privaloma perkeliant svetaines su rankiniais konfigūracijos pakeitimais, nes ji leidžia teisingai pakeisti IP adresus listen direktyvose.

Papildomi nustatymai

  • --users="USER_LIST" – perkelia tik nurodytus naudotojus (atskirtus kableliais). Jei nenurodyta, perkeliami visi naudotojai.
  • --disable_disk_quota – išjungia naudotojų disko kvotų perkėlimą.
  • --with_user_data – įtraukia viso naudotojų namų katalogų turinio kopijavimą (išskyrus pakatalogį logs/). Naudokite atsargiai, nes tai gali gerokai padidinti perkėlimo laiką ir perkeliamų duomenų kiekį.
  • --only_data – perkelia tik duomenis (svetainių failus, pašto failus, duomenų bazių išklotines). Naudinga, jei pradinis struktūros migravimas (naudotojų, svetainių, DB ir kt.) buvo sėkmingas, tačiau failų ar išklotinių kopijavimo etape įvyko klaidų. Leidžia iš naujo paleisti tik duomenų kopijavimo dalį.
  • --transfer_timeout – nustato operacijos skirtąjį laiką (numatytoji reikšmė – 60 minučių).

Komandos pavyzdys

Perkelkite visus naudotojus iš serverio 11.22.33.44 į dabartinį serverį. Sename serveryje svetainės naudojo IP 11.22.33.44 ir 11.22.33.55; naujame serveryje jos atitinkamai turėtų naudoti 99.88.77.66 ir 99.88.77.67. Prisijungimas per SSH naudojant slaptažodį.

/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

Galimos problemos ir klaidų tipai

Klaida migravimo žurnale ne visada reiškia kritinę problemą, tačiau gali nurodyti priežastį, kodėl konkretus objektas nebuvo perkeltas.

  • Konfliktai: atsiranda, kai objekto perkėlimas neįmanomas dėl dabartinės paskirties serverio konfigūracijos (pvz., jau egzistuoja naudotojas ar svetainė tuo pačiu pavadinimu) arba jei svetainės konfigūracija šaltinio serveryje skydeliui yra nežinoma (pvz., dėl didelių rankinių pakeitimų).

  • Nėra išsaugoto slaptažodžio: kaip minėta anksčiau, MySQL duomenų bazių naudotojai be FASTPANEL išsaugoto slaptažodžio šaltinio serveryje negali būti perkelti.

  • Rankiniai nustatymai ir IP adresai: jei šaltinio serveryje esanti svetainė turi rankinių žiniatinklio serverio konfigūracijos pakeitimų ir migravimo metu jos IP adresui susieti nenaudojama vėliavėlė -m, tokia svetainė nebus perkelta, nes skydelis nežino, kurį IP nurodyti paskirties serverio konfigūracijoje.

Svetainės

Šiame puslapyje

Svetainių sąrašo rodymas serveryje

Komanda

mogwai sites list

Išvesties pavyzdys

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

Pastaba: Svetainės IDs iš šio sąrašo naudojami kitose komandose.

Naujos svetainės kūrimas

Komanda

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

Parinktys

  • --owner : FASTPANEL sistemos naudotojas, kuriam priklausys svetainė.
  • --server-name=SERVER-NAME : Svetainės domeno vardas.
  • -a, --alias=ALIAS : Svetainės alternatyvūs vardai, pvz., www subdomenai. Galima nurodyti kelis alternatyvius vardus.
  • --ip=IP : Serverio, kuriame veiks svetainė, IP adresas. Galima nurodyti kelis IP adresus.
  • -h, --handler=HANDLER : Vidinės pusės apdoroklė. Gali būti:
    • PHP: cgi,mpm_itk,php_fpm,fcgi;
    • Node.js: standalone,pm2;
    • Systemd: systemd.
  • --handler_version=HANDLER_VERSION : PHP arba Node.js versija (pvz. 8.2, 8.3, 20.15.1).
  • --create-user : Sukurti svetainės naudotoją.

Komandos pavyzdys

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

Svetainės ištrynimas

Komanda

mogwai sites delete --id=ID

Svetainės ID galima gauti iš komandos mogwai sites list.

Komandos pavyzdys

mogwai sites delete --id=987

Ši komanda ištrins svetainę, kurios ID yra 987

Svetainės nustatymų keitimas

Komanda

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

Svetainės ID galima gauti iš komandos mogwai sites list.

Parinktys

  • -i, --id=ID : Svetainės ID.
  • -a, --add-alias=ADD-ALIAS : Pridėti alternatyvų vardą, galima nurodyti kelis alternatyvius vardus.
  • --del-alias=DEL-ALIAS : Ištrinti alternatyvų vardą, galima nurodyti kelis alternatyvius vardus.
  • --add-ip=ADD-IP : Pridėti IP adresą iš svetainės nustatymų, galima nurodyti kelis IP adresus.
  • --del-ip=DEL-IP : Ištrinti IP adresą iš svetainės nustatymų, galima nurodyti kelis IP adresus.
  • -h, --handler=HANDLER : Vidinės pusės apdoroklė. Gali būti:
    • PHP: cgi,mpm_itk,php_fpm,fcgi;
    • Node.js: standalone,pm2;
    • Systemd: systemd.
  • --handler_version=HANDLER_VERSION : PHP arba Node.js versija (pvz. 8.2, 8.3, 20.15.1).
  • --gzip : Įjungti glaudinimą.
  • --no-gzip : Išjungti glaudinimą.
  • --gzip-comp-level=LEVEL : Nustatykite glaudinimo lygį, 1-9.
  • --expires=EXPIRES : Nustatyti statinio turinio podėliavimo laiką.
  • --worker-count=WORKER-COUNT : Nustatyti PHP-FPM procesų skaičių

Taip pat galite atnaujinti kelių serverio svetainių nustatymus naudodami komandą

mogwai sites batch-update
  • Norėdami pakeisti visų svetainių nustatymus, naudokite vėliavą -a.
  • Norėdami pakeisti pasirinktų svetainių nustatymus, nurodykite kelias --id vėliavas su jų IDs.

Komandos pavyzdys

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

Ši komanda pridės alternatyvųjį vardą www1.example.com, pakeis apdoroklę į cgi ir PHP versiją į 5.6 svetainei, kurios ID yra 3

Komandos pavyzdys

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

Ši komanda pakeis PHP apdoroklę svetainėms, kurių ID yra 2 ir 3

Aprašymas

Šiame puslapyje

FASTPANEL teikia komandų eilutės sąsają (CLI), įgyvendintą per mogwai priemonę (/usr/local/bin/mogwai). Priemonė veiks tik paleista kaip root.

Pagalba

Norėdami pamatyti galimų komandų sąrašą, naudokite:

mogwai --help

Norėdami sužinoti daugiau apie konkrečią komandą, naudokite:

mogwai command --help

Norėdami pamatyti komandų sąrašą su aprašymais, naudokite:

mogwai --help-long