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 --helpSaat lisätietoja tietystä komennosta komennolla:
mogwai command --helpNäet komentojen luettelon kuvauksineen komennolla:
mogwai --help-longKä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 alihakemistoalogs/). 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.67Mahdolliset 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
-msen 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 listEsimerkkituloste
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.comHuomautus: 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.
- PHP:
--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.3Sivuston poistaminen
Komento
mogwai sites delete --id=IDSivuston ID voi saada komennolla mogwai sites list.
Esimerkkikomento
mogwai sites delete --id=987Tä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.
- PHP:
--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 niidenIDs-arvoilla.
Esimerkkikomento
mogwai sites update --id=1 -a www1.example.com -h cgi --handler_version=5.6Tä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 2Tä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 listEsimerkkituloste
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:00Verkkotunnusta IDs käytetään muissa komennoissa.
Sähköpostiverkkotunnuksen lisääminen
Komento
mogwai emails domains createValinnat
--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 fastuserPostilaatikoiden luettelon hakeminen
Komento
mogwai emails boxes listValinnat
--domain=DOMAIN: Postiverkkotunnuksen nimi
Esimerkkikomento
mogwai emails boxes list --domain example.comEsimerkkituloste
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:00Komennon tulosteesta saatua ID käytetään muissa komennoissa.
Postilaatikon luominen
Komento
mogwai emails boxes createValinnat
--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=MySecretPassword123Tämä komento luo postilaatikon nimeltä user@example.com salasanalla MySecretPassword123.
Postilaatikon poistaminen
Komento
mogwai emails boxes deleteValinnat
-b,--box=BOX: Postilaatikon ID..
Esimerkkikomento
mogwai emails boxes delete -b 1Tä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 tilassaimport- tyhjennä olemassa olevat postilaatikot.
Sähköpostin tuontia varten sinun on valmisteltava palvelimelle postilaatikkoluettelo seuraavassa muodossa:
IMAP_HOST;SOURCE_ADDR;SOURCE_PASSWORD;DEST_ADDRValinnat
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=enDEST_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.comKäytettävissä on kaksi tilaa:
Tuontitila
mogwai emails boxes importTä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 --forceSynkronointitila
mogwai emails boxes syncTä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.txtTietokannat
Tällä sivulla
Tietokantapalvelimien luettelon hakeminen
Komento
mogwai databases servers listEsimerkkituloste
ID NAME TYPE LOCAL HOST USERNAME AVAIL
1 mysql(localhost) mysql true fastuser true
2 postgresql(localhost) postgresql true fastuser truePalvelinta IDs käytetään muissa komennoissa.
Tietokantojen luettelon hakeminen
Komento
mogwai databases listEsimerkkituloste
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 UTCTietokantaluettelon synkronointi
Jos olet äskettäin lisännyt tai poistanut tietokantoja eikä niitä vielä näy FASTPANELissa, voit pakottaa luetteloiden synkronoinnin
Komento
mogwai databases syncUuden 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 dbpassword1Tämä komento luo tietokannan nimeltä db1 oletustietokantapalvelimelle (--server=1) ja "liittää" sen example.com-sivustoon.
FASTPANEL