FASTPANELWIKI

CLI

Bazy danych

Na tej stronie

Pobieranie listy serwerów baz danych

Polecenie

mogwai databases servers list

Przykładowe dane wyjściowe

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

Serwer IDs jest używany w innych poleceniach.

Pobieranie listy baz danych

Polecenie

mogwai databases list

Przykł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 UTC

Synchronizacja 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 sync

Tworzenie 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 dbpassword1

To polecenie utworzy bazę danych o nazwie db1 na domyślnym serwerze baz danych (--server=1) i „powiąże” ją z witryną example.com.

E-mail

Na tej stronie

Pobieranie listy domen e-mail

Polecenie

mogwai emails domains list

Przykł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:00

Domena IDs jest używana w innych poleceniach.

Dodawanie domeny e-mail

Polecenie

mogwai emails domains create

Opcje

  • --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 fastuser

Pobieranie listy skrzynek pocztowych

Polecenie

mogwai emails boxes list

Opcje

  • --domain=DOMAIN : Nazwa domeny pocztowej

Przykładowe polecenie

mogwai emails boxes list --domain example.com

Przykł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:00

ID z danych wyjściowych polecenia jest używany w innych poleceniach.

Tworzenie skrzynki pocztowej

Polecenie

mogwai emails boxes create

Opcje

  • --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=MySecretPassword123

To polecenie utworzy skrzynkę pocztową o nazwie user@example.com z hasłem MySecretPassword123.

Usuwanie skrzynki pocztowej

Polecenie

mogwai emails boxes delete

Opcje

  • -b, --box=BOX : ID skrzynki pocztowej..

Przykładowe polecenie

mogwai emails boxes delete -b 1

To 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 trybu import - wyczyść istniejące skrzynki pocztowe.

Aby zaimportować pocztę, musisz przygotować listę skrzynek pocztowych na serwerze w formacie:

IMAP_HOST;SOURCE_ADDR;SOURCE_PASSWORD;DEST_ADDR

Opcje

  • 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=en
  • DEST_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.com

Dostępne są dwa tryby:

Tryb importu

mogwai emails boxes import

W 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 --force

Tryb synchronizacji

mogwai emails boxes sync

W 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.txt

Transfer 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 podkatalogu logs/). 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.67

Moż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 -m do 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 list

Przykł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.com

Uwaga: 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.
  • --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.3

Usuwanie witryny

Polecenie

mogwai sites delete --id=ID

Witrynę ID można uzyskać z polecenia mogwai sites list.

Przykładowe polecenie

mogwai sites delete --id=987

To 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.
  • --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 --id z ich IDs.

Przykładowe polecenie

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

To 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 2

To 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 --help

Aby dowiedzieć się więcej o konkretnym poleceniu, użyj:

mogwai command --help

Aby wyświetlić listę poleceń z opisami, użyj:

mogwai --help-long