FASTPANELWIKI

CLI

Бази данни

На тази страница

Получаване на списък със сървъри на бази данни

Команда

mogwai databases servers list

Примерен изход

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

Сървърът IDs се използва в други команди.

Получаване на списък с бази данни

Команда

mogwai databases list

Примерен изход

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

Синхронизиране на списъка с бази данни

Ако наскоро сте добавили или премахнали бази данни и те все още не са се появили във FASTPANEL, можете да принудите синхронизирането на списъците

Команда

mogwai databases sync

Създаване на нова база данни

Команда

mogwai databases create [flags]

Опции

  • -n, --name=NAME : Име на базата данни.
  • -o, --owner="fastuser" :  Потребител на FASTPANEL, към когото ще бъде добавена базата данни.
  • -s, --site=SITE : Уебсайт във FASTPANEL, към който ще бъде добавена базата данни.
  • -c, --charset="utf8mb4" : Кодиране на базата данни.
  • -u, --username=USERNAME : Потребителско име на базата данни.
  • -p, --password=PASSWORD : Парола на потребителя на базата данни.

Примерна команда

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

Тази команда ще създаде база данни с име db1 на сървъра за бази данни по подразбиране (--server=1) и ще я "обвърже" със сайта example.com.

Описание

На тази страница

FASTPANEL предоставя интерфейс на командния ред (CLI), реализиран чрез помощната програма mogwai (/usr/local/bin/mogwai). Помощната програма ще работи само когато се изпълнява като root.

Помощ

За да видите списък с наличните команди, използвайте:

mogwai --help

За да научите повече за конкретна команда, използвайте:

mogwai command --help

За да видите списък с команди с описания, използвайте:

mogwai --help-long

Имейл

На тази страница

Получаване на списък с имейл домейни

Команда

mogwai emails domains list

Примерен изход

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

Домейнът IDs се използва в други команди.

Добавяне на имейл домейн

Команда

mogwai emails domains create

Опции

  • --domain=DOMAIN : Име на имейл домейн.
  • -o, --owner="fastuser" : Потребителят на FASTPANEL, към когото ще бъде добавен имейл домейнът.

Пример за създаване на имейл домейн example1.com под потребителя fastuser

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

Получаване на списък с пощенски кутии

Команда

mogwai emails boxes list

Опции

  • --domain=DOMAIN : Име на пощенски домейн

Примерна команда

mogwai emails boxes list --domain example.com

Примерен изход

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 от изхода на командата се използва в други команди.

Създаване на пощенска кутия

Команда

mogwai emails boxes create

Опции

  • --domain=DOMAIN : Име на имейл домейн.
  • -l, --login=LOGIN : Името на пощенската кутия, без домейна.
  • -p, --password=PASSWORD : Паролата за пощенската кутия.

Примерна команда

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

Тази команда ще създаде пощенска кутия с име user@example.com с парола MySecretPassword123.

Изтриване на пощенска кутия

Команда

mogwai emails boxes delete

Опции

  • -b, --box=BOX : ID на пощенската кутия..

Примерна команда

mogwai emails boxes delete -b 1

Тази команда ще изтрие пощенската кутия с ID 1.

Импортиране на пощенски кутии и имейли

Команда

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

Опции

  • -i, --import_config=IMPORT_CONFIG : Път до файла със списъка за импортиране
  • --force : Само за режим import - изчистване на съществуващите пощенски кутии.

За да импортирате поща, трябва да подготвите списък с пощенски кутии на сървъра във формат:

IMAP_HOST;SOURCE_ADDR;SOURCE_PASSWORD;DEST_ADDR

Опции

  • IMAP_HOST : Адрес на IMAP пощенския сървър.
  • SOURCE_ADDR : Пощенска кутия на изходния сървър.
  • SOURCE_PASSWORD : Парола за IMAP връзка към пощенската кутия на изходния сървър. Някои услуги, като Google, изискват създаване на парола за приложение за IMAP достъп https://support.google.com/accounts/answer/185833?hl=en
  • DEST_ADDR : Пощенска кутия на сървъра FASTPANEL, към която се прехвърлят съобщенията.

Примерно съдържание на файл

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

Налични са два режима:

Режим на импортиране

mogwai emails boxes import

В този режим всички съобщения се копират изцяло, пощенските кутии на сървъра FASTPANEL не трябва да са създадени или трябва да са празни - при изпълнение на командата FASTPANEL създава необходимите пощенски кутии. Ако вече съществуват пощенски кутии със съдържание, ще бъде показана грешка. Можете да използвате флага --force - тогава пощенската кутия ще бъде изчистена.

Пример за изпълнение на командата със списък с пощенски кутии, съхранен във файла /root/import.txt, и използване на ключа --force

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

Режим на синхронизиране

mogwai emails boxes sync

В този режим Контролният панел изтегля съобщения от изходния сървър, без да изтрива нищо. Той трябва да се използва, ако в оригиналната пощенска кутия са се появили нови съобщения след първото импортиране, които също трябва да бъдат прехвърлени.

