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

Материал из ARK-HOSTER.RU | Документация хостинга
Версия от 22:02, 20 ноября 2026; Maintenance script (обсуждение | вклад) (Новая статья: установка сервера Terraria TShock в панели Pterodactyl, проверено на настоящей панели)
(разн.) ← Предыдущая версия | Текущая версия (разн.) | Следующая версия → (разн.)
Перейти к навигации Перейти к поиску

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

TShock — сервер Terraria с управлением: учётные записи и группы игроков, защита спавна и построек, блокировки, плагины. Игрокам при этом нужна обычная Terraria — ставить им ничего не надо. Шаблон «tshock» скачивает последний выпуск TShock со страницы разработчиков на GitHub; учётная запись Steam не нужна. Обычный сервер без TShock описан в статье Установка сервера Terraria в панели Pterodactyl, сервер с модами — в статье Установка сервера Terraria с модами (tModLoader) в панели Pterodactyl.

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

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

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

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

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

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

Порт Протокол Зачем
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 и шаблон tshock. Образ Docker и команда запуска подставятся сами, менять их не нужно:

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

Поле Что вписать
World Name Имя мира — так будет называться файл мира. Если мира с таким именем ещё нет, сервер создаст новый
World Size Размер нового мира: 1 — маленький, 2 — средний, 3 — большой
Max Players Число мест на сервере. По умолчанию 8
Tshock Version Оставьте latest — последний выпуск TShock

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

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

Перед нажатием кнопки проверьте образ Docker. В блоке «Docker Configuration» в списке Docker Image должен быть выбран образ Dotnet 9 — ghcr.io/parkervcp/yolks:dotnet_9, как на снимке выше. Изначально в списке стоит Dotnet 6, а нынешнему TShock нужен .NET 9: с прежним образом сервер при проверке не запустился и написал в консоль «You must install or update .NET to run this application». Если сервер уже создан, образ меняют на вкладке Startup его страницы — в списке «Docker Image».

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

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

Выйдите из раздела администратора (значок выхода справа вверху) и щёлкните по серверу в списке — откроется его страница с консолью. Пока идёт установка, вверху страницы стоит надпись «This server is currently running its installation process and most actions are unavailable».

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

Когда установка закончится, сервер запустится сам: в форме создания была отмечена настройка «Start Server when Installed». Если вы её сняли, нажмите Start. При первом запуске сервер создаёт мир — в консоли бегут строки с этапами и процентами; при проверке маленький мир создавался две минуты. Следующие запуски занимают полминуты. Сервер готов, когда в консоли появились строки «Listening on port 7777» и «Server started». Рядом с ними TShock печатает код первой настройки — «To setup the server, join the game and type /setup …»; код на снимке — пример, у каждого сервера он свой:

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

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

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

sudo ufw allow 7777/tcp

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

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

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

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

Учётная запись владельца. Создайте её командой в строке под консолью панели — вместо ВАШ_ПАРОЛЬ подставьте свой пароль:

/user add admin ВАШ_ПАРОЛЬ owner

Сервер ответит «Account admin has been added to group owner». В игре откройте чат клавишей Enter и введите /login admin ВАШ_ПАРОЛЬ — после этого вам доступны все команды TShock. Код первой настройки из консоли в таком случае не нужен: отключите его командой /setup в чате, уже войдя владельцем.

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

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

Настройки TShock лежат в папке tshock; она появляется после первого запуска:

  • config.json — настройки сервера;
  • motd.txt и rules.txt — приветствие и правила, которые игрок видит при входе и по команде /rules;
  • whitelist.txt — белый список адресов;
  • tshock.sqlite — база учётных записей, групп, блокировок и защищённых областей;
  • logs — журналы.

Что стоит менять в config.json — при остановленном сервере:

Настройка Изначально Что задаёт
"ServerPassword" "" Пароль для входа на сервер. Пусто — без пароля
"MaxSlots" 8 Число мест. Панель передаёт своё значение в команде запуска — меняйте его на вкладке Startup
"ServerName", "UseServerName" "", false Своё название сервера вместо имени мира. Чтобы оно действовало, поставьте второе в true
"SpawnProtection", "SpawnProtectionRadius" false, 10 Защита места появления от построек и разрушения и её радиус в блоках
"EnableWhitelist" false Пускать только адреса из whitelist.txt
"AutoSave" true Сохранять мир автоматически
"DisableUUIDLogin" false true — не входить в учётную запись автоматически по номеру клиента. Для открытого сервера TShock советует включить

Команды вводят в строку под консолью панели или в чат игры — с косой чертой:

Команда Что делает
/help Список команд, по страницам: /help 2
/who Игроки на сервере
/user add имя пароль группа Создать учётную запись. Группы из поставки: owner, admin, trustedadmin, vip, default
/user group имя группа Перевести учётную запись в другую группу
/kick имя, /ban add имя Выгнать, заблокировать игрока
/region Защищённые области: создать, выдать права на постройку
/save Сохранить мир
/off Сохранить мир и выключить сервер

При проверке сервер выполнил из консоли панели /version, /who, /help и /user add.

Плагины — файлы .dll в папке ServerPlugins. Загрузите плагин кнопкой Upload и перезапустите сервер. Плагин должен быть собран под вашу версию TShock.

Мир — файл ИМЯ_МИРА.wld в корне вкладки Files. Чтобы поставить свой мир, остановите сервер, загрузите файл .wld и впишите его имя без расширения в поле World Name на вкладке Startup. Кнопка Stop выключает сервер с сохранением: при проверке он написал «Saving before exit...» и обновил файл мира.

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

После обновления игры нужен выпуск TShock под новую версию Terraria — он выходит не сразу. Когда он вышел, откройте вкладку Settings и нажмите Reinstall Server: шаблон скачает последний выпуск поверх прежнего. Перед этим сделайте копию папки tshock и файла мира — на вкладке Backups.

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

Что видите Причина и решение
Сервер не запускается, в консоли «You must install or update .NET to run this application» Выбран образ Dotnet 6. На вкладке Startup выберите в списке «Docker Image» образ Dotnet 9 и запустите сервер.
Игрока не пускает из-за версии TShock выпущен под другую версию Terraria. Проверьте версию командой /version и обновите сервер или игру.
Игра просит пароль учётной записи вместо пароля сервера Так работает вход TShock: игрок с учётной записью вводит её пароль. Новый игрок регистрируется в чате командой /register пароль.
Команды владельца не действуют Вы не вошли в учётную запись. Введите в чате /login имя пароль.
Игроки не могут подключиться Закрыт порт 7777/TCP. Именно TCP: правило для UDP не поможет.
При импорте шаблона панель сообщает об ошибке формата Скачан файл для другой панели или вместо файла сохранилась веб-страница. Нужен файл egg-pterodactyl-….json, сохранённый по ссылке из шага 1.
В форме создания сервера нет нужного порта Порт не выделен или уже занят другим сервером. Проверьте вкладку Allocation узла.
Установка не заканчивается: надпись об установке висит часами Wings ждёт загрузки образа Docker не дольше 15 минут; если канал медленный, загрузка обрывается, а сервер остаётся в состоянии установки. Скачайте образ на VDS вручную: sudo docker pull ghcr.io/parkervcp/yolks:dotnet_9, затем на странице сервера откройте Settings и нажмите Reinstall Server.
Сервер запущен, но зайти не удаётся Проверьте, что порты открыты в файрволе VDS и что в игре указан верный адрес и порт.

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