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:00ID от изхода на командата се използва в други команди.
Създаване на пощенска кутия
Команда
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=enDEST_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.
- PHP:
--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.
- PHP:
--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
FASTPANEL