Skip to main content

CyberPanel Интеграция

Бұл нұсқаулық Ultimate Multisite CyberPanel интеграциясын қалай конфигурациялау керектігін түсіндіреді. Бұл сіздің желіңізде карталаған домендерді CyberPanel-де виртуаль хостар ретінде автоматты түрде қосу (және алып тастау) және Let's Encrypt арқылы опционалды авто-SSL қызметін енгізу туралы.

Бұл не істейді​

  • Ultimate Multisite-та домен карталалған кезде, интеграция сол домен үшін CyberPanel API-ға виртуаль хостар жасау үшін шақырады.
  • Домен картасы алынылған кезде, интеграция тиісті виртуаль хостарды өшіру үшін API-ға шақырады.
  • Авто-SSL қосылса, интеграция виртуаль хостар жасалғаннан кейін Let's Encrypt сертификатын дереу шығаруын іске қосады.
  • Домен картасы параметрлеріндегі "Auto-create www subdomain" (www поддоменді автоматты жасау) орнатыңыз/алып тастаңыз опционалды түрде www. псевдонимін енгізеді/алып тастайды.

Алдын ала қажеттіліктер​

  • Жұмыс істейтін CyberPanel нұсқасы (2.3 немесе одан жаңасын ұсынылады), ол WordPress серверіңізден қол жетімді болуы керек.
  • Бұл сервердегі WordPress желінің түбін қызмет ететін, бұрынғы веб-сайт бар. Интеграция жаңа виртуаль хостарларды осы серверге қосады.
  • CyberPanel API-ға қол жеткізу қосылған болуы керек. Аутентификация үшін сіздің CyberPanel администраторлық пайдаланушы атыңыз және парольді қолданасыз.
  • Авто-SSL-нің жарамды сертификат шығаруы мүмкін болған кезде, карталаған домендеріңіздің DNS тізілімдері бұрыннан серверіңіздің IP-браундығына бағдарлауы керек.

Қажеттіліктер​

Төмендегі тұрақты санды wp-config.php файлыңызда анықтауыңыз керек:

define('WU_CYBERPANEL_HOST', 'https://your-cyberpanel-host:8090');
define('WU_CYBERPANEL_USERNAME', 'your_admin_username');
define('WU_CYBERPANEL_PASSWORD', 'your_admin_password');
define('WU_CYBERPANEL_PACKAGE', 'Default');

Опционалды түрде, сіз келесілерді де анықтай аласыз:

define('WU_CYBERPANEL_AUTO_SSL', true);          // Бастапты: true — домен жасалғаннан кейін Let's Encrypt SSL сертификатын шығару
define('WU_CYBERPANEL_PHP_VERSION', 'PHP 8.2');  // Бастапты: PHP 8.2
define('WU_CYBERPANEL_EMAIL', '[email protected]'); // SSL сертификатына хабарласу үшін қолданылады

Орнату нұсқаулары​

1. CyberPanel API-ды қосыңыз​

  1. Администратор ретінде CyberPanel панеліне кіріңіз.
  2. Security > SSL бөліміне өтіп, SSL-дің CyberPanel интерфейсінде белсенді екенін растаңыз (қауіпсіз API шақыру үшін қажет).
  3. CyberPanel API де умолчанию https://your-server-ip:8090/api/ адресінде қолжетімді болады. Оны қосу үшін қосымша қадамдар қажет емес — ол администратор пайдаланушылары үшін по умолчанию белсенді болады.

2. wp-config.php-ке константаларды қосыңыз​

Төмендегі константаларды wp-config.php файлына /* That's all, stop editing! */ жолынан бұрын қосыңыз:

define('WU_CYBERPANEL_HOST', 'https://your-cyberpanel-host:8090');
define('WU_CYBERPANEL_USERNAME', 'admin');
define('WU_CYBERPANEL_PASSWORD', 'your_secure_password');
define('WU_CYBERPANEL_PACKAGE', 'Default');

Авто-SSL-ді қосу үшін (ұсынылады):

define('WU_CYBERPANEL_AUTO_SSL', true);
define('WU_CYBERPANEL_EMAIL', '[email protected]');

