CyberPanel Integratsiyasi
Bu qo'llanma Ultimate Multisite CyberPanel integratsiyasini qanday sozlashni tushuntiradi, shunda sizning tarmoqdagi xaritalangan domenlar avtomatik ravishda CyberPanelda virtual host sifatida qo'shiladi (va olib tashlanadi), Let's Encrypt orqali ixtiyoriy avtomatik SSL proviziyungslanishi bilan.
Nima Qiladi
- Ultimate Multisite da domain xaritaga solinganida, integratsiya ushbu domain uchun virtual host yaratish uchun CyberPanel API chaqiriladi.
- Domain xaritasi o'chirilsa, integratsiya tegishli virtual hostni o'chirish uchun API chaqiriladi.
- Avtomatik SSL yoqilgan bo'lsa, integratsiya virtual host yaratilgandan so'ng Let's Encrypt sertifikatini darhol chiqarishni boshlaydi.
- Domain Xaritasi sozlamalaridagi "Auto-create www subdomain" (www sousdomainini avtomatik yaratish) sozlamangizga qarab
www.aliasini ixtiyoriy ravishda qo'shadi/olib tashlaydi.
Oldingi Shartlar (Prerequisites)
- Ishlatilayotgan CyberPanel instansi (2.3 yoki undan yuqori versiyasi tavsiya etiladi), bu server WordPress serveringizdan yetib borishi kerak.
- CyberPanelda mavjud bo'lgan veb-sayt, u sizning WordPress tarmoq ildizini (network root) xizmat qilishi kerak. Integratsiya yangi virtual hostlarni shu serverga bog'laydi.
- CyberPanel API kirish imkoniyati yoqilgan bo'lishi kerak. Tasdiqlash uchun sizning CyberPanel administrator ismingiz va parolingizdan foydalaniladi.
- Avtomatik SSL sertifikatini berishi uchun DNS yozuvlaringiz (mapping qilingan domenlar uchun) server IP manziliga yo'naltirilgan bo'lishi kerak.
Talablar (Requirements)
Quyidagi konstantlar wp-config.php faylingizda belgilangan bo'lishi kerak:
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');
Isteqlari, shuni ham belgilashingiz mumkin:
define('WU_CYBERPANEL_AUTO_SSL', true); // Default: true — domen yaratilgandan so'ng Let's Encrypt SSL noutishini beradi
define('WU_CYBERPANEL_PHP_VERSION', 'PHP 8.2'); // Default: PHP 8.2
define('WU_CYBERPANEL_EMAIL', '[email protected]'); // SSL sertifikati bilan bog'lanish uchun ishlatiladi
Sozlash Ko'rsatmalari
1. CyberPanel API ni faollashtirish
- Administrator sifatida CyberPanel dashboard'iga kirish yapishingiz kerak.
- Security > SSL ga o'ting va SSL ning CyberPanel interfeysi o'zida faol ekanligini tasdiqlang (xavfsiz API chaqiruvlari uchun talab qilinadi).
- CyberPanel API ko'pincha
https://your-server-ip:8090/api/manzilida mavjud bo'ladi. Uni faollashtirish uchun qo'shimcha qadamlar kerak emas — admin foydalanuvchilari uchun u avtomatik ravishda yoqilgan bo'ladi.
2. wp-config.php ga konstantalar qo'shish
/* That's all, stop editing! */ qatoridan oldin wp-config.php faylingizga quyidagi konstantalarni qo'shing:
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');
Avtomatik SSL ni faollashtirish uchun (tavsiya etiladi):
define('WU_CYBERPANEL_AUTO_SSL', true);
define('WU_CYBERPANEL_EMAIL', '[email protected]');
3. Integratsiyani Faollashtirish
- WordPress tarmoq administrator panelingizda, Ultimate Multisite > Settings (Sozlamalar) ga kiring.
- Domain Mapping (Doimening Xaritasi) yorlig'iga o'ting.
- Pastga qarab Host Integrations (Mezbon Integratsiyalari) bo'limiga chiqing.
- CyberPanel integratsiyasini faollashtiring.
- Save Changes (O'zgartirishlarni saqlash) tugmasini bosing.
4. Ulanishni Tekshirish
Sozlamalar wizardidagi ichki ulanish testidan foydalaning:
- Ultimate Multisite > Settings > Domain Mapping > Host Integrations > CyberPanel ga o'ting.
- Test Connection (Ulanishni tekshirish) tugmasini bosing.
- Muvaqqiyat xabari plugin CyberPanel APIga yetib borishi va to'g'ri autentifikatsiya qilishini tasdiqlaydi.
Qanday Ishlaydi
Domain Mapping
Ultimate Multisite da doimening xaritasi (mapping) qilinganda:
- Integratsiya sizning CyberPanel hostingizdagi
/api/createWebsitemanziligaPOSTso'rov yuboradi. - CyberPanel belgilangan paket ostida domen uchun yangi virtual host yaratadi.
- Dokument ildizi (document root) WordPress tarmoq ildiz katalogingizga ishora qilish uchun sozlanadi.
- Domen xaritasi o'chirilganda, integratsiya virtual hostni tozalash uchun
/api/deleteWebsiteni chaqiradi.
Auto-SSL
Agar WU_CYBERPANEL_AUTO_SSL haqiqat bo'lsa (true) :
- Virtual host yaratilgandan so'ng, integratsiya domen uchun
/api/issueSSLni chaqiradi. - CyberPanel Let's Encrypt sertifikatini ACME HTTP-01 sinovidan foydalanib so'rab oladi.
- Sertifikat muddati tugashidan oldin CyberPanel tomonidan avtomatik yangilaladi.
Muhim: Let's Encrypt domenni tasdiqlashi uchun DNS serveringizning IP manziliga to'liq tarqalishi kerak. Agar SSL berish xaritmasidan darhol keyin muvaffaqiyatsizlik bo'lsa, DNS tarqalishi uchun kutib turing va CyberPanel dashboardidagi SSL > Manage SSL orqali SSLni qayta ishga tushiring.
www Subdomain
Agar Domain Mapping sozlamalarida Auto-create www subdomain (www sousdomainini avtomatik yaratish) yoqilgan bo'lsa, integratsiya ham www.<domain> uchun virtual host alias yaratadi va auto-SSL yoqilgan bo'lsa, bu ikkala variantni (apex va www) qamlovchi sertifikat beradi.
Email Forwarders
Ultimate Multisite: Emails аддон фаол бўлганида, CyberPanel ҳам мижозлар учун электрон почта юбориш (email forwarders) хизматларини тақдим этиши мумкин. Бу юборишлар орқали хабарномаларни тўлиқ почта хатларини яратишсиз, бир домен манзилидан бошқа қабул қилинадиган хатларга йўналтиради. Бу [email protected] ёки [email protected] каби алиас (alias)лар учун жуда фойдалидир.
Мижозлар учун юборишларни фаол қилишдан олдин:
- Юқоридаги CyberPanel константалари солиштирилгани ва уланиш текшируви муваффақиятли ўтганлигини тасдиқланг.
- Emails аддон параметрларида CyberPanel электрон почта провайдерини фаол қилинг.
- Юборишларни яратишдан олдин мижоз домени CyberPanelда борлигини тасдиқланг.
- Тест юборишни яратинг ва ундан орқали хабарнома юборишингизни продакцион планаларга хизматни таклиф қилишдан олдин синаб кўринг.
Agar forwarder yaratishda muammo yuz bersa, avval Ultimate Multisite faoliyat yozuvlarini tekshiring, so'ngra CyberPanel'da manba domen mavjudligini va API foydalanuvchisida elektron pochta boshqaruvi (email-management) huquqlari borligini tasdiqlang.
Konfiguratsiya Ma'lumotlari
| Constant | Talab Etilganmi | Default | Tavsif |
|---|---|---|---|
WU_CYBERPANEL_HOST | Ha | — | Portni o'z ichiga olgan CyberPanel instansiyasining to'liq URL-i, masalan: https://cp.example.com:8090 |
WU_CYBERPANEL_USERNAME | Ha | — | CyberPanel administrator foydalanuvchi nomi |
WU_CYBERPANEL_PASSWORD | Ha | — | CyberPanel administrator paroli |
WU_CYBERPANEL_PACKAGE | Ha | Default | Yangi virtual hostlarga yuklanadigan CyberPanel hosting paketi |
WU_CYBERPANEL_AUTO_SSL | Yo'q | true | Domen yaratilgandan so'ng Let's Encrypt SSL sertifikatini chiqarish |
WU_CYBERPANEL_PHP_VERSION | Yo'q | PHP 8.2 | Yangi virtual hostlar uchun PHP versiyasi (CyberPanelda o'rnatilgan versiyaga mos kelishi kerak) |
WU_CYBERPANEL_EMAIL | Yo'q | — | SSL sertifikatini ro'yxatdan o'tish uchun aloqa elektron pochta manzili |
Muhim Eslatmalar
CyberPanel API sessiya asosidagi token autentifikatsiyasidan foydalanadi. Integratsiya har bir API chaqiruvda tokenni avtomatik olib oladi.
Sizning CyberPanel administrator hisobingiz veb-saytlarni yaratish va o'chirish huquqlariga ega bo'lishi kerak.
CyberPanel ko'pincha 8090 portida ishlaydi. Agar sizning serveringiz firewal (devorchi) dan foydalansa, bu port WordPress ilova serveridan kirish mumkinligini ta'minlang.
Integratsiya DNS yozuvlarini boshqarmaydi. Domenni Ultimate Multisite da xarita qilishdan oldin domen DNS-ni o'zingizning server IP manziliga yo'naltirish kerak.
Agar siz OpenLiteSpeed (OLS) dan foydalansangiz, virtual hostlar o'zgargandan so'ng yumshoq qayta ishga tushirish avtomatik boshlanadi. Qo'lda aralashish shart emas.
Muammolarni hal qilish
API ulanish rad etildi
- Server firewalidingizda
8090portining açık olduğundan emin olun. WU_CYBERPANEL_HOSTdeğerinin doğru protokol (https://) ve portu içerdiğini doğrulayın.- CyberPanel SSL sertifikanızın geçerli olup olmadığını kontrol edin; kendi kendine imzalanmış (self-signed) sertifikalar TLS doğrulama hatalarına neden olabilir. Sadece güvenilir özel ağ ortamlarında
WU_CYBERPANEL_VERIFY_SSLdeğerinifalseolarak ayarlayın.
Kimlik Doğrulama Hataları
- CyberPanel'e doğrudan giriş yaparak
WU_CYBERPANEL_USERNAMEveWU_CYBERPANEL_PASSWORDbilgilerinizin doğru olduğundan emin olun. - Giriş denemeleri tekrar başarısız olursa, CyberPanel'de Security > Brute Force Monitor (Kaba Kuvvet İzleme) bölümünü kontrol edin; kilitlenmeler yaşanırsa buraya bakın.
Alan Adı Oluşturulmadı
API xatolarini tekshirish uchun Ultimate Multisite faoliyat yozuvlaridan (Ultimate Multisite > Activity Logs) foydalaning.
WU_CYBERPANEL_PACKAGE ichida belgilangan paket CyberPanel'da (Packages > List Packages) mavjudligini tasdiqlang.
Domain hali CyberPanel'da veb-sayt sifatida ro'yxatdan olinmaganligiga ishonch hosil qiling — takroriy veb-sayt yaratish xato beradi.
SSL Sertifikati Chiqarilmagan
DNS to'liq tarqalganligini tasdiqlang: dig +short your-domain.com buyrug'i serveringiz IP adresini qaytarishi kerak.
Let's Encrypt tezlik cheklovlarini (rate limits) qo'llaydi. Agar siz yaqinda bir xil domen uchun bir nechta sertifikat bergan bo'lsangiz, qayta urinishdan oldin kutib turing.
Sertifikat berishdagi muammolarga batafsil ma'lumotlar uchun Logs > Error Logs bo'limidagi CyberPanel SSL loglarini tekshiring.
Alternativ usul sifatida, siz CyberPanel orqali SSLni qo'lda berishingiz mumkin: SSL > Manage SSL > domen tanlang > Issue SSL.
Manbalar
- CyberPanel API Dokumentatsiyasi: https://docs.cyberpanel.net/docs/category/api
- CyberPanel SSL Boshqaruvi: https://docs.cyberpanel.net/docs/cyberpanel/SSL/manageSSL
- Let's Encrypt Tezlik Cheklovlari: https://letsencrypt.org/docs/rate-limits/