Skip to main content

Integrácia CyberPanelu

Toto smernica vysvetľuje, ako skonfigurovať integráciu Ultimate Multisite CyberPanel tak, aby mapované domény v vašej sieti boli automaticky pridávané (a odstraňované) ako virtuálne hosty v CyberPanelu, s možnosťou automatického poskytovania SSL cez Let's Encrypt.

Čo to robí​

  • Keď je doména mapovaná v Ultimate Multisite, integrácia volá API CyberPanelu na vytvorenie virtuálneho hosta pre danú doménu.
  • Keď sa mapovanie domény odstráni, integrácia volá API na odstránenie odpovedajúceho virtuálneho hosta.
  • Keď je automatické SSL zapnuté, integrácia spustí vydávanie certifikátu Let's Encrypt okamžite po vytvorení virtuálneho hosta.
  • Možnosť pridávať/odstraňovať alias www. v závislosti od vašej nastavenia "Auto-create www subdomain" v nastaveniach mapovania domén.

Požiadavky​

  • Pracujúca inštancia CyberPanelu (doporučuje sa verzia v2.3 alebo novšia), na ktorú je prístup z vášho WordPress servera.
  • Existujúci webový portál v CyberPanelu, ktorý už slúži ako základ pre vašu sieti WordPress. Integrácia pridáva nové virtuálne hosty k tomuto serveru.
  • Prístup k API CyberPanelu musí byť povolený. Autentifikácia sa vykonáva pomocou vášho používateľského mena a hesla administrátora CyberPanelu.
  • Vaše DNS záznamy pre mapované domény musia už smerovať na IP adresu vášho servera, aby mohol automatické SSL vydávať platný certifikát.

Požiadavky​

Nasledujúce kon constantov musí byť definované v súbore 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');

Možnosť definovať aj:

define('WU_CYBERPANEL_AUTO_SSL', true);          // Predvolené nastavenie: true — vydajte SSL Let's Encrypt po vytvorení domény
define('WU_CYBERPANEL_PHP_VERSION', 'PHP 8.2');  // Predvolené nastavenie: PHP 8.2
define('WU_CYBERPANEL_EMAIL', '[email protected]'); // Používa sa na kontakt pre certifikát SSL

Pokyny na konfiguráciu​

1. Aktivujte API CyberPanel​

  1. Prihláste sa do svojho dashboardu CyberPanel ako admin.
  2. Prejdite do Security > SSL a potvrďte, že SSL je aktivný v siamej rozhrnute CyberPanel (vyžaduje sa pre bezpečnú API volaní).
  3. API CyberPanel je štandardne dostupná na adrese https://va-server-ip:8090/api/. Nie je potrebné robiť žiadne ďalšie kroky na jeho aktiváciu — je to predvolene aktívne pre používateľov admina.

2. Pridajte konстанти do wp-config.php​

Pridajte nasledujúce konconstantné hodnoty do svojho súboru wp-config.php pred čiarom /* That's all, stop editing! */:

define('WU_CYBERPANEL_HOST', 'https://va-cyberpanel-host:8090');
define('WU_CYBERPANEL_USERNAME', 'admin');
define('WU_CYBERPANEL_PASSWORD', 'vaše_bezpečné_heslo');
define('WU_CYBERPANEL_PACKAGE', 'Default');

Aby ste aktivovali auto-SSL (doporučované):

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

3. Aktivujte integráciu​

  1. V administrácii vašej siete WordPress prejdite do Ultimate Multisite > Settings.
  2. Prejdite na záložku Domain Mapping.
  3. Prejdite dole na sekciu Host Integrations.
  4. Aktivujte integráciu CyberPanel.
  5. Kliknite na Save Changes (Uložiť zmeny).

4. Overtečte pripojenosť​

Použite vbudovaný test pripojenia v asistencie nastavení:

  1. Prejdite do Ultimate Multisite > Settings > Domain Mapping > Host Integrations > CyberPanel.
  2. Kliknite na Test Connection.
  3. Úspešné správy potvrdia, že plugin môže dosiahnuť API CyberPanel a správne sa autentizovať.

Ako to funguje​

Domain Mapping (Mapovanie domén)​

Keď je doména mapovaná v Ultimate Multisite:

  1. Integrácia pošle POST požiadavku na /api/createWebsite na vašom hoste CyberPanel.
  2. CyberPanel vytvorí nový virtuálny host pre doménu pod konfigurovaným balíkom (package).
  3. Doména súborový kameň (document root) je nastavený tak, aby ukazoval na základnú smerovú schránku vašej WordPress siete.
  4. Keď sa mapovanie domény odstráni, integrácia volá /api/deleteWebsite na uprnit virtuálny host.

Auto-SSL (Automatické SSL)​

Keď je WU_CYBERPANEL_AUTO_SSL nastavené na true:

  1. Po vytvorení virtuálneho hosta volá integrácia /api/issueSSL pre doménu.
  2. CyberPanel požiada Let's Encrypt o certifikát pomocou ACME HTTP-01 výzvy (challenge).
  3. Certifikát je automaticky obnovovaný CyberPanelom pred expiráciou.

Dôležité: DNS musí byť plne propagovaný na IP adresu vášho serveru, aby Let's Encrypt mohol doménu validovať. Ak sa vydávanie SSL okamžite po mapovaní neprenesie, počkajte na propagáciu DNS a znova spustite SSL z dashboardu CyberPanel pod SSL > Manage SSL.

