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

WISP

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

Розміщена панель, власний вузол

WISP продається як розміщена послуга: панель запускає wisp.gg, а вузол, який несе ваші ігрові сервери, працює на вашому власному обладнанні. Агент звертається до панелі через її API, а до демона вузла — заради консолі; обидва зʼєднання вихідні, тож нічого не треба відкривати в інтернет.

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

Два ключі API

WISP зберігає поділ Pterodactyl на два API, і жоден окремий ключ не дістає до обох. Створіть їх під обліковим записом адміністратора та вставте обидва разом з адресою панелі.

Адреса панелі: повна URL-адреса, наприклад https://panel.example.com. Додавайте порт лише тоді, коли панель справді працює на ньому; панель за зворотним проксі відповідає на стандартному порту своєї схеми.
Ключ Application API: ним створюються, призупиняються, перевстановлюються та видаляються сервери.
Ключ Client API: для живлення, статистики наживо та консолі.
TLS-відбиток (необовʼязково): на розміщеній панелі WISP залиште його порожнім, бо її сертифікат виданий публічним центром сертифікації і закріплювати нема чого.

Ключі WISP не мають префікса, на відміну від ptla_ у Pterodactyl і papp_ у Pelican. Ніщо не підкаже, що ви переплутали ці два: Provibr не може цього перевірити, а панель відповідає на неправильний ключ порожнім 403, який читається як «недостатньо прав». Якщо перевірка зʼєднання не проходить, спершу спробуйте поміняти ключі місцями, перш ніж щось змінювати в панелі.

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

Транспорт

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

shell

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

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

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

Eggs

Сервер збирається з egg, точно як у Pterodactyl. WISP перелічує всі свої eggs разом з їхніми змінними в одному запиті, тож список заповнюється сам, а тариф може перевизначити будь-яку змінну, яку egg позначає як редаговану.

Залиште обовʼязкову змінну порожньою, і WISP не відхилить замовлення: він тихо підставить власне типове значення egg. Ви отримаєте робочий сервер, тільки не той, який замовляли. Provibr перевіряє обовʼязкові змінні перед надсиланням, тож замовлення натомість зупиняється з повідомленням, яке називає цю змінну.

Тарифи

Ігровий тариф несе egg, ліміти ресурсів і будь-які перевизначення змінних. Замовлення йде через тариф: саме тариф вирішує, який egg використовується і скільки сервер може споживати, а один тариф можна повʼязати з кількома панелями.

Розміщення

Вузол WISP повідомляє свої ядра, памʼять і диск, але не те, скільки з цього вже роздано. Provibr підсумовує це за серверами на вузлі, так само як робить для гіпервізора.

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

Життєвий цикл

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

WISP не повідомляє про невдале встановлення. Сервер або позначений як установлений, або ні, і «ще триває» та «щось пішло не так» ззовні виглядають однаково. Якщо новий сервер лишається невстановленим значно довше, ніж зазвичай потребує egg, відкрийте його консоль у WISP і прочитайте вивід встановлення там.

Консоль і метрики

Консоль — це живий термінал на демоні вузла, у тій самій панелі, що й решта вашої інфраструктури, а графіки використання беруться з власних вимірювань панелі. CPU, памʼять, диск і мережа читаються щоразу під час опитування; WISP не повідомляє час роботи, тож контейнер, який перезапустився між двома опитуваннями, не завжди розпізнається як перезапуск.

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

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

НазадMCSManager ДаліСервери й тарифи