CLI
Bazy danych
Na tej stronie
Pobieranie listy serwerów baz danych
Polecenie
mogwai databases servers listPrzykładowe dane wyjściowe
ID NAME TYPE LOCAL HOST USERNAME AVAIL
1 mysql(localhost) mysql true fastuser true
2 postgresql(localhost) postgresql true fastuser trueSerwer IDs jest używany w innych poleceniach.
Pobieranie listy baz danych
Polecenie
mogwai databases listPrzykładowe dane wyjściowe
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 UTCSynchronizacja listy baz danych
Jeśli ostatnio dodano lub usunięto bazy danych i nie pojawiły się jeszcze w FASTPANEL, możesz wymusić synchronizację list
Polecenie
mogwai databases syncTworzenie nowej bazy danych
Polecenie
mogwai databases create [flags]Opcje
-n,--name=NAME: Nazwa bazy danych.-o,--owner="fastuser": użytkownik FASTPANEL, do którego zostanie dodana baza danych.-s,--site=SITE: Witryna w FASTPANEL, do której zostanie dodana baza danych.-c,--charset="utf8mb4": Kodowanie bazy danych.-u,--username=USERNAME: Nazwa użytkownika bazy danych.-p,--password=PASSWORD: Hasło użytkownika bazy danych.
Przykładowe polecenie
mogwai databases create --server=1 -n db1 -o fastuser -s example.com -u dbuser -p dbpassword1To polecenie utworzy bazę danych o nazwie db1 na domyślnym serwerze baz danych (--server=1) i „powiąże” ją z witryną example.com.
Na tej stronie
Pobieranie listy domen e-mail
Polecenie
mogwai emails domains listPrzykładowe dane wyjściowe
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:00Domena IDs jest używana w innych poleceniach.
Dodawanie domeny e-mail
Polecenie
mogwai emails domains createOpcje
--domain=DOMAIN: Nazwa domeny e-mail.-o,--owner="fastuser": Użytkownik FASTPANEL, do którego zostanie dodana domena e-mail.
Przykład tworzenia domeny e-mail example1.com dla użytkownika fastuser
mogwai emails domains create --domain=example1.com -o fastuserPobieranie listy skrzynek pocztowych
Polecenie
mogwai emails boxes listOpcje
--domain=DOMAIN: Nazwa domeny pocztowej
Przykładowe polecenie
mogwai emails boxes list --domain example.comPrzykładowe dane wyjściowe
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 danych wyjściowych polecenia jest używany w innych poleceniach.
Tworzenie skrzynki pocztowej
Polecenie
mogwai emails boxes createOpcje
--domain=DOMAIN: Nazwa domeny e-mail.-l,--login=LOGIN: Nazwa skrzynki pocztowej, bez domeny.-p,--password=PASSWORD: Hasło do skrzynki pocztowej.
Przykładowe polecenie
mogwai emails boxes create --domain=example.com --login=user --password=MySecretPassword123To polecenie utworzy skrzynkę pocztową o nazwie user@example.com z hasłem MySecretPassword123.
Usuwanie skrzynki pocztowej
Polecenie
mogwai emails boxes deleteOpcje
-b,--box=BOX: ID skrzynki pocztowej..
Przykładowe polecenie
mogwai emails boxes delete -b 1To polecenie usunie skrzynkę pocztową o ID 1.
Importowanie skrzynek pocztowych i wiadomości e-mail
Polecenie
mogwai emails boxes import[sync] [<flags>]Opcje
-i,--import_config=IMPORT_CONFIG: Ścieżka do pliku listy importu--force: Tylko dla trybuimport- wyczyść istniejące skrzynki pocztowe.
Aby zaimportować pocztę, musisz przygotować listę skrzynek pocztowych na serwerze w formacie:
IMAP_HOST;SOURCE_ADDR;SOURCE_PASSWORD;DEST_ADDROpcje
IMAP_HOST: Adres serwera pocztowego IMAP.SOURCE_ADDR: Skrzynka pocztowa na serwerze źródłowym.SOURCE_PASSWORD: Hasło do połączenia IMAP ze skrzynką pocztową na serwerze źródłowym. Niektóre usługi, takie jak Google, wymagają utworzenia hasła aplikacji do dostępu IMAP https://support.google.com/accounts/answer/185833?hl=enDEST_ADDR: Skrzynka pocztowa na serwerze FASTPANEL, do której przenoszone są wiadomości.
Przykładowa zawartość pliku
imap.gmail.com;test@gmail.comu;password;test@example.com
imap.gmail.com;test1@gmail.com;password;test1@example.comDostępne są dwa tryby:
Tryb importu
mogwai emails boxes importW tym trybie wszystkie wiadomości są kopiowane w całości, skrzynki pocztowe na serwerze FASTPANEL nie mogą być utworzone lub muszą być puste - podczas wykonywania polecenia FASTPANEL tworzy niezbędne skrzynki pocztowe. Jeśli skrzynki pocztowe z zawartością już istnieją, zostanie wyświetlony błąd. Możesz użyć flagi --force - wtedy skrzynka pocztowa zostanie wyczyszczona.
Przykład uruchomienia polecenia z listą skrzynek pocztowych zapisaną w pliku /root/import.txt i z użyciem klucza --force
mogwai emails boxes import --import_config=/root/import.txt --forceTryb synchronizacji
mogwai emails boxes syncW tym trybie Panel sterowania pobiera wiadomości z serwera źródłowego bez usuwania czegokolwiek. Należy go użyć, jeśli po pierwszym imporcie w oryginalnej skrzynce pocztowej pojawiły się nowe wiadomości, które również trzeba przenieść.
Przykładowe polecenie
mogwai emails boxes sync --import_config=/root/import.txtTransfer użytkowników między serwerami FASTPANEL
Na tej stronie
Wprowadzenie
Ten artykuł opisuje proces przenoszenia kont użytkowników i powiązanych z nimi danych (witryn internetowych, baz danych, poczty e-mail itp.) z jednego serwera FASTPANEL na inny przy użyciu wbudowanego narzędzia migracji.
Kluczowe pojęcia
- Serwer źródłowy - Serwer, z którego przenoszone są dane.
- Serwer docelowy - Serwer, na który przenoszone są dane.
Ważne uwagi
-
Domyślnie migracja działa poprawnie tylko w przypadku witryn ze standardową konfiguracją FASTPANEL.
-
Witryny z ręcznymi zmianami konfiguracji mogą zostać przeniesione tylko wtedy, gdy do mapowania adresów IP użyta zostanie flaga
-m. -
Jeśli zaszyfrowane hasło właściciela bazy danych nie jest dostępne, baza danych nie zostanie przeniesiona.
-
Jeśli witryna internetowa nie zostanie przeniesiona, powiązane z nią bazy danych również nie zostaną przeniesione.
-
Można przenosić tylko lokalne bazy danych.
Proces migracji
Połączenie
Serwer docelowy łączy się z serwerem źródłowym przez SSH. Podczas pierwszego połączenia serwer docelowy instaluje klucz SSH na serwerze źródłowym (wcześniej dostarczony lub wygenerowany z hasła).
Etapy migracji
- Instalacja modułu
- Zbieranie informacji o obiektach, które można przenieść
- Tworzenie użytkowników
- Przenoszenie certyfikatów SSL
- Tworzenie witryn internetowych, kont FTP, domen e-mail i kont e-mail
- Tworzenie baz danych i użytkowników baz danych
- Przenoszenie plików witryn internetowych i skrzynek e-mail
- Przenoszenie zadań cron
Transfer plików jest wykonywany przy użyciu rsync. Bazy danych są przenoszone przez utworzenie zrzutu przez tunel SSH.
Polecenie uruchamiające migrację
Polecenie jest uruchamiane na serwerze docelowym przez użytkownika z uprawnieniami root:
/usr/local/fastpanel2/fastpanel transfer run [SSH_PARAMETERS] [IP_PARAMETERS] [ADDITIONAL_OPTIONS]Flagi wiersza poleceń
Połączenie SSH
--remote_host="SOURCE_IP" - Adres IP serwera źródłowego.--remote_port="SSH_PORT" - Port SSH.--remote_username="SSH_USER" - Użytkownik (musi być root).--remote_password="USER_PASSWORD" - Hasło dla określonego użytkownika SSH.--ssh_key_path="PATH_TO_KEY" - Ścieżka do prywatnego klucza SSH na serwerze docelowym służącego do połączenia z serwerem źródłowym. Jeśli używany jest klucz, hasło (--remote_password) nie jest potrzebne.
Adresy IP
Aby zarządzać adresami IP witryn podczas przenoszenia, należy użyć tylko jednej z następujących flag. Flaga -m ma priorytet.
-
-i"IP_ADDRESS_ON_DESTINATION" - Przypisuje określony adres IP do wszystkich przenoszonych witryn na serwerze docelowym. Aby określić wiele adresów IP (np. jeśli na serwerze źródłowym było ich kilka), powtórz flagę dla każdego źródłowego adresu IP, który ma zostać przeniesiony. -
-m"SOURCE_IP,DESTINATION_IP" - Zalecana metoda. Ustanawia bezpośrednie mapowanie: wszystkie witryny używające SOURCE_IP na serwerze źródłowym będą używać DESTINATION_IP na serwerze docelowym. Tę flagę można podać wiele razy dla różnych par adresów IP. Wymagane do przenoszenia witryn z ręcznymi zmianami konfiguracji, ponieważ umożliwia poprawne zastępowanie adresów IP w dyrektywach listen.
Dodatkowe ustawienia
--users="USER_LIST" - Przenosi tylko określonych użytkowników (oddzielonych przecinkami). Jeśli nie określono, przenoszeni są wszyscy użytkownicy.--disable_disk_quota- Wyłącza przenoszenie limitów quota dysku użytkowników.--with_user_data- Obejmuje kopiowanie całej zawartości katalogów domowych użytkowników (z wyjątkiem podkatalogulogs/). Należy używać ostrożnie, ponieważ może to znacząco zwiększyć czas transferu i ilość przesyłanych danych.--only_data- Przenosi tylko dane (pliki witryn internetowych, pliki poczty, zrzuty baz danych). Przydatne, jeśli początkowa migracja struktury (użytkownicy, witryny, bazy danych itp.) zakończyła się powodzeniem, ale podczas etapu kopiowania plików lub zrzutów wystąpiły błędy. Umożliwia ponowne uruchomienie tylko części odpowiedzialnej za kopiowanie danych.--transfer_timeout- Ustawia limit czasu operacji (domyślnie 60 minut).
Przykładowe polecenie
Przenieś wszystkich użytkowników z serwera 11.22.33.44 na bieżący serwer. Na starym serwerze witryny używały adresów IP 11.22.33.44 i 11.22.33.55; na nowym serwerze powinny używać odpowiednio 99.88.77.66 i 99.88.77.67. Połączenie przez SSH z użyciem hasła.
/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żliwe problemy i typy błędów
Błąd w dzienniku migracji nie zawsze oznacza problem krytyczny, ale może wskazywać przyczynę, dla której określony obiekt nie został przeniesiony.
-
Konflikty: Występują, gdy przeniesienie obiektu jest niemożliwe z powodu bieżącej konfiguracji serwera docelowego (np. użytkownik lub witryna o tej samej nazwie już istnieje) albo gdy konfiguracja witryny na serwerze źródłowym jest nieznana panelowi (np. z powodu rozległych ręcznych zmian).
-
Brak zapisanego hasła: Jak wspomniano wcześniej, użytkownicy bazy danych MySQL bez zapisanego hasła w FASTPANEL na serwerze źródłowym nie mogą zostać przeniesieni.
-
Ustawienia ręczne i adresy IP: Jeśli witryna na serwerze źródłowym ma ręczne zmiany konfiguracji serwera WWW, a podczas migracji nie zostanie użyta flaga
-mdo mapowania jej adresu IP, taka witryna nie zostanie przeniesiona, ponieważ panel nie wie, jaki adres IP należy określić w konfiguracji na serwerze docelowym.
Użytkownicy
Na tej stronie
Tworzenie nowego użytkownika
Polecenie
mogwai users create --username=USERNAME --password=PASSWORD [--role="USER"]Opcje
-u,--username=USERNAME: Określa nazwę użytkownika dla nowego użytkownika.-p,--password=PASSWORD: Określa hasło dla nowego użytkownika.-r,--role="USER": Określa rolę dla nowego użytkownika. Obsługiwane role to RESELLER i USER. Domyślną rolą jest USER.
Informacje o użyciu
Aby utworzyć nowego użytkownika o nazwie testuser, haśle My$ecretPassword123 i roli RESELLER, użyj następującego polecenia:
mogwai users create --username=testuser --password=My$ecretPassword123 --role="RESELLER"Dodatkowe uwagi
- Nazwy użytkowników muszą być unikalne i nie mogą zawierać spacji ani kropek.
- Hasła muszą mieć co najmniej 8 znaków. Zalecamy użycie co najmniej jednej wielkiej litery, jednej małej litery, jednej cyfry i jednego znaku specjalnego.
Witryny internetowe
Na tej stronie
Wyświetlanie listy witryn na serwerze
Polecenie
mogwai sites listPrzykładowe dane wyjściowe
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.comUwaga: Witryna IDs z tej listy jest używana w innych poleceniach.
Tworzenie nowej witryny
Polecenie
mogwai sites create --server-name=SERVER-NAME --owner=OWNER [<flags>]Opcje
--owner: Użytkownik w systemie FASTPANEL, który będzie właścicielem witryny.--server-name=SERVER-NAME: Nazwa domeny dla witryny.-a,--alias=ALIAS: Aliasy dla witryny, takie jak subdomeny www. Można określić wiele aliasów.--ip=IP: Adres IP serwera, na którym będzie działać witryna. Można określić wiele adresów IP.-h,--handler=HANDLER: Handler backendu. Może to być:- PHP:
cgi,mpm_itk,php_fpm,fcgi; - Node.js:
standalone,pm2; - Systemd:
systemd.
- PHP:
--handler_version=HANDLER_VERSION: Wersja PHP lub Node.js (np.8.2,8.3,20.15.1).--create-user: Utwórz użytkownika dla witryny.
Przykładowe polecenie
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.3Usuwanie witryny
Polecenie
mogwai sites delete --id=IDWitrynę ID można uzyskać z polecenia mogwai sites list.
Przykładowe polecenie
mogwai sites delete --id=987To polecenie usunie witrynę o ID 987
Modyfikowanie ustawień witryny
Polecenie
mogwai sites update --id=ID [<flags>]Witrynę ID można uzyskać z polecenia mogwai sites list.
Opcje
-i,--id=ID: ID witryny.-a,--add-alias=ADD-ALIAS: Dodaj alias, można określić wiele aliasów.--del-alias=DEL-ALIAS: Usuń alias, można określić wiele aliasów.--add-ip=ADD-IP: Dodaj adres IP z ustawień witryny, można określić wiele adresów IP.--del-ip=DEL-IP: Usuń adres IP z ustawień witryny, można określić wiele adresów IP.-h,--handler=HANDLER: Handler backendu. Może to być:- PHP:
cgi,mpm_itk,php_fpm,fcgi; - Node.js:
standalone,pm2; - Systemd:
systemd.
- PHP:
--handler_version=HANDLER_VERSION: Wersja PHP lub Node.js (np.8.2,8.3,20.15.1).--gzip: Włącz kompresję.--no-gzip: Wyłącz kompresję.--gzip-comp-level=LEVEL: Ustaw poziom kompresji, 1-9.--expires=EXPIRES: Ustaw czas buforowania dla zawartości statycznej.--worker-count=WORKER-COUNT: Ustaw liczbę workerów dla PHP-FPM
Możesz także zaktualizować ustawienia wielu witryn na serwerze za pomocą polecenia
mogwai sites batch-update- Aby zmienić ustawienia dla wszystkich witryn, użyj flagi
-a. - Aby zmienić ustawienia dla wybranych witryn, podaj wiele flag
--idz ichIDs.
Przykładowe polecenie
mogwai sites update --id=1 -a www1.example.com -h cgi --handler_version=5.6To polecenie doda alias www1.example.com, zmieni handler na cgi i wersję PHP na 5.6 dla witryny o ID 3
Przykładowe polecenie
mogwai sites batch-update -h cgi --handler_version=5.6 --id 3 --id 2To polecenie zmieni handler PHP dla witryn o ID 2 i 3
Opis
Na tej stronie
FASTPANEL udostępnia interfejs wiersza poleceń (CLI) zaimplementowany za pomocą narzędzia mogwai (/usr/local/bin/mogwai). Narzędzie będzie działać tylko po uruchomieniu jako root.
Pomoc
Aby wyświetlić listę dostępnych poleceń, użyj:
mogwai --helpAby dowiedzieć się więcej o konkretnym poleceniu, użyj:
mogwai command --helpAby wyświetlić listę poleceń z opisami, użyj:
mogwai --help-long
FASTPANEL