FASTPANELWIKI

CLI

Databáze

Na této stránce

Získání seznamu databázových serverů

Příkaz

mogwai databases servers list

Příklad výstupu

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

Server IDs se používá v dalších příkazech.

Získání seznamu databází

Příkaz

mogwai databases list

Příklad výstupu

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

Synchronizace seznamu databází

Pokud jste nedávno přidali nebo odebrali databáze a ještě se nezobrazily ve FASTPANEL, můžete vynutit synchronizaci seznamů

Příkaz

mogwai databases sync

Vytvoření nové databáze

Příkaz

mogwai databases create [flags]

Možnosti

  • -n, --name=NAME : Název databáze.
  • -o, --owner="fastuser" :  uživatel FASTPANEL, ke kterému bude databáze přidána.
  • -s, --site=SITE : Web ve FASTPANEL, ke kterému bude databáze přidána.
  • -c, --charset="utf8mb4" : Kódování databáze.
  • -u, --username=USERNAME : Uživatelské jméno databáze.
  • -p, --password=PASSWORD : Heslo uživatele databáze.

Příklad příkazu

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

Tento příkaz vytvoří databázi s názvem db1 na výchozím databázovém serveru (--server=1) a "připojí" ji k webu example.com.

E-mail

Na této stránce

Získání seznamu e-mailových domén

Příkaz

mogwai emails domains list

Příklad výstupu

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ény IDs se používají v dalších příkazech.

Přidání e-mailové domény

Příkaz

mogwai emails domains create

Možnosti

  • --domain=DOMAIN : Název e-mailové domény.
  • -o, --owner="fastuser" : Uživatel FASTPANEL, ke kterému bude e-mailová doména přidána.

Příklad vytvoření e-mailové domény example1.com pod uživatelem fastuser

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

Získání seznamu poštovních schránek

Příkaz

mogwai emails boxes list

Možnosti

  • --domain=DOMAIN : Název poštovní domény

Příklad příkazu

mogwai emails boxes list --domain example.com

Příklad výstupu

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 z výstupu příkazu se používá v dalších příkazech.

Vytvoření poštovní schránky

Příkaz

mogwai emails boxes create

Možnosti

  • --domain=DOMAIN : Název e-mailové domény.
  • -l, --login=LOGIN : Název poštovní schránky bez domény.
  • -p, --password=PASSWORD : Heslo pro poštovní schránku.

Příklad příkazu

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

Tento příkaz vytvoří poštovní schránku s názvem user@example.com a heslem MySecretPassword123.

Odstranění poštovní schránky

Příkaz

mogwai emails boxes delete

Možnosti

  • -b, --box=BOX : ID poštovní schránky..

Příklad příkazu

mogwai emails boxes delete -b 1

Tento příkaz odstraní poštovní schránku s ID 1.

Import poštovních schránek a e-mailů

Příkaz

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

Možnosti

  • -i, --import_config=IMPORT_CONFIG : Cesta k souboru se seznamem pro import
  • --force : Pouze pro režim import - vymazání existujících poštovních schránek.

Pro import pošty je třeba na serveru připravit seznam poštovních schránek ve formátu:

IMAP_HOST;SOURCE_ADDR;SOURCE_PASSWORD;DEST_ADDR

Možnosti

  • IMAP_HOST : Adresa poštovního serveru IMAP.
  • SOURCE_ADDR : Poštovní schránka na zdrojovém serveru.
  • SOURCE_PASSWORD : Heslo pro připojení IMAP k poštovní schránce na zdrojovém serveru. Některé služby, například Google, vyžadují vytvoření hesla aplikace pro přístup přes IMAP https://support.google.com/accounts/answer/185833?hl=en
  • DEST_ADDR : Poštovní schránka na serveru FASTPANEL, do které jsou zprávy přenášeny.

Příklad obsahu souboru

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

K dispozici jsou dva režimy:

Režim importu

mogwai emails boxes import

V tomto režimu se všechny zprávy zkopírují v plném rozsahu, poštovní schránky na serveru FASTPANEL nesmí být vytvořené nebo musí být prázdné - při spuštění příkazu FASTPANEL vytvoří potřebné poštovní schránky. Pokud již existují poštovní schránky s obsahem, zobrazí se chyba. Můžete použít příznak --force - potom bude poštovní schránka vymazána.

Příklad spuštění příkazu se seznamem poštovních schránek uloženým v souboru /root/import.txt a s použitím klíče --force

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

Režim synchronizace

mogwai emails boxes sync

V tomto režimu ovládací panel stahuje zprávy ze zdrojového serveru, aniž by cokoli mazal. Měl by se používat, pokud se po prvním importu v původní poštovní schránce objevily nové zprávy, které je také potřeba přenést.

Příklad příkazu

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

Přenos uživatelů mezi FASTPANEL

Na této stránce

Úvod

Tento článek popisuje proces přenosu uživatelských účtů a jejich přidružených dat (webové stránky, databáze, e-mail atd.) z jednoho serveru FASTPANEL na jiný pomocí vestavěného migračního nástroje.

