Настройка BungeeCord для Minecraft сети

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

BungeeCord объединяет несколько серверов Minecraft в одну сеть: игрок подключается к одному адресу и переходит между серверами командой /server, не выходя из игры. Так устроены проекты с лобби, выживанием и мини-играми. В статье — сеть из прокси и двух серверов на одном VDS с Ubuntu 24.04, настроенная так, чтобы обойти прокси было нельзя. Все команды проверены 16 ноября 2026 года на Ubuntu 24.04.4 с BungeeCord и Paper 26.3, снимки экрана сняты с настоящего сервера.

Ту же задачу решает более новый прокси Velocity от разработчиков Paper — Настройка прокси Velocity для сети серверов Minecraft. Для новой сети выбирайте его; BungeeCord остаётся для сетей, которые на нём уже работают, и для плагинов, написанных только под него.

Как это устроено

Часть Что делает Порт в примере
Прокси BungeeCord Принимает игроков из интернета, проверяет лицензию и передаёт на нужный сервер 25565, открыт наружу
Сервер lobby Обычный сервер Paper, на который игрок попадает первым 25566, только внутри VDS
Сервер survival Второй сервер Paper 25567, только внутри VDS

Главное о безопасности. Серверы за прокси работают с online-mode=false: лицензию проверяет прокси, а серверы верят ему на слово. Если такой сервер доступен из интернета напрямую, на него можно войти под любым ником — в том числе под ником администратора. Поэтому в этой статье серверы слушают только адрес 127.0.0.1: подключиться к ним можно только с самого VDS, то есть только через прокси.

Память. Каждому серверу сети нужна своя память: прокси — 512 МБ, каждому серверу Paper — от 1–2 ГБ, плюс 1–2 ГБ системе. Для сети из двух серверов берите тариф VDS от 6–8 ГБ.

BungeeCord или Velocity. Для новых сетей разработчики Paper рекомендуют более новый прокси Velocity. BungeeCord остаётся рабочим и поддерживает текущие версии игры; если у вас уже есть плагины для него — ставьте его.

Подготовка

Дальше считается, что на VDS уже установлены Java и создан пользователь minecraft, а файл paper.jar лежит в /opt/minecraft/server — как в статье Установка и настройка Spigot-Paper сервера (шаги 1 и 2). Если там работает одиночный сервер, остановите его: порт 25565 займёт прокси.

sudo systemctl disable --now minecraft
sudo -iu minecraft

1. Серверы сети

Создайте два каталога с сервером Paper в каждом:

for s in lobby survival; do mkdir ~/$s; cp ~/server/paper.jar ~/$s/; echo "eula=true" > ~/$s/eula.txt; done
printf 'server-port=25566\nserver-ip=127.0.0.1\nonline-mode=false\nwhite-list=false\nmotd=Lobby\n' > ~/lobby/server.properties
printf 'server-port=25567\nserver-ip=127.0.0.1\nonline-mode=false\nwhite-list=false\nmotd=Survival\n' > ~/survival/server.properties
for s in lobby survival; do printf 'settings:\n  bungeecord: true\n' > ~/$s/spigot.yml; printf '#!/bin/bash\nexec java -Xms1G -Xmx1G -jar paper.jar nogui\n' > ~/$s/start.sh; chmod +x ~/$s/start.sh; done

Что записано в каждый сервер:

Настройка Зачем
server-port У каждого сервера свой порт
server-ip=127.0.0.1 Сервер принимает подключения только с самого VDS — это и защищает его от входа в обход прокси
online-mode=false Лицензию проверяет прокси
bungeecord: true в spigot.yml Сервер принимает от прокси настоящий ник и адрес игрока
start.sh Строка запуска с памятью сервера

Строка eula=true означает, что вы принимаете лицензионное соглашение Minecraft. Остальные настройки сервер допишет сам при первом запуске.

2. Прокси

mkdir ~/proxy && cd ~/proxy
curl -sL -o BungeeCord.jar https://ci.md-5.net/job/BungeeCord/lastSuccessfulBuild/artifact/bootstrap/target/BungeeCord.jar
java -Xms512M -Xmx512M -jar BungeeCord.jar

Первый запуск создаёт файл настроек. Дождитесь строки «Listening on» и остановите прокси командой end.

Откройте config.yml и поменяйте в нём:

nano config.yml
Было Стало Зачем
host: 0.0.0.0:25577 host: 0.0.0.0:25565 Обычный порт Minecraft — игрокам не придётся дописывать порт
ip_forward: false ip_forward: true Передавать серверам настоящий ник и адрес игрока. Пара к bungeecord: true
max_players: 1 max_players: 50 Сколько игроков показывать в списке серверов
forced_hosts: и строка pvp.md-5.net: pvp под ней forced_hosts: {} Убрать пример, который ссылается на несуществующий сервер
online_mode: true не менять Прокси проверяет лицензию игроков

Блок servers замените своим списком серверов:

servers:
  lobby:
    motd: Lobby
    address: 127.0.0.1:25566
    restricted: false
  survival:
    motd: Survival
    address: 127.0.0.1:25567
    restricted: false

