FASTPANELWIKI

CLI

Baze podataka

Na ovoj stranici

Dobijanje liste servera baza podataka

Komanda

mogwai databases servers list

Primer izlaza

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

Server IDs se koristi u drugim komandama.

Dobijanje liste baza podataka

Komanda

mogwai databases list

Primer izlaza

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

Sinhronizacija liste baza podataka

Ako ste nedavno dodali ili uklonili baze podataka, a one se još nisu pojavile u FASTPANEL-u, možete prisiliti sinhronizaciju lista

Komanda

mogwai databases sync

Kreiranje nove baze podataka

Komanda

mogwai databases create [flags]

Opcije

  • -n, --name=NAME : Naziv baze podataka.
  • -o, --owner="fastuser" :  FASTPANEL korisnik kojem će baza podataka biti dodata.
  • -s, --site=SITE : Veb-sajt u FASTPANEL-u kome će baza podataka biti dodata.
  • -c, --charset="utf8mb4" : Kodiranje baze podataka.
  • -u, --username=USERNAME : Korisničko ime baze podataka.
  • -p, --password=PASSWORD : Lozinka korisnika baze podataka.

Primer komande

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

Ova komanda će kreirati bazu podataka pod nazivom db1 na podrazumevanom serveru baze podataka (--server=1) i "povezati" je sa sajtom example.com.

E-pošta

Na ovoj stranici

Dobijanje liste domena e-pošte

Komanda

mogwai emails domains list

Primer izlaza

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

Domeni IDs se koriste u drugim komandama.

Dodavanje domena e-pošte

Komanda

mogwai emails domains create

Opcije

  • --domain=DOMAIN : Naziv domena e-pošte.
  • -o, --owner="fastuser" : FASTPANEL korisnik kojem će domen e-pošte biti dodat.

Primer kreiranja domena e-pošte example1.com pod korisnikom fastuser

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

Dobijanje liste poštanskih sandučića

Komanda

mogwai emails boxes list

Opcije

  • --domain=DOMAIN : Naziv domena pošte

Primer komande

mogwai emails boxes list --domain example.com

Primer izlaza

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 iz izlaza komande se koristi u drugim komandama.

Kreiranje poštanskog sandučića

Komanda

mogwai emails boxes create

Opcije

  • --domain=DOMAIN : Naziv domena e-pošte.
  • -l, --login=LOGIN : Naziv poštanskog sandučića, bez domena.
  • -p, --password=PASSWORD : Lozinka za poštanski sandučić.

Primer komande

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

Ova komanda će kreirati poštanski sandučić pod nazivom user@example.com sa lozinkom MySecretPassword123.

Brisanje poštanskog sandučića

Komanda

mogwai emails boxes delete

Opcije

  • -b, --box=BOX : ID poštanskog sandučića..

Primer komande

mogwai emails boxes delete -b 1

Ova komanda će obrisati poštanski sandučić sa ID-jem 1.

Uvoz poštanskih sandučića i e-poruka

Komanda

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

Opcije

  • -i, --import_config=IMPORT_CONFIG : Putanja do datoteke liste za uvoz
  • --force : Samo za režim import - obriši postojeće poštanske sandučiće.

Da biste uvezli poštu, potrebno je da pripremite listu poštanskih sandučića na serveru u formatu:

IMAP_HOST;SOURCE_ADDR;SOURCE_PASSWORD;DEST_ADDR

Opcije

  • IMAP_HOST : Adresa IMAP servera pošte.
  • SOURCE_ADDR : Poštanski sandučić na izvornom serveru.
  • SOURCE_PASSWORD : Lozinka za IMAP povezivanje sa poštanskim sandučićem na izvornom serveru. Neke usluge, kao što je Google, zahtevaju kreiranje lozinke za aplikaciju za IMAP pristup https://support.google.com/accounts/answer/185833?hl=en
  • DEST_ADDR : Poštanski sandučić na FASTPANEL serveru na koji se poruke prenose.

