Установка игрового сервера Soulmask на Linux

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

Инструкция по установке выделенного сервера Soulmask на VDS с Ubuntu 24.04. Все команды и снимки экрана сняты с настоящего сервера: инструкция проверена 17 ноября 2026 года на Ubuntu 24.04.4.

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

  • VDS с Ubuntu 24.04 LTS и доступом root по SSH.
  • Память: пустой сервер после загрузки мира занимает около 9 ГБ. Берите VDS от 16 ГБ; на 8 ГБ сервер не запустится.
  • Диск: файлы сервера занимают 2,1 ГБ; с запасом на обновления и сохранения мира нужно от 10 ГБ свободного места.
  • Процессор: от 4 ядер.

Подобрать сервер можно на странице тарифов VDS. Учётная запись Steam и купленная игра для установки сервера не нужны.

1. Обновите систему

sudo apt update && sudo apt upgrade -y

На свежей системе обновление идёт от 5 минут до получаса. По ходу могут появиться два места, где нужно ваше участие.

Окно выбора раскладки клавиатуры. Обновление остановится и покажет окно «Configuring keyboard-configuration». Ничего менять не нужно: нажмите Enter, в следующем окне снова Enter.

Сообщение о новом ядре. Если в конце вы видите «Pending kernel upgrade», система обновила ядро и ждёт перезагрузки.

Перезагрузите сервер и подключитесь снова через минуту:

sudo reboot

2. Установите нужные пакеты

sudo apt install -y wget lib32gcc-s1 lib32stdc++6
  • lib32gcc-s1 и lib32stdc++6 нужны программе SteamCMD, через которую скачивается сервер.

3. Создайте пользователя для сервера

Игровой сервер не должен работать от root. Создайте для него отдельного пользователя:

sudo useradd -m -s /bin/bash soulmask

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

4. Скачайте SteamCMD

sudo mkdir -p /opt/steamcmd
cd /opt/steamcmd
sudo wget https://steamcdn-a.akamaihd.net/client/installer/steamcmd_linux.tar.gz
sudo tar -xzf steamcmd_linux.tar.gz
sudo chown -R soulmask:soulmask /opt/steamcmd

Архив маленький (2,3 МБ), но с серверов Steam он может качаться около минуты — это нормально.

5. Установите сервер Soulmask

Переключитесь на пользователя soulmask и запустите SteamCMD:

sudo su - soulmask
cd /opt/steamcmd
./steamcmd.sh

При первом запуске SteamCMD скачивает собственное обновление (около 40 МБ). С серверов Steam оно может идти несколько минут — дождитесь приглашения Steam> и ничего не вводите раньше.

Затем введите по очереди три команды. Порядок важен: каталог установки задаётся до входа.

force_install_dir /home/soulmask/soulmask-server
login anonymous
app_update 3017300 validate

Если вместо загрузки появилась строка «ERROR! Failed to install app … (Missing configuration)», просто введите команду app_update ещё раз: при первом запуске SteamCMD такое случается, со второго раза загрузка начинается.

Загрузка небольшая — около 2,1 ГБ; при проверке она заняла 3–4 минуты. Дождитесь строки «Success! App '3017300' fully installed.»:

Выйдите из SteamCMD:

quit

Проверьте, что файлы на месте:

ls /home/soulmask/soulmask-server

Сервер запускается скриптом StartServer.sh, который лежит в корне каталога: он сам подставляет карту и служебные параметры.

6. Создайте скрипт запуска

Название сервера, число мест и пароли задаются строкой запуска. Создайте скрипт:

nano ~/soulmask-server/start-server.sh
#!/bin/bash
cd /home/soulmask/soulmask-server
exec ./StartServer.sh -SteamServerName="My Soulmask Server" -MaxPlayers=20 -adminpsw="ВАШ_ПАРОЛЬ" -pve -Port=8777 -QueryPort=27015

Строка, начинающаяся с exec, должна быть одной строкой.

