FASTPANELWIKI

CLI

Adatbázisok

Ezen az oldalon

Adatbázis-kiszolgálók listájának lekérése

Parancs

mogwai databases servers list

Példakimenet

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

A IDs kiszolgáló más parancsokban használatos.

Adatbázisok listájának lekérése

Parancs

mogwai databases list

Példakimenet

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

Az adatbázislista szinkronizálása

Ha nemrég adatbázisokat adott hozzá vagy távolított el, és azok még nem jelentek meg a FASTPANEL-ben, kényszerítheti a listák szinkronizálását

Parancs

mogwai databases sync

Új adatbázis létrehozása

Parancs

mogwai databases create [flags]

Beállítások

  • -n, --name=NAME : Az adatbázis neve.
  • -o, --owner="fastuser" :  FASTPANEL-felhasználó, akihez az adatbázis hozzá lesz adva.
  • -s, --site=SITE : A FASTPANEL-ben lévő webhely, amelyhez az adatbázis hozzá lesz adva.
  • -c, --charset="utf8mb4" : Az adatbázis kódolása.
  • -u, --username=USERNAME : Adatbázis-felhasználónév.
  • -p, --password=PASSWORD : Az adatbázis-felhasználó jelszava.

Példaparancs

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

Ez a parancs létrehoz egy db1 nevű adatbázist az alapértelmezett adatbázis-kiszolgálón (--server=1), és azt az example.com webhelyhez "rendeli".

Leírás

Ezen az oldalon

A FASTPANEL parancssori felületet (CLI) biztosít, amely a mogwai segédprogramon (/usr/local/bin/mogwai) keresztül valósul meg. A segédprogram csak akkor működik, ha root felhasználóként futtatják.

Súgó

Az elérhető parancsok listájának megtekintéséhez használja a következőt:

mogwai --help

Egy adott parancsról további információkért használja a következőt:

mogwai command --help

A parancsok listájának leírásokkal együtt történő megtekintéséhez használja a következőt:

mogwai --help-long

E-mail

Ezen az oldalon

E-mail-tartományok listájának lekérése

Parancs

mogwai emails domains list

Példakimenet

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

A IDs tartomány más parancsokban is használatos.

E-mail-tartomány hozzáadása

Parancs

mogwai emails domains create

Beállítások

  • --domain=DOMAIN : E-mail-tartomány neve.
  • -o, --owner="fastuser" : Az a FASTPANEL felhasználó, amelyhez az e-mail-tartomány hozzá lesz adva.

Példa e-mail-tartomány létrehozására: example1.com a fastuser felhasználó alatt

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

Postaládák listájának lekérése

Parancs

mogwai emails boxes list

Beállítások

  • --domain=DOMAIN : Levelezési tartomány neve

Példaparancs

mogwai emails boxes list --domain example.com

Példakimenet

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

A parancs kimenetéből származó ID más parancsokban is használatos.

Postaláda létrehozása

Parancs

mogwai emails boxes create

Beállítások

  • --domain=DOMAIN : E-mail-tartomány neve.
  • -l, --login=LOGIN : A postaláda neve, tartomány nélkül.
  • -p, --password=PASSWORD : A postaláda jelszava.

Példaparancs

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

Ez a parancs létrehoz egy user@example.com nevű postaládát MySecretPassword123 jelszóval.

Postaláda törlése

Parancs

mogwai emails boxes delete

Beállítások

  • -b, --box=BOX : A postaláda azonosítója..

Példaparancs

mogwai emails boxes delete -b 1

Ez a parancs törli az 1 azonosítójú postaládát.

Postaládák és e-mailek importálása

Parancs

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

Beállítások

  • -i, --import_config=IMPORT_CONFIG : Az importlista-fájl elérési útja
  • --force : Csak import módhoz - a meglévő postaládák törlése.

A levelek importálásához elő kell készítenie a kiszolgálón lévő postaládák listáját a következő formátumban:

IMAP_HOST;SOURCE_ADDR;SOURCE_PASSWORD;DEST_ADDR