Primer sadržaja datoteke

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

Dostupna su dva režima:

Režim uvoza

mogwai emails boxes import

U ovom režimu, sve poruke se kopiraju u potpunosti, poštanski sandučići na FASTPANEL serveru ne smeju biti kreirani ili moraju biti prazni - kada se komanda izvrši, FASTPANEL kreira potrebne poštanske sandučiće. Ako poštanski sandučići sa sadržajem već postoje, biće prikazana greška. Možete koristiti oznaku --force - tada će poštanski sandučić biti očišćen.

Primer pokretanja komande sa listom poštanskih sandučića sačuvanom u datoteci /root/import.txt i korišćenjem ključa --force

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

Režim sinhronizacije

mogwai emails boxes sync

U ovom režimu, Kontrolna tabla preuzima poruke sa izvornog servera bez brisanja bilo čega. Treba ga koristiti ako su se nove poruke pojavile u originalnom poštanskom sandučiću nakon prvog uvoza, a koje takođe treba preneti.

Primer komande

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

Korisnici

Na ovoj stranici

Kreiranje novog korisnika

Komanda

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

Opcije

  • -u, --username=USERNAME : Navedite korisničko ime za novog korisnika.
  • -p, --password=PASSWORD : Navedite lozinku za novog korisnika.
  • -r, --role="USER" : Navedite ulogu za novog korisnika. Podržane uloge su RESELLER i USER. Podrazumevana uloga je USER.

Informacije o upotrebi

Da biste kreirali novog korisnika sa korisničkim imenom testuser, lozinkom My$ecretPassword123 i ulogom RESELLER, koristite sledeću komandu:

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

Dodatne napomene

  • Korisnička imena moraju biti jedinstvena i ne smeju sadržati razmake ili tačke.
  • Lozinke moraju imati najmanje 8 znakova. Preporučujemo korišćenje najmanje jednog velikog slova, jednog malog slova, jednog broja i jednog specijalnog znaka.

Prenos korisnika između FASTPANEL servera

Na ovoj stranici

Uvod

Ovaj članak opisuje proces prenosa korisničkih naloga i njihovih povezanih podataka (veb-sajtovi, baze podataka, e-pošta itd.) sa jednog FASTPANEL servera na drugi pomoću ugrađenog alata za migraciju.

Ključni pojmovi

  • Izvorni server - Server sa kog se podaci prenose.
  • Odredišni server - Server na koji se podaci prenose.

Važne napomene

  • Podrazumevano, migracija radi ispravno samo za sajtove sa standardnom FASTPANEL konfiguracijom.

  • Sajtovi sa izmenama ručne konfiguracije mogu se preneti samo ako se za mapiranje IP adresa koristi oznaka -m.

  • Ako šifrovana lozinka za vlasnika baze podataka nije dostupna, baza podataka neće biti preneta.

  • Ako veb-sajt nije prenet, neće biti prenete ni njegove povezane baze podataka.

  • Mogu se preneti samo lokalne baze podataka.

Proces migracije

Povezivanje

Odredišni server se povezuje sa izvornim serverom putem SSH-a. Prilikom prvog povezivanja, odredišni server instalira SSH ključ na izvorni server (ili unapred obezbeđen ili generisan iz lozinke).

Koraci migracije

  • Instalacija modula
  • Prikupljanje informacija o objektima koji se mogu preneti
  • Kreiranje korisnika
  • Prenos SSL sertifikata
  • Kreiranje veb-sajtova, FTP naloga, domena e-pošte i naloga e-pošte
  • Kreiranje baza podataka i korisnika baza podataka
  • Prenos fajlova veb-sajtova i poštanskih sandučića
  • Prenos cron zadataka

Prenos fajlova se izvršava pomoću rsync. Baze podataka se prenose kreiranjem dump-a kroz SSH tunel.

