Перейти до вмісту

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

Pterodactyl

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

Два ключі, а не один

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

  • Ключ застосунку: створення, призупинення, перевстановлення, видалення та читання. Він починається з ptla_.
  • Клієнтський ключ: керування живленням, вимірювання використання та консоль. Він починається з ptlc_.
  • Хост: адреса панелі. Порт не підставляється: панель Pterodactyl — це звичайний вебсайт за зворотним проксі.
Створюйте обидва ключі, увійшовши як адміністратор. Клієнтський ключ звичайного облікового запису не бачить чужих серверів, і тест зʼєднання скаже про це одразу, а не залишить вас зʼясовувати це згодом.
Якщо переплутати ці два ключі місцями, це помітять ще до того, як щось залишить ваш хост, бо в кожного з них свій префікс.

Налаштування

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

Слова, якими послуговується Pterodactyl

Egg
Рецепт збирання: які образи контейнерів можна використовувати, команда запуску та власні змінні. Egg — це те, що ви обираєте замість операційної системи.
Nest
Група eggs. Це лише позначка; насправді посилаються саме на egg.
Вузол
Машина, на якій працює Wings, демон, що запускає контейнери. Якщо ви не оберете вузол, буде обрано той, у якого найбільше вільної памʼяті, оминаючи вузли на обслуговуванні та непублічні вузли.
Виділення
Адреса й порт, які слухає сервер. Панель роздає їх зі свого власного списку; Provibr тут адрес не призначає, бо це була б обіцянка, якої він не може дотримати.

Ігрові тарифи

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

  • Egg на одній інтеграції, а nest записано як позначку.
  • За бажанням можна вказати образ контейнера та команду запуску. Якщо залишити порожнім, вирішує egg.
  • Значення змінних, які перекривають значення egg за замовчуванням. Надсилається кожна змінна, яка є в egg, зокрема й ті, яких клієнт ніколи не бачить, бо панель відхиляє створення, якщо бракує хоч одного поля.
  • Памʼять, swap, диск, CPU та вага вводу-виводу. Нуль означає «без обмежень» для памʼяті, swap, диска та CPU.
  • Скільки баз даних, додаткових виділень і резервних копій може мати сервер.
Винятком є вага вводу-виводу: там нуль не означає «без обмежень». Панель приймає лише значення від 10 до 1000, а нуль непомітно стає 500.

Що можна робити

Запустити, зупинити, перезапустити, жорстко зупинити, призупинити, відновити, оновити, перевстановити та видалити. Різниця між мʼякшими й жорсткішими варіантами тут важить більше, ніж деінде.

  • «Зупинити» надсилає в консоль власну команду зупинки з egg, тож гра завершується так, як їй належить.
  • «Жорстко зупинити» знімає контейнер миттєво. Усе, що ще не записано на диск, буде втрачено, і панель попросить підтвердження.
  • «Призупинити» зупиняє сервер і закриває його власнику доступ. Файли залишаються. Це саме те, чим користується платформа, коли ви перевищуєте ліміт ліцензії.
  • «Перевстановити» знову запускає інсталяційний контейнер egg. Що станеться з наявними файлами, вирішує egg, а не ми, і це сказано в підтвердженні.
Жодному результату не вірять на слово. Pterodactyl підтверджує більшість змін порожньою відповіддю, тож кожна з цих дій завершується повторним читанням сервера і повідомленням про те, що там насправді виявлено.

Консоль

Консоль — це термінал на працюючому контейнері, який передається від Wings через вашого агента до вашого браузера. Ви бачите вивід консолі, зміни статусу та використання; ви можете надсилати команди. Докладніше про це читайте на сторінці про консоль.

Перейняти наявні сервери

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

Варто знати

  • Керування самою панеллю чи її вузлами не передбачено. Provibr створює, запускає та прибирає сервери на панелі, якою керуєте ви.
  • Резервні копії, бази даних і додаткові виділення — це ліміти, які ви задаєте в тарифі; користуються ними в самій ігровій панелі. Їхня кількість надходить разом з опитуванням.
  • Панель кешує показники використання приблизно на двадцять секунд, а Provibr опитує її приблизно з тим самим ритмом. Процесор, памʼять і диск завжди правильні; повторне зчитування може показати нульову швидкість мережі там, де трафік був.
  • Pterodactyl 1.x не повідомляє свою версію через API, тож тест зʼєднання лишає це поле порожнім. Це не помилка.