Установка сервера 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:
- VPS/VDS серверы — для небольших и средних серверов
- Выделенные серверы — для высоконагруженных игровых серверов