Перейти к содержанию

Панель управления Pterodactyl

В этой статье

Информация

Pterodactyl — это бесплатная панель управления игровыми серверами с открытым исходным кодом. Она позволяет централизованно управлять серверами для Minecraft, CS2, Rust и 50+ других игр через веб-интерфейс.

Pterodactyl. Основные возможности

Pterodactyl — это современное решение для управления игровыми серверами, которое сочетает в себе:

  • Поддержка 50+ игр: Предоставляет готовые шаблоны для быстрой установки популярных игровых серверов. Автоматически настраивает ПО, зависимости и параметры запуска, поддерживает выбор версий игр и добавление кастомных шаблонов.
  • Точное управление ресурсами: Контролирует распределение RAM, CPU, дискового пространства и приоритетов между серверами. Предотвращает перегрузки, выделяет ресурсы по квотам и использует SWAP-память для стабильности.
  • Надежные автоматические бэкапы: Обеспечивает гибкое резервное копирование по расписанию с выбором данных (весь сервер или ключевые файлы). Хранит бэкапы локально или в облаке (S3, FTP, GDrive) с шифрованием и мгновенным восстановлением.
  • Эффективная мультисерверность: Запускает каждый сервер в изолированном Docker-контейнере. Автоматически распределяет нагрузку между нодами, назначает порты без конфликтов и позволяет группировать связанные серверы.
  • Гибкий мультипользовательский доступ: Управляет правами через ролевую модель (предустановленные + кастомные роли) с 50+ гранулярными разрешениями. Поддерживает временный доступ, аудит действий и двухфакторную аутентификацию.
  • Консоль управления в реальном времени: Дает полный контроль через веб-интерфейс с интерактивным терминалом (подобным SSH). Включает цветовое форматирование, историю команд, быстрые кнопки действий и оповещения о событиях.
  • Мониторинг статистики в реальном времени: Отображает графики использования ресурсов (CPU, RAM, диск, сеть) и игровые метрики (онлайн, TPS, пинг). Позволяет создавать кастомные дашборды, настраивать оповещения и экспортировать данные в CSV.
  • Упрощенное управление модами/плагинами: Предлагает встроенный магазин для автоматической установки модов, управление версиями и зависимостями. Включает визуальный редактор конфигов с подсветкой синтаксиса и уведомления об обновлениях.
  • Автоматическое обновление: Обеспечивает бесперебойную работу системы. Обновляет игровые серверы по расписанию с тестовым режимом и откатом при ошибках. Обновляет панель управления одной командой (php artisan p:upgrade), проверяя совместимость и мигрируя БД без потерь. Автообновляет демон Wings, поддерживая совместимость с разными дистрибутивами Linux.

Особенности сборки

ID

Основные компоненты системы:

Компонент Назначение
Панель Веб-интерфейс управления (PHP/Laravel)
Wings Демон для управления серверами на нодах (Go)
База данных Хранение конфигураций и данных пользователей

Конфигурационные файлы

Путь Назначение
/var/www/pterodactyl/.env Основные настройки панели
/etc/pterodactyl/config.yml Конфигурация Wings на ноде
/var/log/pterodactyl/ Логи панели
/srv/daemon-data/ Данные игровых серверов

  1. Центральная панель управления:
    Устанавливается на главный сервер (/var/www/pterodactyl)

  2. Ноды (Nodes):
    Физические/виртуальные серверы, на которых запускаются игровые серверы

  3. Демон Wings:
    Устанавливается на каждой ноде, управляет Docker-контейнерами

  4. База данных:
    Хранит конфигурации, пользователей, статистику (/var/lib/mysql/pterodactyl)

Системные требования

Для панели управления

  • Процессор: 2+ ядра
  • Память: 2+ GB RAM
  • Диск: 20+ GB SSD
  • ОС: Ubuntu 20.04/22.04, CentOS ⅞
  • ПО: PHP 8.1+, MySQL 8.0+, Redis, Nginx/Apache

Для нод (на 5-10 игровых серверов)

  • Процессор: 4+ ядер
  • Память: 8+ GB RAM
  • Диск: 50+ GB SSD
  • ОС: Любой Linux с поддержкой Docker
  • Порты: 8080 (Wings), 2022 (SFTP), игровые порты (27015 и др.)

