Установка сервера MTA San Andreas в панели Pterodactyl
Инструкция, как установить и запустить сервер MTA San Andreas в панели управления Pterodactyl. Сама панель уже должна быть установлена — это описано в статье Как установить и настроить панель управления игровым сервером Pterodactyl. Все снимки экрана сняты с настоящей панели: инструкция проверена 20 ноября 2026 года на Pterodactyl 1.15.2 и Wings 1.13.5 с сервером MTA: San Andreas версии 1.6.
Multi Theft Auto: San Andreas (MTA) — сетевая игра для GTA San Andreas с открытым исходным кодом: гонки, ролевые серверы, перестрелки, свои режимы на языке Lua. Шаблон скачивает сервер, файлы настроек и стандартные ресурсы с сайта разработчиков. Сервер бесплатный, учётных записей и ключей не требует; игрокам нужны GTA San Andreas для ПК и программа MTA.
Что понадобится
- VDS с установленной панелью Pterodactyl и узлом Wings; вход в панель под учётной записью администратора.
- Память: пустой сервер со стандартными ресурсами занимает меньше 100 МБ. Серверу в панели достаточно 2 ГБ; для ролевого сервера с сотней игроков — 4 ГБ.
- Диск: сервер с ресурсами занимает около 80 МБ, образ Docker — около 1,3 ГБ. Серверу в панели отведите 5 ГБ: место понадобится под свои ресурсы — модели, карты, звуки.
Подобрать сервер можно на странице тарифов VDS.
1. Добавьте шаблон игры
Игру в Pterodactyl описывает шаблон — «яйцо» (egg): в нём записано, какой образ Docker использовать, как скачать сервер и какой командой его запустить. Шаблона MTA San Andreas в панели изначально нет — его берут из общего хранилища шаблонов, которое ведёт сообщество.
1. Скачайте файл шаблона на свой компьютер: откройте ссылку egg-pterodactyl-multi-theft-auto.json и сохраните страницу (Ctrl+S) под именем egg-pterodactyl-multi-theft-auto.json. Нужен именно файл со словом pterodactyl в имени: соседний файл без него предназначен для другой панели и в Pterodactyl не загрузится.
2. В панели перейдите в раздел администратора (значок с шестерёнками справа вверху) и откройте Nests. Гнездо (nest) — это папка для шаблонов. Если гнезда для дополнительных игр у вас ещё нет, нажмите Create New, введите имя — например, Games — и нажмите Save.
3. Вернитесь в Nests и нажмите Import Egg. В поле «Egg File» выберите скачанный файл, в поле «Associated Nest» — гнездо Games и нажмите Import:
Панель откроет страницу шаблона с сообщением «Successfully imported this Egg and its associated variables».
4. Исправьте правило переменной. Без этого шага панель не создаст сервер: форма отвечает «There was an error validating the data provided». Причина — в самом шаблоне: у служебной переменной LD_PRELOAD длина значения ограничена 20 знаками, а её же значение по умолчанию длиннее.
На открывшейся странице шаблона перейдите на вкладку Variables, найдите блок переменной «LD_PRELOAD» и в поле Input Rules замените max:20 на max:64 — должно получиться required|string|max:64. Нажмите Save в этом блоке. После этого сервер при проверке создался.
2. Выделите порты
Адрес и порты сервер получает из списка «выделений» (allocations) узла. Серверу MTA San Andreas нужны порты:
| Порт | Протокол | Зачем |
|---|---|---|
| 22003 | UDP | Игра |
| 22005 | TCP | Загрузка ресурсов сервера игроками (поле «SERVER_WEBPORT»). Если порт закрыт, игрок застревает на загрузке |
| 22126 | UDP | Запросы списка серверов — всегда «игровой порт плюс 123» |
1. Откройте Nodes, щёлкните по своему узлу и перейдите на вкладку Allocation.
2. В блоке «Assign New Allocations» в поле «IP Address» выберите IP-адрес VDS, а в поле «Ports» введите 22003, 22005, 22126 — после каждого номера нажимайте Enter. Нажмите Submit:
IP-адрес на снимках заменён примером.
3. Создайте сервер
1. Откройте Servers и нажмите Create New.
2. Заполните верхнюю часть формы:
- Server Name — название сервера в панели; игроки его не видят;
- Server Owner — начните вводить почту своей учётной записи и выберите её из списка;
- Node — ваш узел, Default Allocation — порт
22003, в поле Additional Allocation(s) —22005и22126; - Memory —
2048(в мегабайтах), Disk Space —5000, Swap —0, CPU Limit —0, то есть без ограничения.
3. В блоке «Nest Configuration» выберите гнездо Games и шаблон Multi Theft Auto. Образ Docker и команда запуска подставятся сами, менять их не нужно:
4. В блоке «Service Variables» задайте настройки игры. Что стоит изменить:
| Поле | Что вписать |
|---|---|
| SERVER_WEBPORT | Порт загрузки ресурсов. Оставьте 22005 — тот же порт вы выделили серверу
|
| LD_PRELOAD | Служебная переменная шаблона. Не меняйте |
Остальные поля можно оставить как есть.
5. Нажмите Create Server внизу страницы.
4. Дождитесь установки
Панель создаст сервер, а Wings начнёт установку: скачает образ Docker и файлы игры. Установка занимает меньше минуты: шаблон скачивает сервер, файлы настроек и стандартные ресурсы — вместе около 80 МБ. Если образ Docker ещё не загружен, добавится время на его загрузку.
Выйдите из раздела администратора (значок выхода справа вверху) и щёлкните по серверу в списке — откроется его страница с консолью. Пока идёт установка, вверху страницы стоит надпись «This server is currently running its installation process and most actions are unavailable».
5. Запустите сервер
Когда установка закончится, сервер запустится сам: в форме создания была отмечена настройка «Start Server when Installed». Если вы её сняли, нажмите Start. Запуск занимает пару секунд. Сервер печатает сводку — название, порты, число мест, — загружает ресурсы и пишет «Server started and is ready to accept connections!». Строки «ERROR: ld.so: object … from LD_PRELOAD cannot be preloaded … ignored» в начале — не ошибка сервера: при проверке они были и у работающего сервера.
Кнопки Restart и Stop перезапускают и останавливают сервер; при остановке панель посылает ему штатную команду завершения, и он успевает сохранить мир. Команды сервера вводят в строку под консолью.
6. Откройте порты в файрволе
Если на VDS включён файрвол ufw, разрешите порты сервера. Выполните на VDS:
sudo ufw allow 22003/udp sudo ufw allow 22005/tcp sudo ufw allow 22126/udp
Проверить, включён ли файрвол, можно командой sudo ufw status: ответ «Status: inactive» означает, что он выключен и порты открывать не нужно.
При проверке сервер, созданный в панели, ответил на запрос снаружи, с другого компьютера: название «ARK-HOSTER MTA», режим «play», версия 1.6; порт загрузки ресурсов тоже ответил.
7. Зайдите на сервер
В программе MTA откройте список серверов и найдите сервер по названию, либо нажмите «Быстрое подключение» и введите адрес сервера и порт 22003.
Учётная запись администратора. Создайте её командой в строке под консолью панели — вместо ВАШ_ПАРОЛЬ подставьте свой пароль:
addaccount admin ВАШ_ПАРОЛЬ
Сервер ответит «ACCOUNTS: Console added account 'admin'». Прав у записи пока нет. Остановите сервер кнопкой Stop, на вкладке Files откройте файл mods/deathmatch/acl.xml и сразу под строкой <group name="Admin"> добавьте строку:
<object name="user.admin"></object>
Сохраните файл и запустите сервер. Правьте acl.xml только при остановленном сервере: работающий сервер перезаписывает файл.
В игре откройте консоль клавишей F8 и введите login admin ВАШ_ПАРОЛЬ. Группа Admin защищена привязкой к компьютеру: при первом входе с нового компьютера сервер не пустит и попросит подтверждения. Подтвердите вход командой authserial admin в консоли панели и войдите ещё раз. После входа клавиша P открывает панель администратора: игроки, блокировки, ресурсы, карты.
Настройки после установки
Всё, что вы задали в блоке «Service Variables», можно изменить позже — на вкладке Startup страницы сервера. Изменения вступают в силу после перезапуска сервера кнопкой Restart.
Настройки сервера лежат в папке mods/deathmatch:
mtaserver.conf— главный файл настроек;acl.xml— права: группы и учётные записи администраторов;resources— ресурсы: режимы игры, карты, скрипты;logs— журналы;internal.db— учётные записи.
Файл mtaserver.conf подробно прокомментирован. Меняйте его при остановленном сервере. Самое нужное:
| Строка | Что задаёт |
|---|---|
<servername>Default MTA Server</servername> |
Название сервера в списке |
<maxplayers>32</maxplayers> |
Число мест |
<password></password> |
Пароль на вход. Пусто — сервер открыт всем |
<ase>1</ase> |
Показывать сервер в общем списке. 0 — не показывать
|
<owner_email_address></owner_email_address> |
Почта владельца — на неё разработчики MTA сообщают о проблемах с сервером. Не публикуется |
<fpslimit>36</fpslimit> |
Ограничение кадров у игроков. Для гонок и стрельбы ставят 60 |
Строки <serverport> и <httpport> менять не нужно: порты панель передаёт серверу в команде запуска.
Режимы игры и ресурсы. Всё, что происходит на сервере MTA, — это ресурсы: режим игры, карта, панель администратора, таблица очков. Сразу после установки запущен режим play — свободная игра. В стандартном наборе есть и другие: race (гонки), deathmatch и tdm (перестрелки), ctf (захват флага). Режим меняют командой в консоли панели; при проверке после gamemode race сервер запустил гонки и первую карту.
| Команда | Что делает |
|---|---|
gamemode имя |
Сменить режим игры |
start имя, stop имя, restart имя |
Запустить, остановить, перезапустить ресурс |
refresh |
Перечитать папку ресурсов: сервер увидит новые |
addaccount имя пароль, delaccount имя, chgpass имя пароль |
Учётные записи |
authserial имя |
Подтвердить вход администратора с нового компьютера |
help |
Список всех команд |
Чтобы режим запускался вместе с сервером, откройте mtaserver.conf и в конце файла, в списке строк <resource src="…" startup="1" … />, замените play на нужный режим. Свои ресурсы загружают папкой или архивом .zip в mods/deathmatch/resources (кнопка Upload); после этого в консоли выполняют refresh и start имя.
Кнопка Stop посылает серверу команду shutdown и останавливает его за несколько секунд.
Обновление сервера
Сам сервер при запуске обновления не проверяет. Новую версию ставит кнопка Reinstall Server на вкладке Settings. Перед этим сохраните свои файлы mtaserver.conf и acl.xml: при переустановке шаблон кладёт поверх них файлы настроек из поставки. Скачайте оба файла через меню с тремя точками или сделайте копию на вкладке Backups, а после переустановки верните на место.
Если что-то пошло не так
| Что видите | Причина и решение |
|---|---|
| Форма создания сервера отвечает «There was an error validating the data provided» | Не исправлено правило переменной LD_PRELOAD — см. шаг «Исправьте правило переменной».
|
| В консоли строки «ERROR: ld.so: object … cannot be preloaded … ignored» | На работу сервера не влияют. |
| Игрок застревает на загрузке ресурсов | Закрыт порт 22005/TCP. |
| Сервера нет в общем списке | Закрыт порт 22126/UDP, либо в mtaserver.conf стоит <ase>0</ase>.
|
login отвечает, что вход с этого компьютера не разрешён |
Подтвердите вход командой authserial admin в консоли панели и войдите ещё раз.
|
Правки в acl.xml пропали |
Файл меняли при работающем сервере. Остановите сервер, внесите правки и запустите его. |
| При импорте шаблона панель сообщает об ошибке формата | Скачан файл для другой панели или вместо файла сохранилась веб-страница. Нужен файл egg-pterodactyl-….json, сохранённый по ссылке из шага 1.
|
| В форме создания сервера нет нужного порта | Порт не выделен или уже занят другим сервером. Проверьте вкладку Allocation узла. |
| Установка не заканчивается: надпись об установке висит часами | Wings ждёт загрузки образа Docker не дольше 15 минут; если канал медленный, загрузка обрывается, а сервер остаётся в состоянии установки. Скачайте образ на VDS вручную: sudo docker pull ghcr.io/parkervcp/games:mta, затем на странице сервера откройте Settings и нажмите Reinstall Server.
|
| Сервер запущен, но зайти не удаётся | Проверьте, что порты открыты в файрволе VDS и что в игре указан верный адрес и порт. |
Для размещения игровых серверов рекомендуем услуги ARK-HOSTER.RU:
- VPS/VDS серверы — для небольших и средних серверов
- Выделенные серверы — для высоконагруженных игровых серверов