Klíčové pojmy

  • Zdrojový server - Server, ze kterého se přenášejí data.
  • Cílový server - Server, na který se data přenášejí.

Důležité poznámky

  • Ve výchozím nastavení funguje migrace správně pouze pro weby se standardní konfigurací FASTPANEL.

  • Weby s ručními změnami konfigurace lze přenést pouze při použití příznaku -m pro mapování IP adres.

  • Pokud není k dispozici šifrované heslo vlastníka databáze, databáze nebude přenesena.

  • Pokud není přenesena webová stránka, nebudou přeneseny ani její přidružené databáze.

  • Přenášet lze pouze lokální databáze.

Proces migrace

Připojení

Cílový server se ke zdrojovému serveru připojuje přes SSH. Při prvním připojení cílový server nainstaluje na zdrojový server klíč SSH (buď předem poskytnutý, nebo vygenerovaný z hesla).

Kroky migrace

  • Instalace modulu
  • Shromažďování informací o přenositelných objektech
  • Vytváření uživatelů
  • Přenos certifikátů SSL
  • Vytváření webových stránek, FTP účtů, e-mailových domén a e-mailových účtů
  • Vytváření databází a uživatelů databází
  • Přenos souborů webových stránek a e-mailových schránek
  • Přenos úloh cron

Přenos souborů se provádí pomocí rsync. Databáze se přenášejí vytvořením dumpu přes SSH tunel.

Příkaz pro spuštění migrace

Příkaz se spouští na cílovém serveru jako uživatel s právy root:

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

Příznaky příkazového řádku

Připojení SSH

  • --remote_host="SOURCE_IP" - IP adresa zdrojového serveru.
  • --remote_port="SSH_PORT" - Port SSH.
  • --remote_username="SSH_USER" - Uživatel (musí být root).
  • --remote_password="USER_PASSWORD" - Heslo pro zadaného uživatele SSH.
  • --ssh_key_path="PATH_TO_KEY" - Cesta k privátnímu klíči SSH na cílovém serveru pro připojení ke zdrojovému serveru. Pokud se použije klíč, heslo (--remote_password) není potřeba.

IP adresy

Pro správu IP adres webů během přenosu musíte použít pouze jeden z následujících příznaků. Příznak -m má prioritu.

  • -i "IP_ADDRESS_ON_DESTINATION" - Přiřadí zadanou IP adresu všem přenášeným webům na cílovém serveru. Chcete-li zadat více IP adres (např. pokud jich na zdrojovém serveru bylo několik), opakujte příznak pro každou zdrojovou IP adresu, kterou je třeba přenést.

  • -m "SOURCE_IP,DESTINATION_IP" - Doporučená metoda. Vytvoří přímé mapování: všechny weby používající SOURCE_IP na zdrojovém serveru budou používat DESTINATION_IP na cílovém serveru. Tento příznak lze zadat vícekrát pro různé dvojice IP. Povinné pro přenos webů s ručními úpravami konfigurace, protože umožňuje správné nahrazení IP adres v direktivách listen.

Další nastavení

  • --users="USER_LIST" - Přenese pouze zadané uživatele (oddělené čárkami). Pokud není zadáno, přenesou se všichni uživatelé.
  • --disable_disk_quota - Zakáže přenos diskových kvót uživatelů.
  • --with_user_data - Zahrnuje kopírování celého obsahu domovských adresářů uživatelů (kromě podadresáře logs/). Používejte opatrně, protože to může výrazně prodloužit dobu přenosu a zvýšit objem přenášených dat.
  • --only_data - Přenese pouze data (soubory webových stránek, poštovní soubory, dumpy databází). Užitečné, pokud byla počáteční migrace struktury (uživatelé, weby, DB atd.) úspěšná, ale během fáze kopírování souborů nebo dumpů došlo k chybám. Umožňuje znovu spustit pouze část kopírování dat.
  • --transfer_timeout - Nastaví časový limit operace (výchozí hodnota je 60 minut).

Ukázkový příkaz

Přenese všechny uživatele ze serveru 11.22.33.44 na aktuální server. Na starém serveru weby používaly IP adresy 11.22.33.44 a 11.22.33.55; na novém serveru by měly používat postupně 99.88.77.66 a 99.88.77.67. Připojení přes SSH pomocí hesla.

/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

Možné problémy a typy chyb

Chyba v migračním protokolu neznamená vždy kritický problém, ale může poukazovat na důvod, proč nebyl konkrétní objekt přenesen.

  • Konflikty: Nastávají, když je přenos objektu nemožný kvůli aktuální konfiguraci cílového serveru (např. uživatel nebo web se stejným názvem již existuje) nebo pokud je konfigurace webu na zdrojovém serveru panelu neznámá (např. kvůli rozsáhlým ručním úpravám).

  • Chybějící uložené heslo: Jak bylo uvedeno dříve, uživatele databáze MySQL bez uloženého hesla ve FASTPANEL na zdrojovém serveru nelze přenést.

  • Ruční nastavení a IP adresy: Pokud má web na zdrojovém serveru ruční úpravy konfigurace webového serveru a během migrace se nepoužije příznak -m k namapování jeho IP adresy, takový web nebude přenesen, protože panel neví, kterou IP adresu má v konfiguraci na cílovém serveru zadat.