Примерна команда

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

Потребители

На тази страница

Създаване на нов потребител

Команда

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

Опции

  • -u, --username=USERNAME : Посочете потребителското име за новия потребител.
  • -p, --password=PASSWORD : Посочете паролата за новия потребител.
  • -r, --role="USER" : Посочете ролята за новия потребител. Поддържаните роли са RESELLER и USER. Ролята по подразбиране е USER.

Информация за употреба

За да създадете нов потребител с потребителско име testuser, парола My$ecretPassword123 и роля RESELLER, използвайте следната команда:

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

Допълнителни бележки

  • Потребителските имена трябва да бъдат уникални и не могат да съдържат интервали или точки.
  • Паролите трябва да бъдат с дължина поне 8 знака. Препоръчваме да използвате поне една главна буква, една малка буква, една цифра и един специален знак.

Прехвърляне на потребители между FASTPANEL

На тази страница

Въведение

Тази статия описва процеса по прехвърляне на потребителски акаунти и свързаните с тях данни (уебсайтове, бази данни, имейл и др.) от един FASTPANEL сървър към друг чрез вградената помощна програма за миграция.

Ключови термини

  • Изходен сървър - Сървърът, от който се прехвърлят данните.
  • Целеви сървър - Сървърът, към който се прехвърлят данните.

Важни бележки

  • По подразбиране миграцията работи коректно само за сайтове със стандартна FASTPANEL конфигурация.

  • Сайтове с промени в ръчната конфигурация могат да бъдат прехвърлени само ако се използва флагът -m за съпоставяне на IP адреси.

  • Ако криптирана парола за собственик на база данни не е налична, базата данни няма да бъде прехвърлена.

  • Ако уебсайт не бъде прехвърлен, свързаните с него бази данни също няма да бъдат прехвърлени.

  • Могат да бъдат прехвърляни само локални бази данни.

Процес на миграция

Свързване

Целевият сървър се свързва към изходния сървър чрез SSH. При първото свързване целевият сървър инсталира SSH ключ на изходния сървър (или предварително предоставен, или генериран от парола).

Стъпки на миграцията

  • Инсталиране на модули
  • Събиране на информация за обекти, които могат да бъдат прехвърлени
  • Създаване на потребители
  • Прехвърляне на SSL сертификати
  • Създаване на уебсайтове, FTP акаунти, имейл домейни и имейл акаунти
  • Създаване на бази данни и потребители на бази данни
  • Прехвърляне на файлове на уебсайтове и имейл пощенски кутии
  • Прехвърляне на cron задачи

Прехвърлянето на файлове се изпълнява чрез rsync. Базите данни се прехвърлят чрез създаване на dump през SSH тунел.

Команда за стартиране на миграцията

Командата се изпълнява на целевия сървър от потребител с root права:

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

Флагове на командния ред

SSH връзка

  • --remote_host="SOURCE_IP" - IP адрес на изходния сървър.
  • --remote_port="SSH_PORT" - SSH порт.
  • --remote_username="SSH_USER" - Потребител (трябва да е root).
  • --remote_password="USER_PASSWORD" - Парола за посочения SSH потребител.
  • --ssh_key_path="PATH_TO_KEY" - Път до частния SSH ключ на целевия сървър за свързване към изходния сървър. Ако се използва ключ, паролата (--remote_password) не е необходима.

IP адреси

Трябва да използвате само един от следните флагове за управление на IP адресите на сайтовете по време на прехвърлянето. Флагът -m има приоритет.

  • -i "IP_ADDRESS_ON_DESTINATION" - Задава посочения IP адрес на всички прехвърлени сайтове на целевия сървър. За да зададете множество IP адреси (напр. ако на изходния сървър е имало няколко), повторете флага за всеки IP адрес от изходния сървър, който трябва да бъде прехвърлен.

  • -m "SOURCE_IP,DESTINATION_IP" - Препоръчителен метод. Установява директно съпоставяне: всички сайтове, използващи SOURCE_IP на изходния сървър, ще използват DESTINATION_IP на целевия сървър. Този флаг може да бъде зададен многократно за различни двойки IP адреси. Задължителен е за прехвърляне на сайтове с ръчни промени в конфигурацията, тъй като позволява коректна замяна на IP адресите в директивите listen.

Допълнителни настройки

  • --users="USER_LIST" - Прехвърля само посочените потребители (разделени със запетая). Ако не е зададено, се прехвърлят всички потребители.
  • --disable_disk_quota - Деактивира прехвърлянето на дискови квоти на потребителите.
  • --with_user_data - Включва копиране на цялото съдържание на домашните директории на потребителите (с изключение на поддиректорията logs/). Използвайте с повишено внимание, тъй като това може значително да увеличи времето за прехвърляне и количеството прехвърлени данни.
  • --only_data - Прехвърля само данни (файлове на уебсайтове, файлове на поща, dump файлове на бази данни). Полезно е, ако първоначалната миграция на структурата (потребители, сайтове, БД и др.) е била успешна, но са възникнали грешки по време на етапа на копиране на файловете или dump файловете. Позволява повторно изпълнение само на частта за копиране на данни.
  • --transfer_timeout - Задава timeout на операцията (по подразбиране е 60 минути).