3. Интеграцияны іске қосыңыз​

  1. WordPress желі администраторында, Ultimate Multisite > Settings-ке өтіңіз.
  2. Domain Mapping табына барыңыз.
  3. Төмендегі Host Integrations бөліміне жылжыңыз.
  4. CyberPanel интеграциясын іске қосыңыз.
  5. Save Changes-қа басыңыз.

4. Байланысты тексеріңіз​

Реттеу wizardындағы енгізілген байланыс тестін қолданыңыз:

  1. Ultimate Multisite > Settings > Domain Mapping > Host Integrations > CyberPanel жолдарына өтіңіз.
  2. Test Connection-ды басыңыз.
  3. Сәттілік хабарламасы плагин CyberPanel API-ға қол жеткізе алатынын және дұрыс аутентификациялағанын растайды.

Қалай жұмыс істейді​

Домен картасы (Domain Mapping)​

Ultimate Multisite-та домен картасы жасалған кезде:

  1. Интеграция CyberPanel хостиңіздегі /api/createWebsite нүктесіне POST сұрағын жібереді.
  2. CyberPanel белгіленген пакет астында домен үшін жаңа виртуаль хост құрайды.
  3. Документ тамыры (document root) WordPress желі тамыры директориясына бағдарлануға орнатылады.
  4. Домен картасы алынылған кезде, интеграция виртуаль хосты тазалау үшін /api/deleteWebsite-ке шақырады.

Авто-SSL (Auto-SSL)​

WU_CYBERPANEL_AUTO_SSL true болса:

  1. Виртуал хост жасалғаннан кейін, интеграция домен үшін /api/issueSSL-ді шақырады.
  2. CyberPanel ACME HTTP-01 сынағын қолданып Let's Encrypt сертификатын сұрайды.
  3. Сертификат мерзімінен бұрын CyberPanel арқылы автоматты түрде жаңартылады.

Маңызды: Let's Encrypt доменді растай ала отырып, DNS-ті сервердің IP-адресіне толық тарату қажет. SSL إصدارу картасы жасалғаннан кейін дереу сәтсіз болса, DNS таралуын күтіп тұрыңыз және SSL > Manage SSL арқылы CyberPanel дашбордында қайта іске қосуды жүргізіңіз.

www Поддомен (Subdomain)​

Домен картасы параметрлерінде Auto-create www subdomain қосылған болса, интеграция www.<domain> үшін виртуаль хост атынас жасап, авто-SSL қосылған кезде apex және www варианттарын қамтитын сертификатты шығарады.

Электрондық пошта жіберушілері (Email Forwarders)​

Ultimate Multisite: Emails плагіні белсенді болған кезде, CyberPanel клиенттердің электрондық поштасын жоғары өткізушілерді (customer email forwarders) да ұсына алады. Бұл жоғары өткізушілер домен адресінен басқа кітапхана құрусыз хабарламаларды басқа кітапханаға бағыттайды, бұл [email protected] немесе [email protected] сияқты псевдонимдер үшін өте пайдалы.

Клиенттер үшін жоғары өткізушілерді іске қосу алдында:

  1. Жоғардағы CyberPanel константалары орнатылғанын және байланыс тестілеу сәтті өткенін растаңыз.
  2. Emails плагіні параметрлерінде CyberPanel электрондық қызметін іске қосыңыз.
  3. Жоғары өткізушіні жасау алдында клиенттік домендеген асты CyberPanelде бар екенін растаңыз.
  4. Тест жоғары өткізушісін жасап, одан хабарлама жіберіңіз және өнімдік жоспарларға мүмкіндікті ұсыну алдында бұл мүмкіндікті ұсыныңыз.

Егер жоғары өткізушіні жасау сәтсіз болса, алдымен Ultimate Multisite белсенділік журналына қараңыз, содан кейін CyberPanelде дереккөз домены бар екенін және API пайдаланушысында электрондық менеджмент рұқсаттары бар екенін растаңыз.

Конфигурацияға сілтеме​

