Как объединить несколько серверов Minecraft с помощью Velocity
Объедините несколько серверов Paper за прокси Velocity на VPS или выделенном Linux-сервере: безопасная передача данных игроков, закрытые внутренние порты и откат.
На этой странице
Ваши значения
Укажите их один раз, и команды в руководстве обновятся.
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Проверьте или измените эти строки в начале файла:
bind = "0.0.0.0:25565"
online-mode = true
player-info-forwarding-mode = "modern"
forwarding-secret-file = "forwarding.secret"Затем замените всё содержимое разделов [servers] и [forced-hosts]:
[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, особенно на страницах о передаче данных игроков и безопасности.