Примерна команда

Прехвърлете всички потребители от сървър 11.22.33.44 към текущия сървър. На стария сървър сайтовете са използвали IP адресите 11.22.33.44 и 11.22.33.55; на новия сървър те трябва да използват съответно 99.88.77.66 и 99.88.77.67. Свързване чрез SSH с парола.

/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

Възможни проблеми и видове грешки

Грешка в лога на миграцията не винаги показва критичен проблем, а може да посочи причината, поради която конкретен обект не е бил прехвърлен.

  • Конфликти: Възникват, когато прехвърлянето на обект е невъзможно поради текущата конфигурация на целевия сървър (напр. потребител или сайт със същото име вече съществува) или ако конфигурацията на сайта на изходния сървър е непозната за панела (напр. поради обширни ръчни редакции).

  • Липсваща запазена парола: Както беше споменато по-рано, потребителите на MySQL бази данни без запазена парола във FASTPANEL на изходния сървър не могат да бъдат прехвърлени.

  • Ръчни настройки и IP адреси: Ако сайт на изходния сървър има ръчни редакции в конфигурацията на уеб сървъра и флагът -m не се използва по време на миграцията за съпоставяне на неговия IP адрес, такъв сайт няма да бъде прехвърлен, защото панелът не знае кой IP адрес да посочи в конфигурацията на целевия сървър.

Уебсайтове

На тази страница

Извеждане на сайтовете на сървър

Команда

mogwai sites list

Примерен изход

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

Забележка: Сайт IDs от този списък се използва в други команди.

Създаване на нов сайт

Команда

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

Опции

  • --owner : Потребител в системата FASTPANEL, който ще притежава сайта.
  • --server-name=SERVER-NAME : Име на домейн за сайта.
  • -a, --alias=ALIAS : Псевдоними за сайта, например www поддомейни. Могат да бъдат посочени множество псевдоними.
  • --ip=IP : IP адрес на сървъра, на който ще работи сайтът. Могат да бъдат посочени множество IP адреси.
  • -h, --handler=HANDLER : Backend обработчик. Може да бъде:
    • PHP: cgi,mpm_itk,php_fpm,fcgi;
    • Node.js: standalone,pm2;
    • Systemd: systemd.
  • --handler_version=HANDLER_VERSION : Версия на PHP или Node.js (например 8.2, 8.3, 20.15.1).
  • --create-user : Създаване на потребител за сайта.

Примерна команда

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

Изтриване на сайт

Команда

mogwai sites delete --id=ID

Сайтът ID може да бъде получен от командата mogwai sites list.

Примерна команда

mogwai sites delete --id=987

Тази команда ще изтрие сайта с ID 987

Промяна на настройките на сайт

Команда

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

Сайтът ID може да бъде получен от командата mogwai sites list.

Опции

  • -i, --id=ID : ID на сайта.
  • -a, --add-alias=ADD-ALIAS : Добавяне на псевдоним; могат да бъдат посочени множество псевдоними.
  • --del-alias=DEL-ALIAS : Изтриване на псевдоним; могат да бъдат посочени множество псевдоними.
  • --add-ip=ADD-IP : Добавяне на IP адрес от настройките на сайта; могат да бъдат посочени множество IP адреси.
  • --del-ip=DEL-IP : Изтриване на IP адрес от настройките на сайта; могат да бъдат посочени множество IP адреси.
  • -h, --handler=HANDLER : Backend обработчик. Може да бъде:
    • PHP: cgi,mpm_itk,php_fpm,fcgi;
    • Node.js: standalone,pm2;
    • Systemd: systemd.
  • --handler_version=HANDLER_VERSION : Версия на PHP или Node.js (например 8.2, 8.3, 20.15.1).
  • --gzip : Активиране на компресията.
  • --no-gzip : Деактивиране на компресията.
  • --gzip-comp-level=LEVEL : Задаване на нивото на компресия, 1-9.
  • --expires=EXPIRES : Задаване на времето за кеширане на статично съдържание.
  • --worker-count=WORKER-COUNT : Задаване на броя workers за PHP-FPM

Можете също да актуализирате настройките за множество сайтове на сървър чрез командата

mogwai sites batch-update
  • За да промените настройките за всички сайтове, използвайте флага -a.
  • За да промените настройките за избрани сайтове, посочете множество флагове --id с техните IDs.

Примерна команда

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

Тази команда ще добави псевдоним www1.example.com, ще промени обработчика на cgi и версията на PHP на 5.6 за сайта с ID 3

Примерна команда

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

Тази команда ще промени PHP обработчика за сайтовете с ID 2 и 3