Komanda za pokretanje migracije

Komanda se pokreće na odredišnom serveru kao korisnik sa root privilegijama:

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

Oznake komandne linije

SSH veza

  • --remote_host="SOURCE_IP" - IP adresa izvornog servera.
  • --remote_port="SSH_PORT" - SSH port.
  • --remote_username="SSH_USER" - Korisnik (mora biti root).
  • --remote_password="USER_PASSWORD" - Lozinka za navedenog SSH korisnika.
  • --ssh_key_path="PATH_TO_KEY" - Putanja do privatnog SSH ključa na odredišnom serveru za povezivanje sa izvornim serverom. Ako se koristi ključ, lozinka (--remote_password) nije potrebna.

IP adrese

Morate koristiti samo jednu od sledećih oznaka za upravljanje IP adresama sajtova tokom prenosa. Oznaka -m ima prioritet.

  • -i "IP_ADDRESS_ON_DESTINATION" - Dodeljuje navedenu IP adresu svim prenetim sajtovima na odredišnom serveru. Da biste naveli više IP adresa (npr. ako ih je bilo više na izvornom serveru), ponovite oznaku za svaku izvornu IP adresu koju treba preneti.

  • -m "SOURCE_IP,DESTINATION_IP" - Preporučeni metod. Uspostavlja direktno mapiranje: svi sajtovi koji koriste SOURCE_IP na izvornom serveru koristiće DESTINATION_IP na odredišnom serveru. Ova oznaka može se navesti više puta za različite IP parove. Obavezna je za prenos sajtova sa ručnim izmenama konfiguracije, jer omogućava ispravnu zamenu IP adresa u listen direktivama.

Dodatna podešavanja

  • --users="USER_LIST" - Prenosi samo navedene korisnike (odvojene zarezima). Ako nije navedeno, prenose se svi korisnici.
  • --disable_disk_quota - Onemogućava prenos disk kvota korisnika.
  • --with_user_data - Uključuje kopiranje celokupnog sadržaja korisničkih home direktorijuma (osim poddirektorijuma logs/). Koristite sa oprezom, jer ovo može značajno povećati vreme prenosa i količinu prenetih podataka.
  • --only_data - Prenosi samo podatke (fajlove veb-sajtova, fajlove pošte, dump-ove baza podataka). Korisno ako je početna migracija strukture (korisnici, sajtovi, baze podataka itd.) bila uspešna, ali su se pojavile greške tokom faze kopiranja fajlova ili dump-ova. Omogućava ponovno pokretanje samo dela za kopiranje podataka.
  • --transfer_timeout - Podesite vremensko ograničenje operacije (podrazumevano je 60 minuta).

Primer komande

Prenesite sve korisnike sa servera 11.22.33.44 na trenutni server. Na starom serveru, sajtovi su koristili IP adrese 11.22.33.44 i 11.22.33.55; na novom serveru treba da koriste 99.88.77.66 i 99.88.77.67 redom. Povezivanje putem SSH-a sa lozinkom.

/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

Mogući problemi i tipovi grešaka

Greška u dnevniku migracije ne ukazuje uvek na kritičan problem, već može ukazivati na razlog zašto određeni objekat nije prenet.

  • Konflikti: Nastaju kada je prenos objekta nemoguć zbog trenutne konfiguracije odredišnog servera (npr. korisnik ili sajt sa istim imenom već postoji) ili ako je konfiguracija sajta na izvornom serveru nepoznata panelu (npr. zbog opsežnih ručnih izmena).

  • Nedostaje sačuvana lozinka: Kao što je ranije pomenuto, MySQL korisnici baze podataka bez sačuvane lozinke u FASTPANEL-u na izvornom serveru ne mogu se preneti.

  • Ručna podešavanja i IP adrese: Ako sajt na izvornom serveru ima ručne izmene konfiguracije veb-servera i oznaka -m se ne koristi tokom migracije za mapiranje njegove IP adrese, takav sajt neće biti prenet jer panel ne zna koju IP adresu da navede u konfiguraciji na odredišnom serveru.