Сервер, указанный в блоке priorities (по умолчанию lobby), — тот, на который игрок попадает при входе. Отступы в файле значимы: только пробелы.

На снимке те же правки сделаны командами sed и показан результат. Создайте скрипт запуска прокси и выйдите из сеанса:

printf '#!/bin/bash\nexec java -Xms512M -Xmx512M -jar BungeeCord.jar\n' > start.sh; chmod +x start.sh
exit

3. Службы

Серверов несколько, поэтому удобно описать службу один раз — шаблоном. Имя после знака @ подставляется вместо %i и означает каталог сервера.

sudo nano /etc/systemd/system/minecraft@.service
[Unit]
Description=Minecraft server %i
After=network-online.target
Wants=network-online.target

[Service]
Type=forking
User=minecraft
WorkingDirectory=/opt/minecraft/%i
ExecStart=/usr/bin/tmux -L %i new-session -d -s %i /opt/minecraft/%i/start.sh
ExecStop=/usr/bin/tmux -L %i send-keys -t %i 'stop' Enter
ExecStop=/bin/sh -c 'while tmux -L %i has-session -t %i 2>/dev/null; do sleep 1; done'
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

Прокси останавливается другой командой (end), поэтому у него своя служба:

sudo nano /etc/systemd/system/bungeecord.service
[Unit]
Description=BungeeCord proxy
After=network-online.target
Wants=network-online.target

[Service]
Type=forking
User=minecraft
WorkingDirectory=/opt/minecraft/proxy
ExecStart=/usr/bin/tmux -L proxy new-session -d -s proxy /opt/minecraft/proxy/start.sh
ExecStop=/usr/bin/tmux -L proxy send-keys -t proxy 'end' Enter
ExecStop=/bin/sh -c 'while tmux -L proxy has-session -t proxy 2>/dev/null; do sleep 1; done'
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl enable --now minecraft@lobby minecraft@survival bungeecord
systemctl is-active minecraft@lobby minecraft@survival bungeecord
sudo ss -tlnp | grep java | awk '{print $4}' | sort

Все три службы работают. Вывод ss показывает главное: прокси слушает порт 25565 на всех адресах (*), а оба сервера — только на 127.0.0.1. Проверка состояния (скрипт из статьи Мониторинг и диагностика Minecraft сервера) отвечает на всех трёх портах. Снаружи проверено: порт 25565 открыт, порты 25566 и 25567 недоступны.

Если на VDS включён файрвол, откройте только порт прокси: sudo ufw allow 25565/tcp.

4. Управление

Команда Что делает
sudo -u minecraft tmux -L proxy attach -t proxy Консоль прокси
sudo -u minecraft tmux -L lobby attach -t lobby Консоль сервера lobby; так же для остальных
sudo systemctl restart minecraft@survival Перезапустить один сервер — остальные и прокси продолжают работать
sudo systemctl restart bungeecord Перезапустить прокси; всех игроков отключит

Выход из любой консоли без остановки — Ctrl+B, затем D.

Команды консоли прокси:

Команда Что делает
glist Игроки на всех серверах сети
alert ТЕКСТ Объявление игрокам всех серверов
send НИК СЕРВЕР Перевести игрока на другой сервер
greload Перечитать config.yml
end Остановить прокси

Игроки переходят между серверами сами: /server survival. Права и плагины на каждом сервере свои; чтобы права были общими, в LuckPerms подключают общую базу данных.

Ещё один сервер

Создайте каталог с сервером по образцу шага 1 (свой порт, например 25568), добавьте его в блок servers в config.yml прокси, затем:

sudo systemctl enable --now minecraft@ИМЯ
sudo systemctl restart bungeecord

Если серверу сети нужно стоять на другом VDS, одного server-ip уже недостаточно: порт придётся открыть. Тогда разрешите его в файрволе только для адреса прокси (sudo ufw allow from АДРЕС_ПРОКСИ to any port 25566 proto tcp) и поставьте на сервер плагин BungeeGuard, который отклоняет подключения в обход прокси.

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

Что видите Причина и решение
Игрок видит «If you wish to use IP forwarding, please enable it in your BungeeCord config as well!» На сервере включено bungeecord: true, а в config.yml прокси осталось ip_forward: false
«Could not connect to a default or fallback server» Сервер из блока priorities не запущен или в servers указан не тот порт. Проверьте systemctl is-active minecraft@lobby
У всех игроков один и тот же адрес и «чужие» UUID Не включена пересылка: ip_forward: true на прокси и bungeecord: true в spigot.yml серверов
«Forced host server pvp is not defined» в журнале прокси В настройках остался пример — замените блок на forced_hosts: {}
Прокси не запускается: «Address already in use» Порт 25565 занят одиночным сервером. Остановите его: sudo systemctl disable --now minecraft
Служба сервера сразу останавливается Файл start.sh не исполняемый или в каталоге нет paper.jar. Причина — в sudo journalctl -u minecraft@lobby -n 20 --no-pager
На сервер заходят под чужими никами Сервер сети доступен из интернета напрямую. Проверьте server-ip=127.0.0.1 и вывод ss из шага 3

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