КонстантаҚажеттілікБарыष्ठाсыСипаттамасы
WU_CYBERPANEL_HOSTИә—Портты қосқандағы CyberPanel нұсқаңызға дейінгі толық URL, мысалы: https://cp.example.com:8090
WU_CYBERPANEL_USERNAMEИә—CyberPanel администратор пайдаланушы аты-жөні
WU_CYBERPANEL_PASSWORDИә—CyberPanel администратор паролі
WU_CYBERPANEL_PACKAGEИәDefaultЖаңа виртуаль хостарларға беруге арналған CyberPanel хостинг пакеті
WU_CYBERPANEL_AUTO_SSLЖоқtrueДомен жасалғаннан кейін Let's Encrypt SSL сертификатын шығару
WU_CYBERPANEL_PHP_VERSIONЖоқPHP 8.2Жаңа виртуаль хостарлар үшін PHP нұсқасы (CyberPanelде орнатылған нұсқамен сәйкес болуы керек)
WU_CYBERPANEL_EMAILЖоқ—SSL сертификатын тіркеу үшін байланыс электрондық поштасы

Маңызды ескертулер​

CyberPanel API сессиялық токен аутентификациясын қолданады. Интеграция әрбір API шақыру кезінде токенді автоматты түрде алуды қамтамасыз етеді. Сіздің CyberPanel администраторлық аккаунтыңыз веб-сайттарды жасау және өшіру құқығына ие болуы керек. CyberPanel борыштағы порт 8090 де умолчанию жұмыс істейді. Егер сіздің серверіңізде брандмауэр болса, осы порттың WordPress қосымша серверінен қолжетімді екенін қамтамасыз етіңіз. Интеграция DNS тіркемелерін басқаrmaz. Доменді Ultimate Multisite-те картадан бұрын домен DNS-ті сервердің IP-адресіне бағыттауыңыз керек. Егер сіз OpenLiteSpeed (OLS) қолдансаңыз, виртуаль хосттарды өзгертуден кейін қауіпсіз қайта жүктеу автоматты түрде іске қосылады. Қолдану арқылы араласу қажет емес.

Түзету жұмыстары (Troubleshooting)​

API الاتصال жоқ (API Connection Refused)​

  • Сервер брандмауерінде 8090 порты ашық екенін тексеріңіз.
  • WU_CYBERPANEL_HOST мәнінде дұрыс протокол (https://) және порттың бар екенін растаңыз.
  • CyberPanel SSL сертификатының дұрыс екенін тексеріңіз; өзіндік қол қойылған сертификаттар TLS тексеруіне қате туындауы мүмкін. Бұл жағдайда WU_CYBERPANEL_VERIFY_SSL-ді тек сенімді жеке желі орталарында false деп орнатыңыз.

Аутентификация қателері (Authentication Errors)​

  • CyberPanelге тікелей кіріп, WU_CYBERPANEL_USERNAME және WU_CYBERPANEL_PASSWORD-дің дұрыс екенін растаңыз.
  • Қайталанған сәтсіз кіру әрекеттерінен кейін CyberPanel аккаунттарды бұғаттайды. Бұғаттаулар туындаса, CyberPanelде Security > Brute Force Monitor бөлімін тексеріңіз.

Домен жасалмаған (Domain Not Created)​

  • API қате хабарламаларын Ultimate Multisite-те (Ultimate Multisite > Activity Logs) қызмет көрсету журналынан тексеріңіз.
  • WU_CYBERPANEL_PACKAGE арқылы анықталған пакетті CyberPanelде (Packages > List Packages) бар екенін растаңыз.
  • Домендің CyberPanelде веб-сайт ретінде әлі тіркелмегенін қамтамасыз етіңіз — қайталап жасау қате тудырады.

SSL сертификаты шығарылмаған (SSL Certificate Not Issued)​

DNS-тігі толық тарады деп тексеріңіз: dig +short your-domain.com командасы сервердің IP-асын көрсетуі керек. Let's Encrypt жылдамдық шектеулерін (rate limits) қолданады. Егер сіз бұрын бірнеше сертификатты бір домен үшін шығарған болсаңыз, қайта жіберуден бұрын күтіңіз. Сертификат беру кезіндегі қателер туралы мәліметтерді Logs > Error Logs бөлімдегі CyberPanel SSL журналын тексеріңіз. Қосымша шешім ретінде, сіз CyberPanel-ден SSL-ді қолмен шығара аласыз: SSL > Manage SSL > доменді таңдаңыз > Issue SSL.

Сілтемелер​