Установка сервера Velocity в панели Pterodactyl
Инструкция, как установить и запустить сервер Velocity в панели управления Pterodactyl. Сама панель уже должна быть установлена — это описано в статье Как установить и настроить панель управления игровым сервером Pterodactyl. Все снимки экрана сняты с настоящей панели: инструкция проверена 19 ноября 2026 года на Pterodactyl 1.15.2 и Wings 1.13.5 с Velocity 4.3.1.
Velocity — прокси для Minecraft Java Edition от авторов Paper. Игроки заходят на один адрес, а прокси направляет их на один из ваших серверов — лобби, выживание, мини-игры — и позволяет переходить между ними командой /server. Velocity быстрее BungeeCord и надёжнее защищает игровые серверы от входа в обход прокси. Сам прокси мира не содержит: игровые серверы ставятся отдельно, например Paper.
Что понадобится
- VDS с установленной панелью Pterodactyl и узлом Wings; вход в панель под учётной записью администратора.
- Память: прокси занимает около 220 МБ. Серверу в панели отведите 1 ГБ.
- Диск: файлы прокси занимают около 40 МБ, образ Docker с Java — около 1 ГБ. Серверу в панели отведите 2 ГБ.
Подобрать сервер можно на странице тарифов VDS.
1. Добавьте шаблон игры
Игру в Pterodactyl описывает шаблон — «яйцо» (egg): в нём записано, какой образ Docker использовать, как скачать сервер и какой командой его запустить. Шаблона Velocity в панели изначально нет — его берут из общего хранилища шаблонов, которое ведёт сообщество.
1. Скачайте файл шаблона на свой компьютер: откройте ссылку egg-pterodactyl-velocity.json и сохраните страницу (Ctrl+S) под именем egg-pterodactyl-velocity.json. Нужен именно файл со словом pterodactyl в имени: соседний файл без него предназначен для другой панели и в Pterodactyl не загрузится.
2. В панели перейдите в раздел администратора (значок с шестерёнками справа вверху) и откройте Nests. Гнездо (nest) — это папка для шаблонов; новый шаблон положим в гнездо Minecraft — оно есть в панели изначально.
3. Нажмите Import Egg. В поле «Egg File» выберите скачанный файл, в поле «Associated Nest» — гнездо Minecraft и нажмите Import:
Панель откроет страницу шаблона с сообщением «Successfully imported this Egg and its associated variables».
2. Выделите порты
Адрес и порты сервер получает из списка «выделений» (allocations) узла. Серверу Velocity нужны порты:
| Порт | Протокол | Зачем |
|---|---|---|
| 25565 | TCP | Адрес, на который заходят игроки. Игровым серверам за прокси порты выделяют отдельно — см. раздел «Подключение игровых серверов» |
1. Откройте Nodes, щёлкните по своему узлу и перейдите на вкладку Allocation.
2. В блоке «Assign New Allocations» в поле «IP Address» выберите IP-адрес VDS, а в поле «Ports» введите 25565 — после каждого номера нажимайте Enter. Нажмите Submit:
IP-адрес на снимках заменён примером.
3. Создайте сервер
1. Откройте Servers и нажмите Create New.
2. Заполните верхнюю часть формы:
- Server Name — название сервера в панели; игроки его не видят;
- Server Owner — начните вводить почту своей учётной записи и выберите её из списка;
- Node — ваш узел, Default Allocation — порт
25565; - Memory —
1024(в мегабайтах), Disk Space —2000, Swap —0, CPU Limit —0, то есть без ограничения.
3. В блоке «Nest Configuration» выберите гнездо Minecraft и шаблон Velocity. Образ Docker и команда запуска подставятся сами, менять их не нужно:
4. В блоке «Service Variables» задайте настройки игры. Что стоит изменить:
| Поле | Что вписать |
|---|---|
| Docker Image (блок «Docker Configuration») | Выберите Java 25 — в списке образов этого шаблона первой стоит Java 8, а Velocity 4 требует Java 25 |
| Velocity Version и Build Number | Оставьте latest. На установку они не влияют: файл прокси вы загрузите сами на шаге 5
|
| Server Jar File | Имя файла прокси. Оставьте velocity.jar
|
Остальные поля можно оставить как есть.
5. Нажмите Create Server внизу страницы.
4. Дождитесь установки
Панель создаст сервер, а Wings начнёт установку: скачает образ Docker и файлы игры. Установка занимает несколько секунд.
Выйдите из раздела администратора (значок выхода справа вверху) и щёлкните по серверу в списке — откроется его страница с консолью.
5. Запустите сервер
Сначала загрузите файл прокси. После установки сервер попробует запуститься и сразу остановится: в консоли появится строка «Error: Invalid or corrupt jarfile velocity.jar». Установочный скрипт шаблона скачивает Velocity по старому адресу PaperMC, который больше не работает, и вместо файла сохраняет ответ об ошибке размером около 150 байт. Поле «Download Path» в форме создания здесь не поможет — скрипт этого шаблона его не читает. Поэтому файл нужно загрузить самому:
- откройте страницу papermc.io/downloads/velocity и скачайте на свой компьютер последнюю сборку — файл вида
velocity-4.3.1-45.jar, около 40 МБ; - переименуйте его в
velocity.jar; - на вкладке Files нажмите Upload и выберите файл — он заменит неисправный;
- вернитесь на вкладку Console и нажмите Start.
Лицензию Minecraft прокси принимать не просит. Он готов, когда в консоли появилась строка «Done (…)!» — при проверке запуск занял несколько секунд:
Кнопки Restart и Stop перезапускают и останавливают сервер; при остановке панель посылает ему штатную команду завершения, и он успевает сохранить мир. Команды сервера вводят в строку под консолью.
6. Откройте порты в файрволе
Если на VDS включён файрвол ufw, разрешите порты сервера. Выполните на VDS:
sudo ufw allow 25565/tcp
Проверить, включён ли файрвол, можно командой sudo ufw status: ответ «Status: inactive» означает, что он выключен и порты открывать не нужно.
При проверке прокси, созданный в панели, ответил на запрос снаружи, с другого компьютера: «Velocity 1.7.2-26.3».
7. Зайдите на сервер
Игроки заходят на адрес прокси: «Сетевая игра» → «Добавить сервер» → IP_СЕРВЕРА:25565. Пока за прокси нет ни одного работающего игрового сервера, зайти не получится — сначала подключите игровые серверы (см. ниже).
Настройки после установки
Всё, что вы задали в блоке «Service Variables», можно изменить позже — на вкладке Startup страницы сервера. Изменения вступают в силу после перезапуска сервера кнопкой Restart.
Настройки прокси лежат в файле velocity.toml. На вкладке Files щёлкните по нему, измените нужное, нажмите Save Content и перезапустите прокси. Главные параметры:
| Параметр | Что задаёт |
|---|---|
motd |
Описание в списке серверов |
show-max-players |
Число мест, которое показывается в списке серверов. Настоящего ограничения у Velocity нет |
online-mode |
true — прокси проверяет лицензию игроков у Mojang
|
player-info-forwarding-mode |
Как передавать игровым серверам настоящие адреса и имена игроков. Для серверов Paper ставьте "modern"
|
раздел [servers] |
Список игровых серверов: имя и адрес с портом. Строка try — на какой сервер попадает игрок при входе
|
раздел [forced-hosts] |
Привязка доменных имён к серверам. Если не нужна, удалите строки-примеры |
Плагины. Плагины Velocity кладут в папку plugins на вкладке Files и перезапускают прокси. Плагины для Paper и Spigot сюда не подходят — они ставятся на игровые серверы.
Подключение игровых серверов
Игровые серверы за прокси не должны быть доступны из интернета напрямую, иначе игрок зайдёт в обход прокси под любым именем. В Pterodactyl для этого игровым серверам выделяют порт не на внешнем IP-адресе VDS, а на внутреннем адресе сети Docker — 172.18.0.1: такой порт виден только серверам того же узла. При проверке запрос из интернета на такой порт получил отказ, а через прокси игровой сервер отвечал.
1. Выделите внутренний порт. В разделе администратора откройте Nodes → узел → Allocation. В поле «IP Address» введите 172.18.0.1 и нажмите Enter, в поле «Ports» — порт игрового сервера, например 25566, затем Submit:
2. Создайте игровой сервер по статье для своего ядра — например, Paper, — и в поле «Default Allocation» выберите 172.18.0.1:25566. У уже созданного сервера адрес меняется в разделе администратора: Servers → сервер → вкладка Build Configuration → «Game Port».
3. Впишите сервер в настройки прокси. В файле velocity.toml в разделе [servers] уже есть три строки-примера (lobby, factions, minigames) с портами 30066–30068. Оставьте свои серверы и исправьте адреса:
[servers] lobby = "172.18.0.1:25566" try = ["lobby"]
Строки с серверами, которых у вас нет, удалите — и здесь, и в разделе [forced-hosts].
4. Включите передачу данных игроков. Без неё все игроки на игровом сервере выглядят пришедшими с адреса прокси, а сервер не может проверить, что игрок пришёл именно через него.
- В
velocity.tomlпоставьтеplayer-info-forwarding-mode = "modern". - На вкладке Files прокси откройте файл
forwarding.secretи скопируйте его содержимое — это общий секрет прокси и игровых серверов. Никому его не показывайте. - На игровом сервере Paper в файле
server.propertiesпоставьтеonline-mode=false, а в файлеconfig/paper-global.ymlв разделеproxies→velocity—enabled: true,online-mode: trueи в строкуsecretвставьте скопированный секрет в одинарных кавычках. - Перезапустите игровой сервер и прокси.
Paper после этого пишет при запуске предупреждение «SERVER IS RUNNING IN OFFLINE/INSECURE MODE» — так и должно быть: лицензию игроков теперь проверяет прокси. При проверке прокси и сервер Paper 26.3 с такими настройками запустились, и прокси показывал в списке серверов описание игрового сервера.
Серверам на Fabric, Forge и NeoForge для режима modern нужен отдельный мод — ищите его по словам «Velocity forwarding» для своего загрузчика.
Если игровой сервер стоит на другом VDS, в разделе [servers] указывают его внешний адрес и порт, а порт игрового сервера в файрволе того VDS открывают только для IP-адреса прокси.
Обновление прокси
Скачайте свежую сборку со страницы papermc.io/downloads/velocity, переименуйте файл в velocity.jar, остановите прокси и загрузите файл через Files → Upload поверх прежнего, затем нажмите Start. Настройки и секрет при этом не меняются. Кнопкой Reinstall Server не пользуйтесь: она снова заменит файл прокси неисправным.
Если что-то пошло не так
| Что видите | Причина и решение |
|---|---|
| В консоли «Error: Invalid or corrupt jarfile velocity.jar» | Вместо файла прокси сохранился ответ об ошибке. Загрузите настоящий velocity.jar через вкладку Files, как описано в шаге 5.
|
| В консоли «UnsupportedClassVersionError» или «has been compiled by a more recent version of the Java Runtime» | Выбрана старая Java. На вкладке Startup выберите Java 25 в списке «Docker Image» и запустите прокси снова. |
| Игрок заходит на прокси, но получает сообщение, что соединиться с сервером не удалось | Прокси не достаёт до игрового сервера. Проверьте адрес и порт в разделе [servers] файла velocity.toml, убедитесь, что игровой сервер запущен и что его порт выделен на адресе 172.18.0.1.
|
| Игровой сервер отключает игрока с сообщением «Unable to verify player details» | Секрет на игровом сервере не совпадает с файлом forwarding.secret прокси или на прокси не включён режим modern. Сверьте обе настройки и перезапустите оба сервера.
|
| При импорте шаблона панель сообщает об ошибке формата | Скачан файл для другой панели или вместо файла сохранилась веб-страница. Нужен файл egg-pterodactyl-….json, сохранённый по ссылке из шага 1.
|
| В форме создания сервера нет нужного порта | Порт не выделен или уже занят другим сервером. Проверьте вкладку Allocation узла. |
| Установка не заканчивается: надпись об установке висит часами | Wings ждёт загрузки образа Docker не дольше 15 минут; если канал медленный, загрузка обрывается, а сервер остаётся в состоянии установки. Скачайте образ на VDS вручную: sudo docker pull ghcr.io/pelican-eggs/yolks:java_25, затем на странице сервера откройте Settings и нажмите Reinstall Server.
|
| Сервер запущен, но зайти не удаётся | Проверьте, что порты открыты в файрволе VDS и что в игре указан верный адрес и порт. |
Для размещения игровых серверов рекомендуем услуги ARK-HOSTER.RU:
- VPS/VDS серверы — для небольших и средних серверов
- Выделенные серверы — для высоконагруженных игровых серверов