FASTPANELWIKI

CLI

Kuvaus

Tällä sivulla

FASTPANEL tarjoaa komentorivikäyttöliittymän (CLI), joka on toteutettu mogwai-apuohjelman kautta (/usr/local/bin/mogwai). Apuohjelma toimii vain, kun se suoritetaan käyttäjänä root.

Ohje

Näet käytettävissä olevien komentojen luettelon komennolla:

mogwai --help

Saat lisätietoja tietystä komennosta komennolla:

mogwai command --help

Näet komentojen luettelon kuvauksineen komennolla:

mogwai --help-long

Käyttäjien siirtäminen FASTPANEL-palvelimien välillä

Tällä sivulla

Johdanto

Tässä artikkelissa kuvataan käyttäjätilien ja niihin liittyvien tietojen (verkkosivustot, tietokannat, sähköposti jne.) siirtoprosessi yhdeltä FASTPANEL-palvelimelta toiselle sisäänrakennetun siirtotyökalun avulla.

Keskeiset termit

  • Lähdepalvelin - Palvelin, jolta tietoja siirretään.
  • Kohdepalvelin - Palvelin, jolle tietoja siirretään.

Tärkeitä huomautuksia

  • Oletusarvoisesti migraatio toimii oikein vain sivustoille, joissa on FASTPANELin vakiokokoonpano.

  • Sivustot, joissa on manuaalisia kokoonpanomuutoksia, voidaan siirtää vain, jos IP-osoitteiden yhdistämiseen käytetään lippua -m.

  • Jos tietokannan omistajan salattua salasanaa ei ole saatavilla, tietokantaa ei siirretä.

  • Jos verkkosivustoa ei siirretä, myöskään siihen liittyviä tietokantoja ei siirretä.

  • Vain paikallisia tietokantoja voidaan siirtää.

Migraatioprosessi

Yhteys

Kohdepalvelin muodostaa yhteyden lähdepalvelimeen SSH:n kautta. Ensimmäisen yhteyden aikana kohdepalvelin asentaa SSH-avaimen lähdepalvelimeen (joko etukäteen annetun tai salasanasta luodun).

Migraation vaiheet

  • Moduulin asennus
  • Siirrettävien objektien tietojen kerääminen
  • Käyttäjien luominen
  • SSL-varmenteiden siirtäminen
  • Verkkosivustojen, FTP-tilien, sähköpostiverkkotunnusten ja sähköpostitilien luominen
  • Tietokantojen ja tietokantakäyttäjien luominen
  • Verkkosivuston tiedostojen ja sähköpostilaatikkotiedostojen siirtäminen
  • Cron-tehtävien siirtäminen

Tiedostojen siirto suoritetaan käyttäen rsync. Tietokannat siirretään luomalla vedos SSH-tunnelin kautta.

Komento migraation käynnistämiseen

Komento suoritetaan kohdepalvelimella käyttäjänä, jolla on root-oikeudet:

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

Komentoriviliput

SSH-yhteys

  • --remote_host="SOURCE_IP" - Lähdepalvelimen IP-osoite.
  • --remote_port="SSH_PORT" - SSH-portti.
  • --remote_username="SSH_USER" - Käyttäjä (täytyy olla root).
  • --remote_password="USER_PASSWORD" - Määritetyn SSH-käyttäjän salasana.
  • --ssh_key_path="PATH_TO_KEY" - Polku kohdepalvelimen yksityiseen SSH-avaimeen yhteyden muodostamiseksi lähdepalvelimeen. Jos avainta käytetään, salasanaa (--remote_password) ei tarvita.

IP-osoitteet

Sinun on käytettävä vain yhtä seuraavista lipuista sivustojen IP-osoitteiden hallintaan siirron aikana. Lippu -m on ensisijainen.

  • -i "IP_ADDRESS_ON_DESTINATION" - Määrittää annetun IP-osoitteen kaikille kohdepalvelimelle siirretyille sivustoille. Jos haluat määrittää useita IP-osoitteita (esim. jos lähteessä niitä oli useita), toista lippu jokaiselle lähde-IP-osoitteelle, joka on siirrettävä.

  • -m "SOURCE_IP,DESTINATION_IP" - Suositeltu menetelmä. Määrittää suoran yhdistämisen: kaikki sivustot, jotka käyttävät SOURCE_IP-osoitetta lähdepalvelimella, käyttävät DESTINATION_IP-osoitetta kohdepalvelimella. Tämä lippu voidaan määrittää useita kertoja eri IP-pareille. Pakollinen siirrettäessä sivustoja, joissa on manuaalisia kokoonpanomuokkauksia, sillä sen avulla IP-osoitteet voidaan korvata oikein listen-direktiiveissä.

