RU

Игровые серверы

Как объединить несколько серверов Minecraft с помощью Velocity

Объедините несколько серверов Paper за прокси Velocity на VPS или выделенном Linux-сервере: безопасная передача данных игроков, закрытые внутренние порты и откат.

9 мин чтения, обновлено 18 ноября 2026 г.

На этой странице

Ваши значения

Укажите их один раз, и команды в руководстве обновятся.

Velocity — это прокси для Minecraft: игроки подключаются к одному адресу и переходят с сервера на сервер без отключения. В этом руководстве ваш существующий сервер размещается за Velocity, а на той же машине к нему добавляется сервер lobby.

Оно продолжает руководства Создание сервера Minecraft и Установка и обновление плагинов на Paper и использует пользователя minecraft, папку /opt/minecraft/server, сервис minecraft.service и команду mc-console.

В итоге у вас будут:

  • Velocity на публичном порту 25565, поэтому адрес для игроков останется прежним
  • два сервера Paper, доступные только с самой машины
  • безопасная передача идентификационных данных игроков с сохранением их UUID и инвентарей

Предварительные требования

  • Сервер на Paper, установленный по двум указанным выше руководствам, с Java 25, curl и jq
  • SSH-доступ с пользователем, у которого есть sudo
  • Примерно 2 ГБ свободной памяти сверх той, что занимает текущий сервер: 1 ГБ для Velocity и до 1 ГБ для лобби
  • Достаточно места на диске для полной копии папки сервера

Velocity, BungeeCord или Waterfall?

Velocity BungeeCord Waterfall
Проект PaperMC, активная разработка SpigotMC, исторически первый прокси PaperMC, поддержка прекращена
Безопасная передача идентификационных данных Да, с подписью на основе секрета Нет Нет
Плагины API Velocity API BungeeCord API BungeeCord

PaperMC рекомендует Velocity вместо BungeeCord и Waterfall и больше не поддерживает Waterfall.

BungeeCord остаётся оправданным выбором лишь в одном случае: вам необходим плагин для прокси, которого нет для Velocity, поскольку Velocity не загружает плагины BungeeCord. Так как передача идентификационных данных в BungeeCord не подписывается, описанное ниже закрытие внутренних портов здесь ещё важнее.

Целевая схема установки

Сервис Имя в Velocity Папка Адрес прослушивания Откуда доступен
velocity.service /opt/minecraft/velocity 0.0.0.0:25565 Интернет
minecraft.service survie /opt/minecraft/server 127.0.0.1:25566 Только с этой машины
minecraft-lobby.service lobby /opt/minecraft/lobby 127.0.0.1:25567 Только с этой машины

Резервное копирование сервера

Остановите сервер, затем создайте полный архив. Сервер останется остановленным до конца настройки, поскольку порт 25565 перейдёт к Velocity:

Терминал
sudo systemctl stop minecraft.service
sudo mkdir -p /opt/minecraft/backups
sudo tar -czf /opt/minecraft/backups/avant-velocity-$(date +%F-%H%M).tar.gz -C /opt/minecraft server
sudo ls -lh /opt/minecraft/backups

Установка Velocity

Создайте скрипт, который загружает последнюю стабильную сборку и проверяет её контрольную сумму. Он пригодится и для обновлений:

Терминал
sudo nano /opt/minecraft/velocity-update.sh
Терминал
#!/bin/bash
# Загружает последнюю стабильную сборку Velocity и заменяет velocity.jar
set -euo pipefail

VERSION="${1:?Укажите версию Velocity, например 4.3.1}"
UA="mon-serveur-minecraft/1.0 (https://your-domain.com)"
API="https://fill.papermc.io/v3/projects/velocity/versions/$VERSION/builds"

mkdir -p /opt/minecraft/velocity
cd /opt/minecraft/velocity

BUILD=$(curl -fsSL -H "User-Agent: $UA" "$API" | jq -c 'map(select(.channel == "STABLE")) | .[0]')
if [ "$BUILD" = "null" ]; then
    echo "Не найдена стабильная сборка для Velocity $VERSION." >&2
    exit 1
fi

URL=$(echo "$BUILD" | jq -r '.downloads."server:default".url')
SHA256=$(echo "$BUILD" | jq -r '.downloads."server:default".checksums.sha256')

curl -fL -H "User-Agent: $UA" -o velocity.jar.new "$URL"
echo "$SHA256  velocity.jar.new" | sha256sum -c -

if [ -f velocity.jar ]; then
    mv velocity.jar velocity.jar.old
fi
mv velocity.jar.new velocity.jar
echo "Velocity $VERSION, сборка $(echo "$BUILD" | jq -r '.id'), установлен."

В строке UA замените your-domain.com адресом вашего сайта или другим способом связи с вами. Затем запустите скрипт:

Терминал
sudo chmod 755 /opt/minecraft/velocity-update.sh
sudo -u minecraft /opt/minecraft/velocity-update.sh 4.3.1

Строка velocity.jar.new: OK подтверждает, что файл не повреждён.

Создайте сервис:

Терминал
sudo nano /etc/systemd/system/velocity.service
Конфигурация
[Unit]
Description=Прокси Minecraft Velocity
After=network.target

[Service]
User=minecraft
WorkingDirectory=/opt/minecraft/velocity
ExecStart=/usr/bin/java -Xms1G -Xmx1G -XX:+UseG1GC -XX:G1HeapRegionSize=4M -XX:+UnlockExperimentalVMOptions -XX:+ParallelRefProcEnabled -XX:+AlwaysPreTouch -XX:MaxInlineLevel=15 -jar /opt/minecraft/velocity/velocity.jar
SuccessExitStatus=130 143
Restart=on-failure
RestartSec=20
StandardInput=null

[Install]
WantedBy=multi-user.target

Эти параметры Java рекомендованы в документации Velocity. Запустите прокси в первый раз, чтобы он создал свою конфигурацию:

Терминал
sudo systemctl daemon-reload
sudo systemctl start velocity.service
sudo journalctl -u velocity.service -n 30 --no-pager

Дождитесь строки Done. Предупреждение Player info forwarding is disabled! на этом этапе — нормальное явление. Затем остановите прокси и защитите его папку, в которой хранится секрет:

Терминал
sudo systemctl stop velocity.service
sudo chmod 700 /opt/minecraft/velocity
sudo ls -l /opt/minecraft/velocity

Вы должны увидеть velocity.toml и forwarding.secret.

Настройка Velocity

Терминал
sudo -u minecraft nano /opt/minecraft/velocity/velocity.toml

Проверьте или измените эти строки в начале файла:

toml
bind = "0.0.0.0:25565"
online-mode = true
player-info-forwarding-mode = "modern"
forwarding-secret-file = "forwarding.secret"

Затем замените всё содержимое разделов [servers] и [forced-hosts]:

toml
[servers]
lobby = "127.0.0.1:25567"
survie = "127.0.0.1:25566"

try = [
    "lobby",
    "survie"
]

[forced-hosts]

try задаёт порядок, в котором перебираются серверы при подключении или когда игрока выбрасывает с сервера. Раздел [forced-hosts] остаётся пустым: поставляемые примеры указывают на серверы factions и minigames, которых у вас нет, и Velocity отказался бы запускаться.

Подключение существующего сервера

Настройте сервер на прослушивание петлевого интерфейса и нового порта и передайте аутентификацию прокси:

Терминал
sudo -u minecraft sed -i \
    -e 's/^server-ip=.*/server-ip=127.0.0.1/' \
    -e 's/^server-port=.*/server-port=25566/' \
    -e 's/^online-mode=.*/online-mode=false/' \
    /opt/minecraft/server/server.properties
sudo grep -E '^(server-ip|server-port|online-mode)=' /opt/minecraft/server/server.properties

Затем включите современную передачу данных в конфигурации Paper, указав секрет, созданный Velocity:

Терминал
SECRET=$(sudo cat /opt/minecraft/velocity/forwarding.secret)
sudo -u minecraft sed -i "/^  velocity:/,/^ \{0,2\}[a-z]/{s/^    enabled: .*/    enabled: true/;s/^    online-mode: .*/    online-mode: true/;s/^    secret: .*/    secret: '$SECRET'/;}" /opt/minecraft/server/config/paper-global.yml
unset SECRET
sudo chmod 700 /opt/minecraft/server/config

Проверьте результат, не показывая секрет:

Терминал
sudo grep -A3 '^  velocity:' /opt/minecraft/server/config/paper-global.yml | sed 's/secret: .*/secret: (скрыто)/'
sudo grep -qF "$(sudo cat /opt/minecraft/velocity/forwarding.secret)" /opt/minecraft/server/config/paper-global.yml && echo "Секрет совпадает" || echo "Секрет не совпадает"
sudo grep 'bungeecord:' /opt/minecraft/server/spigot.yml

Вы должны получить enabled: true, online-mode: true, Секрет совпадает и bungeecord: false. Последний параметр при современной передаче данных должен оставаться равным false.

Создание сервера lobby

Лобби использует тот же server.jar и ту же глобальную конфигурацию Paper:

Терминал
sudo -u minecraft mkdir -p /opt/minecraft/lobby/config
sudo chmod 700 /opt/minecraft/lobby/config
sudo -u minecraft cp /opt/minecraft/server/server.jar /opt/minecraft/lobby/
sudo -u minecraft cp /opt/minecraft/server/config/paper-global.yml /opt/minecraft/lobby/config/
echo "eula=true" | sudo -u minecraft tee /opt/minecraft/lobby/eula.txt

