Pterodactyl в Майнкрафте — установка панели и управление

Pterodactyl — бесплатная панель с открытым исходным кодом для управления серверами Майнкрафта через браузер: запуска, остановки, ввода команд, работы с файлами и резервными копиями. На готовом хостинге достаточно войти в выданную панель; для собственной установки нужен Linux-сервер с поддержкой Docker. Панель не предоставляет вычислительные ресурсы: VPS или выделенную машину вы оплачиваете отдельно. При ограниченном бюджете сравните варианты дешёвого хостинга Майнкрафт.

Как устроены Panel, Wings и eggs

Веб-панель и игровые серверы могут работать на одной машине. Если машин несколько, к одной панели подключают несколько узлов с Wings.

Адрес панели и игровой адрес — разные вещи. Панель открывают в браузере, а в Майнкрафте подключаются к адресу игрового сервера и его порту.

Как запустить сервер на готовом хостинге

Если вам уже выдали доступ к Pterodactyl Panel, устанавливать Linux, Docker и Wings не требуется. Выбор ядра, версии Java и лимитов зависит от настроек хостинга и ваших прав.

1. Откройте сервер и вкладку Console. Здесь находятся журнал, строка команд и кнопки управления.
2. Проверьте Startup. Сверьте версию Майнкрафта, имя запускаемого файла и Docker-образ. Набор полей зависит от egg.
3. Нажмите Start. При первом запуске Java-сервера потребуется принять EULA. Прочитайте соглашение; если отдельного окна нет, после остановки сервера установите eula=true в файле eula.txt и запустите его снова.
4. Дождитесь завершения загрузки. Если процесс остановился с ошибкой, сначала прочитайте последние сообщения консоли.
5. Скопируйте игровой адрес. Подключитесь из подходящей редакции игры. Общие шаги подготовки есть в руководстве по созданию сервера.

В консоль Java-сервера вводите команды без начального /: например, list, whitelist on или op НикИгрока. Последняя команда выдаёт права оператора внутри игры; используйте её только для доверенных игроков. Другие примеры есть в разделе команд Майнкрафта.

Консоль Майнкрафта не выполняет команды Linux: вводить в неё apt или systemctl бесполезно. Для администрирования собственной VPS нужен отдельный SSH-доступ.

Как редактировать файлы и менять ядро

Перед изменением server.properties, заменой мира, ядра или модов остановите сервер кнопкой Stop и дождитесь завершения процесса. Для больших загрузок используйте SFTP: адрес, порт и имя пользователя смотрите в Settings. Выбирайте именно протокол SFTP, а не FTP.

• Vanilla подходит для сервера без модов и Bukkit-плагинов.
• Paper используют для совместимых Bukkit- и Paper-плагинов.
• Fabric, Forge и NeoForge выбирают под конкретную сборку модов и её версию Майнкрафта.

Замена одного файла server.jar подходит не каждой сборке: загрузчику модов могут требоваться библиотеки и собственная команда запуска. Для такого перехода используйте подходящий egg. Перед сменой ядра сохраните копию всех файлов; сначала проверьте запуск на копии сервера.

Что нужно для самостоятельной установки

Нужны Linux-машина, права root или sudo, SSH-доступ, доменные имена для панели и узла, настроенные DNS и HTTPS. Для Wings обязательна возможность запускать Docker. На VPS с LXC или OpenVZ уточните её у провайдера: одного названия виртуализации недостаточно.

В документации Pterodactyl ветка 1.x обозначена как стабильная, а 2.0 — как открытая бета. Ниже приведён порядок для Panel 1.x; зависимости и команды разных веток смешивать нельзя. Требования Panel 1.x.

Универсального минимума оперативной памяти для любого сервера нет. Ресурсы нужны системе, панели, базе данных и каждому игровому процессу. Не выделяйте контейнерам всю RAM машины: Java расходует память и за пределами кучи, ограниченной параметром -Xmx.

В каком порядке устанавливать Panel и Wings

Команды установки пакетов зависят от дистрибутива Linux. Сначала подготовьте зависимости выбранной ветки, затем переходите к настройке приложения.