Beállítások

  • IMAP_HOST : Az IMAP levelezőszerver címe.
  • SOURCE_ADDR : Postaláda a forráskiszolgálón.
  • SOURCE_PASSWORD : Jelszó a forráskiszolgálón lévő postaládához történő IMAP-kapcsolathoz. Egyes szolgáltatások, például a Google, alkalmazásjelszó létrehozását igénylik az IMAP-hozzáféréshez: https://support.google.com/accounts/answer/185833?hl=en
  • DEST_ADDR : Az a postaláda a FASTPANEL-kiszolgálón, amelybe az üzenetek átkerülnek.

Példa fájltartalom

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

Két mód érhető el:

Importálási mód

mogwai emails boxes import

Ebben a módban az összes üzenet teljes egészében másolásra kerül, a FASTPANEL-kiszolgálón lévő postaládákat nem szabad létrehozni, vagy üresnek kell lenniük - a parancs végrehajtásakor a FASTPANEL létrehozza a szükséges postaládákat. Ha már léteznek tartalommal rendelkező postaládák, hibaüzenet jelenik meg. Használhatja a --force jelzőt - ekkor a postaláda törlésre kerül.

Példa a parancs futtatására a /root/import.txt fájlban tárolt postaládalistával és a --force kulcs használatával

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

Szinkronizálási mód

mogwai emails boxes sync

Ebben a módban a Vezérlőpult letölti az üzeneteket a forráskiszolgálóról anélkül, hogy bármit törölne. Akkor érdemes használni, ha az első importálás után új üzenetek jelentek meg az eredeti postaládában, amelyeket szintén át kell vinni.

Példaparancs

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

Felhasználók

Ezen az oldalon

Új felhasználó létrehozása

Parancs

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

Beállítások

  • -u, --username=USERNAME : Adja meg az új felhasználó felhasználónevét.
  • -p, --password=PASSWORD : Adja meg az új felhasználó jelszavát.
  • -r, --role="USER" : Adja meg az új felhasználó szerepkörét. A támogatott szerepkörök: RESELLER és USER. Az alapértelmezett szerepkör a USER.

Használati információk

Új felhasználó létrehozásához a(z) testuser felhasználónévvel, My$ecretPassword123 jelszóval és RESELLER szerepkörrel használja a következő parancsot:

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

További megjegyzések

  • A felhasználóneveknek egyedieknek kell lenniük, és nem tartalmazhatnak szóközt vagy pontot.
  • A jelszónak legalább 8 karakter hosszúnak kell lennie. Javasoljuk, hogy legalább egy nagybetűt, egy kisbetűt, egy számot és egy speciális karaktert használjon.

Felhasználók átvitele FASTPANEL szerverek között

Ezen az oldalon

Bevezetés

Ez a cikk a felhasználói fiókok és a hozzájuk tartozó adatok (webhelyek, adatbázisok, e-mail stb.) átvitelének folyamatát ismerteti egyik FASTPANEL szerverről egy másikra a beépített migrációs segédprogram használatával.

Kulcsfogalmak

  • Forrásszerver - Az a szerver, amelyről az adatok átvitele történik.
  • Célszerver - Az a szerver, amelyre az adatok átvitele történik.

Fontos megjegyzések

  • Alapértelmezés szerint a migráció csak a szabványos FASTPANEL-konfigurációval rendelkező webhelyek esetén működik megfelelően.

  • A kézi konfigurációs módosításokkal rendelkező webhelyek csak akkor vihetők át, ha az IP-címek leképezéséhez a -m jelzőt használják.

  • Ha egy adatbázis tulajdonosának titkosított jelszava nem áll rendelkezésre, az adatbázis nem kerül átvitelre.

  • Ha egy webhely nem kerül átvitelre, a hozzá tartozó adatbázisok sem kerülnek átvitelre.

  • Csak helyi adatbázisok vihetők át.

Migrációs folyamat

Kapcsolódás

A célszerver SSH-n keresztül csatlakozik a forrásszerverhez. Az első csatlakozás során a célszerver egy SSH-kulcsot telepít a forrásszerverre (vagy előre megadottat, vagy jelszóból generáltat).