Начало работы после развертывания Pterodactyl

После оплаты заказа на указанную при регистрации электронную почту придет уведомление о готовности сервера к работе. В нем будет указан IP-адрес VPS, а также логин и пароль для подключения. Управление оборудованием клиенты нашей компании осуществляют в панели управления серверами и API — Invapi.

Данные для авторизации, которые можно найти или во вкладке Информация >> Тэги панели управления сервером или в присланном e-mail:

  • Ссылка: в теге webpanel. Для доступа к панели администратора добавьте /admin к основной ссылке;
  • Логин и Пароль приходят в письме на вашу электронную почту при готовности сервера к работе после развертывания ПО.

Первая авторизация

  1. Откройте веб-браузер и перейдите по адресу вашей панели Pterodactyl

  2. Нажмите Login:

  3. После успешной авторизации вы попадете на главную страницу панели.

  4. Для перехода в панель администратора нажмите на кнопку :

Создание пользователя

  1. В левом меню панели администратора нажмите на название раздела Users;

  2. Нажмите кнопку Create New в правом верхнем углу:

  3. Заполните обязательные поля:

    • Username: имя пользователя
    • Email: email адрес пользователя
    • First Name: имя
    • Last Name: фамилия
    • Password: пароль (минимум 8 символов, должен содержать буквы разного регистра и цифры)
  4. При необходимости выберите значение Yesв строке Administrator для предоставления прав администратора

  5. Нажмите Create User:

Создание локации

  1. В левом меню выберите Locations;

  2. Нажмите кнопку Create New в правом верхнем углу:

  3. Заполните поля:

    • Short Code: короткий код локации (например, "US1", "EU1")
    • Description: описание локации (например, "Датацентр в США")

  4. Нажмите Create:

Создание ноды

  1. В левом меню выберите Nodes;

  2. Нажмите кнопку Create New в правом верхнем углу:

  3. Заполните основные настройки:

    • Name: имя ноды (например, hostkey-node1);
    • Location: выберите созданную ранее локацию;
    • Public: установите, если нода должна быть видна пользователям;
    • FQDN: полное доменное имя сервера (например, node1.example.com);
    • Communicate Over SSL: включите для HTTPS соединения;
    • Behind Proxy: включите, если нода находится за прокси.

  4. Настройте конфигурацию:

    • Daemon Server File Directory: /var/lib/pterodactyl/volumes;
    • Total Memory: общее количество RAM в MB;
    • Memory Over-Allocation: процент перевыделения памяти;
    • Total Disk Space: общее дисковое пространство в MB;
    • Disk Over-Allocation: процент перевыделения диска:

  5. Нажмите кнопку Create Node.

Настройка аллокаций (Allocations)

После создания ноды необходимо настроить аллокации - это IP адреса и порты, которые будут доступны для серверов:

  1. Перейдите на вкладку Allocation для настройки IP-адресов и портов;
  2. В разделе Assign New Allocations (справа) заполните поля:
    • IP Address: введите IP адрес сервера (например, 192.168.1.7 или внешний IP);
    • IP Alias: псевдоним для IP адреса (необязательно, поле с placeholder "alias");
    • Ports: укажите порты или диапазон портов (например, 25565 для Minecraft или 25565-25575 для нескольких серверов).

  3. Нажмите зеленую кнопку Submit;

  4. Созданные аллокации появятся в таблице Existing Allocations (слева).

Примечание

Без настройки аллокаций вы не сможете создавать серверы на этой ноде.

Настройка конфигурации ноды

Способ 1: Автоматическая настройка (рекомендуется)

  1. Перейдите на вкладку Configuration;

  2. В разделе Auto-Deploy справа нажмите кнопку Generate Token^

  3. Скопируйте сгенерированную команду (она будет содержать токен для автоматической настройки):

  4. Выполните эту команду на сервере ноды - она автоматически обновит конфигурацию и настроит демон.

