Документація

CyberPanel

CyberPanel — це панель керування з відкритим кодом для вебхостингу. Provibr розмовляє з її API за даними головного адміністратора й керує сайтами на ній: створює їх, призупиняє та поновлює, переносить до іншого пакета й видаляє.

Увімкнути доступ до API

На свіжому CyberPanel API вимкнений, і це стосується також головного адміністратора. Ви вмикаєте його в панелі, у розділі Users, API Access, для користувача admin. Більше нічого не потрібно: Provibr заходить із тими даними, які ви вже маєте.

Якщо залишити його вимкненим, кожен виклик повертається як API Access Disabled, щоб ви не ввели. CyberPanel перевіряє цей перемикач раніше за пароль, тому правильний пароль дає точно таку саму відповідь, як і помилковий. Усе вказує на ваші дані, хоча проблема лежить на одну позначку далі.

Головний адміністратор має називатися admin

Частина API CyberPanel відхиляє будь-яке інше імʼя, крім admin, і саме вона перелічує сайти на панелі й повідомляє, на якому етапі перебуває новий. Provibr потребує обох, тому обліковий запис, який ви вказуєте нижче, — це той, що називається admin.

Це не налаштування, а умова, і вона походить від CyberPanel, а не від нас: перейменований адміністратор для цієї інтеграції не підійде. Перевірка зʼєднання повідомить про це, щоб ви дізналися раніше за перше замовлення.

Що просить Provibr

Чотири поля. Агент зберігає їх у власному сховищі на вашому хості; Provibr не може прочитати їх назад.

Адреса панелі з портом, наприклад https://panel.example.com:8090. Без порту Provibr додає 8090. Звичайний http відхиляється: цей порт розмовляє лише TLS.
Імʼя головного адміністратора, а це admin.
Пароль цього адміністратора.
Відбиток SHA-256 сертифіката, поки панель користується самопідписаним.

У CyberPanel немає токена API, який охоплював би ці команди: у власному API шлях через токен увімкнений або вимкнений для кожного ендпойнта окремо, і саме чотири команди, які створюють, призупиняють, міняють пакет і видаляють сайт, вимагають пароля. Отже, тут стоїть повний пароль головного адміністратора, та сама ситуація, що й із Webmin.

Сертифікат

Кожен свіжий CyberPanel подає один і той самий самопідписаний сертифікат, виданий на www.example.com і підписаний самим CyberPanel. Тому браузер називає його неправильним, а не самопідписаним, і ланцюжок ніколи не перевіряється. Вкажіть відбиток, і агент довірятиме лише цьому сертифікату замість того, щоб вимкнути перевірку. Ви читаєте його з будь-якої машини, яка дістає до панелі:

shell

openssl s_client -connect <host>:8090 </dev/null 2>/dev/null | \
  openssl x509 -noout -fingerprint -sha256

Команди та вивід термінала всюди англійською і в панелі, і на цих сторінках. Один текст, одна правда: те, що ви читаєте тут, ваш хост виведе дослівно так само.

Якщо на імʼя хоста панелі покласти власний сертифікат, ланцюжок перевіряється сам, і поле можна залишити порожнім. Там це кращий вибір, бо такий сертифікат час від часу замінюють, а закріплений доводилося б щоразу вписувати сюди заново.

Пакети

CyberPanel описує в пакеті, чим може користуватися сайт. Provibr читає цей перелік і посилається на пакет за назвою; самі пакети створюють і змінюють у CyberPanel, а не тут.

Тариф вебхостингу в Provibr вказує на один пакет однієї інтеграції. Саме це замовляє ваш клієнт, а ціну ви визначаєте самі.

Перенесення сайта в інший пакет змінює лише облік і нічого більше. Виміряно зсередини сервера з пакетом, який мав інші обмеження: дискова квота залишилася такою, як була, а конфігурація вебсервера зберегла старі значення. Панель показує нову назву, тому читайте її як облік, а не як обмеження, що переїхало разом із нею.

Що надсилає замовлення

Сайт у CyberPanel визначається своїм доменом, і це також його ідентичність у Provibr. Замовлення несе чотири речі:

Домен. Він має бути вільний на панелі, і все, що Provibr робить потім із цим сервером, вказує на нього.
Контактна адреса для сайта.
Пакет, у який потрапляє сайт.
Пароль для входу в панель, який CyberPanel створює під сайтом.

Створення триває в CyberPanel близько пʼятдесяти секунд, із яких близько двадцяти восьми йдуть на спробу SSL, яку панель робить у будь-якому разі. Provibr чекає на справжній результат, а не вірить першій відповіді: вона приходить за якіхось три секунди й не каже нічого, навіть того, чи був домен ще вільний.

Призупинення та поновлення

Обидві дії діють одразу: панель повертає новий стан, а її власний перелік показує його відразу. Provibr призупиняє сайт на ваше прохання й тоді, коли перевищено вашу ємність.

Призупинення в CyberPanel — це хитрість у вебсервері, а не блокування облікового запису. Сайт стає недосяжним, але FTP, пошта й бази даних працюють далі, а користувача unix не заблоковано. Це відрізняється від DirectAdmin і має значення, тільки-но ви використовуєте призупинення як засіб примусу.

Дисковий простір і трафік

CyberPanel є єдиною панеллю керування в Provibr без графіків споживання, і це не інтеграція їх оминає: панель цього не вимірює. Трафік обчислюється й потім відкидається, а витрата диска береться з кешу, який на новому сайті залишився порожнім, тож нуль, що звідти виходить, не відрізнити від справді нульового споживання.

Графік, який назавжди стоїть на нулі, виглядає як вимірювання, тому його немає. Те, чим може користуватися сайт, записано в його пакеті, а те, що CyberPanel все ж знає, залишається в самій панелі.

Сайти, які вже є

Сайти, створені поза Provibr, можна імпортувати зі сторінки інтеграції: агент перелічує те, що є на панелі, а ви обираєте, які з них стануть сервером у Provibr.

Імпортований сайт із цієї миті зараховується до вашої ємності, як і будь-який інший вебсервер.

Чого це не робить

Provibr керує сайтами, а не панеллю: він не встановлює CyberPanel, не оновлює його й не змінює налаштувань сервера. Консолі немає, а DNS, поштові скриньки й бази даних залишаються незайманими. CyberPanel уміє все це сам, і Provibr ним не керує.

НазадHestiaCP ДаліCloudPanel