Migrációs lépések

  • Modultelepítés
  • Információk gyűjtése az átvihető objektumokról
  • Felhasználók létrehozása
  • SSL-tanúsítványok átvitele
  • Webhelyek, FTP-fiókok, e-mail-tartományok és e-mail-fiókok létrehozása
  • Adatbázisok és adatbázis-felhasználók létrehozása
  • Webhely- és e-mail-postafiókfájlok átvitele
  • Cron feladatok átvitele

A fájlátvitel a rsync használatával történik. Az adatbázisok átvitele dump létrehozásával történik egy SSH-alagúton keresztül.

Parancs a migráció indításához

A parancsot a célszerveren kell futtatni root jogosultságokkal rendelkező felhasználóként:

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

Parancssori jelzők

SSH-kapcsolat

  • --remote_host="SOURCE_IP" - A forrásszerver IP-címe.
  • --remote_port="SSH_PORT" - SSH-port.
  • --remote_username="SSH_USER" - Felhasználó (rootnak kell lennie).
  • --remote_password="USER_PASSWORD" - A megadott SSH-felhasználó jelszava.
  • --ssh_key_path="PATH_TO_KEY" - A célszerveren található privát SSH-kulcs elérési útja a forrásszerverhez való csatlakozáshoz. Ha kulcsot használ, a jelszó (--remote_password) nem szükséges.

IP-címek

Az átvitel során a webhelyek IP-címeinek kezeléséhez csak az alábbi jelzők egyikét kell használnia. A -m jelző elsőbbséget élvez.

  • -i "IP_ADDRESS_ON_DESTINATION" - A megadott IP-címet rendeli hozzá az összes átvitt webhelyhez a célszerveren. Több IP megadásához (pl. ha a forráson több is volt), ismételje meg a jelzőt minden egyes forrás IP-címhez, amelyet át kell vinni.

  • -m "SOURCE_IP,DESTINATION_IP" - Ajánlott módszer. Közvetlen leképezést hoz létre: minden olyan webhely, amely a forrásszerveren a SOURCE_IP címet használja, a célszerveren a DESTINATION_IP címet fogja használni. Ez a jelző különböző IP-párokhoz többször is megadható. Kötelező a kézi konfigurációs szerkesztésekkel rendelkező webhelyek átviteléhez, mivel lehetővé teszi az IP-címek helyes cseréjét a listen direktívákban.

További beállítások

  • --users="USER_LIST" - Csak a megadott felhasználókat viszi át (vesszővel elválasztva). Ha nincs megadva, az összes felhasználó átvitelre kerül.
  • --disable_disk_quota - Letiltja a felhasználói lemezkvóták átvitelét.
  • --with_user_data - Tartalmazza a felhasználói home könyvtárak teljes tartalmának másolását (a logs/ alkönyvtár kivételével). Óvatosan használja, mivel ez jelentősen növelheti az átviteli időt és az átvitt adatmennyiséget.
  • --only_data - Csak adatokat visz át (webhelyfájlok, levélfájlok, adatbázis-dumpok). Hasznos, ha a kezdeti struktúramigráció (felhasználók, webhelyek, adatbázisok stb.) sikeres volt, de hibák történtek a fájlok vagy dumpok másolási szakaszában. Lehetővé teszi, hogy csak az adatmásolási részt futtassa újra.
  • --transfer_timeout - Műveleti időkorlát beállítása (az alapértelmezett 60 perc).

Példaparancs

Az összes felhasználó átvitele a 11.22.33.44 szerverről az aktuális szerverre. A régi szerveren a webhelyek a 11.22.33.44 és 11.22.33.55 IP-címeket használták; az új szerveren ezeknek rendre a 99.88.77.66 és 99.88.77.67 címeket kell használniuk. Kapcsolódás SSH-n keresztül jelszóval.

/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

Lehetséges problémák és hibatípusok