Lisäasetukset

  • --users="USER_LIST" - Siirtää vain määritetyt käyttäjät (pilkuilla erotettuna). Jos tätä ei ole määritetty, kaikki käyttäjät siirretään.
  • --disable_disk_quota - Poistaa käyttäjien levykiintiöiden siirron käytöstä.
  • --with_user_data - Sisältää käyttäjien kotihakemistojen koko sisällön kopioinnin (lukuun ottamatta alihakemistoa logs/). Käytä varoen, sillä tämä voi merkittävästi lisätä siirtoaikaa ja siirrettävän datan määrää.
  • --only_data - Siirtää vain datan (verkkosivustotiedostot, sähköpostitiedostot, tietokantavedokset). Hyödyllinen, jos alkuperäinen rakenteen migraatio (käyttäjät, sivustot, tietokannat jne.) onnistui, mutta tiedostojen tai vedosten kopiointivaiheessa ilmeni virheitä. Mahdollistaa vain datan kopiointiosan suorittamisen uudelleen.
  • --transfer_timeout - Aseta toiminnon aikakatkaisu (oletus on 60 minuuttia).

Esimerkkikomento

Siirrä kaikki käyttäjät palvelimelta 11.22.33.44 nykyiselle palvelimelle. Vanhalla palvelimella sivustot käyttivät IP-osoitteita 11.22.33.44 ja 11.22.33.55; uudella palvelimella niiden tulisi käyttää vastaavasti osoitteita 99.88.77.66 ja 99.88.77.67. Yhteys SSH:n kautta salasanalla.

/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

Mahdolliset ongelmat ja virhetyypit

Migraatiolokissa oleva virhe ei aina tarkoita kriittistä ongelmaa, vaan voi osoittaa syyn siihen, miksi tiettyä objektia ei siirretty.

  • Ristiriidat: Näitä ilmenee, kun objektin siirtäminen on mahdotonta kohdepalvelimen nykyisen kokoonpanon vuoksi (esim. samanniminen käyttäjä tai sivusto on jo olemassa) tai jos lähdepalvelimen sivuston kokoonpano on paneelille tuntematon (esim. laajojen manuaalisten muokkausten vuoksi).

  • Tallennettu salasana puuttuu: Kuten aiemmin mainittiin, lähdepalvelimen FASTPANELiin tallennettua salasanaa vailla olevia MySQL-tietokantakäyttäjiä ei voida siirtää.

  • Manuaaliset asetukset ja IP-osoitteet: Jos lähdepalvelimen sivustolla on manuaalisia verkkopalvelimen kokoonpanomuokkauksia eikä migraation aikana käytetä lippua -m sen IP-osoitteen yhdistämiseen, tällaista sivustoa ei siirretä, koska paneeli ei tiedä, mikä IP-osoite kohdepalvelimen kokoonpanossa pitäisi määrittää.

Käyttäjät

Tällä sivulla

Uuden käyttäjän luominen

Komento

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

Valinnat

  • -u, --username=USERNAME : Määritä uuden käyttäjän käyttäjänimi.
  • -p, --password=PASSWORD : Määritä uuden käyttäjän salasana.
  • -r, --role="USER" : Määritä uuden käyttäjän rooli. Tuetut roolit ovat RESELLER ja USER. Oletusrooli on USER.

Käyttötiedot

Voit luoda uuden käyttäjän käyttäjänimellä testuser, salasanalla My$ecretPassword123 ja roolilla RESELLER käyttämällä seuraavaa komentoa:

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

Lisähuomautukset

  • Käyttäjänimien on oltava yksilöllisiä, eivätkä ne saa sisältää välilyöntejä tai pisteitä.
  • Salasanojen on oltava vähintään 8 merkkiä pitkiä. Suosittelemme käyttämään vähintään yhtä isoa kirjainta, yhtä pientä kirjainta, yhtä numeroa ja yhtä erikoismerkkiä.

Sivustot

Tällä sivulla

Palvelimen sivustojen luetteloiminen

Komento

mogwai sites list

