Начать

Подключение ноды

Нода — Linux-машина, на которой работают игровые серверы. Агент панели (game-agent) управляет на ней Docker-контейнерами, раздаёт вашим клиентам SFTP и передаёт панели нагрузку.

Подключение

В панели откройте Ноды → Подключить ноду. В окне будет одна команда — выполните её на ноде от root:

curl -fsSL https://panel.example.com/agent/install.sh | sudo bash -s -- \
  --master-url https://panel.example.com --join-token gjt_...

Команда скачивает сборку агента под архитектуру ноды, сверяет контрольную сумму, при необходимости ставит Docker и OpenSSH (Debian/Ubuntu), записывает настройки в /etc/game-agent/agent.env и запускает сервис game-agent. При первом запуске нода регистрируется, получает свой TLS-сертификат и через несколько секунд появляется в списке.

Дополнительные параметры (в конец команды):

  • --node-id ID — имя ноды; по умолчанию имя хоста.
  • --sftp-host HOST — адрес SFTP, который увидят клиенты, если он отличается от адреса ноды.
  • --node-ip IP — публичный IP ноды, если он определяется неверно.

Токен подключения одноразовый. Для каждой ноды выпускайте новый.

Сеть

  • Нода подключается к панели: https://<домен панели> и порт 4222. Панель к ноде не подключается.
  • На ноде откройте 22/tcp для SFTP и порты ваших игр. Диапазон портов для игровых серверов задаётся в панели.

Лимиты

Лицензия ограничивает число нод. Нода считается, пока зарегистрирована, в том числе офлайн. Нода сверх лимита получает отказ при регистрации, а её токен не расходуется. Чтобы освободить место, удалите в панели ноду, которая больше не нужна (см. Управление нодами).

Сертификаты

Сертификат ноды действует год, агент сам продлевает его примерно за четыре месяца до конца — вручную ничего делать не нужно.

Удаление ноды в панели отзывает её сертификаты и сразу разрывает соединение. Чтобы вернуть машину, подключите её заново с новым токеном.

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

Выполните команду установки на ноде ещё раз, без токена. Настройки в /etc/game-agent/agent.env сохраняются, ставится версия агента, которая идёт вместе с панелью:

curl -fsSL https://panel.example.com/agent/install.sh | sudo bash

На странице нод отмечены ноды, у которых агент старее панели. См. Обновления.

Нода не появляется

Посмотрите лог агента на ноде:

journalctl -u game-agent -n 100

Частые причины: нода не открывает https://<домен> или порт 4222 панели, токен уже использован, исчерпан лимит нод по лицензии. Подробнее — Типовые проблемы.