Параметр Что задаёт
-SteamServerName="My Soulmask Server" Название сервера в списке
-MaxPlayers=20 Число мест
-adminpsw="ВАШ_ПАРОЛЬ" Пароль администратора. Только латинские буквы и цифры
-PSW="пароль" Пароль на вход. Добавьте параметр, если сервер только для своих; без него сервер открыт всем
-pve Режим PvE: игроки не могут нападать друг на друга. Для PvP замените на -pvp
-Port=8777 Игровой порт (UDP)
-QueryPort=27015 Порт запросов списка серверов (UDP)

Сохраните файл (в nano: Ctrl+O, Enter, Ctrl+X) и сделайте его исполняемым:

chmod +x ~/soulmask-server/start-server.sh
cat ~/soulmask-server/StartServer.sh
cat ~/soulmask-server/start-server.sh

На снимке сверху — скрипт из поставки сервера: видно, что карту Level01_Main и служебный порт -EchoPort=18888 он подставляет сам. Ниже — ваш скрипт.

Вернитесь к root:

exit

7. Настройте автозапуск

Чтобы сервер запускался вместе с системой и поднимался после сбоя, создайте для него службу:

sudo nano /etc/systemd/system/soulmask-server.service

Вставьте:

[Unit]
Description=Soulmask Dedicated Server
After=network.target

[Service]
Type=simple
User=soulmask
WorkingDirectory=/home/soulmask/soulmask-server
ExecStart=/home/soulmask/soulmask-server/start-server.sh
Restart=always
RestartSec=5
KillSignal=SIGINT
TimeoutStopSec=120

[Install]
WantedBy=multi-user.target

8. Запустите сервер и проверьте его

sudo systemctl daemon-reload
sudo systemctl enable soulmask-server
sudo systemctl start soulmask-server

Сервер запускается долго: мир загружается от 3 до 7 минут, и всё это время в списке серверов его нет. Проверьте состояние службы — должно быть active (running):

sudo systemctl status soulmask-server --no-pager -n 0

Сервер готов, когда он занял порты 8777 и 27015, а в журнале появились строки «IpNetDriver listening on port 8777» и «registe server soulmask session succeed» — сервер зарегистрировался в списке. Последняя команда показывает память: после загрузки мира сервер занимает около 9 ГБ.

sudo ss -lntup | grep WSServer | awk '{print $1, $5}'
sudo journalctl -u soulmask-server -o cat | grep -E "listening on port|session succeed" | tail -n 2 | cut -c31-130
free -h | head -n 2

Управление службой:

sudo systemctl stop soulmask-server      # остановить
sudo systemctl restart soulmask-server   # перезапустить
sudo journalctl -u soulmask-server -f    # смотреть журнал, выход — Ctrl+C

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

Внимание: сначала разрешите SSH и только потом включайте файрвол. Иначе связь с сервером оборвётся. Если SSH у вас на нестандартном порту, вместо первой команды выполните sudo ufw allow НОМЕР_ПОРТА/tcp.

sudo ufw allow OpenSSH
sudo ufw allow 8777/udp
sudo ufw allow 27015/udp
sudo ufw enable

Если появится вопрос «Command may disrupt existing ssh connections. Proceed with operation (y|n)?», ответьте y. Проверьте результат:

sudo ufw status

Порт Зачем
8777/UDP Игра
27015/UDP Запросы списка серверов

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

В игре выберите «Сетевая игра» и найдите сервер по названию в списке — поиск по части названия работает. Если задан пароль -PSW, игра спросит его при входе.

Права администратора: в игре откройте консоль клавишей ~ и введите gm key ВАШ_ПАРОЛЬ — пароль из параметра -adminpsw. Откроется панель администратора.

Служебные порты

Кроме игровых, сервер открывает два порта, которые видны в списке шага 8:

  • 127.0.0.1:18888 — служебный порт управления (-EchoPort). Он доступен только с самого VDS, и открывать его в файрволе нельзя. Без нужды к нему не подключайтесь: при проверке посторонняя команда, отправленная в этот порт, завершила работу сервера;
  • 19000/tcp — открывается сервером на всех адресах. Для входа игроков он не нужен, в файрволе его не открывайте.

