CLI
Datubāzes
Šajā lapā
Datubāzu serveru saraksta iegūšana
Komanda
mogwai databases servers listIzvades piemērs
ID NAME TYPE LOCAL HOST USERNAME AVAIL
1 mysql(localhost) mysql true fastuser true
2 postgresql(localhost) postgresql true fastuser trueServeris IDs tiek izmantots citās komandās.
Datubāzu saraksta iegūšana
Komanda
mogwai databases listIzvades piemērs
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 UTCDatubāzu saraksta sinhronizēšana
Ja nesen pievienojāt vai noņēmāt datubāzes un tās vēl nav parādījušās FASTPANEL, varat piespiedu kārtā sinhronizēt sarakstus
Komanda
mogwai databases syncJaunas datubāzes izveide
Komanda
mogwai databases create [flags]Opcijas
-n,--name=NAME: Datubāzes nosaukums.-o,--owner="fastuser": FASTPANEL lietotājs, kuram tiks pievienota datubāze.-s,--site=SITE: Tīmekļvietne FASTPANEL, kurai tiks pievienota datubāze.-c,--charset="utf8mb4": Datubāzes kodējums.-u,--username=USERNAME: Datubāzes lietotājvārds.-p,--password=PASSWORD: Datubāzes lietotāja parole.
Komandas piemērs
mogwai databases create --server=1 -n db1 -o fastuser -s example.com -u dbuser -p dbpassword1Šī komanda izveidos datubāzi ar nosaukumu db1 uz noklusējuma datubāzu servera (--server=1) un "piesaistīs" to vietnei example.com.
E-pasts
Šajā lapā
E-pasta domēnu saraksta iegūšana
Komanda
mogwai emails domains listIzvades piemērs
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:00Domēns IDs tiek izmantots citās komandās.
E-pasta domēna pievienošana
Komanda
mogwai emails domains createOpcijas
--domain=DOMAIN: E-pasta domēna nosaukums.-o,--owner="fastuser": FASTPANEL lietotājs, kuram tiks pievienots e-pasta domēns.
Piemērs e-pasta domēna example1.com izveidei lietotājam fastuser
mogwai emails domains create --domain=example1.com -o fastuserPastkastu saraksta iegūšana
Komanda
mogwai emails boxes listOpcijas
--domain=DOMAIN: Pasta domēna nosaukums
Komandas piemērs
mogwai emails boxes list --domain example.comIzvades piemērs
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 no komandas izvades tiek izmantots citās komandās.
Pastkastes izveide
Komanda
mogwai emails boxes createOpcijas
--domain=DOMAIN: E-pasta domēna nosaukums.-l,--login=LOGIN: Pastkastes nosaukums bez domēna.-p,--password=PASSWORD: Pastkastes parole.
Komandas piemērs
mogwai emails boxes create --domain=example.com --login=user --password=MySecretPassword123Šī komanda izveidos pastkasti ar nosaukumu user@example.com un paroli MySecretPassword123.
Pastkastes dzēšana
Komanda
mogwai emails boxes deleteOpcijas
-b,--box=BOX: Pastkastes ID..
Komandas piemērs
mogwai emails boxes delete -b 1Šī komanda izdzēsīs pastkasti ar ID 1.
Pastkastu un e-pastu importēšana
Komanda
mogwai emails boxes import[sync] [<flags>]Opcijas
-i,--import_config=IMPORT_CONFIG: Ceļš uz importa saraksta failu--force: Tikai režīmamimport— notīrīt esošās pastkastes.
Lai importētu pastu, jums jāsagatavo pastkastu saraksts serverī šādā formātā:
IMAP_HOST;SOURCE_ADDR;SOURCE_PASSWORD;DEST_ADDROpcijas
IMAP_HOST: IMAP pasta servera adrese.SOURCE_ADDR: Pastkaste avota serverī.SOURCE_PASSWORD: Parole IMAP savienojumam ar pastkasti avota serverī. Daži pakalpojumi, piemēram, Google, IMAP piekļuvei pieprasa izveidot lietotnes paroli https://support.google.com/accounts/answer/185833?hl=enDEST_ADDR: Pastkaste FASTPANEL serverī, uz kuru tiek pārsūtīti ziņojumi.
Faila satura piemērs
imap.gmail.com;test@gmail.comu;password;test@example.com
imap.gmail.com;test1@gmail.com;password;test1@example.comIr pieejami divi režīmi:
Importa režīms
mogwai emails boxes importŠajā režīmā visi ziņojumi tiek pilnībā kopēti, pastkastes FASTPANEL serverī nedrīkst būt izveidotas vai tām jābūt tukšām — izpildot komandu, FASTPANEL izveido nepieciešamās pastkastes. Ja jau eksistē pastkastes ar saturu, tiks parādīta kļūda. Varat izmantot karogu --force — tad pastkaste tiks notīrīta.
Komandas palaišanas piemērs ar pastkastu sarakstu, kas saglabāts failā /root/import.txt, un izmantojot atslēgu --force
mogwai emails boxes import --import_config=/root/import.txt --forceSinhronizācijas režīms
mogwai emails boxes syncŠajā režīmā vadības panelis lejupielādē ziņojumus no avota servera, neko neizdzēšot. Tas jāizmanto, ja pēc pirmā importa sākotnējā pastkastē ir parādījušies jauni ziņojumi, kas arī jāpārsūta.
Komandas piemērs
mogwai emails boxes sync --import_config=/root/import.txtApraksts
Šajā lapā
FASTPANEL nodrošina komandrindas saskarni (CLI), kas īstenota, izmantojot utilītu mogwai (/usr/local/bin/mogwai). Utilīta darbosies tikai tad, ja tā tiks palaista kā root.
Palīdzība
Lai skatītu pieejamo komandu sarakstu, izmantojiet:
mogwai --helpLai uzzinātu vairāk par konkrētu komandu, izmantojiet:
mogwai command --helpLai skatītu komandu sarakstu ar aprakstiem, izmantojiet:
mogwai --help-longLietotāji
Šajā lapā
Jauna lietotāja izveide
Komanda
mogwai users create --username=USERNAME --password=PASSWORD [--role="USER"]Opcijas
-u,--username=USERNAME: Norādiet jaunā lietotāja lietotājvārdu.-p,--password=PASSWORD: Norādiet jaunā lietotāja paroli.-r,--role="USER": Norādiet jaunā lietotāja lomu. Atbalstītās lomas ir RESELLER un USER. Noklusējuma loma ir USER.
Lietošanas informācija
Lai izveidotu jaunu lietotāju ar lietotājvārdu testuser, paroli My$ecretPassword123 un lomu RESELLER, izmantojiet šādu komandu:
mogwai users create --username=testuser --password=My$ecretPassword123 --role="RESELLER"Papildu piezīmes
- Lietotājvārdiem jābūt unikāliem, un tie nedrīkst saturēt atstarpes vai punktus.
- Parolēm jābūt vismaz 8 rakstzīmes garām. Mēs iesakām izmantot vismaz vienu lielo burtu, vienu mazo burtu, vienu ciparu un vienu speciālo rakstzīmi.
Lietotāju pārsūtīšana starp FASTPANEL
Šajā lapā
Ievads
Šajā rakstā ir aprakstīts lietotāju kontu un ar tiem saistīto datu (vietņu, datubāzu, e-pasta utt.) pārsūtīšanas process no viena FASTPANEL servera uz citu, izmantojot iebūvēto migrācijas utilītu.
Galvenie termini
- Avota serveris - serveris, no kura dati tiek pārsūtīti.
- Mērķa serveris - serveris, uz kuru dati tiek pārsūtīti.
Svarīgas piezīmes
-
Pēc noklusējuma migrācija korekti darbojas tikai vietnēm ar standarta FASTPANEL konfigurāciju.
-
Vietnes ar manuālām konfigurācijas izmaiņām var pārsūtīt tikai tad, ja IP adrešu kartēšanai tiek izmantots karodziņš
-m. -
Ja šifrēta datubāzes īpašnieka parole nav pieejama, datubāze netiks pārsūtīta.
-
Ja vietne netiek pārsūtīta, arī ar to saistītās datubāzes netiks pārsūtītas.
-
Var pārsūtīt tikai lokālās datubāzes.
Migrācijas process
Savienojums
Mērķa serveris savienojas ar avota serveri, izmantojot SSH. Pirmā savienojuma laikā mērķa serveris avota serverī instalē SSH atslēgu (vai nu iepriekš nodrošinātu, vai ģenerētu no paroles).
Migrācijas soļi
- Moduļa instalēšana
- Informācijas apkopošana par pārsūtāmajiem objektiem
- Lietotāju izveide
- SSL sertifikātu pārsūtīšana
- Vietņu, FTP kontu, e-pasta domēnu un e-pasta kontu izveide
- Datubāzu un datubāzu lietotāju izveide
- Vietņu un e-pasta pastkastīšu failu pārsūtīšana
- Cron uzdevumu pārsūtīšana
Failu pārsūtīšana tiek veikta, izmantojot rsync. Datubāzes tiek pārsūtītas, izveidojot dump caur SSH tuneli.
Komanda migrācijas sākšanai
Komanda tiek izpildīta mērķa serverī kā lietotājam ar root privilēģijām:
/usr/local/fastpanel2/fastpanel transfer run [SSH_PARAMETERS] [IP_PARAMETERS] [ADDITIONAL_OPTIONS]Komandrindas karodziņi
SSH savienojums
--remote_host="SOURCE_IP" - avota servera IP adrese.--remote_port="SSH_PORT" - SSH ports.--remote_username="SSH_USER" - lietotājs (jābūt root).--remote_password="USER_PASSWORD" - parole norādītajam SSH lietotājam.--ssh_key_path="PATH_TO_KEY" - ceļš uz privāto SSH atslēgu mērķa serverī savienojumam ar avota serveri. Ja tiek izmantota atslēga, parole (--remote_password) nav nepieciešama.
IP adreses
Lai pārvaldītu vietņu IP adreses pārsūtīšanas laikā, jāizmanto tikai viens no šiem karodziņiem. Karodziņam -m ir prioritāte.
-
-i"IP_ADDRESS_ON_DESTINATION" - piešķir norādīto IP adresi visām pārsūtītajām vietnēm mērķa serverī. Lai norādītu vairākas IP adreses (piemēram, ja avota serverī tās bija vairākas), atkārtojiet karodziņu katrai avota IP adresei, kas jāpārsūta. -
-m"SOURCE_IP,DESTINATION_IP" - ieteicamā metode. Izveido tiešu kartējumu: visas vietnes, kas avota serverī izmanto SOURCE_IP, mērķa serverī izmantos DESTINATION_IP. Šo karodziņu var norādīt vairākas reizes dažādiem IP pāriem. Obligāts vietņu ar manuāliem konfigurācijas labojumiem pārsūtīšanai, jo tas ļauj korekti aizstāt IP adreseslistendirektīvās.
Papildu iestatījumi
--users="USER_LIST" - pārsūta tikai norādītos lietotājus (atdalītus ar komatiem). Ja nav norādīts, tiek pārsūtīti visi lietotāji.--disable_disk_quota- atspējo lietotāju diska kvotu pārsūtīšanu.--with_user_data- ietver visas lietotāju mājas direktoriju satura kopēšanu (izņemot apakšdirektorijulogs/). Izmantojiet piesardzīgi, jo tas var ievērojami palielināt pārsūtīšanas laiku un pārsūtīto datu apjomu.--only_data- pārsūta tikai datus (vietņu failus, pasta failus, datubāžu dumpus). Noderīgi, ja sākotnējā struktūras migrācija (lietotāji, vietnes, DB utt.) bija veiksmīga, bet failu vai dumpu kopēšanas posmā radās kļūdas. Ļauj atkārtoti palaist tikai datu kopēšanas daļu.--transfer_timeout- iestata darbības noildzi (noklusējums ir 60 minūtes).
Komandas piemērs
Pārsūtiet visus lietotājus no servera 11.22.33.44 uz pašreizējo serveri. Vecajā serverī vietnes izmantoja IP adreses 11.22.33.44 un 11.22.33.55; jaunajā serverī tām attiecīgi jāizmanto 99.88.77.66 un 99.88.77.67. Savienojums caur SSH ar paroli.
/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.67Iespējamās problēmas un kļūdu veidi
Kļūda migrācijas žurnālā ne vienmēr norāda uz kritisku problēmu, bet var norādīt iemeslu, kāpēc konkrēts objekts netika pārsūtīts.
-
Konflikti: rodas, ja objekta pārsūtīšana nav iespējama mērķa servera pašreizējās konfigurācijas dēļ (piemēram, jau eksistē lietotājs vai vietne ar tādu pašu nosaukumu) vai ja vietnes konfigurācija avota serverī panelim nav zināma (piemēram, plašu manuālu labojumu dēļ).
-
Trūkst saglabātas paroles: kā minēts iepriekš, MySQL datubāzes lietotājus bez FASTPANEL saglabātas paroles avota serverī nevar pārsūtīt.
-
Manuālie iestatījumi un IP adreses: ja vietnei avota serverī ir manuāli tīmekļa servera konfigurācijas labojumi un migrācijas laikā tās IP adreses kartēšanai netiek izmantots karodziņš
-m, šāda vietne netiks pārsūtīta, jo panelis nezina, kuru IP adresi norādīt konfigurācijā mērķa serverī.
Tīmekļa vietnes
Šajā lapā
Vietņu uzskaitīšana serverī
Komanda
mogwai sites listPiemēra izvade
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.comPiezīme: Vietnes IDs no šī saraksta tiek izmantots citās komandās.
Jaunas vietnes izveide
Komanda
mogwai sites create --server-name=SERVER-NAME --owner=OWNER [<flags>]Opcijas
--owner: Lietotājs FASTPANEL sistēmā, kuram piederēs vietne.--server-name=SERVER-NAME: Vietnes domēna nosaukums.-a,--alias=ALIAS: Vietnes aizstājvārdi, piemēram, www apakšdomēni. Var norādīt vairākus aizstājvārdus.--ip=IP: Servera IP adrese, kurā vietne darbosies. Var norādīt vairākas IP adreses.-h,--handler=HANDLER: Aizmugures apstrādātājs. Var būt:- PHP:
cgi,mpm_itk,php_fpm,fcgi; - Node.js:
standalone,pm2; - Systemd:
systemd.
- PHP:
--handler_version=HANDLER_VERSION: PHP vai Node.js versija (piem.,8.2,8.3,20.15.1).--create-user: Izveidot lietotāju vietnei.
Komandas piemērs
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.3Vietnes dzēšana
Komanda
mogwai sites delete --id=IDVietni ID var iegūt no komandas mogwai sites list.
Komandas piemērs
mogwai sites delete --id=987Šī komanda izdzēsīs vietni ar ID 987
Vietnes iestatījumu mainīšana
Komanda
mogwai sites update --id=ID [<flags>]Vietni ID var iegūt no komandas mogwai sites list.
Opcijas
-i,--id=ID: Vietnes ID.-a,--add-alias=ADD-ALIAS: Pievienot aizstājvārdu, var norādīt vairākus aizstājvārdus.--del-alias=DEL-ALIAS: Dzēst aizstājvārdu, var norādīt vairākus aizstājvārdus.--add-ip=ADD-IP: Pievienot IP adresi no vietnes iestatījumiem, var norādīt vairākas IP adreses.--del-ip=DEL-IP: Dzēst IP adresi no vietnes iestatījumiem, var norādīt vairākas IP adreses.-h,--handler=HANDLER: Aizmugures apstrādātājs. Var būt:- PHP:
cgi,mpm_itk,php_fpm,fcgi; - Node.js:
standalone,pm2; - Systemd:
systemd.
- PHP:
--handler_version=HANDLER_VERSION: PHP vai Node.js versija (piem.,8.2,8.3,20.15.1).--gzip: Iespējot saspiešanu.--no-gzip: Atspējot saspiešanu.--gzip-comp-level=LEVEL: Iestatīt saspiešanas līmeni, 1-9.--expires=EXPIRES: Iestatīt statiskā satura kešošanas laiku.--worker-count=WORKER-COUNT: Iestatīt PHP-FPM darba procesu skaitu
Varat arī atjaunināt vairāku servera vietņu iestatījumus, izmantojot komandu
mogwai sites batch-update- Lai mainītu visu vietņu iestatījumus, izmantojiet karogu
-a. - Lai mainītu atlasīto vietņu iestatījumus, norādiet vairākus karogus
--idar toIDs.
Komandas piemērs
mogwai sites update --id=1 -a www1.example.com -h cgi --handler_version=5.6Šī komanda pievienos aizstājvārdu www1.example.com, mainīs apstrādātāju uz cgi un PHP versiju uz 5.6 vietnei ar ID 3
Komandas piemērs
mogwai sites batch-update -h cgi --handler_version=5.6 --id 3 --id 2Šī komanda mainīs PHP apstrādātāju vietnēm ar ID 2 un 3
FASTPANEL