Создайте его настройки с плоским миром и без монстров:

Терминал
sudo -u minecraft tee /opt/minecraft/lobby/server.properties > /dev/null <<'EOF'
server-ip=127.0.0.1
server-port=25567
online-mode=false
motd=Lobby
max-players=50
level-type=minecraft\:flat
generate-structures=false
gamemode=adventure
force-gamemode=true
difficulty=peaceful
allow-nether=false
view-distance=6
simulation-distance=4
EOF

Создайте его сервис:

Терминал
sudo nano /etc/systemd/system/minecraft-lobby.service
Конфигурация
[Unit]
Description=Minecraft Lobby Server
After=network.target

[Service]
User=minecraft
WorkingDirectory=/opt/minecraft/lobby
ExecStart=/usr/bin/java -Xms512M -Xmx1G -jar /opt/minecraft/lobby/server.jar nogui
ExecStop=/bin/kill -SIGINT $MAINPID
SuccessExitStatus=130 143
TimeoutStopSec=180
Restart=on-failure
RestartSec=20
StandardInput=null

[Install]
WantedBy=multi-user.target

Запуск всех сервисов

Запустите оба сервера, затем следите за первым запуском лобби до появления строки Done:

Терминал
sudo systemctl daemon-reload
sudo systemctl start minecraft.service
sudo systemctl enable --now minecraft-lobby.service
sudo journalctl -u minecraft-lobby.service -f

Выйдите из просмотра журнала клавишами Ctrl+C, затем запустите прокси:

Терминал
sudo systemctl enable --now velocity.service
sudo journalctl -u velocity.service -n 30 --no-pager

Проверка закрытия внутренних портов

Терминал
sudo ss -ltnp | grep -E ':(25565|25566|25567)\b'

Порт 25565 должен прослушиваться на всех адресах. Для портов 25566 и 25567 должно отображаться 127.0.0.1 или [::ffff:127.0.0.1], но никогда 0.0.0.0, * или [::].

Настройки брандмауэра не меняются: открытым остаётся только порт 25565. При использовании UFW эта команда не должна ничего вывести:

Терминал
sudo ufw status | grep -E '2556[67]'

Затем проверьте порты с другого компьютера. Первый должен ответить, а проверка второго должна завершиться неудачей:

Терминал
nc -zv -w 5 IP_СЕРВЕРА 25565
nc -zv -w 5 IP_СЕРВЕРА 25566

Если сервер находится на другой машине

Петлевой интерфейс работает только в пределах одной машины. На второй машине настройте сервер на прослушивание частного адреса, в идеале адреса туннеля WireGuard, укажите этот адрес в velocity.toml и разрешите доступ только прокси. На этой второй машине с UFW:

Терминал
sudo ufw allow from IP_ПРОКСИ to any port 25566 proto tcp

Или с iptables:

Терминал
sudo iptables -A INPUT -p tcp -s IP_ПРОКСИ --dport 25566 -j ACCEPT
sudo iptables -A INPUT -p tcp --dport 25566 -j DROP

Проверка результата

Сначала проверьте все три сервиса:

Терминал
systemctl is-active velocity.service minecraft.service minecraft-lobby.service

Затем подключитесь через клиент Minecraft по тому же адресу, что и раньше. Вы должны оказаться в лобби. Введите:

Текст
/server
/server survie

Первая команда выводит список серверов, вторая переносит вас на другой сервер без отключения. Ваши постройки и инвентарь должны быть на месте. Наконец, проверьте, что получил сервер:

Терминал
sudo journalctl -u minecraft.service --since "10 minutes ago" --no-pager | grep -E 'UUID of player|logged in with entity id'

Вы должны увидеть свой публичный IP-адрес, а не 127.0.0.1. Третий блок UUID должен начинаться с 4: это признак аутентифицированной учётной записи.

Плагины и прокси

Плагины Paper остаются в папке plugins каждого сервера. У Velocity собственные плагины: их нужно поместить в /opt/minecraft/velocity/plugins и загрузить, перезапустив прокси.

Если вы используете Geyser и Floodgate, за прокси их установка меняется: следуйте документации Floodgate для Velocity.

Резервное копирование прокси и лобби

Скрипт backup.sh из базового руководства не охватывает эти папки. Сначала защитите папку с архивами, поскольку в них будет находиться секрет:

Терминал
sudo chmod 700 /opt/minecraft/backups

Затем добавьте эту строку в /opt/minecraft/backup.sh после существующей строки tar. Благодаря префиксу world_ такие архивы будут учитываться при автоматической очистке, которую выполняет скрипт:

Терминал
tar -czf $BACKUP_DIR/world_proxy_$DATE.tar.gz -C /opt/minecraft velocity lobby

Обновление

