Настройка прокси Velocity для сети серверов Minecraft

Материал из ARK-HOSTER.RU | Документация хостинга
Перейти к навигации Перейти к поиску

Velocity — прокси для серверов Minecraft: игроки подключаются к одному адресу, а за ним стоит несколько серверов — лобби, выживание, мини-игры. Между серверами игрок переходит командой /server, не выходя из игры, а сами серверы спрятаны: снаружи виден только прокси. Velocity делает команда PaperMC — та же, что выпускает Paper. В статье — установка прокси, второй сервер, связка их в сеть и проверка. Всё проверено 17 ноября 2026 года на Ubuntu 24.04.4: Velocity 4.3.1, два сервера Paper 26.3; снимки экрана сняты с настоящего сервера.

Первый сервер установлен по статье Установка и настройка Spigot-Paper сервера: каталог /opt/minecraft/server, служба minecraft. Прежний прокси того же назначения описан в статье Настройка BungeeCord для Minecraft сети; для новых сетей разработчики Paper советуют Velocity.

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

Что Каталог Адрес и порт Служба
Прокси Velocity /opt/minecraft/velocity все адреса, 25565 — сюда заходят игроки velocity
Сервер lobby /opt/minecraft/server 127.0.0.1:25566 minecraft
Сервер survival /opt/minecraft/survival 127.0.0.1:25567 minecraft-survival

Три правила, на которых всё держится:

  • учётную запись игрока проверяет прокси — на нём online-mode = true. На серверах за ним проверка выключена (online-mode=false): они доверяют прокси;
  • прокси передаёт серверам, кто зашёл — имя, идентификатор и адрес игрока. Способ передачи называется modern и защищён общим секретом: сервер принимает игрока, только если его привёл прокси, знающий секрет;
  • серверы слушают только внутренний адрес 127.0.0.1 — подключиться к ним снаружи, минуя прокси, нельзя.

Сколько нужно ресурсов. Прокси хватает 1 ГБ памяти. Каждому серверу память нужна своя, как обычному серверу Minecraft: два сервера по 2 ГБ и прокси — это тариф от 6–8 ГБ. Как считать — Какой VDS выбрать для игрового сервера; подобрать — тарифы VDS.

1. Установка Velocity

Номер свежей версии смотрите на странице загрузки PaperMC; на день проверки это 4.3.1.

