FASTPANELWIKI

CLI

Andmebaasid

Sellel lehel

Andmebaasiserverite loendi hankimine

Käsk

mogwai databases servers list

Väljundi näide

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

Serverit IDs kasutatakse teistes käskudes.

Andmebaaside loendi hankimine

Käsk

mogwai databases list

Väljundi näide

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

Andmebaaside loendi sünkroonimine

Kui olete hiljuti andmebaase lisanud või eemaldanud ja need ei ole veel FASTPANELis ilmunud, saate loendite sünkroonimise jõuga käivitada

Käsk

mogwai databases sync

Uue andmebaasi loomine

Käsk

mogwai databases create [flags]

Valikud

  • -n, --name=NAME : Andmebaasi nimi.
  • -o, --owner="fastuser" :  FASTPANELi kasutaja, kellele andmebaas lisatakse.
  • -s, --site=SITE : FASTPANELi veebisait, millele andmebaas lisatakse.
  • -c, --charset="utf8mb4" : Andmebaasi kodeering.
  • -u, --username=USERNAME : Andmebaasi kasutajanimi.
  • -p, --password=PASSWORD : Andmebaasi kasutaja parool.

Käsu näide

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

See käsk loob vaikimisi andmebaasiserveris (--server=1) andmebaasi nimega db1 ja "seob" selle saidiga example.com.

E-post

Sellel lehel

E-posti domeenide loendi hankimine

Käsk

mogwai emails domains list

Näidisväljund

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

Domeeni IDs kasutatakse teistes käskudes.

E-posti domeeni lisamine

Käsk

mogwai emails domains create

Valikud

  • --domain=DOMAIN : E-posti domeeni nimi.
  • -o, --owner="fastuser" : FASTPANELi kasutaja, kellele e-posti domeen lisatakse.

Näide e-posti domeeni example1.com loomisest kasutaja fastuser all

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

Postkastide loendi hankimine

Käsk

mogwai emails boxes list

Valikud

  • --domain=DOMAIN : Postidomeeni nimi

Näidiskäsk

mogwai emails boxes list --domain example.com

Näidisväljund

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

Käsu väljundist pärit ID kasutatakse teistes käskudes.

Postkasti loomine

Käsk

mogwai emails boxes create

Valikud

  • --domain=DOMAIN : E-posti domeeni nimi.
  • -l, --login=LOGIN : Postkasti nimi ilma domeenita.
  • -p, --password=PASSWORD : Postkasti parool.

Näidiskäsk

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

See käsk loob postkasti nimega user@example.com parooliga MySecretPassword123.

Postkasti kustutamine

Käsk

mogwai emails boxes delete

Valikud

  • -b, --box=BOX : Postkasti ID..

Näidiskäsk

mogwai emails boxes delete -b 1

See käsk kustutab postkasti ID-ga 1.

Postkastide ja e-kirjade importimine

Käsk

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

Valikud

  • -i, --import_config=IMPORT_CONFIG : Importimisloendi faili tee
  • --force : Ainult režiimi import jaoks - tühjenda olemasolevad postkastid.

Kirjade importimiseks peate serveris ette valmistama postkastide loendi järgmises vormingus:

IMAP_HOST;SOURCE_ADDR;SOURCE_PASSWORD;DEST_ADDR

Valikud

  • IMAP_HOST : IMAP-postiserveri aadress.
  • SOURCE_ADDR : Lähte-serveri postkast.
  • SOURCE_PASSWORD : Parool IMAP-ühenduse jaoks lähte-serveri postkastiga. Mõned teenused, näiteks Google, nõuavad IMAP-juurdepääsuks rakenduse parooli loomist https://support.google.com/accounts/answer/185833?hl=en
  • DEST_ADDR : FASTPANELi serveri postkast, kuhu kirjad teisaldatakse.

Näidisfaili sisu

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

Saadaval on kaks režiimi:

Importimisrežiim

mogwai emails boxes import