1. Подготовьте файлы Panel. Распакуйте выбранный выпуск в /var/www/pterodactyl, создайте базу данных и отдельного пользователя для неё.
2. Настройте приложение. В каталоге панели выполните cp .env.example .env и composer install --no-dev --optimize-autoloader. Только при новой установке создайте ключ командой php artisan key:generate --force.
3. Укажите параметры. Выполните php artisan p:environment:setup, php artisan p:environment:database и настройте почту через php artisan p:environment:mail.
4. Создайте таблицы и администратора. Используйте php artisan migrate --seed --force, затем php artisan p:user:make. Сохраните .env и ключ APP_KEY вне этой машины.
5. Настройте службы Panel. Выдайте веб-серверу необходимые права, направьте сайт на каталог /var/www/pterodactyl/public, включите HTTPS, ежеминутный cron для artisan schedule:run и обработчик очереди pteroq.
6. Подготовьте игровой узел. Установите Docker и Wings. Создайте узел через Nodes в панели и сохраните выданную конфигурацию в /etc/pterodactyl/config.yml. Для HTTPS-панели обеспечьте HTTPS-доступ к Wings с действующим сертификатом.
7. Проверьте Wings. Запустите sudo wings --debug. После проверки остановите его сочетанием клавиш Ctrl+C, создайте службу systemd по инструкции Wings и включите её командой sudo systemctl enable --now wings.
8. Создайте игровой сервер. Добавьте allocation на узле, затем выберите владельца, egg, Docker-образ, лимиты ресурсов и основной игровой порт.

Для allocation используйте адрес сетевого интерфейса узла; при NAT может потребоваться внутренний адрес и отдельный проброс порта. Адрес 127.0.0.1 для allocation не подходит. Настройка Wings и allocations.

Как установить Pterodactyl eggs

Egg содержит команду запуска, переменные, допустимые Docker-образы и сценарий установки. Это шаблон для панели: загружать его в папку plugins игрового сервера не нужно.

1. Выберите шаблон для нужного ядра в каталоге Pterodactyl Eggs и скачайте его JSON-файл.
2. В административной части Panel 1.x откройте Nests и выберите Import Egg.
3. Укажите JSON-файл и nest, в котором будет находиться шаблон.
4. Создайте сервер с этим egg. Проверьте переменные: версию игры, имя файла и другие параметры установки.

В Panel 2.0 импорт устроен иначе: Admin → Eggs → Browse catalog → выбор шаблона → Import. Установленный egg не обновляется автоматически вместе с каталогом. Порядок импорта eggs.

На арендованном игровом сервере импорт обычно выполняет администратор хостинга. Если нужного ядра или образа нет, обратитесь в поддержку. Обновление egg, замена серверных файлов и обновление самой панели — отдельные действия.

Как выбрать Java для сервера

Для Java Edition 26.3 выбирайте окружение с Java 25. В Pterodactyl важна Java внутри Docker-образа игрового сервера: установка новой Java на самой VPS не меняет окружение контейнера.

Откройте Startup и найдите Docker Image. Если подходящего варианта нет, администратору нужно добавить совместимый образ в egg и разрешить его использование сервером. Такой порядок выбора Java описан и в документации Paper.

Для популярных старых версий — 1.12.2, 1.16.5, 1.20.1 и 1.21.x — проверяйте требования именно вашего ядра и загрузчика модов. Самая новая Java подходит не каждой старой сборке. Обновление Pterodactyl само по себе не обновляет Майнкрафт, моды или плагины.

Для Bedrock Dedicated Server нужен отдельный egg и подходящий Docker-образ; Java ему не требуется. Обычный Java-сервер принимает игровые подключения по TCP, Bedrock-сервер — по UDP. Установка панели сама по себе не объединяет игроков двух редакций.

Как настроить резервные копии и доступ помощникам

Для резервных копий администратор должен настроить хранилище и разрешить их создание для сервера. По умолчанию используется локальное хранилище Wings; доступно и S3-совместимое хранилище. Настройки резервного копирования.

1. Остановите сервер и создайте пробную копию во вкладке Backups. Дождитесь успешного завершения.
2. Скачайте важную копию на другую машину. Архив на том же диске не защитит от потери этого диска.
3. Для регулярных копий создайте расписание в Schedules и добавьте действие создания резервной копии.
4. Проверьте время следующего запуска, результат выполнения и доступный лимит копий.

Резервная копия игрового сервера не заменяет копию базы данных Panel, файла .env и конфигурации Wings. Если плагины хранят данные во внешней базе, сохраняйте её отдельно.

Помощников добавляйте через Users и выдавайте только необходимые разрешения. Например, для перезапуска не требуется право удаления файлов. Учётная запись в панели, административные права Panel и права оператора Майнкрафта настраиваются отдельно.

Почему сервер не запускается или недоступен

Сначала сохраните полный текст ошибки. На своей VPS состояние Wings можно проверить через sudo systemctl status wings, последние записи службы — через sudo journalctl -u wings -n 100 --no-pager. Если ошибка возникает уже при загрузке Майнкрафта, проверьте также раздел ошибок и решений.