CLI
Andmebaasid
Sellel lehel
Andmebaasiserverite loendi hankimine
Käsk
mogwai databases servers listVäljundi näide
ID NAME TYPE LOCAL HOST USERNAME AVAIL
1 mysql(localhost) mysql true fastuser true
2 postgresql(localhost) postgresql true fastuser trueServerit IDs kasutatakse teistes käskudes.
Andmebaaside loendi hankimine
Käsk
mogwai databases listVä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 UTCAndmebaaside 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 syncUue 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 dbpassword1See 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 listNä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:00Domeeni IDs kasutatakse teistes käskudes.
E-posti domeeni lisamine
Käsk
mogwai emails domains createValikud
--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 fastuserPostkastide loendi hankimine
Käsk
mogwai emails boxes listValikud
--domain=DOMAIN: Postidomeeni nimi
Näidiskäsk
mogwai emails boxes list --domain example.comNä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:00Käsu väljundist pärit ID kasutatakse teistes käskudes.
Postkasti loomine
Käsk
mogwai emails boxes createValikud
--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=MySecretPassword123See käsk loob postkasti nimega user@example.com parooliga MySecretPassword123.
Postkasti kustutamine
Käsk
mogwai emails boxes deleteValikud
-b,--box=BOX: Postkasti ID..
Näidiskäsk
mogwai emails boxes delete -b 1See 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žiimiimportjaoks - tühjenda olemasolevad postkastid.
Kirjade importimiseks peate serveris ette valmistama postkastide loendi järgmises vormingus:
IMAP_HOST;SOURCE_ADDR;SOURCE_PASSWORD;DEST_ADDRValikud
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=enDEST_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.comSaadaval on kaks režiimi:
Importimisrežiim
mogwai emails boxes importSelles 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 --forceSünkroonimisrežiim
mogwai emails boxes syncSelles 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.txtKasutajad
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 alamkatalooglogs/). 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.67Võ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 --helpKindla käsu kohta lisateabe saamiseks kasutage:
mogwai command --helpKäskude loendi koos kirjeldustega kuvamiseks kasutage:
mogwai --help-longVeebisaidid
Sellel lehel
Serveris olevate saitide loetlemine
Käsk
mogwai sites listNä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.comMä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.
- PHP:
--handler_version=HANDLER_VERSION: PHP või Node.js versioon (nt8.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.3Saidi kustutamine
Käsk
mogwai sites delete --id=IDSaidi ID saab käsuga mogwai sites list.
Näidiskäsk
mogwai sites delete --id=987See 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.
- PHP:
--handler_version=HANDLER_VERSION: PHP või Node.js versioon (nt8.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
--idkoos nendeIDs.
Näidiskäsk
mogwai sites update --id=1 -a www1.example.com -h cgi --handler_version=5.6See 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 2See käsk muudab PHP käitlejat saitidel ID-ga 2 ja 3
FASTPANEL