Настройка BungeeCord для Minecraft сети: различия между версиями

Материал из ARK-HOSTER.RU | Документация хостинга
Перейти к навигации Перейти к поиску
Добавлен блок со ссылками на Telegram
Ссылка на статью о Velocity
 
(не показана 1 промежуточная версия этого же участника)
Строка 1: Строка 1:
<div class="ark-crumbs">[[Главная страница|База знаний]] › [[Виртуально выделенный сервер (VPS / VDS )|VPS / VDS]] › [[Установка игрового сервера на VDS|Игровые серверы на VDS]]</div>
<div class="ark-crumbs">[[Главная страница|База знаний]] › [[Виртуально выделенный сервер (VPS / VDS )|VPS / VDS]] › [[Установка игрового сервера на VDS|Игровые серверы на VDS]]</div>
= Настройка BungeeCord для Minecraft сети =
BungeeCord объединяет несколько серверов Minecraft в одну сеть: игрок подключается к одному адресу и переходит между серверами командой <code>/server</code>, не выходя из игры. Так устроены проекты с лобби, выживанием и мини-играми. В статье — сеть из прокси и двух серверов на одном VDS с Ubuntu 24.04, настроенная так, чтобы обойти прокси было нельзя. Все команды проверены 16 ноября 2026 года на Ubuntu 24.04.4 с BungeeCord и Paper 26.3, снимки экрана сняты с настоящего сервера.


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


* Войдите в систему под учетной записью с правами '''root''' или пользователя с правами '''sudo'''.
== Как это устроено ==
* Убедитесь, что у вас есть доступ к серверу через SSH или консоль.
* Рекомендуется использовать Ubuntu 24.04 LTS для стабильной работы.


== 2. Установка Java ==
{| class="wikitable"
! style="width:22%;" | Часть !! Что делает !! Порт в примере
|-
| Прокси BungeeCord || Принимает игроков из интернета, проверяет лицензию и передаёт на нужный сервер || 25565, открыт наружу
|-
| Сервер <code>lobby</code> || Обычный сервер Paper, на который игрок попадает первым || 25566, только внутри VDS
|-
| Сервер <code>survival</code> || Второй сервер Paper || 25567, только внутри VDS
|}


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