Esimerkkituloste

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

Huomautus: Tämän luettelon sivustoa IDs käytetään muissa komennoissa.

Uuden sivuston luominen

Komento

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

Valinnat

  • --owner : FASTPANEL-järjestelmän käyttäjä, joka omistaa sivuston.
  • --server-name=SERVER-NAME : Sivuston verkkotunnus.
  • -a, --alias=ALIAS : Sivuston aliakset, kuten www-aliverkkotunnukset. Voit määrittää useita aliaksia.
  • --ip=IP : Sen palvelimen IP-osoite, jolla sivusto toimii. Voit määrittää useita IP-osoitteita.
  • -h, --handler=HANDLER : Taustajärjestelmän käsittelijä. Voi olla:
    • PHP: cgi,mpm_itk,php_fpm,fcgi;
    • Node.js: standalone,pm2;
    • Systemd: systemd.
  • --handler_version=HANDLER_VERSION : PHP- tai Node.js -versio (esim. 8.2, 8.3, 20.15.1).
  • --create-user : Luo käyttäjä sivustolle.

Esimerkkikomento

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

Sivuston poistaminen

Komento

mogwai sites delete --id=ID

Sivuston ID voi saada komennolla mogwai sites list.

Esimerkkikomento

mogwai sites delete --id=987

Tämä komento poistaa sivuston, jonka tunnus on 987

Sivuston asetusten muokkaaminen

Komento

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

Sivuston ID voi saada komennolla mogwai sites list.

Valinnat

  • -i, --id=ID : Sivuston tunnus.
  • -a, --add-alias=ADD-ALIAS : Lisää alias, useita aliaksia voidaan määrittää.
  • --del-alias=DEL-ALIAS : Poista alias, useita aliaksia voidaan määrittää.
  • --add-ip=ADD-IP : Lisää IP-osoite sivuston asetuksista, useita IP-osoitteita voidaan määrittää.
  • --del-ip=DEL-IP : Poista IP-osoite sivuston asetuksista, useita IP-osoitteita voidaan määrittää.
  • -h, --handler=HANDLER : Taustajärjestelmän käsittelijä. Voi olla:
    • PHP: cgi,mpm_itk,php_fpm,fcgi;
    • Node.js: standalone,pm2;
    • Systemd: systemd.
  • --handler_version=HANDLER_VERSION : PHP- tai Node.js -versio (esim. 8.2, 8.3, 20.15.1).
  • --gzip : Ota pakkaus käyttöön.
  • --no-gzip : Poista pakkaus käytöstä.
  • --gzip-comp-level=LEVEL : Aseta pakkaustaso välille 1-9.
  • --expires=EXPIRES : Aseta staattisen sisällön välimuistiaika.
  • --worker-count=WORKER-COUNT : Aseta PHP-FPM:n workerien määrä

Voit myös päivittää palvelimen useiden sivustojen asetuksia komennolla

mogwai sites batch-update
  • Jos haluat muuttaa kaikkien sivustojen asetuksia, käytä lippua -a.
  • Jos haluat muuttaa valittujen sivustojen asetuksia, määritä useita --id-lippuja niiden IDs-arvoilla.

Esimerkkikomento

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

Tämä komento lisää aliaksen www1.example.com, vaihtaa käsittelijäksi cgi:n ja PHP-versioksi 5.6 sivustolle, jonka tunnus on 3

Esimerkkikomento

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

Tämä komento vaihtaa PHP-käsittelijän sivustoille, joiden tunnukset ovat 2 ja 3

Sähköposti

Tällä sivulla

Sähköpostiverkkotunnusten luettelon hakeminen

Komento

mogwai emails domains list

Esimerkkituloste

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

Verkkotunnusta IDs käytetään muissa komennoissa.

Sähköpostiverkkotunnuksen lisääminen

Komento

mogwai emails domains create

Valinnat

  • --domain=DOMAIN : Sähköpostiverkkotunnuksen nimi.
  • -o, --owner="fastuser" : FASTPANEL-käyttäjä, jolle sähköpostiverkkotunnus lisätään.

Esimerkki sähköpostiverkkotunnuksen example1.com luomisesta fastuser-käyttäjälle

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

Postilaatikoiden luettelon hakeminen

Komento

mogwai emails boxes list

Valinnat

  • --domain=DOMAIN : Postiverkkotunnuksen nimi

Esimerkkikomento