Когда выходит новая версия Minecraft, обновляйте Velocity раньше серверов, чтобы он принимал новые клиенты. На время операции игроки будут отключены:

Терминал
sudo systemctl stop velocity.service
sudo tar -czf /opt/minecraft/backups/velocity-$(date +%F-%H%M).tar.gz -C /opt/minecraft velocity
sudo -u minecraft /opt/minecraft/velocity-update.sh 4.3.1
sudo systemctl start velocity.service

Затем обновите сервер survie, как описано в руководстве по Paper, и скопируйте его файл в папку лобби:

Терминал
sudo systemctl stop minecraft-lobby.service
sudo tar -czf /opt/minecraft/backups/lobby-$(date +%F-%H%M).tar.gz -C /opt/minecraft lobby
sudo -u minecraft cp /opt/minecraft/server/server.jar /opt/minecraft/lobby/server.jar
sudo systemctl start minecraft-lobby.service

Откат

Чтобы вернуться к одиночному серверу на порту 25565, не потеряв игровой прогресс, накопленный за это время:

Терминал
sudo systemctl disable --now velocity.service minecraft-lobby.service
sudo systemctl stop minecraft.service
sudo -u minecraft sed -i \
    -e 's/^server-ip=.*/server-ip=/' \
    -e 's/^server-port=.*/server-port=25565/' \
    -e 's/^online-mode=.*/online-mode=true/' \
    /opt/minecraft/server/server.properties
sudo -u minecraft sed -i "/^  velocity:/,/^ \{0,2\}[a-z]/{s/^    enabled: .*/    enabled: false/;s/^    secret: .*/    secret: ''/;}" /opt/minecraft/server/config/paper-global.yml
sudo systemctl start minecraft.service

Папки velocity и lobby остаются на месте. При более серьёзной проблеме восстановите архив avant-velocity-…, как описано в разделе Восстановление из резервной копии руководства по Paper.

При возникновении проблем

Начните с журналов прокси и соответствующего сервера:

Терминал
sudo journalctl -u velocity.service -n 100 --no-pager
sudo journalctl -u minecraft.service -n 100 --no-pager
sudo journalctl -u minecraft-lobby.service -n 100 --no-pager

«Unable to connect you to lobby. Please try again later.»

Velocity не может связаться с этим сервером. Убедитесь, что он запущен и завершил загрузку, а порт в velocity.toml совпадает с server-port. Приведённая выше команда ss показывает фактически открытые порты.

«There are no available servers to connect you to.»

Ни один сервер из списка try не принял игрока. Проверьте этот список и запустите хотя бы один из указанных серверов.

«Your server did not send a forwarding request to the proxy»

Современная передача данных не включена на сервере Paper. Проверьте наличие enabled: true в config/paper-global.yml, затем перезапустите сервер. Если в его журнале есть сообщение Velocity is enabled, but no secret key was specified, секрет пуст: вернитесь к разделу Подключение существующего сервера.

«Unable to verify player details»

Секрет в Paper не совпадает с forwarding.secret. Снова выполните команду копирования секрета на соответствующем сервере, затем перезапустите его. Для лобби используйте путь /opt/minecraft/lobby/config/paper-global.yml.

«This server requires you to connect with Velocity.»

Игрок подключается к серверу Paper в обход прокси, либо Velocity не использует режим modern. Проверьте player-info-forwarding-mode и адрес, который использует игрок. Если ему удалось подключиться к порту 25566 из интернета, немедленно закройте этот порт.

«This server is only compatible with Minecraft 1.13 and above.»

Современная передача данных не принимает клиенты версий ниже 1.13. Этим игрокам нужно перейти на более новую версию.

Velocity не запускается

Сообщение в журнале Причина Решение
Can't bind to …:25565 Порт уже занят, часто сервером Minecraft Проверьте server-port и воспользуйтесь sudo ss -ltnp
Server 'factions' for forced host '…' does not exist В [forced-hosts] остался пример Очистите этот раздел
Fallback server … is not registered in your configuration! Имя из try отсутствует в [servers] Исправьте имя
You don't have a forwarding secret set Файл секрета пуст или не найден Проверьте forwarding.secret
UnsupportedClassVersionError Слишком старая версия Java Установите Java 25

«FAILED TO BIND TO PORT» на сервере Paper

Два сервиса используют один и тот же порт. Проверьте server-port в каждом файле server.properties: 25566 для survie, 25567 для лобби.

Игроки потеряли инвентарь

Сервер назначил им другой UUID, обычно потому, что передача данных не была включена или proxies.velocity.online-mode не соответствует online-mode в Velocity. Остановите сервер, исправьте эти параметры и запустите его снова: исходные данные остаются в мире под старым UUID.

Подробнее читайте в официальной документации Velocity, особенно на страницах о передаче данных игроков и безопасности.