Способ 2: Ручная настройка

  1. Перейдите на вкладку Configuration;
  2. Скопируйте содержимое конфигурационного файла из текстового поля слева;
  3. На сервере откройте существующий файл конфигурации для редактирования:

nano /etc/pterodactyl/config.yml
4. Замените содержимое файла на новую конфигурацию, скопированную из веб-интерфейса; 5. Сохраните изменения (Ctrl+X, затем Y, затем Enter).

Проверка и перезапуск

  1. Убедитесь, что конфигурация обновлена правильно: 

    cat /etc/pterodactyl/config.yml

  2. Перезапустите демон Pterodactyl для применения новых настроек: 

    systemctl restart wings

  3. Проверьте статус демона: 

    systemctl status wings

Создание неста и добавление яйца

Создание неста

  1. В левом меню выберите раздел Nests;

  2. Нажмите кнопку Create New в правом верхнем углу:

  3. Заполните поля:

    • Name: название неста (например, "Minecraft");
    • Description: описание неста;

  4. Нажмите Create Nest:

Добавление яйца

  1. В разделе Nests найдите созданный на прошлом этапе и нажмите на него;

  2. Нажмите кнопку New Egg:

  3. Заполните основную информацию:

    • Name: название яйца (например, "Paper Minecraft");
    • Description: описание;
    • Author: автор яйца;
    • Docker Image: образ Docker (например, ghcr.io/pterodactyl/yolks:java_17).
  4. Настройте скрипт установки:
    • Install Script: скрипт для установки сервера;
    • Install Container: контейнер для установки;
    • Install Entrypoint: точка входа для установки;
  5. Настройте переменные окружения для Minecraft Paper:
    • SERVER_JARFILE: paper.jar;
    • VANILLA_VERSION: latest;
    • BUILD_NUMBER: latest.

  6. Нажмите Create Egg:

Примечание: Для Paper Minecraft рекомендуется использовать готовое яйцо из официального репозитория Pterodactyl.

Как использовать готовое яйцо:

  1. Скачайте готовое яйцо Paper:

  2. Импортируйте яйцо в панель:

    • В админ-панели перейдите в раздел Nests;
    • Выберите нужное гнездо (например, Minecraft);
    • Нажмите кнопку Import Egg;
    • Выберите скачанный .json файл;
    • Нажмите Import.

Создание сервера

  1. В левом меню выберите Servers;

  2. Нажмите кнопку Create New в правом верхнем углу:

  3. Заполните основную информацию:

    • Server Name: имя сервера (например, "My Minecraft Server");
    • Server Owner: выберите владельца сервера из списка пользователей;
    • Server Description: описание сервера.
  4. Настройте лимиты ресурсов:
    • Memory: лимит RAM в MB (например, 2048);
    • Swap: лимит swap в MB;
    • Disk Space: лимит дискового пространства в MB;
    • Block IO Weight: приоритет ввода/вывода (100-1000);
    • CPU Limit: лимит CPU в процентах.
  5. Выберите конфигурацию:
    • Node: выберите ноду, на которой будет работать сервер;
    • Default Allocation: основной IP и порт;
    • Additional Allocations: дополнительные порты при необходимости.
  6. Настройте игровые параметры:
    • Nest: выберите "Minecraft";
    • Egg: выберите "Paper";
    • Docker Image: оставьте по умолчанию.
  7. Настройте переменные сервера:
    • Server Jar File: paper.jar;
    • Minecraft Version: укажите версию (например, "1.20.1");
    • Build Number: latest.

  8. Нажмите Create Server:

Запуск сервера

  1. Перейдите в раздел Servers;
  2. Найдите созданный сервер и нажмите на него;
  3. На странице сервера найдите кнопку Start и нажмите на неё;
  4. Дождитесь загрузки сервера - статус изменится на Running;
  5. В консоли сервера вы увидите процесс загрузки Minecraft сервера.

Примечание

Подробная информация по основным настройкам Pterodactyl содержится в документации разработчиков.

Заказ сервера Pterodactyl с помощью API

Для установки данного ПО с использованием API следуйте этой инструкции.

question_mark
Я могу вам чем-то помочь?
question_mark
ИИ Помощник ×