Skip to main content

CyberPanel ინტეგრაცია

ეს გზამი აგიხსნით, როგორ დავაყენოთ Ultimate Multisite-ის CyberPanel ინტეგრაცია, რომ თქვენს ქსელში მაცნობილი დომეინები ავტომატურად დაემატოს (და მოიხსნას) როგორც ვირტუალური ჰოსტები CyberPanel-ში, ოპციონალურად Let's Encrypt-ის მეშვეობით ავტომატური SSL-ის მომწოდებით.

რა აკეთებს ეს​

  • როდესაც დომენი დაემატება Ultimate Multisite-ში, ინტეგრაცია იყენებს CyberPanel API-ს იმ დომენისთვის ვირტუალური ჰოსტის შესაქმნელად.
  • როდესაც დომენის მაცნობა მოხსნილია, ინტეგრაცია API-ს აგზავნის ბრძანებას შესაბამისი ვირტუალური ჰოსტის წაშლისთვის.
  • თუ ავტომატური SSL ჩართულია, ინტეგრაცია Let's Encrypt-ის სერტიფიკატის გამოშვებას დაუყოვნებლივ იწყებს ვირტუალური ჰოსტის შექმნის შემდეგ.
  • ოპციალურად, ემატება/მოიხსნება www. ალIAS (별명) იმის მიხედვით, თუ რა პარამეტრებია დაყენებული Domain Mapping-ის პარამეტრებში "Auto-create www subdomain" (ავტომატური www დომენის შექმნა).

წინაპირობები​

  • მუშა მყოფი CyberPanel ინსტანცია (რეკომენდებულია v2.3 ან უფრო ახალი) თქვენი WordPress სერვერისგან ხელმისაწვდომი.
  • არსებული ვებგვერდი CyberPanel-ში, რომელიც უკვე აწვდის თქვენს WordPress ქსელის ძირს. ინტეგრაცია ამ სერვერთან ახალ ვირტუალურ ჰოსტებს დააკავშირებს.
  • CyberPanel API-ის წვდომა ჩართულია. ავთენტიფიკაცია ხდება თქვენი CyberPanel ადმინისტრატორის მომხმარებლის სახელით და პაროლით.
  • მაცნობილი დომეინებისთვის თქვენი DNS რეკორდები უკვე უნდა მიუთითებდეს თქვენი სერვერის IP მისამართზე, სანამ ავტომატური SSL-მა მოგცემს ვალიდურ სერტიფიკატს.

მოთხოვნები​

ქვემოთ ჩამოთვლილი კონსტანტები უნდა იყოს განსაზღვრული თქვენს 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. გადაამოწმეთ კავშირი​

გამოიყენეთ პარამეტრების ვიზიტორში არსებული შენიშვნის ტესტი:

  1. გადადით Ultimate Multisite > Settings > Domain Mapping > Host Integrations > CyberPanel.
  2. დააჭირეთ Test Connection.
  3. წარმატების შეტყობინება ადასტურებს, რომ პლაგინი შეძლებს CyberPanel API-ის მიღებას და სწორად ავთენტიფიცირებას.

როგორ მუშაობს​

Domain Mapping (დომენის ერკვევა)​

როდესაც დომენი იხაზება Ultimate Multisite-ში:

  1. ინტეგრაცია აგზავნის POST მოთხოვნას /api/createWebsite-ზე თქვენს CyberPanel ჰოსტზე.
  2. CyberPanel ქმნის ახალ ვირტუალურ ჰოსტს დომენისთვის კონფიგურირებული პაკეტის ქვეშ.
  3. დოკუმენტის ფესვი (document root) დაყენებულია იმის მიხედვით, რომ ის მიუთითებდეს თქვენი WordPress-ის ქსელის ძირითად დირექტორიაში.
  4. როდესაც დომენის ერკვევა მოხსნილია, ინტეგრაცია იძახებს /api/deleteWebsite-ს ვირტუალური ჰოსტის გასუფთავებისთვის.

Auto-SSL (ავტომატური SSL)​

როდესაც WU_CYBERPANEL_AUTO_SSL არის true:

  1. ვირტუალური ჰოსტის შექმნის შემდეგ, ინტეგრაცია იძახებს /api/issueSSL-ს დომენისთვის.
  2. CyberPanel მოითხოვს Let's Encrypt სერტიფიკატს ACME HTTP-01 გამოწვევის გამოყენებით.
  3. სერტიფიკატი ავტომატურად განახლდება CyberPanel-ის მიერ ვადის გასვლის წინ.

მნიშვნელოვანია: DNS-ის სრულად გავრცელება თქვენი სერვერის IP მისამართზე უნდა მოხდეს, სანამ Let's Encrypt შეძლებს დომენის ვალიდაციას. თუ SSL-ის გამოცემა დაუყოვნებლივ ჩავარდება ერკვევის შემდეგ, დაელოდეთ DNS-ის გავრცელებას და ხელახლა დაწყება SSL-ის პროცესის CyberPanel-ის დაფის SSL > Manage SSL განყოფილებაში.

www Subdomain (www ქვედომენი)​

თუ Domain Mapping-ის პარამეტრებში გააქტიურებულია Auto-create www subdomain, ინტეგრაცია ასევე ქმნის ვირტუალურ ჰოსტის ალIAS-ს www.<domain>-ისთვის და, როდესაც ავტომატური SSL-ი ჩართულია, გამოჰყავს სერტიფიკატი როგორც მთავარ (apex), ასევე www ვარიანტებს.

Email Forwarders (ელფოსტის გადამხდელები)​

როდესაც Ultimate Multisite: Emails add-on აქტიურია, CyberPanel ასევე შეუძლია მომხმარებლების ელფოსტის გადამამის (email forwarders) გაწევაც. Forwarders იგზავნი შეტყობინებებს დომეინის მისამართიდან სხვა მიმღებლად, სრული მეილბოქსის შექმნის გარეშე, რაც სასარგებლოა ასეთი ალთაებისთვის, როგორიცაა [email protected] ან [email protected].

მომხმარებლებისთვის forwarders-ის ჩართვის წინ:

  1. დაადასტურეთ, რომ ზემოთ მითითებული CyberPanel констанტები კონფიგურირებულია და კავშირის ტესტი წარმატებით გადის.
  2. ჩართეთ CyberPanel ელფოსტის პროვაიდერი Emails add-on-ის პარამეტრებში.
  3. დაადასტურეთ, რომ მომხმარებლის დომენი უკვე არსებობს CyberPanel-ში forwarder-ის შექმნის წინ.
  4. შექმენით ტესტო forwarder და გაგზავნეთ შეტყობინება მისამართიდან, სანამ ფუნქციას პროდუქციის პლანებზე დაუწერთ.

თუ forwarder-ის შექმნა ვერ ხერხდება, პირველ რიგში შეამოწმეთ Ultimate Multisite აქტივობის логები (activity logs), შემდეგ კი დაადასტურეთ CyberPanel-ში, რომ წყარო დომენი არსებობს და API მომხმარებელს აქვს ელფოსტის მართვის უფლებები.

კონფიგურაციის მითითებები​

константаსაჭირონაგულისხმევიაღწერა
WU_CYBERPANEL_HOSTდიახ—სრული URL თქვენი CyberPanel ინსტანციისთვის პორტით, მაგალითად: https://cp.example.com:8090
WU_CYBERPANEL_USERNAMEდიახ—CyberPanel ადმინისტრატორის მომხმარებლის სახელი
WU_CYBERPANEL_PASSWORDდიახ—CyberPanel ადმინისტრატორის პაროლი
WU_CYBERPANEL_PACKAGEდიახDefaultCyberPanel-ის ჰოსტინგ პაკეტი, რომელიც დაემატება ახალ ვირტუალურ ჰოსტებს
WU_CYBERPANEL_AUTO_SSLარაtrueLet's Encrypt SSL სერტიფიკატის გამოცემა დომენის შექმნის შემდეგ
WU_CYBERPANEL_PHP_VERSIONარაPHP 8.2PHP-ის ვერსია ახალი ვირტუალურ ჰოსტებისთვის (უნდა համապატარებოდეს CyberPanel-ში დანერგილ ვერსიას)
WU_CYBERPANEL_EMAILარა—SSL სერტიფიკატის რეგისტრაციისთვის საკონტაქტო ელფოსტა

