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 серверден жеткиликтүү болушу керек.
  • CyberPanelде дагы эле 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 файлына константаларды кошуу

Төмөнкү константаларды `/* That's all, stop editing! */` сапка чейин `wp-config.php` файыңызга кошуңуз:

```php
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 тармагыңыздын kök директоруна багытталган болуп коюлат.
  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 колдонуучулардын электрондук почтасын өткөрүүчү (email forwarders) кызматтарын да сунуштай алат. Бул өткөрүүчтөр домен адрести билген каттарды толук почта ханасы түзбөй, бир инбоксга жөнөтөт, бул [email protected] же [email protected] сыяктуу алиас (alias) үчүн пайдалуу болот.

Колдонуучулар үчүн өткөрүүчтөрдү иштетүүгө алдында:

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

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

API Байланыс Режесін Қабылдамау​

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

Аутентификация Қателіктері​

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

Домен Жасалмаған​

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

SSL Сертификаты Жарналмаған​

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

Маалыматтар​