www Subdomain (Poddoména www)​

Ak je v nastaveniach Domain Mapping zapnutá funkcia Auto-create www subdomain, integrácia vytvorí aj alias virtuálneho hosta pre www.<doména> a pri zapnutom Auto-SSL vydá certifikát, ktorý pokrýva obe varianty – apex (základnú doménu) a www.

Email Forwarders (Prekonajky e-mailov)​

Keď je aktivý addon Ultimate Multisite: Emails, môže CyberPanel poskytovať aj forwardery e-mailov pre zákazníkov. Forwardery presmerujú správy z domény na iný inbox bez vytvárania plného pošтового prepustenia, čo je užitočné pre aliasy ako [email protected] alebo [email protected].

Pred aktivovaním forwarderov pre zákazníkov:

  1. Potvrďte, že vyššie uvedené konštanty CyberPanel sú nakonfigurované a že test pripojenia úspešne prebieha.
  2. Aktivujte poskytovatec e-mailov v nastaveniach addon Email.
  3. Potvrďte, že doména zákazníka už existuje v CyberPanel pred vytvorením forwardera.
  4. Vytvorte testovací forwarder a pošlite si správu cez ne, než ponúknete funkciu na produkčných plánoch.

Ak vytváranie forwardera neúspešne, skontrolujte najprv aktivita logov Ultimate Multisite, potom potvrďte v CyberPanel, že zdrojová doména existuje a že používateľ API má oprávnenia na správu e-mailov.

Referencia konfiguračnej informácie​

KonstanťPožadovanéPredvolené nastaveniePopis
WU_CYBERPANEL_HOSTÁno—Plný URL na vašu instanciu CyberPanel vrátane portu, napr. https://cp.example.com:8090
WU_CYBERPANEL_USERNAMEÁno—Používateľské meno admina CyberPanel
WU_CYBERPANEL_PASSWORDÁno—Heslo admina CyberPanel
WU_CYBERPANEL_PACKAGEÁnoDefaultBalenie hostingu CyberPanel, ktoré sa priradí novým virtuálnym hostom
WU_CYBERPANEL_AUTO_SSLNietrueVytvorenie SSL certifikátu Let's Encrypt po vytvorení domény
WU_CYBERPANEL_PHP_VERSIONNiePHP 8.2Verzia PHP pre nové virtuálne hosty (musí zodpovedať verzii nainštalovanej v CyberPanel)
WU_CYBERPANEL_EMAILNie—E-mail kontakt na registráciu SSL certifikátu

Dôležité poznámky​

API CyberPanel používa autentifikáciu na základe session tokenov. Integrácia automaticky získava token pri každom API volaní. Vaše admin účto v CyberPanel musí mať oprávnenia na vytváranie a odstránenie webových stránok. CyberPanel štartuje po počte 8090 ako štandard. Ak váš server používa firewall, uistite sa, že tento port je prístupný pre server aplikácie WordPress. Integrácia neobsahuje správu DNS záznamov. Musíte doménne DNS ukázať na IP adresu vášho servera pred mapovaním domény v Ultimate Multisite. Ak používate OpenLiteSpeed (OLS), po zmenení virtuálho hosta sa automaticky spustí pokojné restartovanie. Nie je potrebná manuálna intervencia.

Riešenie problémov​

Odmietnuté pripojenie k API​

  • Overte, že port 8090 je otvorený v firewall vášho servera.
  • Potvrďte, že hodnota WU_CYBERPANEL_HOST obsahuje správny protokol (https://) a port.
  • Skontrolujte, či je váš SSL certifikát CyberPanel platný; samopripravené certifikáty môžu spôsobiť chyby v verifikácii TLS. Nastavte WU_CYBERPANEL_VERIFY_SSL na false len v zvykových súkromných sieťových prostredích.

Chyby pri autentifikácii​

  • Potvrďte, že vaše WU_CYBERPANEL_USERNAME a WU_CYBERPANEL_PASSWORD sú správne, priamo sa prihlínajte do CyberPanel.
  • CyberPanel blokuje účty po opakovaných neúspešných pokusoch na prihlásenie. Skontrolujte Security > Brute Force Monitor v CyberPanel, ak dôjde k blokádiyam.

Doména nie je vytvorená​

  • Skontrolujte aktivita log Ultimate Multisite (Ultimate Multisite > Activity Logs) na zmes chýb API.
  • Potvrďte, že balíček definovaný v WU_CYBERPANEL_PACKAGE existuje v CyberPanel (Packages > List Packages).
  • Uistite sa, že doména nie je už zaregistrovaná ako webová stránka v CyberPanel — dvojité vytvorenie webovej stránky vráti chybu.

SSL certifikát nebol vydaný​

  • Potvrďte, že DNS je úplne propagovaný: Príkaz dig +short your-domain.com by mal vrátiť IP adresu vášho serveru.
  • Let's Encrypt nastavuje limity rýchlosti (rate limits). Ak ste nedávno vydali niekoľko certifikátov pre rovnakú doménu, počkajte, než sa pokyniete znova.
  • Pre detaily o chubovnosti vydávania certifikátov si pozrite logy SSL v CyberPanel pod Logs > Error Logs.
  • Ako záverečnú možnosť môžete SSL manuálne vydať cez CyberPanel: SSL > Manage SSL > vyberte doménu > Issue SSL.

Referencie​