1. Обновите систему:
'''Память.''' Каждому серверу сети нужна своя память: прокси — 512 МБ, каждому серверу Paper — от 1–2 ГБ, плюс 1–2 ГБ системе. Для сети из двух серверов берите [https://ark-hoster.ru/vpsgame/ тариф VDS] от 6–8 ГБ.
<pre>sudo apt update</pre>
<pre>sudo apt upgrade -y</pre>


2. Установите необходимые пакеты:
'''BungeeCord или Velocity.''' Для новых сетей разработчики Paper рекомендуют более новый прокси Velocity. BungeeCord остаётся рабочим и поддерживает текущие версии игры; если у вас уже есть плагины для него — ставьте его.
<pre>sudo apt install -y wget curl unzip screen htop</pre>


=== Установка OpenJDK ===
== Подготовка ==


1. Установите OpenJDK 21:
Дальше считается, что на VDS уже установлены Java и создан пользователь <code>minecraft</code>, а файл <code>paper.jar</code> лежит в <code>/opt/minecraft/server</code> — как в статье [[Установка и настройка Spigot-Paper сервера]] (шаги 1 и 2). Если там работает одиночный сервер, остановите его: порт 25565 займёт прокси.
<pre>sudo apt install -y openjdk-21-jdk</pre>


2. Проверьте версию Java:
<pre>sudo systemctl disable --now minecraft
<pre>java --version</pre>
sudo -iu minecraft</pre>


3. Настройте JAVA_HOME:
== 1. Серверы сети ==
<pre>echo 'export JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64' >> ~/.bashrc</pre>
<pre>source ~/.bashrc</pre>


== 3. Создание пользователя для BungeeCord ==
Создайте два каталога с сервером Paper в каждом:


=== Создание пользователя ===
<pre>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</pre>


1. Создайте пользователя bungeecord:
[[Файл:Linux-mcbc-backends.png|800px]]
<pre>sudo useradd -m -s /bin/bash bungeecord</pre>


2. Установите пароль:
Что записано в каждый сервер:
<pre>sudo passwd bungeecord</pre>


3. Добавьте пользователя в группу sudo:
{| class="wikitable"
<pre>sudo usermod -aG sudo bungeecord</pre>
! style="width:34%;" | Настройка !! Зачем
|-
| <code>server-port</code> || У каждого сервера свой порт
|-
| <code>server-ip=127.0.0.1</code> || Сервер принимает подключения только с самого VDS — это и защищает его от входа в обход прокси
|-
| <code>online-mode=false</code> || Лицензию проверяет прокси
|-
| <code>bungeecord: true</code> в <code>spigot.yml</code> || Сервер принимает от прокси настоящий ник и адрес игрока
|-
| <code>start.sh</code> || Строка запуска с памятью сервера
|}


=== Настройка директорий ===
Строка <code>eula=true</code> означает, что вы принимаете [https://aka.ms/MinecraftEULA лицензионное соглашение Minecraft]. Остальные настройки сервер допишет сам при первом запуске.


1. Создайте директорию для BungeeCord:
== 2. Прокси ==
<pre>sudo mkdir -p /opt/bungeecord</pre>


2. Установите права доступа:
<pre>mkdir ~/proxy && cd ~/proxy
<pre>sudo chown -R bungeecord:bungeecord /opt/bungeecord</pre>
curl -sL -o BungeeCord.jar https://ci.md-5.net/job/BungeeCord/lastSuccessfulBuild/artifact/bootstrap/target/BungeeCord.jar
java -Xms512M -Xmx512M -jar BungeeCord.jar</pre>


3. Переключитесь на пользователя bungeecord:
Первый запуск создаёт файл настроек. Дождитесь строки «Listening on» и остановите прокси командой <code>end</code>.
<pre>sudo su - bungeecord</pre>


== 4. Установка BungeeCord ==
[[Файл:Linux-mcbc-proxy.png|800px]]


=== Скачивание BungeeCord ===
Откройте <code>config.yml</code> и поменяйте в нём:


1. Перейдите в директорию BungeeCord:
<pre>nano config.yml</pre>
<pre>cd /opt/bungeecord</pre>
 
2. Скачайте последнюю версию BungeeCord:
<pre>wget https://ci.md-5.net/job/BungeeCord/lastSuccessfulBuild/artifact/bootstrap/target/BungeeCord.jar</pre>
 
3. Переименуйте файл:
<pre>mv BungeeCord.jar bungeecord.jar</pre>
 
=== Первый запуск ===
 
1. Запустите BungeeCord в первый раз:
<pre>java -jar bungeecord.jar</pre>
 
2. Остановите сервер через несколько секунд:
<pre>pkill java</pre>
 
== 5. Настройка конфигурации ==
 
=== Базовая конфигурация ===


1. Отредактируйте config.yml:
{| class="wikitable"
<pre>nano config.yml</pre>
! style="width:36%;" | Было !! Стало !! Зачем
|-
| <code>host: 0.0.0.0:25577</code> || <code>host: 0.0.0.0:25565</code> || Обычный порт Minecraft — игрокам не придётся дописывать порт
|-
| <code>ip_forward: false</code> || <code>ip_forward: true</code> || Передавать серверам настоящий ник и адрес игрока. Пара к <code>bungeecord: true</code>
|-
| <code>max_players: 1</code> || <code>max_players: 50</code> || Сколько игроков показывать в списке серверов
|-
| <code>forced_hosts:</code> и строка <code>pvp.md-5.net: pvp</code> под ней || <code>forced_hosts: {}</code> || Убрать пример, который ссылается на несуществующий сервер
|-
| <code>online_mode: true</code> || не менять || Прокси проверяет лицензию игроков
|}


2. Настройте основные параметры:
Блок <code>servers</code> замените своим списком серверов:
<pre># BungeeCord Configuration
# Основные настройки
listeners:
- query_port: 25577
  motd: '&1Just another BungeeCord server'
  tab_list: GLOBAL_PING
  query_enabled: false
  proxy_protocol: false
  forced_hosts:
    pvp.md-5.net: pvp
  ping_passthrough: false
  priorities:
  - lobby
  bind_local_address: true
  host: 0.0.0.0:25565
  max_players: 1
  tab_size: 60
  force_default_server: false


# Настройки серверов
<pre>servers:
servers:
   lobby:
   lobby:
     motd: '&1Just another BungeeCord server'
     motd: Lobby
     address: localhost:25566
     address: 127.0.0.1:25566
     restricted: false
     restricted: false
   survival:
   survival:
     motd: '&1Just another BungeeCord server'
     motd: Survival
     address: localhost:25567
     address: 127.0.0.1:25567
     restricted: false
     restricted: false</pre>
  creative:
    motd: '&1Just another BungeeCord server'
    address: localhost:25568
    restricted: false


# Настройки игроков
Сервер, указанный в блоке <code>priorities</code> (по умолчанию <code>lobby</code>), — тот, на который игрок попадает при входе. Отступы в файле значимы: только пробелы.
player_limit: -1
ip_forward: true
network_compression_threshold: 256
</pre>


=== Настройка серверов ===
[[Файл:Linux-mcbc-config.png|800px]]


1. Создайте директории для серверов:
На снимке те же правки сделаны командами <code>sed</code> и показан результат. Создайте скрипт запуска прокси и выйдите из сеанса:
<pre>mkdir -p servers/lobby</pre>
<pre>mkdir -p servers/survival</pre>
<pre>mkdir -p servers/creative</pre>


2. Настройте lobby сервер:
<pre>printf '#!/bin/bash\nexec java -Xms512M -Xmx512M -jar BungeeCord.jar\n' > start.sh; chmod +x start.sh
<pre>nano servers/lobby/server.properties</pre>
exit</pre>


3. Добавьте конфигурацию:
== 3. Службы ==
<pre># Lobby Server Configuration
server-ip=127.0.0.1
server-port=25566
online-mode=false
white-list=false
motd=Lobby Server
max-players=20
</pre>


'''Внимание:''' серверы за BungeeCord работают с <code>online-mode=false</code>, то есть сами не проверяют лицензию игрока. Поэтому они должны принимать подключения только от прокси: строка <code>server-ip=127.0.0.1</code> обязательна для каждого сервера (lobby, survival, creative), а их порты нельзя открывать в файрволе. Иначе любой сможет войти напрямую под чужим ником, в том числе под ником администратора. В <code>spigot.yml</code> каждого сервера Spigot или Paper включите <code>bungeecord: true</code>, а в <code>config.yml</code> BungeeCord — <code>ip_forward: true</code>.
Серверов несколько, поэтому удобно описать службу один раз — шаблоном. Имя после знака <code>@</code> подставляется вместо <code>%i</code> и означает каталог сервера.


== 6. Установка плагинов BungeeCord ==
<pre>sudo nano /etc/systemd/system/minecraft@.service</pre>


=== Создание директории для плагинов ===
<pre>[Unit]
Description=Minecraft server %i
After=network-online.target
Wants=network-online.target


1. Создайте директорию для плагинов:
[Service]
<pre>mkdir -p plugins</pre>
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


2. Установите права доступа:
[Install]
<pre>chmod 755 plugins</pre>
WantedBy=multi-user.target</pre>
 
=== Установка основных плагинов ===
 
1. '''Установка LuckPerms BungeeCord''':
<pre>cd plugins</pre>
<pre>wget https://github.com/lucko/LuckPerms/releases/latest/download/LuckPerms-Bungee-5.4.101.jar</pre>
 
2. '''Установка BungeeCord Chat''':
<pre>wget https://github.com/lucko/BungeeCord-Chat/releases/latest/download/BungeeCord-Chat-1.0.0.jar</pre>
 
3. '''Установка BungeeCord Command''':
<pre>wget https://github.com/lucko/BungeeCord-Command/releases/latest/download/BungeeCord-Command-1.0.0.jar</pre>
 
4. '''Установка BungeeCord Config''':
<pre>wget https://github.com/lucko/BungeeCord-Config/releases/latest/download/BungeeCord-Config-1.0.0.jar</pre>
 
== 7. Настройка systemd сервиса ==
 
=== Создание сервиса ===


1. Выйдите из пользователя bungeecord:
Прокси останавливается другой командой (<code>end</code>), поэтому у него своя служба:
<pre>exit</pre>


2. Создайте systemd сервис:
<pre>sudo nano /etc/systemd/system/bungeecord.service</pre>
<pre>sudo nano /etc/systemd/system/bungeecord.service</pre>


3. Добавьте конфигурацию:
<pre>[Unit]
<pre>[Unit]
Description=BungeeCord Proxy Server
Description=BungeeCord proxy
After=network.target
After=network-online.target
Wants=network-online.target


[Service]
[Service]
Type=simple
Type=forking
User=bungeecord
User=minecraft
Group=bungeecord
WorkingDirectory=/opt/minecraft/proxy
WorkingDirectory=/opt/bungeecord
ExecStart=/usr/bin/tmux -L proxy new-session -d -s proxy /opt/minecraft/proxy/start.sh
ExecStart=/usr/bin/java -Xms1G -Xmx2G -XX:+UseG1GC -XX:+ParallelRefProcEnabled -XX:MaxGCPauseMillis=200 -XX:+UnlockExperimentalVMOptions -XX:+DisableExplicitGC -XX:+AlwaysPreTouch -XX:G1NewSizePercent=30 -XX:G1MaxNewSizePercent=40 -XX:G1HeapRegionSize=8M -XX:G1ReservePercent=20 -XX:G1HeapWastePercent=5 -XX:G1MixedGCCountTarget=4 -XX:InitiatingHeapOccupancyPercent=15 -XX:G1MixedGCLiveThresholdPercent=90 -XX:G1RSetUpdatingPauseTimePercent=5 -XX:SurvivorRatio=32 -XX:+PerfDisableSharedMem -XX:MaxTenuringThreshold=1 -jar bungeecord.jar
ExecStop=/usr/bin/tmux -L proxy send-keys -t proxy 'end' Enter
ExecStop=/bin/kill -15 $MAINPID
ExecStop=/bin/sh -c 'while tmux -L proxy has-session -t proxy 2>/dev/null; do sleep 1; done'
Restart=always
Restart=always
RestartSec=10
RestartSec=10


[Install]
[Install]
WantedBy=multi-user.target
WantedBy=multi-user.target</pre>
</pre>
 
=== Запуск сервиса ===
 
1. Перезагрузите systemd:
<pre>sudo systemctl daemon-reload</pre>
 
2. Включите автозапуск:
<pre>sudo systemctl enable bungeecord</pre>
 
3. Запустите сервис:
<pre>sudo systemctl start bungeecord</pre>
 
4. Проверьте статус:
<pre>sudo systemctl status bungeecord</pre>
 
== 8. Настройка файрвола ==
 
=== Настройка UFW ===
 
1. Установите UFW:
<pre>sudo apt install -y ufw</pre>
 
2. Настройте правила:
<pre>sudo ufw allow 22/tcp</pre>
<pre>sudo ufw allow 25565/tcp</pre>
<pre>sudo ufw enable</pre>
 
Порты внутренних серверов (25566–25568) не открывайте: к ним обращается только BungeeCord с этого же сервера.
 
3. Проверьте статус:
<pre>sudo ufw status</pre>
 
== 9. Мониторинг и диагностика ==
 
=== Создание скрипта мониторинга ===
 
1. Создайте скрипт мониторинга:
<pre>sudo nano /usr/local/bin/bungeecord-monitor.sh</pre>
 
2. Добавьте содержимое:
<pre>#!/bin/bash
 
# Проверка статуса BungeeCord
if&#32;! systemctl is-active --quiet bungeecord; then
    echo "BungeeCord не запущен!" | mail -s "BungeeCord Alert" admin@example.com
fi
 
# Проверка использования памяти
MEMORY_USAGE=$(ps aux | grep bungeecord | grep -v grep | awk '{print $4}')
if [&#32;! -z "$MEMORY_USAGE" ] && [ $(echo "$MEMORY_USAGE > 80" | bc) -eq 1 ]; then
    echo "Высокое использование памяти: ${MEMORY_USAGE}%" | mail -s "BungeeCord Alert" admin@example.com
fi
 
# Проверка доступности порта
if&#32;! nc -z localhost 25565; then
    echo "BungeeCord не отвечает на порту 25565!" | mail -s "BungeeCord Alert" admin@example.com
fi
</pre>
 
3. Сделайте скрипт исполняемым:
<pre>sudo chmod +x /usr/local/bin/bungeecord-monitor.sh</pre>
 
4. Добавьте в crontab:
<pre>sudo crontab -e</pre>
 
5. Добавьте задачу:
<pre>*/5 * * * * /usr/local/bin/bungeecord-monitor.sh</pre>
 
== 10. Резервное копирование ==
 
=== Создание скрипта резервного копирования ===
 
1. Создайте скрипт резервного копирования:
<pre>sudo nano /usr/local/bin/bungeecord-backup.sh</pre>
 
2. Добавьте содержимое:
<pre>#!/bin/bash
 
BACKUP_DIR="/backup/bungeecord"
DATE=$(date +%Y%m%d_%H%M%S)
 
# Создание директории для бэкапа
mkdir -p $BACKUP_DIR
 
# Остановка BungeeCord для бэкапа
systemctl stop bungeecord
 
# Создание архива
tar -czf $BACKUP_DIR/bungeecord-backup-$DATE.tar.gz -C /opt bungeecord
 
# Запуск BungeeCord
systemctl start bungeecord
 
# Удаление старых бэкапов (старше 7 дней)
find $BACKUP_DIR -name "bungeecord-backup-*" -mtime +7 -delete
 
echo "BungeeCord backup completed: $DATE"
</pre>


3. Сделайте скрипт исполняемым:
<pre>sudo systemctl daemon-reload
<pre>sudo chmod +x /usr/local/bin/bungeecord-backup.sh</pre>
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</pre>


4. Добавьте в crontab:
[[Файл:Linux-mcbc-services.png|800px]]
<pre>sudo crontab -e</pre>


5. Добавьте задачу:
Все три службы работают. Вывод <code>ss</code> показывает главное: прокси слушает порт 25565 на всех адресах (<code>*</code>), а оба сервера — только на <code>127.0.0.1</code>. Проверка состояния (скрипт из статьи [[Мониторинг и диагностика Minecraft сервера]]) отвечает на всех трёх портах. Снаружи проверено: порт 25565 открыт, порты 25566 и 25567 недоступны.
<pre>0 3 * * * /usr/local/bin/bungeecord-backup.sh</pre>


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


=== Частые проблемы ===
== 4. Управление ==


1. '''BungeeCord не запускается''':
{| class="wikitable"
* Проверьте статус: <pre>sudo systemctl status bungeecord</pre>
! style="width:55%;" | Команда !! Что делает
* Проверьте логи: <pre>sudo journalctl -u bungeecord</pre>
|-
* Проверьте права доступа к файлам
| <code>sudo -u minecraft tmux -L proxy attach -t proxy</code> || Консоль прокси
|-
| <code>sudo -u minecraft tmux -L lobby attach -t lobby</code> || Консоль сервера <code>lobby</code>; так же для остальных
|-
| <code>sudo systemctl restart minecraft@survival</code> || Перезапустить один сервер — остальные и прокси продолжают работать
|-
| <code>sudo systemctl restart bungeecord</code> || Перезапустить прокси; всех игроков отключит
|}


2. '''Проблемы с подключением''':
Выход из любой консоли без остановки — '''Ctrl+B''', затем '''D'''.
* Проверьте настройки файрвола
* Проверьте конфигурацию серверов
* Проверьте сетевую связность


3. '''Проблемы с плагинами''':
[[Файл:Linux-mcbc-console.png|800px]]
* Проверьте совместимость плагинов
* Проверьте зависимости плагинов
* Проверьте логи BungeeCord


=== Диагностика ===
Команды консоли прокси:


1. '''Проверка статуса BungeeCord''':
{| class="wikitable"
<pre>sudo systemctl status bungeecord</pre>
! style="width:30%;" | Команда !! Что делает
|-
| <code>glist</code> || Игроки на всех серверах сети
|-
| <code>alert ТЕКСТ</code> || Объявление игрокам всех серверов
|-
| <code>send НИК СЕРВЕР</code> || Перевести игрока на другой сервер
|-
| <code>greload</code> || Перечитать <code>config.yml</code>
|-
| <code>end</code> || Остановить прокси
|}


2. '''Проверка логов''':
Игроки переходят между серверами сами: <code>/server survival</code>. Права и плагины на каждом сервере свои; чтобы права были общими, в LuckPerms подключают общую базу данных.
<pre>sudo journalctl -u bungeecord -f</pre>


3. '''Проверка портов''':
== Ещё один сервер ==
<pre>sudo netstat -tlnp | grep :25565</pre>


4. '''Проверка использования ресурсов''':
Создайте каталог с сервером по образцу шага 1 (свой порт, например 25568), добавьте его в блок <code>servers</code> в <code>config.yml</code> прокси, затем:
<pre>htop</pre>
<pre>free -h</pre>
<pre>df -h</pre>


5. '''Тестирование подключения''':
<pre>sudo systemctl enable --now minecraft@ИМЯ
<pre>telnet localhost 25565</pre>
sudo systemctl restart bungeecord</pre>


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


BungeeCord успешно установлен и настроен! Теперь у вас есть полнофункциональный прокси-сервер с возможностями мониторинга, резервного копирования и управления сетью серверов.
== Если что-то пошло не так ==


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


* '''[https://ark-hoster.ru/dedicated/ Выделенные серверы]''' - для высоконагруженных BungeeCord сетей
'''Для размещения ваших проектов рекомендуем услуги [https://ark-hoster.ru ARK-HOSTER.RU]:'''
* '''[https://ark-hoster.ru/vpsgame/ VPS/VDS серверы]''' - для небольших и средних сетей


Наши специалисты помогут с настройкой BungeeCord и оптимизацией производительности!
* '''[https://ark-hoster.ru/vpsgame/ VPS/VDS серверы]''' — для небольших и средних проектов
* '''[https://ark-hoster.ru/dedicated/ Выделенные серверы]''' — для высоконагруженных проектов


{{Телеграм}}
{{Телеграм}}

Текущая версия от 14:59, 17 ноября 2026

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: