Настройка прокси Velocity для сети серверов Minecraft
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.
Как устроена сеть
| Что | Каталог | Адрес и порт | Служба |
|---|---|---|---|
| Прокси 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 — Привязка домена к Minecraft серверу.
Плагины. У прокси свои плагины — каталог /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:
- VPS/VDS серверы — для небольших и средних серверов
- Выделенные серверы — для высоконагруженных игровых серверов