Uživatelé

Na této stránce

Vytvoření nového uživatele

Příkaz

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

Možnosti

  • -u, --username=USERNAME : Zadejte uživatelské jméno pro nového uživatele.
  • -p, --password=PASSWORD : Zadejte heslo pro nového uživatele.
  • -r, --role="USER" : Zadejte roli pro nového uživatele. Podporované role jsou RESELLER a USER. Výchozí role je USER.

Informace o použití

Chcete-li vytvořit nového uživatele s uživatelským jménem testuser, heslem My$ecretPassword123 a rolí RESELLER, použijte následující příkaz:

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

Další poznámky

  • Uživatelská jména musí být jedinečná a nesmí obsahovat mezery ani tečky.
  • Hesla musí mít alespoň 8 znaků. Doporučujeme použít alespoň jedno velké písmeno, jedno malé písmeno, jednu číslici a jeden speciální znak.

Weby

Na této stránce

Výpis webů na serveru

Příkaz

mogwai sites list

Ukázkový výstup

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

Poznámka: Web IDs z tohoto seznamu se používá v dalších příkazech.

Vytvoření nového webu

Příkaz

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

Možnosti

  • --owner : Uživatel v systému FASTPANEL, který bude vlastníkem webu.
  • --server-name=SERVER-NAME : Název domény pro web.
  • -a, --alias=ALIAS : Aliasy pro web, například subdomény www. Lze zadat více aliasů.
  • --ip=IP : IP adresa serveru, na kterém bude web běžet. Lze zadat více IP adres.
  • -h, --handler=HANDLER: Backend handler. Může být:
    • PHP: cgi,mpm_itk,php_fpm,fcgi;
    • Node.js: standalone,pm2;
    • Systemd: systemd.
  • --handler_version=HANDLER_VERSION : Verze PHP nebo Node.js (např. 8.2, 8.3, 20.15.1).
  • --create-user : Vytvořit uživatele pro web.

Ukázkový příkaz

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

Odstranění webu

Příkaz

mogwai sites delete --id=ID

ID webu ID lze získat pomocí příkazu mogwai sites list.

Ukázkový příkaz

mogwai sites delete --id=987

Tento příkaz odstraní web s ID 987

Úprava nastavení webu

Příkaz

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

ID webu ID lze získat pomocí příkazu mogwai sites list.

Možnosti

  • -i, --id=ID : ID webu.
  • -a, --add-alias=ADD-ALIAS : Přidat alias, lze zadat více aliasů.
  • --del-alias=DEL-ALIAS : Odstranit alias, lze zadat více aliasů.
  • --add-ip=ADD-IP : Přidat IP adresu z nastavení webu, lze zadat více IP adres.
  • --del-ip=DEL-IP : Odstranit IP adresu z nastavení webu, lze zadat více IP adres.
  • -h, --handler=HANDLER: Backend handler. Může být:
    • PHP: cgi,mpm_itk,php_fpm,fcgi;
    • Node.js: standalone,pm2;
    • Systemd: systemd.
  • --handler_version=HANDLER_VERSION : Verze PHP nebo Node.js (např. 8.2, 8.3, 20.15.1).
  • --gzip : Povolit kompresi.
  • --no-gzip : Zakázat kompresi.
  • --gzip-comp-level=LEVEL : Nastavit úroveň komprese, 1-9.
  • --expires=EXPIRES : Nastavit dobu ukládání do mezipaměti pro statický obsah.
  • --worker-count=WORKER-COUNT : Nastavit počet workerů pro PHP-FPM

Nastavení pro více webů na serveru můžete také aktualizovat pomocí příkazu

mogwai sites batch-update
  • Chcete-li změnit nastavení pro všechny weby, použijte příznak -a.
  • Chcete-li změnit nastavení pro vybrané weby, zadejte více příznaků --id s jejich IDs.

Ukázkový příkaz

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

Tento příkaz přidá alias www1.example.com, změní handler na cgi a verzi PHP na 5.6 pro web s ID 3

Ukázkový příkaz

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

Tento příkaz změní PHP handler pro weby s ID 2 a 3

Popis

Na této stránce

FASTPANEL poskytuje rozhraní příkazového řádku (CLI) implementované prostřednictvím nástroje mogwai (/usr/local/bin/mogwai). Nástroj bude fungovat pouze při spuštění jako root.

Nápověda

Chcete-li zobrazit seznam dostupných příkazů, použijte:

mogwai --help

Chcete-li se dozvědět více o konkrétním příkazu, použijte:

mogwai command --help

Chcete-li zobrazit seznam příkazů s popisy, použijte:

mogwai --help-long