Selles režiimis kopeeritakse kõik kirjad täielikult, FASTPANELi serveri postkastid ei tohi olla loodud või peavad olema tühjad - käsu käivitamisel loob FASTPANEL vajalikud postkastid. Kui sisuga postkastid on juba olemas, kuvatakse viga. Võite kasutada lippu --force - siis postkast tühjendatakse.

Näide käsu käivitamisest postkastide loendiga, mis on salvestatud faili /root/import.txt, ja võtme --force kasutamisega

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

Sünkroonimisrežiim

mogwai emails boxes sync

Selles režiimis laadib juhtpaneel kirjad lähte-serverist alla ilma midagi kustutamata. Seda tuleks kasutada siis, kui algsesse postkasti on pärast esimest importi ilmunud uusi kirju, mis tuleb samuti üle kanda.

Näidiskäsk

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

Kasutajad

Sellel lehel

Uue kasutaja loomine

Käsk

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

Valikud

  • -u, --username=USERNAME : Määra uue kasutaja kasutajanimi.
  • -p, --password=PASSWORD : Määra uue kasutaja parool.
  • -r, --role="USER" : Määra uue kasutaja roll. Toetatud rollid on RESELLER ja USER. Vaikeroll on USER.

Kasutusteave

Uue kasutaja loomiseks kasutajanimega testuser, parooliga My$ecretPassword123 ja rolliga RESELLER kasuta järgmist käsku:

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

Täiendavad märkused

  • Kasutajanimed peavad olema kordumatud ega tohi sisaldada tühikuid ega punkte.
  • Paroolid peavad olema vähemalt 8 märki pikad. Soovitame kasutada vähemalt ühte suurtähte, ühte väiketähte, ühte numbrit ja ühte erimärki.

Kasutajate ülekandmine FASTPANELi serverite vahel

Sellel lehel

Sissejuhatus

See artikkel kirjeldab kasutajakontode ja nendega seotud andmete (veebisaidid, andmebaasid, e-post jne) ülekandmise protsessi ühest FASTPANELi serverist teise, kasutades sisseehitatud migreerimisutiliiti.

Põhiterminid

  • Lähte server - server, millest andmeid üle kantakse.
  • Sihtserver - server, kuhu andmed üle kantakse.

Olulised märkused

  • Vaikimisi toimib migreerimine korrektselt ainult standardse FASTPANELi konfiguratsiooniga saitide puhul.

  • Käsitsi muudetud konfiguratsiooniga saite saab üle kanda ainult siis, kui IP-aadresside vastendamiseks kasutatakse lippu -m.

  • Kui andmebaasi omaniku krüpteeritud parool ei ole saadaval, siis andmebaasi üle ei kanta.

  • Kui veebisaiti üle ei kanta, siis ei kanta üle ka sellega seotud andmebaase.

  • Üle kanda saab ainult kohalikke andmebaase.

Migreerimisprotsess

Ühendus

Sihtserver ühendub lähte serveriga SSH kaudu. Esimese ühenduse ajal paigaldab sihtserver lähte serverisse SSH-võtme (kas eelnevalt antud või paroolist genereeritud).

Migreerimise sammud

  • Mooduli paigaldamine
  • Ülekantavate objektide kohta teabe kogumine
  • Kasutajate loomine
  • SSL-sertifikaatide ülekandmine
  • Veebisaitide, FTP-kontode, e-posti domeenide ja e-posti kontode loomine
  • Andmebaaside ja andmebaasikasutajate loomine
  • Veebisaidi- ja e-posti postkastifailide ülekandmine
  • Croni ülesannete ülekandmine

Failide ülekandmine toimub kasutades utiliiti rsync. Andmebaasid kantakse üle, luues dump'i läbi SSH-tunneli.

Käsk migreerimise käivitamiseks

Käsk käivitatakse sihtserveris root-õigustega kasutaja alt:

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

Käsurea lipud

