Установка агента

Требования

• VPS или выделенный сервер под вашим управлением.
• Windows: Windows Server 2019 или новее либо Windows 10/11, с правами администратора.
• Linux: Debian 11+, Ubuntu 20.04+ или RHEL/Fedora с apt или dnf, с правами root или sudo.
• Исходящий доступ в интернет: агент общается с Servitium по HTTPS. Открывать входящие порты для панели не нужно.
• Email и пароль вашего аккаунта Servitium.

Установка на Windows

1. Щёлкните правой кнопкой по меню «Пуск» и выберите Windows PowerShell (администратор) или Терминал (администратор).
2. Вставьте команду ниже. На странице установки в Center она показана уже с вашим email. Если копируете её отсюда, замените адрес из примера.
3. PowerShell запросит пароль от вашего аккаунта Servitium. Введите его и нажмите Enter.

iwr -useb https://api.servitium.org/downloads/client/v1/setup.ps1 -OutFile $env:TEMP\setup.ps1; & $env:TEMP\setup.ps1 -Email your-email@example.com

Установщик загружает агент (около 76 МБ), на чистой машине это занимает примерно 3-5 минут.

Установка на Linux

1. Подключитесь к машине по SSH и убедитесь, что можете использовать sudo (или войдите как root).
2. Выполните команду ниже.
3. Установщик интерактивно запросит ваши email и пароль Servitium. Это тот же аккаунт, что и в Center.

curl -fsSL https://api.servitium.org/downloads/client/v1/setup.sh | sudo -E bash

На чистой машине это занимает примерно 2-4 минуты.

Что делает установщик

На Windows установщик:

• Загружает агент в отдельную папку.
• Устанавливает среду выполнения Visual C++ и компоненты DirectX, нужные Conan Exiles, если их нет.
• Добавляет папку агента в исключения Защитника Windows.
• Регистрирует машину в вашем аккаунте.
• Устанавливает службу Windows Servitium Monitor. Она запускается вместе с Windows и сама перезапускается, если остановится.

На Linux установщик:

• Устанавливает системные пакеты, нужные агенту и SteamCMD (apt или dnf).
• Загружает агент и регистрирует машину в вашем аккаунте.
• Если установлен брандмауэр ufw, разрешает агенту автоматически открывать игровые порты.
• Создаёт службу systemd servitium-monitor с автозапуском при загрузке.

Установщик можно безопасно запускать повторно: он обновляет агент на месте и сохраняет идентификатор вашего хоста.

Проверьте, что хост появился

Откройте в Center раздел Админ, Хосты. Ваша машина должна появиться примерно через 30 секунд. На странице установки кнопка Найти мой хост ждёт его около двух минут и сообщает, когда он подключится.

Если хост не появился, проверьте службу на машине:

Get-Service ServitiumMonitor

Get-Content C:\Servitium\logs\service-*.log -Tail 50

sudo systemctl status servitium-monitor

sudo journalctl -u servitium-monitor -f

Когда хост будет в сети, нажмите Добавить игровой сервер на странице хостов, чтобы привязать сервер. Другие решения собраны в разделе FAQ и решение проблем.

Обновление агента

Чтобы обновить агент, снова выполните ту же команду установки. Она заменит программу, сохранит ваши настройки и идентификатор хоста и перезапустит службу. Ваши игровые серверы и их файлы не затрагиваются.

Удаление

На Windows запустите деинсталлятор из PowerShell от имени администратора. Он удаляет службу, останавливает запущенные им игровые серверы, удаляет папки агента и созданные им правила брандмауэра. Файлы игровых серверов сохраняются, если не добавить -WipeServers (и -WipeSteam, чтобы удалить также SteamCMD).

iwr -useb https://api.servitium.org/downloads/client/v1/uninstall.ps1 -OutFile $env:TEMP\uninstall.ps1; & $env:TEMP\uninstall.ps1

На Linux остановите и удалите службу и программу агента:

sudo systemctl disable --now servitium-monitor
sudo rm /etc/systemd/system/servitium-monitor.service /opt/servitium/servitium-monitor
sudo rm -f /etc/sudoers.d/servitium-monitor
sudo systemctl daemon-reload

Наконец, откройте хост в Center в разделе Админ, Хосты и нажмите Удалить этот хост. Назначенные ему серверы станут неназначенными, но не будут удалены. Если агент где-то ещё работает, он снова зарегистрируется при следующем подключении.