FASTPANELWIKI

CLI

Datubāzes

Šajā lapā

Datubāzu serveru saraksta iegūšana

Komanda

mogwai databases servers list

Izvades piemērs

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

Serveris IDs tiek izmantots citās komandās.

Datubāzu saraksta iegūšana

Komanda

mogwai databases list

Izvades 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 UTC

Datubā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 sync

Jaunas 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 list

Izvades 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:00

Domēns IDs tiek izmantots citās komandās.

E-pasta domēna pievienošana

Komanda

mogwai emails domains create

Opcijas

  • --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 fastuser

Pastkastu saraksta iegūšana

Komanda

mogwai emails boxes list

Opcijas

  • --domain=DOMAIN : Pasta domēna nosaukums

Komandas piemērs

mogwai emails boxes list --domain example.com

Izvades 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:00

ID no komandas izvades tiek izmantots citās komandās.

Pastkastes izveide

Komanda

mogwai emails boxes create

Opcijas

  • --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 delete

Opcijas

  • -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žīmam import — 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_ADDR

Opcijas

  • 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=en
  • DEST_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.com

Ir 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 --force

Sinhronizā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.txt

Apraksts

Š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 --help

Lai uzzinātu vairāk par konkrētu komandu, izmantojiet:

mogwai command --help

Lai skatītu komandu sarakstu ar aprakstiem, izmantojiet:

mogwai --help-long

Lietotā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 adreses listen direktī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šdirektoriju logs/). 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.67

Iespē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 list

Piemē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.com

Piezī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.
  • --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.3

Vietnes dzēšana

Komanda

mogwai sites delete --id=ID

Vietni 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.
  • --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 --id ar to IDs.

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