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

ISPConfig

Provibr керує обліковими записами хостингу ISPConfig через віддалений API панелі. Агент зʼєднується назовні з вашою інсталяцією ISPConfig, тож немає ні вхідних портів, ні VPN. Ця сторінка описує, чим ISPConfig відрізняється й що робить інтеграція.

Один обліковий запис — це один сайт

ISPConfig відділяє клієнта (замовника, з входом і набором обмежень) від web_domain (сайта). Один обліковий запис хостингу Provibr — це один сайт, визначений своїм доменом. Щоб створити сайт, потрібен власник, тож Provibr створює нового клієнта й сайт під ним, а коли ви видаляєте обліковий запис, прибирає обох. Агент виводить вхід клієнта з домену, тож завжди знаходить власника знову.

Що потрібно агентові

Чотири поля, які вводяться один раз, коли ви підключаєте інтеграцію:

Адреса панелі: повний https-URL, разом із портом (8080 типово).
Віддалений користувач: створений у System → Remote Users, обмежений функціями client і sites.
Пароль цього віддаленого користувача.
Відбиток TLS панелі: рекомендовано, бо свіжа інсталяція самопідписана.

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

Сертифікат

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

shell

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

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

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

Пакети

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

Ви обираєте пакет за назвою у формі замовлення й змінюєте його згодом без простою. Зміна переносить обмеження клієнта одразу.

Віддалений API не може створити шаблон клієнта, тож пакети ви будуєте самі в панелі ISPConfig. Provibr лише посилається на них за назвою; назву, якої він не знає, буде відхилено, перш ніж щось створиться.

Життєвий цикл облікового запису

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

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

Призупинення

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

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

Споживання

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

Споживання диска заповнюється після того, як відпрацювало завдання моніторингу панелі, тож на свіжому сайті ще немає показника, а це не те саме, що нуль. Трафік береться з одного виклику для всіх сайтів; диск — з одного виклику на клієнта.

Імпорт

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

НазадCloudPanel ДаліPterodactyl