Установка сервера 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 байт. Поэтому файл нужно загрузить самому:
- скачайте на свой компьютер файл
https://ci.md-5.net/job/BungeeCord/lastSuccessfulBuild/artifact/bootstrap/target/BungeeCord.jar(около 25 МБ) — это последняя сборка со страницы разработчика; - переименуйте его в
bungeecord.jar— строчными буквами; - на вкладке Files нажмите Upload и выберите файл — он заменит неисправный;
- вернитесь на вкладку 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:
- VPS/VDS серверы — для небольших и средних серверов
- Выделенные серверы — для высоконагруженных игровых серверов