CLI
Веб-сайттар
Сервердегі сайттарды тізімдеу
Команда
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: Бэкенд өңдегіші. Мыналар болуы мүмкін:- 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=IDID сайтын mogwai sites list командасынан алуға болады.
Команда мысалы
mogwai sites delete --id=987Бұл команда 987 ID-і бар сайтты жояды
Сайт баптауларын өзгерту
Команда
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: Бэкенд өңдегіші. Мыналар болуы мүмкін:- 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: PHP-FPM үшін worker санын орнату
Сондай-ақ сервердегі бірнеше сайттың баптауларын келесі команда арқылы жаңарта аласыз
mogwai sites batch-update- Барлық сайттардың баптауларын өзгерту үшін
-aжалаушасын пайдаланыңыз. - Таңдалған сайттардың баптауларын өзгерту үшін олардың
IDsмәндерімен бірнеше--idжалаушасын көрсетіңіз.
Команда мысалы
mogwai sites update --id=1 -a www1.example.com -h cgi --handler_version=5.6Бұл команда www1.example.com бүркеншік атын қосады, өңдегішті cgi-ге өзгертеді және ID-і 3 болатын сайт үшін PHP нұсқасын 5.6-ға өзгертеді
Команда мысалы
mogwai sites batch-update -h cgi --handler_version=5.6 --id 3 --id 2Бұл команда 2 және 3 ID-і бар сайттар үшін PHP өңдегішін өзгертеді
Дерекқорлар
Осы бетте
Дерекқор серверлерінің тізімін алу
Пәрмен
mogwai databases servers listШығыс мысалы
ID NAME TYPE LOCAL HOST USERNAME AVAIL
1 mysql(localhost) mysql true fastuser true
2 postgresql(localhost) postgresql true fastuser trueIDs сервері басқа пәрмендерде қолданылады.
Дерекқорлар тізімін алу
Пәрмен
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Бұл пәрмен әдепкі дерекқор серверінде (--server=1) db1 атты дерекқорды жасайды және оны example.com сайтына "байланыстырады".
Сипаттама
Осы бетте
FASTPANEL mogwai утилитасы (/usr/local/bin/mogwai) арқылы іске асырылған пәрмен жолы интерфейсін (CLI) ұсынады. Утилита тек root ретінде іске қосылғанда ғана жұмыс істейді.
Анықтама
Қолжетімді пәрмендер тізімін көру үшін мынаны пайдаланыңыз:
mogwai --helpБелгілі бір пәрмен туралы толығырақ білу үшін мынаны пайдаланыңыз:
mogwai command --helpСипаттамалары бар пәрмендер тізімін көру үшін мынаны пайдаланыңыз:
mogwai --help-longПайдаланушылар
Осы бетте
Жаңа пайдаланушыны жасау
Пәрмен
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 конфигурациясы бар сайттар үшін дұрыс жұмыс істейді.
-
Қолмен конфигурациялау өзгерістері бар сайттарды тек IP мекенжайларын сәйкестендіру үшін
-mжалаушасы пайдаланылған жағдайда ғана көшіруге болады. -
Егер дерекқор иесінің шифрланған құпиясөзі қолжетімді болмаса, дерекқор көшірілмейді.
-
Егер веб-сайт көшірілмесе, оған байланысты дерекқорлар да көшірілмейді.
-
Тек жергілікті дерекқорларды көшіруге болады.
Көшіру процесі
Қосылу
Мақсатты сервер бастапқы серверге SSH арқылы қосылады. Бірінші қосылу кезінде мақсатты сервер бастапқы серверге SSH кілтін орнатады (не алдын ала берілген, не құпиясөзден жасалған).
Көшіру қадамдары
- Модульді орнату
- Көшіріле алатын объектілер туралы ақпарат жинау
- Пайдаланушыларды жасау
- SSL сертификаттарын көшіру
- Веб-сайттарды, FTP тіркелгілерін, электрондық пошта домендерін және электрондық пошта тіркелгілерін жасау
- Дерекқорлар мен дерекқор пайдаланушыларын жасау
- Веб-сайт және электрондық пошта жәшігі файлдарын көшіру
- Cron тапсырмаларын көшіру
Файлдарды көшіру rsync арқылы орындалады. Дерекқорлар SSH туннелі арқылы dump жасау жолымен көшіріледі.
Көшіруді бастау пәрмені
Пәрмен мақсатты серверде 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 жұптары үшін бірнеше рет көрсетуге болады. Қолмен конфигурациялау түзетулері бар сайттарды көшіру үшін міндетті, өйткені ол listen директиваларындағы IP мекенжайларын дұрыс ауыстыруға мүмкіндік береді.
Қосымша баптаулар
--users="USER_LIST" - Тек көрсетілген пайдаланушыларды көшіреді (үтірмен бөлінген). Егер көрсетілмесе, барлық пайдаланушылар көшіріледі.--disable_disk_quota- Пайдаланушының диск квоталарын көшіруді өшіреді.--with_user_data- Пайдаланушының home каталогтарының толық мазмұнын көшіруді қосады (logs/ішкі каталогынан басқа). Сақтықпен пайдаланыңыз, өйткені бұл көшіру уақытын және көшірілетін деректер көлемін едәуір арттыруы мүмкін.--only_data- Тек деректерді көшіреді (веб-сайт файлдары, пошта файлдары, дерекқор dump-тары). Бастапқы құрылымды көшіру (пайдаланушылар, сайттар, ДҚ және т.б.) кезінде пайдалы сәтті аяқталса, бірақ файлдарды немесе dump-тарды көшіру кезеңінде қателер туындаса, пайдалы. Тек деректерді көшіру бөлігін қайта іске қосуға мүмкіндік береді.--transfer_timeout- Операция таймаутын орнатады (әдепкісі 60 минут).
Пәрмен мысалы
11.22.33.44 серверінен ағымдағы серверге барлық пайдаланушыларды көшіріңіз. Ескі серверде сайттар 11.22.33.44 және 11.22.33.55 IP мекенжайларын пайдаланды; жаңа серверде олар тиісінше 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Мүмкін мәселелер мен қате түрлері
Көшіру журналындағы қате әрқашан сыни мәселені білдірмейді, бірақ нақты объектінің неге көшірілмегенінің себебін көрсетуі мүмкін.
-
Қақтығыстар: Объектіні көшіру мақсатты сервердің ағымдағы конфигурациясына байланысты мүмкін болмағанда пайда болады (мысалы, дәл сондай атауы бар пайдаланушы немесе сайт бұрыннан бар) немесе бастапқы сервердегі сайт конфигурациясы панельге белгісіз болса (мысалы, ауқымды қолмен түзетулерге байланысты).
-
Сақталған құпиясөздің болмауы: Жоғарыда айтылғандай, бастапқы сервердегі FASTPANEL ішінде сақталған құпиясөзі жоқ MySQL дерекқор пайдаланушыларын көшіру мүмкін емес.
-
Қолмен баптаулар және IP мекенжайлары: Егер бастапқы сервердегі сайтта веб-сервер конфигурациясына қолмен түзетулер болса және көшіру кезінде оның IP мекенжайын сәйкестендіру үшін
-mжалаушасы пайдаланылмаса, мұндай сайт көшірілмейді, өйткені панель мақсатты сервердегі конфигурацияда қай IP-ді көрсету керектігін білмейді.
Электрондық пошта
Осы бетте
Электрондық пошта домендерінің тізімін алу
Пәрмен
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:00IDs домені басқа пәрмендерде қолданылады.
Электрондық пошта доменін қосу
Пәрмен
mogwai emails domains createОпциялар
--domain=DOMAIN: Электрондық пошта доменінің атауы.-o,--owner="fastuser": Электрондық пошта домені қосылатын FASTPANEL пайдаланушысы.
fastuser пайдаланушысы астында example1.com электрондық пошта доменін жасау мысалы
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=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
FASTPANEL