Установка сервера BungeeCord в панели Pterodactyl

Материал из ARK-HOSTER.RU | Документация хостинга
Версия от 11:37, 19 ноября 2026; Maintenance script (обсуждение | вклад) (Статья исправлена по результатам проверки: сервер BungeeCord в панели Pterodactyl)
(разн.) ← Предыдущая версия | Текущая версия (разн.) | Следующая версия → (разн.)
Перейти к навигации Перейти к поиску

Инструкция, как установить и запустить сервер BungeeCord в панели управления Pterodactyl. Сама панель уже должна быть установлена — это описано в статье Как установить и настроить панель управления игровым сервером Pterodactyl. Все снимки экрана сняты с настоящей панели: инструкция проверена 19 ноября 2026 года на Pterodactyl 1.15.2 и Wings 1.13.5 со сборкой BungeeCord для Minecraft 1.8–26.x.

BungeeCord — прокси для Minecraft Java Edition. Игроки заходят на один адрес, а прокси направляет их на один из ваших серверов — лобби, выживание, мини-игры — и позволяет переходить между ними командой /server. Сам BungeeCord мира не содержит: игровые серверы ставятся отдельно, например Paper.

Что понадобится

  • VDS с установленной панелью Pterodactyl и узлом Wings; вход в панель под учётной записью администратора.
  • Память: прокси занимает около 150 МБ. Серверу в панели отведите 1 ГБ.
  • Диск: файлы прокси занимают около 25 МБ, образ Docker с Java — около 1 ГБ. Серверу в панели отведите 2 ГБ.

Подобрать сервер можно на странице тарифов VDS.

1. Шаблон игры

Игру в Pterodactyl описывает шаблон — «яйцо» (egg): в нём записано, какой образ Docker использовать, как скачать сервер и какой командой его запустить. Шаблон BungeeCord входит в поставку панели: он лежит в гнезде Minecraft, добавлять ничего не нужно.

2. Выделите порты

Адрес и порты сервер получает из списка «выделений» (allocations) узла. Серверу BungeeCord нужны порты:

Порт Протокол Зачем
25565 TCP Адрес, на который заходят игроки. Игровым серверам за прокси выделите другие порты — например, 25566 и 25567 — на внутреннем адресе 172.18.0.1 (см. раздел «Настройки после установки»)

1. Откройте Nodes, щёлкните по своему узлу и перейдите на вкладку Allocation.

2. В блоке «Assign New Allocations» в поле «IP Address» выберите IP-адрес VDS, а в поле «Ports» введите 25565 — после каждого номера нажимайте Enter. Нажмите Submit:

IP-адрес на снимках заменён примером.

3. Создайте сервер

1. Откройте Servers и нажмите Create New.

2. Заполните верхнюю часть формы:

  • Server Name — название сервера в панели; игроки его не видят;
  • Server Owner — начните вводить почту своей учётной записи и выберите её из списка;
  • Node — ваш узел, Default Allocation — порт 25565;
  • Memory — 1024 (в мегабайтах), Disk Space — 2000, Swap — 0, CPU Limit — 0, то есть без ограничения.

3. В блоке «Nest Configuration» выберите гнездо Minecraft и шаблон Bungeecord. Образ Docker и команда запуска подставятся сами, менять их не нужно:

4. В блоке «Service Variables» задайте настройки игры. Что стоит изменить:

Поле Что вписать
Bungeecord Version latest — последняя сборка
Bungeecord Jar File Имя файла прокси. Оставьте bungeecord.jar

Остальные поля можно оставить как есть.

5. Нажмите Create Server внизу страницы.

4. Дождитесь установки

Панель создаст сервер, а Wings начнёт установку: скачает образ Docker и файлы игры. Установка занимает несколько секунд.

Выйдите из раздела администратора (значок выхода справа вверху) и щёлкните по серверу в списке — откроется его страница с консолью.

5. Запустите сервер

Сначала загрузите файл прокси. После установки сервер попробует запуститься и сразу остановится: в консоли появится строка «Error: Invalid or corrupt jarfile bungeecord.jar». Установочный скрипт шаблона скачивает BungeeCord по устаревшему адресу и вместо файла получает страницу переадресации размером 167 байт. Поэтому файл нужно загрузить самому:

  1. скачайте на свой компьютер файл https://ci.md-5.net/job/BungeeCord/lastSuccessfulBuild/artifact/bootstrap/target/BungeeCord.jar (около 25 МБ) — это последняя сборка со страницы разработчика;
  2. переименуйте его в bungeecord.jar — строчными буквами;
  3. на вкладке Files нажмите Upload и выберите файл — он заменит неисправный;
  4. вернитесь на вкладку Console и нажмите Start.