SSH-ühendus

  • --remote_host="SOURCE_IP" - lähte serveri IP-aadress.
  • --remote_port="SSH_PORT" - SSH-port.
  • --remote_username="SSH_USER" - kasutaja (peab olema root).
  • --remote_password="USER_PASSWORD" - määratud SSH-kasutaja parool.
  • --ssh_key_path="PATH_TO_KEY" - tee sihtserveris asuva privaatse SSH-võtmeni, mida kasutatakse lähte serveriga ühenduse loomiseks. Kui kasutatakse võtit, siis parooli (--remote_password) ei ole vaja.

IP-aadressid

Saitide IP-aadresside haldamiseks ülekandmise ajal tuleb kasutada ainult üht järgmistest lippudest. Lipul -m on prioriteet.

  • -i "IP_ADDRESS_ON_DESTINATION" - määrab sihtserveris kõigile ülekantud saitidele määratud IP-aadressi. Mitme IP määramiseks (nt kui lähte serveris oli neid mitu) korrake lippu iga lähte IP jaoks, mis tuleb üle kanda.

  • -m "SOURCE_IP,DESTINATION_IP" - soovitatav meetod. Loob otsese vastenduse: kõik saidid, mis kasutavad lähte serveris SOURCE_IP, hakkavad sihtserveris kasutama DESTINATION_IP. Seda lippu saab erinevate IP-paaride jaoks määrata mitu korda. Kohustuslik käsitsi muudetud konfiguratsiooniga saitide ülekandmisel, kuna see võimaldab listen-direktiivides IP-aadresse korrektselt asendada.