მნიშვნელოვანი შენიშვნები​

CyberPanel API სესიის ბაზაზე არსებულ ტოკენით ავთენტიფიკაციას იყენებს. ინტეგრაცია ავტომატურად ახორციელებს ტოკენის მიღებას თითოეულ API მოთხოვნაზე. သင့် CyberPanel ადმინისტრაციულ ანგარიშს უნდა ჰქონდეს ვებგვერდების შექმნისა და წაშლის უფლებები. CyberPanel ნაგულისხმევად მუშაობს პორტზე 8090-ზე. თუ თქვენს სერვერზე გაქვთ ფაირვოლი, დარწმუნდით, რომ ეს პორტი ხელმისაწვდომია WordPress აპლიკაციის სერვერიდან. ინტეგრაცია არ მართავს DNS ჩანაწერებს. დომეინის DNS-ის მიმართულების დაყენება თქვენი სერვერის IP მისამართზე უნდა მოხდეს Ultimate Multisite-ში დომეინის მ正確ად დასახვის წინ. თუ OpenLiteSpeed (OLS) იყენებთ, ვირტუალური ჰოსტის ცვლილების შემდეგ ავტომატურად იწყება გრასაული გადატვირთვა. არ არის საჭირო ხელით ჩარევა.

პრობლემების მოგვარება​

API-ის კავშირის უარყოფა (API Connection Refused)​

  • შეამოწმეთ, არის თუ არა პორტი 8090 ღია თქვენს სერვერის ფაიროლში.
  • დაადასტურეთ, რომ WU_CYBERPANEL_HOST-ის მნიშვნელობა შეიცავს სწორ პროტოკოლს (https://) და პორტს.
  • შეამოწმეთ, არის თუ არა თქვენი CyberPanel SSL სერტიფიკატი ვალიდური; თვითდასახული სერტიფიკატები შეიძლება გამოიწვიოს TLS-ის გადამოწმების შეცდომები. WU_CYBERPANEL_VERIFY_SSL-ს დააყენეთ false მხოლოდ სანდო პრივატულ ქსელურ გარემოში.

ავთენტიფიკაციის შეცდომები (Authentication Errors)​

  • დაადასტურეთ, რომ თქვენი WU_CYBERPANEL_USERNAME და WU_CYBERPANEL_PASSWORD სწორია, პირდაპირი წვდომით CyberPanel-ში შესვლით.
  • CyberPanel ბლოკავს ანგარიშებს შეცდომით შესვლის მრავალი ცდუნების შემდეგ. თუ დაბლოკვა ხდება, შეამოწმეთ Security > Brute Force Monitor CyberPanel-ში.

დომეინის არარსებობა (Domain Not Created)​

  • შეამოწმეთ Ultimate Multisite-ის აქტივობის ჟურნალი (Ultimate Multisite > Activity Logs) API-ის შეცდომის შეტყობინებების მიხედვით.
  • დაადასტურეთ, რომ 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). თუ ბოლო პერიოდში რამდენიმე სერტიფიკატი გაეცით იმავე დომეინისთვის, ხელახლა ცდებისთვის დაელოდეთ. შეამოწმეთ CyberPanel-ის SSL-ის логები Logs > Error Logs განყოფილებაში სერტიფიკატების გამოცემის წარუმატებლობის შესახებ დეტალებისთვის. როგორც yedek (fallback) ვარიანტი, შეგიძლიათ SSL-ის მართვა ხელით გააკეთოთ CyberPanel-იდან: SSL > Manage SSL > აირჩიეთ დომენი > Issue SSL.

დამატებითი ინფორმაცია (References)​