Установка сервера Terraria в панели Pterodactyl

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

Инструкция, как установить и запустить сервер Terraria в панели управления Pterodactyl. Сама панель уже должна быть установлена — это описано в статье Как установить и настроить панель управления игровым сервером Pterodactyl. Все снимки экрана сняты с настоящей панели: инструкция проверена 19 ноября 2026 года на Pterodactyl 1.15.2 и Wings 1.13.5 с сервером Terraria 1.4.5.8.

Шаблон «Terraria Vanilla» ставит официальный сервер Terraria от разработчиков игры — без модов и плагинов. Сервер бесплатный, учётная запись Steam для его установки не нужна.

Что понадобится

  • VDS с установленной панелью Pterodactyl и узлом Wings; вход в панель под учётной записью администратора.
  • Память: сервер с маленьким миром занимает около 600 МБ. Серверу в панели отведите 2 ГБ.
  • Диск: файлы сервера с миром занимают около 100 МБ, образ Docker — около 1 ГБ. Серверу в панели отведите 5 ГБ.

Подобрать сервер можно на странице тарифов VDS.

1. Добавьте шаблон игры

Игру в Pterodactyl описывает шаблон — «яйцо» (egg): в нём записано, какой образ Docker использовать, как скачать сервер и какой командой его запустить. Шаблона Terraria в панели изначально нет — его берут из общего хранилища шаблонов, которое ведёт сообщество.

1. Скачайте файл шаблона на свой компьютер: откройте ссылку egg-pterodactyl-terraria-vanilla.json и сохраните страницу (Ctrl+S) под именем egg-pterodactyl-terraria-vanilla.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».

2. Выделите порты

Адрес и порты сервер получает из списка «выделений» (allocations) узла. Серверу Terraria нужны порты:

Порт Протокол Зачем
7777 TCP Игра

1. Откройте Nodes, щёлкните по своему узлу и перейдите на вкладку Allocation.

2. В блоке «Assign New Allocations» в поле «IP Address» выберите IP-адрес VDS, а в поле «Ports» введите 7777 — после каждого номера нажимайте Enter. Нажмите Submit:

IP-адрес на снимках заменён примером.

3. Создайте сервер

1. Откройте Servers и нажмите Create New.

2. Заполните верхнюю часть формы:

  • Server Name — название сервера в панели; игроки его не видят;
  • Server Owner — начните вводить почту своей учётной записи и выберите её из списка;
  • Node — ваш узел, Default Allocation — порт 7777;
  • Memory — 2048 (в мегабайтах), Disk Space — 5000, Swap — 0, CPU Limit — 0, то есть без ограничения.

3. В блоке «Nest Configuration» выберите гнездо Games и шаблон Terraria Vanilla. Образ Docker и команда запуска подставятся сами, менять их не нужно:

4. В блоке «Service Variables» задайте настройки игры. Что стоит изменить:

Поле Что вписать
World Name Имя мира — так будет называться файл мира. Если мира с таким именем ещё нет, сервер создаст новый
World Size Размер нового мира: 1 — маленький, 2 — средний, 3 — большой
Difficulty Проверьте это поле. Режим нового мира: 0 — классика, 1 — эксперт, 2 — мастер, 3 — путешествие. По умолчанию в шаблоне стоит 3, а в мир-путешествие пускает только персонажей, созданных в режиме путешествия. Для обычных персонажей поставьте 0
Max Players Число мест на сервере
Password Пароль для входа. Пустое поле — вход без пароля
MOTD Приветствие, которое игрок видит в чате при входе
World Seed Зерно нового мира. Пустое поле — случайный мир
Terraria version latest — последняя версия сервера

Остальные поля можно оставить как есть.

5. Нажмите Create Server внизу страницы.

4. Дождитесь установки

Панель создаст сервер, а Wings начнёт установку: скачает образ Docker и файлы игры. Установка занимает меньше минуты: скачивается архив сервера с сайта terraria.org.

Выйдите из раздела администратора (значок выхода справа вверху) и щёлкните по серверу в списке — откроется его страница с консолью.

5. Запустите сервер

