FASTPANELWIKI

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

Бұл команда 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.
  • --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        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

Бұл пәрмен әдепкі дерекқор серверінде (--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:00

IDs домені басқа пәрмендерде қолданылады.

Электрондық пошта доменін қосу

Пәрмен

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