Opis

Na ovoj stranici

FASTPANEL pruža interfejs komandne linije (CLI) implementiran putem uslužnog programa mogwai (/usr/local/bin/mogwai). Uslužni program će raditi samo kada se pokreće kao root.

Pomoć

Da biste videli listu dostupnih komandi, koristite:

mogwai --help

Da biste saznali više o određenoj komandi, koristite:

mogwai command --help

Da biste videli listu komandi sa opisima, koristite:

mogwai --help-long

Veb-sajtovi

Na ovoj stranici

Izlistavanje sajtova na serveru

Komanda

mogwai sites list

Primer izlaza

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

Napomena: Sajt IDs sa ove liste koristi se u drugim komandama.

Kreiranje novog sajta

Komanda

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

Opcije

  • --owner : Korisnik na FASTPANEL sistemu koji će biti vlasnik sajta.
  • --server-name=SERVER-NAME : Naziv domena za sajt.
  • -a, --alias=ALIAS : Aliasi za sajt, kao što su www poddomeni. Može se navesti više aliasa.
  • --ip=IP : IP adresa servera na kojem će sajt raditi. Može se navesti više IP adresa.
  • -h, --handler=HANDLER : Backend handler. Može biti:
    • PHP: cgi,mpm_itk,php_fpm,fcgi;
    • Node.js: standalone,pm2;
    • Systemd: systemd.
  • --handler_version=HANDLER_VERSION : PHP ili Node.js verzija (npr. 8.2, 8.3, 20.15.1).
  • --create-user : Kreira korisnika za sajt.

Primer komande

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

Brisanje sajta

Komanda

mogwai sites delete --id=ID

Sajt ID može se dobiti iz komande mogwai sites list.

Primer komande

mogwai sites delete --id=987

Ova komanda će obrisati sajt sa ID-jem 987

Izmena podešavanja sajta

Komanda

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

Sajt ID može se dobiti iz komande mogwai sites list.

Opcije

  • -i, --id=ID : ID sajta.
  • -a, --add-alias=ADD-ALIAS : Dodaje alias, može se navesti više aliasa.
  • --del-alias=DEL-ALIAS : Briše alias, može se navesti više aliasa.
  • --add-ip=ADD-IP : Dodaje IP adresu iz podešavanja sajta, može se navesti više IP adresa.
  • --del-ip=DEL-IP : Briše IP adresu iz podešavanja sajta, može se navesti više IP adresa.
  • -h, --handler=HANDLER : Backend handler. Može biti:
    • PHP: cgi,mpm_itk,php_fpm,fcgi;
    • Node.js: standalone,pm2;
    • Systemd: systemd.
  • --handler_version=HANDLER_VERSION : PHP ili Node.js verzija (npr. 8.2, 8.3, 20.15.1).
  • --gzip : Omogućava kompresiju.
  • --no-gzip : Onemogućava kompresiju.
  • --gzip-comp-level=LEVEL : Podešava nivo kompresije, 1-9.
  • --expires=EXPIRES : Podešava vreme keširanja za statički sadržaj.
  • --worker-count=WORKER-COUNT : Podešava broj worker procesa za PHP-FPM

Takođe možete ažurirati podešavanja za više sajtova na serveru pomoću komande

mogwai sites batch-update
  • Da biste promenili podešavanja za sve sajtove, koristite oznaku -a.
  • Da biste promenili podešavanja za izabrane sajtove, navedite više oznaka --id sa njihovim IDs.

Primer komande

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

Ova komanda će dodati alias www1.example.com, promeniti handler na cgi i PHP verziju na 5.6 za sajt sa ID-jem 3

Primer komande

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

Ova komanda će promeniti PHP handler za sajtove sa ID-jevima 2 i 3