Когда установка закончится, сервер запустится сам: в форме создания была отмечена настройка «Start Server when Installed». Если вы её сняли, нажмите Start. При первом запуске сервер создаёт мир — в консоли бегут проценты. Маленький мир при проверке создавался около минуты. Сервер готов, когда в консоли появились строки «Listening on port 7777» и «Server started»:

Кнопки Restart и Stop перезапускают и останавливают сервер; при остановке панель посылает ему штатную команду завершения, и он успевает сохранить мир. Команды сервера вводят в строку под консолью.

6. Откройте порты в файрволе

Если на VDS включён файрвол ufw, разрешите порты сервера. Выполните на VDS:

sudo ufw allow 7777/tcp

Проверить, включён ли файрвол, можно командой sudo ufw status: ответ «Status: inactive» означает, что он выключен и порты открывать не нужно.

При проверке сервер, созданный в панели, ответил снаружи, с другого компьютера, на запрос входа по протоколу игры: вход разрешён, игроку выдано место.

7. Зайдите на сервер

В игре выберите «Сетевая игра» → «Присоединиться по IP», затем персонажа, введите IP-адрес VDS и порт 7777. Если на сервере задан пароль, игра спросит его следующим шагом. Версия игры у игрока должна совпадать с версией сервера.

Настройки после установки

Всё, что вы задали в блоке «Service Variables», можно изменить позже — на вкладке Startup страницы сервера. Изменения вступают в силу после перезапуска сервера кнопкой Restart.

Мир лежит в папке saves/Worlds — файл ИМЯ_МИРА.wld и его запасная копия .wld.bak. Чтобы поставить свой мир, остановите сервер, загрузите файл .wld в эту папку кнопкой Upload и впишите его имя без расширения в поле World Name на вкладке Startup.

Настройки сервер читает из файла serverconfig.txt, но менять их нужно на вкладке Startup: при каждом запуске панель записывает в этот файл имя мира, режим, размер, число игроков, пароль и приветствие из переменных шаблона. Правки, сделанные прямо в файле, после перезапуска пропадут.

Команды. В строке под консолью работают команды сервера: save — сохранить мир, playing — список игроков, kick НИК и ban НИК — выгнать и заблокировать игрока, say ТЕКСТ — сообщение в чат. Кнопка Stop посылает серверу команду exit — он сохраняет мир и выключается.

Обновление сервера

После обновления игры сервер прежней версии игроков не пускает. Чтобы обновить сервер, откройте на его странице вкладку Settings и нажмите Reinstall Server: панель остановит сервер и скачает свежую версию. Мир при этом сохраняется — при проверке так и было. После переустановки запустите сервер кнопкой Start.

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

Что видите Причина и решение
Игрок не может зайти своим персонажем, хотя адрес и версия верные Мир создан в режиме путешествия (поле «Difficulty» — 3), а персонаж обычный, или наоборот. Режим задаётся при создании мира: впишите в поле «World Name» новое имя, поставьте нужный режим в поле «Difficulty» и перезапустите сервер — он создаст новый мир.
Игра сообщает, что версия не совпадает Обновите сервер кнопкой Reinstall Server или игру у игрока — версии должны быть одинаковыми.
После перезапуска вернулись прежние имя мира, пароль или число игроков Эти настройки панель берёт из переменных шаблона. Меняйте их на вкладке Startup, а не в файле serverconfig.txt.
Сервер долго в состоянии «Starting» При первом запуске он создаёт мир; большой мир создаётся несколько минут. Следите за процентами в консоли.
При импорте шаблона панель сообщает об ошибке формата Скачан файл для другой панели или вместо файла сохранилась веб-страница. Нужен файл egg-pterodactyl-….json, сохранённый по ссылке из шага 1.
В форме создания сервера нет нужного порта Порт не выделен или уже занят другим сервером. Проверьте вкладку Allocation узла.
Установка не заканчивается: надпись об установке висит часами Wings ждёт загрузки образа Docker не дольше 15 минут; если канал медленный, загрузка обрывается, а сервер остаётся в состоянии установки. Скачайте образ на VDS вручную: sudo docker pull ghcr.io/parkervcp/yolks:debian, затем на странице сервера откройте Settings и нажмите Reinstall Server.
Сервер запущен, но зайти не удаётся Проверьте, что порты открыты в файрволе VDS и что в игре указан верный адрес и порт.

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