Множители и правила мира

После первого запуска сервер создаёт файл с настройками мира:

sudo -u soulmask nano /home/soulmask/soulmask-server/WS/Saved/GameplaySettings/GameXishu.json

Названия настроек в нём записаны латиницей по-китайски. Самые нужные:

Настройка Что меняет
ExpRatio Множитель опыта
CaiJiDiaoLuoRatio Добыча при сборе
FaMuDiaoLuoRatio Добыча при рубке деревьев
CaiKuangDiaoLuoRatio Добыча руды
ZuoWuShengZhangRatio Скорость роста посевов
ZhiZuoTimeRatio Время изготовления предметов

Значение 1 — как задумано разработчиками, 2 — вдвое больше. Правьте файл при остановленном сервере: sudo systemctl stop soulmask-server, после правки — start.

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

После выхода обновления игры остановите сервер, обновите файлы и запустите снова:

sudo systemctl stop soulmask-server
sudo -u soulmask /opt/steamcmd/steamcmd.sh +force_install_dir /home/soulmask/soulmask-server +login anonymous +app_update 3017300 validate +quit
sudo systemctl start soulmask-server

Файлы настроек, сохранения и скрипт запуска при обновлении не затрагиваются.

Где лежат сохранения и настройки

  • /home/soulmask/soulmask-server/WS/Saved/Worlds/Dedicated/Level01_Main/world.db — мир: постройки, персонажи, племена. Этот файл и нужно сохранять в резервную копию;
  • /home/soulmask/soulmask-server/WS/Saved/GameplaySettings/GameXishu.json — множители и правила мира;
  • /home/soulmask/soulmask-server/start-server.sh — строка запуска: название, пароли, порты;
  • /home/soulmask/soulmask-server/WS/Saved/Logs/ — журналы.

Останавливайте сервер только через службу (sudo systemctl stop soulmask-server): она посылает серверу сигнал, по которому он сохраняет мир и завершается — при проверке на это ушло 30 секунд. Копировать world.db надёжнее при остановленном сервере.

Что не проверено

Проверены: установка, запуск, порты, регистрация в списке серверов (сервер отвечает на запрос снаружи), память, сохранение мира при остановке, появление файла с настройками мира. Не проверены: вход игрока, команда gm key и действие множителей — для этого нужна сама игра.

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

Что видите Причина и решение
Сервера нет в списке сразу после запуска Мир загружается от 3 до 7 минут. Дождитесь строки «session succeed» в журнале — шаг 8.
Служба перезапускается по кругу, в журнале «Killed» Не хватает памяти: серверу нужно около 9 ГБ уже без игроков. Нужен VDS от 16 ГБ.
После перезапуска пропали последние постройки Сервер был остановлен принудительно и не успел сохранить мир. Останавливайте его через systemctl stop и не уменьшайте TimeoutStopSec в файле службы.
SteamCMD отвечает «ERROR! Failed to install app '3017300' (Missing configuration)» Так иногда бывает при первом запуске SteamCMD. Введите команду app_update ещё раз — со второго раза загрузка начинается.
После установки нет каталога /home/soulmask/soulmask-server Команда force_install_dir была введена с ошибкой или после login, и сервер установился в /home/soulmask/Steam/steamapps/common/. Запустите SteamCMD заново и повторите три команды из шага 5 по порядку.
Служба в состоянии «failed» Посмотрите причину: sudo journalctl -u soulmask-server -n 50 --no-pager. Чаще всего это опечатка в пути или скрипт запуска не сделан исполняемым.
Сервер запущен, но зайти не удаётся Проверьте, что порты открыты (sudo ufw status) и что в игре указан верный адрес и порт.
Сервер «вылетает» под нагрузкой, в журнале «Killed» или «Out of memory» Не хватает оперативной памяти: посмотрите free -h. Нужен тариф VDS с большим объёмом памяти.

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