sudo systemctl stop minecraft
V=4.3.1
U=$(curl -s https://fill.papermc.io/v3/projects/velocity/versions/$V/builds/latest | jq -r '.downloads["server:default"].url')
sudo -u minecraft mkdir -p /opt/minecraft/velocity
sudo -u minecraft curl -sL -o /opt/minecraft/velocity/velocity.jar "$U"
sudo ls -l /opt/minecraft/velocity | cut -c24-90

Файл занимает около 42 МБ. Сервер Minecraft остановлен в первой строке не случайно: он занимает порт 25565, который теперь нужен прокси.

Служба для прокси:

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

[Service]
Type=forking
User=minecraft
WorkingDirectory=/opt/minecraft/velocity
ExecStart=/usr/bin/tmux -L velocity new-session -d -s velocity '/usr/bin/java -Xms1G -Xmx1G -XX:+UseG1GC -jar velocity.jar'
ExecStop=/usr/bin/tmux -L velocity send-keys -t velocity 'shutdown' Enter
ExecStop=/bin/sh -c 'while tmux -L velocity has-session -t velocity 2>/dev/null; do sleep 1; done'
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

Первый запуск нужен, чтобы Velocity создал свои файлы; после него прокси останавливаем для настройки:

sudo systemctl daemon-reload
sudo systemctl enable --now velocity
sudo systemctl stop velocity
sudo ls /opt/minecraft/velocity
grep -E "Booting|Listening|Done" /opt/minecraft/velocity/logs/latest.log | sed -E 's/ \[[^]]*\] \[[^]]*\]//' | cut -c1-100

На снимке служба создана одной командой вместо редактора — результат тот же. Появились velocity.toml — настройки прокси — и forwarding.secret — тот самый общий секрет. Его никому не показывают: зная секрет, можно выдать себя за любого игрока.

Почему tmux -L velocity. Каждая служба запускает свою консоль в отдельном tmux с собственным именем. Если этого не сделать, вторая служба пользователя minecraft попадёт в tmux первой, и systemd не сможет за ней следить — на проверке такая служба завершалась с ошибкой «timeout was exceeded».

2. Настройка прокси

sudo -u minecraft sed -i 's/^player-info-forwarding-mode = .*/player-info-forwarding-mode = "modern"/; s/^lobby = .*/lobby = "127.0.0.1:25566"/; s/^factions = .*/survival = "127.0.0.1:25567"/; /^minigames = /d' /opt/minecraft/velocity/velocity.toml
sudo -u minecraft sed -i '/^"lobby.example.com"/,/^\[advanced\]/{/^\[advanced\]/!d}' /opt/minecraft/velocity/velocity.toml
sudo grep -E "^(bind|motd|show-max-players|online-mode|player-info-forwarding-mode|forwarding-secret-file) " /opt/minecraft/velocity/velocity.toml
sudo sed -n '/^\[servers\]/,/^\[advanced\]/p' /opt/minecraft/velocity/velocity.toml | grep -v -E "^\s*(#|$)"

Первая команда включает передачу сведений об игроке и заменяет серверы из примера своими, вторая убирает из раздела [forced-hosts] примеры с несуществующими серверами. То же можно сделать в редакторе: sudo nano /opt/minecraft/velocity/velocity.toml.

Настройка Что означает
bind Адрес и порт, на которых прокси ждёт игроков
motd, show-max-players Название и число мест в списке серверов игры
online-mode = true Прокси проверяет учётные записи игроков. Не выключайте
player-info-forwarding-mode modern — передавать серверам имя, идентификатор и адрес игрока с проверкой секретом. Подходит для серверов версии 1.13 и новее
[servers] Серверы сети: имя и адрес. Имя — то, что игрок вводит в команде /server
try Куда отправлять игрока при входе и куда — если его сервер выключился
[forced-hosts] Какое доменное имя ведёт сразу на какой сервер — см. ниже

3. Серверы за прокси

Сначала существующий сервер — он станет lobby. Ему нужны новый порт, внутренний адрес, выключенная проверка учётных записей и секрет прокси:

sudo -u minecraft sed -i 's/^server-ip=.*/server-ip=127.0.0.1/; s/^server-port=.*/server-port=25566/; s/^online-mode=.*/online-mode=false/' /opt/minecraft/server/server.properties
sudo -u minecraft sed -i "/^  velocity:/,/secret:/{s/enabled: false/enabled: true/; s/secret: .*/secret: '$(sudo cat /opt/minecraft/velocity/forwarding.secret)'/}" /opt/minecraft/server/config/paper-global.yml

Вторая команда правит раздел proxies → velocity в настройках Paper: включает его и вписывает секрет из файла прокси, не показывая его на экране.

Второй сервер — копия первого без мира: при запуске он создаст свой. Копируя eula.txt, вы подтверждаете согласие с лицензионным соглашением Minecraft и для него.

sudo -u minecraft mkdir -p /opt/minecraft/survival/config
sudo -u minecraft cp /opt/minecraft/server/{paper.jar,eula.txt,server.properties} /opt/minecraft/survival/
sudo -u minecraft cp /opt/minecraft/server/config/paper-global.yml /opt/minecraft/survival/config/
sudo -u minecraft sed -i 's/^server-port=.*/server-port=25567/; s/^rcon.port=.*/rcon.port=25576/; s/^motd=.*/motd=Survival/' /opt/minecraft/survival/server.properties
sudo sed 's#/opt/minecraft/server#/opt/minecraft/survival#; s/tmux new-session -d -s minecraft/tmux -L survival new-session -d -s survival/; s/tmux send-keys -t minecraft/tmux -L survival send-keys -t survival/; s/tmux has-session -t minecraft/tmux -L survival has-session -t survival/' /etc/systemd/system/minecraft.service | sudo tee /etc/systemd/system/minecraft-survival.service > /dev/null
grep -E "^(server-ip|server-port|online-mode)=" /opt/minecraft/server/server.properties /opt/minecraft/survival/server.properties | sed 's#/opt/minecraft/##'
sudo grep -A3 "^  velocity:" /opt/minecraft/survival/config/paper-global.yml | sed -E "s/(secret: ').*/\1************'/"
grep -E "^(Working|ExecStart)" /etc/systemd/system/minecraft-survival.service | cut -c1-105

У второго сервера свой порт игры и свой порт RCON (если RCON включён — Настройка RCON на сервере Minecraft). Служба второго сервера получена из службы первого заменой каталога и имени консоли. Предпоследняя команда показывает раздел velocity в настройках Paper, закрывая секрет звёздочками.

4. Запуск и проверка

Для проверки пригодится маленькая программа, которая спрашивает сервер так же, как список серверов в игре:

sudo nano /usr/local/bin/mc-ping
#!/usr/bin/env python3
# mc-ping <адрес> [порт] — запрос состояния сервера Minecraft Java
import json, socket, struct, sys
host = sys.argv[1]; port = int(sys.argv[2]) if len(sys.argv) > 2 else 25565
def varint(n):
    out = b''
    while True:
        out += bytes([(n & 0x7F) | (0x80 if n > 0x7F else 0)]); n >>= 7
        if not n: return out
def read_varint(s):
    n = 0
    for i in range(5):
        b = s.recv(1)[0]; n |= (b & 0x7F) << (7 * i)
        if b < 0x80: return n
def text(t):
    if isinstance(t, str): return t
    return t.get('text', '') + ''.join(text(e) for e in t.get('extra', []))
h = host.encode()
try:
    s = socket.create_connection((host, port), 4)
    hello = b'\x00' + varint(0) + varint(len(h)) + h + struct.pack('>H', port) + varint(1)
    s.sendall(varint(len(hello)) + hello + b'\x01\x00')
    read_varint(s); read_varint(s); n = read_varint(s); d = b''
    while len(d) < n: d += s.recv(n - len(d))
except (OSError, IndexError, TypeError):
    print('нет ответа'); sys.exit(1)
j = json.loads(d)
print('сервер отвечает: "%s" | %s | игроков %s/%s' % (text(j.get('description', '')), j['version']['name'], j['players']['online'], j['players']['max']))
sudo chmod +x /usr/local/bin/mc-ping
sudo systemctl daemon-reload
sudo systemctl start minecraft velocity
sudo systemctl enable --now minecraft-survival
systemctl is-active velocity minecraft minecraft-survival | tr "\n" " "; echo
sudo ss -lntp | grep -E ":(25565|25566|25567) " | awk '{print $4}' | sort
mc-ping 127.0.0.1 25565
mc-ping 127.0.0.1 25566
mc-ping 127.0.0.1 25567

Серверам нужно около минуты на запуск — особенно второму, он создаёт мир. На снимке: все три службы работают; порт 25565 открыт на всех адресах, 25566 и 25567 — только на внутреннем; прокси отвечает «A Velocity Server» и принимает игроков версий от 1.7.2 до 26.3, оба сервера отвечают прокси.

На проверке тот же запрос отправлен и снаружи, с другого компьютера: порт 25565 ответил, порты 25566 и 25567 — нет. Кроме того, проверена защита секретом: попытка войти на сервер напрямую, в обход прокси, получила отказ — в журнале сервера осталась строка

lost connection: This server requires you to connect with Velocity.

5. Консоль прокси

Команды в консоль прокси отправляются так же, как серверу, — через tmux; ответ виден на экране консоли:

sudo -u minecraft tmux -L velocity send-keys -t velocity 'glist all' Enter
sudo -u minecraft tmux -L velocity send-keys -t velocity 'velocity plugins' Enter
sudo -u minecraft tmux -L velocity send-keys -t velocity 'velocity info' Enter
sudo -u minecraft tmux -L velocity capture-pane -p -t velocity | grep -v '^$' | tail -n 9 | cut -c1-105
grep -E "OFFLINE|Done \(" /opt/minecraft/survival/logs/latest.log | cut -c34-110

Открыть консоль целиком — sudo -u minecraft tmux -L velocity attach -t velocity, выйти, не останавливая прокси, — Ctrl+B, затем D. Консоль второго сервера — то же с -L survival и -t survival.

Предупреждение «SERVER IS RUNNING IN OFFLINE/INSECURE MODE» в журнале серверов (последняя команда на снимке) теперь ожидаемо: проверку учётных записей делает прокси, а серверы закрыты от прямых подключений адресом 127.0.0.1 и секретом.

Команда Что делает
glist all Сколько игроков в сети и кто на каком сервере
server имя Только в игре: перейти на другой сервер. Без имени — показать список серверов
send игрок имя_сервера Перевести игрока на другой сервер
velocity plugins Плагины прокси
velocity reload Перечитать velocity.toml
shutdown Остановить прокси

6. Файрвол

Наружу нужен только порт прокси:

sudo ufw allow 25565/tcp

Порты 25566 и 25567 открывать не нужно — и нельзя: серверы за прокси не проверяют учётные записи.

Что дальше

Доменные имена на серверы. Раздел [forced-hosts] отправляет игрока на сервер по имени, которое он ввёл в игре:

[forced-hosts]
"survival.example.com" = [
    "survival"
]

Каждое такое имя должно указывать на адрес VDS — это запись типа A у регистратора домена.

Плагины. У прокси свои плагины — каталог /opt/minecraft/velocity/plugins, вариант «Velocity» на странице загрузки плагина. Чтобы права были общими для всей сети, LuckPerms ставят на прокси и на каждый сервер и подключают к одной базе данных — Права и группы на сервере Minecraft — плагин LuckPerms. Чтобы пускать игроков Bedrock, Geyser и Floodgate ставят на прокси, а Floodgate — ещё и на каждый сервер, с одним и тем же файлом key.pem — Вход игроков Bedrock на сервер Minecraft Java — Geyser и Floodgate.

Серверы на отдельных VDS. Когда серверам становится тесно на одном VDS, их выносят на отдельные: в [servers] вместо 127.0.0.1 указывают адрес другого VDS, на том сервере в server-ip оставляют пустое значение, а порт открывают только для адреса прокси:

sudo ufw allow from 203.0.113.10 to any port 25565 proto tcp

Так сеть растёт без переездов: новый режим игры — ещё один VDS, а для самых нагруженных серверов — выделенный сервер.

Копии. В резервную копию должны попадать каталоги всех серверов и прокси — Настройка автоматических бэкапов Minecraft.

Что не проверено

Проверены: установка и служба Velocity, настройки, второй сервер, запуск всех трёх служб, ответы прокси и серверов на запрос состояния — с самого VDS и снаружи, отказ сервера при входе в обход прокси, команды консоли. Не проверены: вход игрока через прокси и переход между серверами командой /server — для этого нужна сама игра с учётной записью; раздел [forced-hosts], плагины на прокси и серверы на отдельных VDS.

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

Что видите Причина и решение
Прокси не запускается, в журнале «Address already in use» Порт 25565 занят — обычно сервером, который ещё не переведён на 25566. Шаг 3
Служба второго сервера или прокси: «timeout was exceeded» В файле службы нет своего имени tmux (-L) — см. шаг 1
Игрок видит «Unable to connect you to lobby» Сервер не запущен или в [servers] неверный порт. Проверьте mc-ping 127.0.0.1 25566
«Unable to verify player details» Секрет на сервере не совпадает с forwarding.secret прокси. Повторите вторую команду шага 3 и перезапустите сервер
«This server requires you to connect with Velocity» Игрок подключается к серверу напрямую, а не к прокси
В журнале сервера «Velocity is enabled, but no secret key was specified» В paper-global.yml пустой secret — прокси ещё не запускался, и файла с секретом не было. Шаг 1, затем шаг 3
У всех игроков одинаковый адрес 127.0.0.1, слетели скины и права На прокси осталось player-info-forwarding-mode = "NONE" — шаг 2
Игроки заходят с пиратских клиентов под чужими именами Сервер доступен снаружи в обход прокси. Верните server-ip=127.0.0.1 и закройте порт сервера

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