A migrációs naplóban szereplő hiba nem mindig jelez kritikus problémát, de utalhat arra, hogy egy adott objektum miért nem került átvitelre.

  • Ütközések: Akkor fordulnak elő, ha egy objektum átvitele a célszerver aktuális konfigurációja miatt lehetetlen (pl. már létezik azonos nevű felhasználó vagy webhely), vagy ha a forrásszerveren lévő webhely konfigurációja a panel számára ismeretlen (pl. kiterjedt kézi szerkesztések miatt).

  • Hiányzó mentett jelszó: Ahogy korábban említettük, a forrásszerveren a FASTPANEL-ben mentett jelszó nélküli MySQL-adatbázis-felhasználók nem vihetők át.

  • Kézi beállítások és IP-címek: Ha a forrásszerveren egy webhely webkiszolgáló-konfigurációját kézzel szerkesztették, és a migráció során nem használják a -m jelzőt az IP-cím leképezéséhez, az ilyen webhely nem kerül átvitelre, mert a panel nem tudja, melyik IP-címet kell megadni a célszerveren lévő konfigurációban.

Webhelyek

Ezen az oldalon

Webhelyek listázása a szerveren

Parancs

mogwai sites list

Példakimenet

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

Megjegyzés: Az ebben a listában szereplő IDs webhelyet más parancsok használják.

Új webhely létrehozása

Parancs

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

Beállítások

  • --owner : A FASTPANEL rendszer azon felhasználója, aki a webhely tulajdonosa lesz.
  • --server-name=SERVER-NAME : A webhely domainneve.
  • -a, --alias=ALIAS : A webhely aliasai, például www aldomainjei. Több alias is megadható.
  • --ip=IP : Annak a szervernek az IP-címe, amelyen a webhely futni fog. Több IP-cím is megadható.
  • -h, --handler=HANDLER : Backend kezelő. Lehet:
    • PHP: cgi,mpm_itk,php_fpm,fcgi;
    • Node.js: standalone,pm2;
    • Systemd: systemd.
  • --handler_version=HANDLER_VERSION : PHP vagy Node.js verzió (pl. 8.2, 8.3, 20.15.1).
  • --create-user : Felhasználó létrehozása a webhelyhez.

Példaparancs

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

Webhely törlése

Parancs

mogwai sites delete --id=ID

A ID webhely lekérhető a mogwai sites list paranccsal.

Példaparancs

mogwai sites delete --id=987

Ez a parancs törli a 987 azonosítójú webhelyet

Webhelybeállítások módosítása

Parancs

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

A ID webhely lekérhető a mogwai sites list paranccsal.

Beállítások

  • -i, --id=ID : A webhely azonosítója.
  • -a, --add-alias=ADD-ALIAS : Alias hozzáadása, több alias is megadható.
  • --del-alias=DEL-ALIAS : Alias törlése, több alias is megadható.
  • --add-ip=ADD-IP : IP-cím hozzáadása a webhely beállításaihoz, több IP-cím is megadható.
  • --del-ip=DEL-IP : IP-cím törlése a webhely beállításaiból, több IP-cím is megadható.
  • -h, --handler=HANDLER : Backend kezelő. Lehet:
    • PHP: cgi,mpm_itk,php_fpm,fcgi;
    • Node.js: standalone,pm2;
    • Systemd: systemd.
  • --handler_version=HANDLER_VERSION : PHP vagy Node.js verzió (pl. 8.2, 8.3, 20.15.1).
  • --gzip : Tömörítés engedélyezése.
  • --no-gzip : Tömörítés letiltása.
  • --gzip-comp-level=LEVEL : A tömörítési szint beállítása, 1-9.
  • --expires=EXPIRES : A statikus tartalmak gyorsítótárazási idejének beállítása.
  • --worker-count=WORKER-COUNT : A PHP-FPM worker számának beállítása

A szerveren több webhely beállításait is frissítheti a következő paranccsal

mogwai sites batch-update
  • Az összes webhely beállításainak módosításához használja a -a jelölőt.
  • A kiválasztott webhelyek beállításainak módosításához adjon meg több --id jelölőt a hozzájuk tartozó IDs értékekkel.

Példaparancs

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

Ez a parancs hozzáad egy www1.example.com aliast, a handlert cgi-re módosítja, és a PHP verziót 5.6-ra állítja a 3 azonosítójú webhelyhez

Példaparancs

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

Ez a parancs módosítja a PHP kezelőt a 2 és 3 azonosítójú webhelyeknél