CLI
Databáze
Na této stránce
Získání seznamu databázových serverů
Příkaz
mogwai databases servers listPříklad výstupu
ID NAME TYPE LOCAL HOST USERNAME AVAIL
1 mysql(localhost) mysql true fastuser true
2 postgresql(localhost) postgresql true fastuser trueServer IDs se používá v dalších příkazech.
Získání seznamu databází
Příkaz
mogwai databases listPří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 UTCSynchronizace 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 syncVytvoř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 dbpassword1Tento 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.
Na této stránce
Získání seznamu e-mailových domén
Příkaz
mogwai emails domains listPří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:00Domény IDs se používají v dalších příkazech.
Přidání e-mailové domény
Příkaz
mogwai emails domains createMož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 fastuserZískání seznamu poštovních schránek
Příkaz
mogwai emails boxes listMožnosti
--domain=DOMAIN: Název poštovní domény
Příklad příkazu
mogwai emails boxes list --domain example.comPří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:00ID z výstupu příkazu se používá v dalších příkazech.
Vytvoření poštovní schránky
Příkaz
mogwai emails boxes createMož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=MySecretPassword123Tento 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 deleteMožnosti
-b,--box=BOX: ID poštovní schránky..
Příklad příkazu
mogwai emails boxes delete -b 1Tento 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žimimport- 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_ADDRMož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=enDEST_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.comK dispozici jsou dva režimy:
Režim importu
mogwai emails boxes importV 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 --forceRežim synchronizace
mogwai emails boxes syncV 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.txtPř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
-mpro 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ářelogs/). 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.67Mož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
-mk 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
Výpis webů na serveru
Příkaz
mogwai sites listUká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.comPozná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.
- PHP:
--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.3Odstranění webu
Příkaz
mogwai sites delete --id=IDID webu ID lze získat pomocí příkazu mogwai sites list.
Ukázkový příkaz
mogwai sites delete --id=987Tento 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.
- PHP:
--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ů
--ids jejichIDs.
Ukázkový příkaz
mogwai sites update --id=1 -a www1.example.com -h cgi --handler_version=5.6Tento 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 2Tento 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 --helpChcete-li se dozvědět více o konkrétním příkazu, použijte:
mogwai command --helpChcete-li zobrazit seznam příkazů s popisy, použijte:
mogwai --help-long
FASTPANEL