mogwai emails boxes list --domain example.com

Esimerkkituloste

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

Komennon tulosteesta saatua ID käytetään muissa komennoissa.

Postilaatikon luominen

Komento

mogwai emails boxes create

Valinnat

  • --domain=DOMAIN : Sähköpostiverkkotunnuksen nimi.
  • -l, --login=LOGIN : Postilaatikon nimi ilman verkkotunnusta.
  • -p, --password=PASSWORD : Postilaatikon salasana.

Esimerkkikomento

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

Tämä komento luo postilaatikon nimeltä user@example.com salasanalla MySecretPassword123.

Postilaatikon poistaminen

Komento

mogwai emails boxes delete

Valinnat

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

Esimerkkikomento

mogwai emails boxes delete -b 1

Tämä komento poistaa postilaatikon, jonka ID on 1.

Postilaatikoiden ja sähköpostien tuominen

Komento

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

Valinnat

  • -i, --import_config=IMPORT_CONFIG : Tuontiluettelotiedoston polku
  • --force : Vain tilassa import - tyhjennä olemassa olevat postilaatikot.

Sähköpostin tuontia varten sinun on valmisteltava palvelimelle postilaatikkoluettelo seuraavassa muodossa:

IMAP_HOST;SOURCE_ADDR;SOURCE_PASSWORD;DEST_ADDR

Valinnat

  • IMAP_HOST : IMAP-postipalvelimen osoite.
  • SOURCE_ADDR : Postilaatikko lähdepalvelimella.
  • SOURCE_PASSWORD : Salasana IMAP-yhteydelle lähdepalvelimen postilaatikkoon. Jotkin palvelut, kuten Google, edellyttävät sovelluskohtaisen salasanan luomista IMAP-käyttöä varten https://support.google.com/accounts/answer/185833?hl=en
  • DEST_ADDR : Postilaatikko FASTPANEL-palvelimella, johon viestit siirretään.

Esimerkkitiedoston sisältö

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

Käytettävissä on kaksi tilaa:

Tuontitila

mogwai emails boxes import

Tässä tilassa kaikki viestit kopioidaan kokonaisuudessaan, FASTPANEL-palvelimen postilaatikoita ei saa olla luotu tai niiden on oltava tyhjiä - komentoa suoritettaessa FASTPANEL luo tarvittavat postilaatikot. Jos sisältöä sisältäviä postilaatikoita on jo olemassa, näytetään virhe. Voit käyttää lippua --force - silloin postilaatikko tyhjennetään.

Esimerkki komennon suorittamisesta käyttäen tiedostoon /root/import.txt tallennettua postilaatikkoluetteloa ja avainta --force

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

Synkronointitila

mogwai emails boxes sync

Tässä tilassa Ohjauspaneeli lataa viestit lähdepalvelimelta poistamatta mitään. Sitä tulisi käyttää, jos alkuperäiseen postilaatikkoon on ilmestynyt uusia viestejä ensimmäisen tuonnin jälkeen ja nekin on siirrettävä.

Esimerkkikomento

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

Tietokannat

Tällä sivulla

Tietokantapalvelimien luettelon hakeminen

Komento

mogwai databases servers list

Esimerkkituloste

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

Palvelinta IDs käytetään muissa komennoissa.

Tietokantojen luettelon hakeminen

Komento

mogwai databases list

Esimerkkituloste

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

Tietokantaluettelon synkronointi

Jos olet äskettäin lisännyt tai poistanut tietokantoja eikä niitä vielä näy FASTPANELissa, voit pakottaa luetteloiden synkronoinnin

Komento

mogwai databases sync

Uuden tietokannan luominen

Komento

mogwai databases create [flags]

Valinnat

  • -n, --name=NAME : Tietokannan nimi.
  • -o, --owner="fastuser" :  FASTPANEL-käyttäjä, jolle tietokanta lisätään.
  • -s, --site=SITE : FASTPANELissa oleva sivusto, johon tietokanta lisätään.
  • -c, --charset="utf8mb4" : Tietokannan merkistökoodaus.
  • -u, --username=USERNAME : Tietokannan käyttäjätunnus.
  • -p, --password=PASSWORD : Tietokannan käyttäjän salasana.

Esimerkkikomento

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

Tämä komento luo tietokannan nimeltä db1 oletustietokantapalvelimelle (--server=1) ja "liittää" sen example.com-sivustoon.