Täiendavad sätted

  • --users="USER_LIST" - kannab üle ainult määratud kasutajad (komadega eraldatult). Kui seda ei ole määratud, kantakse üle kõik kasutajad.
  • --disable_disk_quota - keelab kasutajate kettakvootide ülekandmise.
  • --with_user_data - sisaldab kasutajate kodukataloogide kogu sisu kopeerimist (välja arvatud alamkataloog logs/). Kasutage ettevaatlikult, kuna see võib oluliselt suurendada ülekandmise aega ja ülekantavate andmete mahtu.
  • --only_data - kannab üle ainult andmed (veebisaidifailid, e-posti failid, andmebaasi dump'id). Kasulik, kui esialgne struktuuri migreerimine (kasutajad, saidid, andmebaasid jne) õnnestus, kuid failide või dump'ide kopeerimise etapis tekkisid vead. Võimaldab uuesti käivitada ainult andmete kopeerimise osa.
  • --transfer_timeout - määrab toimingu ajalõpu (vaikimisi 60 minutit).

Käsu näide

Kandke kõik kasutajad serverist 11.22.33.44 üle praegusesse serverisse. Vanas serveris kasutasid saidid IP-sid 11.22.33.44 ja 11.22.33.55; uues serveris peavad need kasutama vastavalt 99.88.77.66 ja 99.88.77.67. Ühendus SSH kaudu parooliga.

/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

Võimalikud probleemid ja veatüübid

Viga migreerimislogis ei viita alati kriitilisele probleemile, kuid võib osutada põhjusele, miks konkreetset objekti üle ei kantud.

  • Konfliktid: tekivad siis, kui objekti ülekandmine on sihtserveri praeguse konfiguratsiooni tõttu võimatu (nt sama nimega kasutaja või sait on juba olemas) või kui saidi konfiguratsioon lähte serveris on paneelile tundmatu (nt ulatuslike käsitsi tehtud muudatuste tõttu).

  • Salvestatud parool puudub: nagu eespool mainitud, ei saa lähte serveri FASTPANELis salvestatud paroolita MySQLi andmebaasikasutajaid üle kanda.

  • Käsitsi määratud sätted ja IP-aadressid: kui lähte serveris oleval saidil on veebiserveri konfiguratsioonis käsitsi tehtud muudatused ja migreerimise ajal ei kasutata selle IP-aadressi vastendamiseks lippu -m, siis sellist saiti üle ei kanta, sest paneel ei tea, milline IP sihtserveri konfiguratsioonis määrata.

Kirjeldus

Sellel lehel

FASTPANEL pakub käsurealiidest (CLI), mis on teostatud utiliidi mogwai kaudu (/usr/local/bin/mogwai). Utiliit töötab ainult siis, kui see käivitatakse kasutajana root.

Abi

Saadaolevate käskude loendi kuvamiseks kasutage:

mogwai --help

Kindla käsu kohta lisateabe saamiseks kasutage:

mogwai command --help

Käskude loendi koos kirjeldustega kuvamiseks kasutage:

mogwai --help-long

Veebisaidid

Sellel lehel

Serveris olevate saitide loetlemine

Käsk

mogwai sites list

Näidisväljund

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

Märkus: Selle loendi saidi IDs kasutatakse teistes käskudes.

Uue saidi loomine

Käsk

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

Valikud

  • --owner : FASTPANELi süsteemi kasutaja, kellele sait kuulub.
  • --server-name=SERVER-NAME : Saidi domeeninimi.
  • -a, --alias=ALIAS : Saidi aliased, näiteks www-alamdomeenid. Määrata saab mitu aliast.
  • --ip=IP : Serveri IP-aadress, kus sait töötab. Määrata saab mitu IP-aadressi.
  • -h, --handler=HANDLER : Taustatöötluse käitleja. Võib olla:
    • PHP: cgi,mpm_itk,php_fpm,fcgi;
    • Node.js: standalone,pm2;
    • Systemd: systemd.
  • --handler_version=HANDLER_VERSION : PHP või Node.js versioon (nt 8.2, 8.3, 20.15.1).
  • --create-user : Loo saidi jaoks kasutaja.

Näidiskäsk

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

Saidi kustutamine

Käsk

mogwai sites delete --id=ID

Saidi ID saab käsuga mogwai sites list.

Näidiskäsk

mogwai sites delete --id=987

See käsk kustutab saidi ID-ga 987

Saidi sätete muutmine

Käsk

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

Saidi ID saab käsuga mogwai sites list.

Valikud

  • -i, --id=ID : Saidi ID.
  • -a, --add-alias=ADD-ALIAS : Lisa alias, määrata saab mitu aliast.
  • --del-alias=DEL-ALIAS : Kustuta alias, määrata saab mitu aliast.
  • --add-ip=ADD-IP : Lisa saidi sätetesse IP-aadress, määrata saab mitu IP-aadressi.
  • --del-ip=DEL-IP : Kustuta saidi sätetest IP-aadress, määrata saab mitu IP-aadressi.
  • -h, --handler=HANDLER : Taustatöötluse käitleja. Võib olla:
    • PHP: cgi,mpm_itk,php_fpm,fcgi;
    • Node.js: standalone,pm2;
    • Systemd: systemd.
  • --handler_version=HANDLER_VERSION : PHP või Node.js versioon (nt 8.2, 8.3, 20.15.1).
  • --gzip : Luba tihendamine.
  • --no-gzip : Keela tihendamine.
  • --gzip-comp-level=LEVEL : Määra tihendustase, 1-9.
  • --expires=EXPIRES : Määra staatilise sisu vahemällu salvestamise aeg.
  • --worker-count=WORKER-COUNT : Määra PHP-FPM-i tööprotsesside arv

Saate serveris mitme saidi sätteid uuendada ka käsuga

mogwai sites batch-update
  • Kõigi saitide sätete muutmiseks kasutage lippu -a.
  • Valitud saitide sätete muutmiseks määrake mitu lippu --id koos nende IDs.

Näidiskäsk

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

See käsk lisab aliase www1.example.com, muudab käitleja väärtuseks cgi ja PHP versiooniks 5.6 saidil ID-ga 3

Näidiskäsk

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

See käsk muudab PHP käitlejat saitidel ID-ga 2 ja 3