Лицензию Minecraft прокси принимать не просит. Он готов, когда в консоли появилась строка «Listening on /0.0.0.0:25565» — при проверке запуск занял несколько секунд:

Кнопки Restart и Stop перезапускают и останавливают сервер; при остановке панель посылает ему штатную команду завершения, и он успевает сохранить мир. Команды сервера вводят в строку под консолью.

6. Откройте порты в файрволе

Если на VDS включён файрвол ufw, разрешите порты сервера. Выполните на VDS:

sudo ufw allow 25565/tcp

Проверить, включён ли файрвол, можно командой sudo ufw status: ответ «Status: inactive» означает, что он выключен и порты открывать не нужно.

При проверке прокси, созданный в панели, ответил на запрос снаружи, с другого компьютера: «BungeeCord 1.8.x-26.x».

7. Зайдите на сервер

Игроки заходят на адрес прокси: «Сетевая игра» → «Добавить сервер» → IP_СЕРВЕРА:25565. Пока за прокси нет ни одного работающего игрового сервера, зайти не получится — сначала настройте список серверов (см. ниже).

Настройки после установки

Всё, что вы задали в блоке «Service Variables», можно изменить позже — на вкладке Startup страницы сервера. Изменения вступают в силу после перезапуска сервера кнопкой Restart.

Настройки прокси лежат в файле config.yml — он создаётся при первом запуске. На вкладке Files щёлкните по нему, измените нужное, нажмите Save Content и перезапустите прокси. Главные разделы:

Раздел Что задаёт
servers Список игровых серверов за прокси. У каждого — имя (в новом файле это lobby) и address — адрес и порт сервера, например 172.18.0.1:25566
listeners → priorities На какой сервер попадает игрок при входе — имя из списка servers
listeners → max_players Число мест, которое показывается в списке серверов. В новом файле стоит 1
listeners → motd Описание в списке серверов
ip_forward true — передавать игровым серверам настоящие адреса и имена игроков

Что настроить на игровых серверах. Чтобы сервер Paper принимал игроков от прокси, в его server.properties ставят online-mode=false, а в spigot.yml — bungeecord: true; на самом прокси при этом должно быть ip_forward: true. Проверку лицензии игроков в такой схеме выполняет прокси, а игровой сервер пускает любого, кто до него дотянется, — под любым именем.

Закройте игровые серверы от входа в обход прокси. Порты игровым серверам выделяйте не на внешнем IP-адресе VDS, а на внутреннем адресе сети Docker — 172.18.0.1: в разделе администратора откройте Nodes → узел → Allocation, в поле «IP Address» введите 172.18.0.1, в поле «Ports» — порт, и при создании игрового сервера выберите этот адрес в поле «Default Allocation». Такой порт виден только серверам того же узла: при проверке запрос из интернета на него получил отказ, а прокси с того же узла до игрового сервера доставал. В разделе servers файла config.yml адрес игрового сервера тогда записывается как 172.18.0.1:25566. Снимок формы с внутренним адресом есть в статье о Velocity — прокси от авторов Paper, который защищает игровые серверы ещё и общим секретом.

Если что-то пошло не так

Что видите Причина и решение
В консоли «Error: Invalid or corrupt jarfile bungeecord.jar» Вместо файла прокси скачалась страница переадресации. Загрузите настоящий bungeecord.jar через вкладку Files, как описано в шаге 5.
Игрок видит «Could not connect to a default or fallback server» Прокси работает, но не может соединиться с игровым сервером. Проверьте адрес и порт в разделе servers файла config.yml и убедитесь, что игровой сервер запущен.
В форме создания сервера нет нужного порта Порт не выделен или уже занят другим сервером. Проверьте вкладку Allocation узла.
Установка не заканчивается: надпись об установке висит часами Wings ждёт загрузки образа Docker не дольше 15 минут; если канал медленный, загрузка обрывается, а сервер остаётся в состоянии установки. Скачайте образ на VDS вручную: sudo docker pull ghcr.io/pterodactyl/yolks:java_25, затем на странице сервера откройте Settings и нажмите Reinstall Server.
Сервер запущен, но зайти не удаётся Проверьте, что порты открыты в файрволе VDS и что в игре указан верный адрес и порт.

Для размещения игровых серверов рекомендуем услуги ARK-HOSTER.RU: