Управление серверами

Повседневная работа с игровыми серверами в Saba-chan — от добавления, запуска и мониторинга серверов до бэкапов, расписаний, приглашения друзей и интеграции с Discord.

Управление серверами

Этот документ объясняет, как пользоваться Saba-chan с точки зрения пользователя. Даже не трогая код модулей и не создавая собственных расширений, с одной этой страницей можно держать один-два игровых сервера для друзей.

Установка описана в разделе Начало работы, а сопряжение с ботом — в Discord-бот и облачный ретранслятор. Здесь мы считаем, что установка уже завершена, и сосредоточимся на том, что нажимать и на что смотреть при открытом GUI.


1. Общая картина: GUI — это пульт, серверы запускает демон

Сначала запомните: закрытие окна GUI не выключает ваши игровые серверы.

  • saba-chan-gui (окно): пульт, который отправляет команды демону и отрисовывает экран. CLI (saba-chan-cli) выполняет ту же роль.
  • saba-core (демон): основной процесс, который работает в фоне, запускает игровые серверы и следит за ними. Работающие серверы, бэкапы, задачи по расписанию и подключение к Discord — всё это обрабатывает демон.
  • Процессы игровых серверов — сами серверы, запущенные демоном (java, PalServer.exe и т. д.).

Поэтому повседневная работа выглядит так:

  1. Откройте GUI — вместе с ним запустится демон (если он уже работает, GUI подключится к нему).
  2. Когда друзья соберутся заходить, нажмите Запустить на экране сервера.
  3. Во время игры окно можно свернуть или закрыть. При закрытии вы выбираете между Закрыть интерфейс (демон продолжает работать) и Выход полностью (демон тоже останавливается). Чтобы серверы продолжали работать, выберите Закрыть интерфейс.
  4. Когда закончите, снова откройте GUI и нажмите Остановить.

Выключение ПК выключает и игровые серверы. Демон работает только на вашем собственном ПК. Если нужна работа 24/7, используйте выделенный хостинг.


2. Создание первого сервера (кратко)

Полный пошаговый процесс — в разделе Начало работы. Вкратце:

  1. На экране Серверы нажмите Добавить сервер.
  2. Выберите Добавить как новый сервер. Если у вас уже есть папка сервера, Миграция сервера подключит её (файлы останутся на месте).
  3. Выберите игру (Minecraft / Palworld / Project Zomboid / Terraria и т. д.), затем задайте имя сервера и рекомендуемый пресет.
  4. Если у игры есть условия, которые нужно принять, это делается здесь. Например, Minecraft требует принять EULA Minecraft, прежде чем сервер сможет запуститься (§3.7).
  5. Нажмите Добавить сервер. Файлы сервера загрузятся автоматически, а ход загрузки отобразится на экране сервера.
  6. Когда установка завершится, сервер появится в списке.

Сервер можно назвать как угодно: «Minecraft с друзьями», «Zomboid по выходным» и так далее. В командах Discord на сервер можно ссылаться по его имени или по названию игры (псевдониму). Остановленный сервер можно переименовать кнопкой с карандашом рядом с именем.


3. Повседневная работа

При выборе сервера справа открывается его экран. Наверху — кнопка Запустить/Остановить и состояние, ниже — вкладки. Набор вкладок зависит от игры.

ВкладкаСодержимое
КонсольВывод сервера и ввод команд (только для игр с консолью)
КомандыКоманды, определённые игрой (например, объявления и список игроков в Palworld)
НастройкиНастройки игры (порт, максимум игроков, пароль и т. д.)
Saba-chanНастройки того, как Saba-chan управляет сервером: автоперезапуск, лимит памяти, время ожидания остановки, предпросмотр аргументов запуска, пересылка игрового чата
БэкапыСоздание и восстановление бэкапов, задачи по расписанию
DiscordСлова, которыми в Discord называют этот сервер и его команды
ЖурналКто и когда запускал, останавливал сервер или отправлял команды
СведенияПорт, версия, время работы, последние завершения, проверка сервера, открытие папки сервера, удаление сервера

3.1 Запуск / остановка / перезапуск

  • Запустить: демон сначала проверяет принятие условий и выполняет проверки модуля, а затем запускает сервер. Если проверка находит критическую проблему, сервер не запускается и показывается причина.
  • Остановить: отправляет игре команду корректной остановки (например, stop в Minecraft, quit в Zomboid) и ждёт. Если сервер не завершился за время ожидания остановки (по умолчанию 30 секунд; для разных игр отличается и меняется на вкладке Saba-chan), он завершается принудительно.
  • Перезапустить: выполняет остановку → запуск за один шаг. Подключённые игроки ненадолго отключаются.

3.2 Просмотр консоли / отправка команд

  • Вкладка Консоль показывает вывод игрового сервера в реальном времени.
  • Введите команду и нажмите Enter, чтобы отправить её в консоль сервера (stdin). Примеры для Minecraft: say hi!, op FriendNick. Клавишей ↑ можно вызвать предыдущие команды.
  • Команды идут в порядке stdin → REST → RCON. Игры без консоли (например, Palworld, которым управляют только через REST API) управляются предопределёнными командами на вкладке Команды. RCON используется только для игры без другого пути — только через loopback (127.0.0.1), с портом и случайным паролем для каждого экземпляра, которые назначает демон.
  • Консоль можно вынести в отдельное окно, а в Windows кнопка Открыть в терминале открывает консоль CLI.
  • Для каждого сервера демон хранит в памяти последние строки консоли (до 10 000) и также записывает их в файлы в папке logs/ внутри папки сервера.

3.3 Несколько серверов одновременно

  • Можно создать несколько серверов одной игры (например, «Ванильный MC» и «MC с модпаком») или запускать разные игры рядом.
  • Порты серверов (номера, по которым игра принимает игроков) не должны пересекаться. При создании нового сервера Saba-chan сдвигает порт по умолчанию, чтобы он не конфликтовал с другими вашими серверами, а если порты всё же пересекаются, на экране сервера появляется предупреждение. Порт можно изменить на вкладке Настройки.
  • Каждый дополнительный сервер использует больше памяти и CPU ПК. Перед добавлением проверьте характеристики своего ПК.

3.4 Обнаружение сбоев и автоперезапуск

  • Когда сервер завершается, демон определяет причину: Остановлен вами, Остановлен из игры, Сбой или Неизвестно. Вердикт записывается в Последние завершения на вкладке Сведения.
  • Если это признано сбоем, по умолчанию сервер автоматически перезапускается. Первый перезапуск происходит через 5 секунд, и с каждым перезапуском ожидание удваивается. После более чем 3 перезапусков за 10 минут демон прекращает перезапуски, и вам нужно запустить сервер самостоятельно.
  • Это можно изменить в разделе Автоперезапуск на вкладке Saba-chan.
    • Перезапускать после сбоя: когда сервер явно завершился из-за ошибки (по умолчанию включено).
    • Перезапускать и при неизвестной причине: охватывает и случаи, которые невозможно оценить, например завершение через Диспетчер задач (по умолчанию выключено).
  • Серверы, которые вы остановили сами — из Saba-chan или в игре, — не перезапускаются.

3.5 Лимит памяти (Windows)

  • В разделе Лимит памяти на вкладке Saba-chan можно ограничить память (МБ), которую сервер и его дочерние процессы могут использовать вместе. При превышении лимита сервер останавливается.
  • Оставьте поле пустым, чтобы не ограничивать. Для серверов на Java задайте значение на 1–2 ГБ больше -Xmx.
  • Только для Windows; вступает в силу после перезапуска сервера.

3.6 Предпросмотр аргументов запуска

  • Для игр, использующих аргументы запуска, Предпросмотр аргументов запуска на вкладке Saba-chan показывает командную строку, с которой сервер запустился бы при текущих настройках, не запуская его.
  • Аргументы, которые вы указали в Дополнительные аргументы и которых нет на экране настроек (например, -players=16 -useperfthreads), передаются при запуске как есть. Неправильные значения отмечаются прямо в предпросмотре.
  • Такие значения, как пароли, маскируются как ***.

3.7 Принятие условий (EULA Minecraft и т. п.)

  • Если у игрового сервера есть условия, требующие согласия, при создании сервера или его первом запуске появляется окно Требуется согласие. Прочитайте исходный текст, отметьте флажок и нажмите Принять и запустить.
  • Дать согласие можно только из GUI или CLI на этом ПК. Если кто-то попытается запустить сервер из Discord до принятия условий, сначала примите их на ПК.

4. Бэкапы и задачи по расписанию

Они находятся на вкладке Бэкапы. Задачи по расписанию доступны для любого сервера, а список бэкапов и задачи бэкапа появляются только для игр с поддержкой бэкапов.

4.1 Бэкапы

  • Создать бэкап сжимает мир и файлы сохранений. Что именно сохраняется, решает игровой модуль (для Minecraft — папки мира). Если сервер работает, игре сначала отправляется команда сохранения (save-all в Minecraft и т. п.).
  • В списке бэкапов указан тип каждого бэкапа: Вручную, По расписанию, Перед обновлением, Перед восстановлением.
  • Восстановить можно только при остановленном сервере. Перед восстановлением текущее состояние ещё раз сохраняется в бэкап, так что даже восстановление не того бэкапа можно откатить.
  • Ручные бэкапы не участвуют в автоматической очистке. Остальные (по расписанию, перед обновлением, перед восстановлением) хранятся в количестве Хранить бэкапов по расписанию (по умолчанию 10), начиная удаление с самых старых.
  • Файлы бэкапов хранятся внутри папки сервера (экземпляра). Удаление сервера удаляет и его бэкапы, поэтому важные бэкапы скопируйте в другое место.

4.2 Задачи по расписанию

Через Добавить задачу можно автоматически выполнять следующее с фиксированным интервалом (каждые N минут) или в заданное время каждый день (ЧЧ:ММ, в часовом поясе ПК).

ЗадачаЧто делает
БэкапДелает бэкап, пока сервер работает
ПерезапускПерезапускает сервер, если он работает
ОбъявлениеОтправляет сообщение в игру, если сервер работает
ОбновлениеПроверяет наличие обновления игрового сервера и применяет его, если оно есть (перезапускает сервер, если он работал)
  • Задачи перезапуска и обновления могут заранее предупреждать игроков в игре (например, за 10, 5, 1 минут). Объявления и предупреждения доступны, только если игра поддерживает команду объявления.
  • После перезапуска демона интервальные задачи начинают отсчёт заново с этого момента. Задачи, время которых прошло, пока демон был выключен, потом пакетом не выполняются.

5. Как друзьям подключиться

Если вы настроили игровой сервер, а друзья не могут зайти, почти всегда дело в одном из трёх случаев.

5.1 Друзья в той же сети Wi-Fi (LAN)

Дополнительная настройка не нужна. Достаточно подключиться по частному IP-адресу ПК с сервером (например, 192.168.0.10) и порту.

5.2 Друзья извне: роутер поддерживает проброс портов

Проброс портов — это настройка роутера, которая передаёт внешние подключения на ПК с сервером.

  1. На странице администрирования роутера пробросьте игровой порт на частный IP-адрес ПК с сервером.
  2. Передайте друзьям адрес <публичный IP>:<порт>. Узнать свой публичный IP можно на сайтах вроде whatismyip.com.
  3. В брандмауэре Windows разрешите входящий трафик (подключения извне) на этот порт.

5.3 Друзья извне: проброс портов невозможен

Проброс портов часто заблокирован в школьных и корпоративных сетях, за CGNAT провайдера и в гостевом Wi-Fi. Даже там запускать и останавливать серверы из Discord всё равно можно через облачный ретранслятор.

  • На экране Discord в GUI нажмите Подключить сервер Discord, получите код и введите его в слэш-команде /saba connect на своём сервере Discord.
  • После этого друзья смогут запускать и останавливать серверы или проверять их состояние из Discord.
  • Подробный порядок действий — в Discord-бот и облачный ретранслятор.

Облачный ретранслятор передаёт только команды управления (запуск/остановка/состояние и т. п.), а не игровой трафик. Если друзья не могут напрямую подключиться к игровому серверу, может понадобиться дополнительное решение (например, ZeroTier, Tailscale).


6. Discord-бот: сводка на одной странице

Когда бот сопряжён, значительную часть повседневной работы можно делать из Discord, не открывая GUI. Текстовые команды имеют вид <префикс> <сервер> <команда>, префикс по умолчанию — Saba-chan (его можно изменить в настройках бота). В качестве <сервер> используйте имя сервера или название игры (псевдоним).

СитуацияЧто ввести в Discord (префикс по умолчанию)
«Давайте сегодня запустим MC»Saba-chan minecraft start
«Сервер сейчас работает?»Saba-chan minecraft status
«Выключаем»Saba-chan minecraft stop
«Какие есть серверы?»Saba-chan list
«Что можно вводить?»Saba-chan help

Для каждого сервера также создаётся собственная слэш-команда /<имя сервера>. Полный список команд и регистрация псевдонимов описаны в документе Команды.

О настройке, сопряжении и работе ретранслятора для самого бота читайте в Discord-бот и облачный ретранслятор.


7. Обновления и очистка

7.1 Обновление Saba-chan

  • Saba-chan периодически проверяет подписанный список релизов и, когда выходит новая версия, показывает в GUI уведомление Доступны обновления.
  • В Настройки → Saba Хранилище вкладка Компоненты позволяет загружать и применять обновления по компонентам (ядро, модули, расширения и т. д.). Для компонентов, чьи работающие файлы нужно заменить, например ядра, установщик (saba-chan-installer) ненадолго останавливает демон, заменяет файлы и снова запускает только то, что изменилось. Если изменился только демон, окно приложения остаётся открытым, а перезапускается лишь демон.
  • Поскольку демон перезапускается, применяйте обновления, когда никто не играет.

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

  • Когда выходит новая версия игрового сервера, на экране сервера появляется кнопка Обновить. Применить обновление можно при остановленном сервере.
  • Перед этим автоматически создаётся бэкап Перед обновлением (для игр с поддержкой бэкапов).
  • Обновления можно также применять автоматически в заданное время с помощью задачи по расписанию Обновление (§4.2).

7.3 Удаление сервера

  • Удалите его кнопкой Удалить сервер на вкладке Сведения. Удалить сервер можно только после его остановки.
  • Для серверов, которые Saba-chan загрузил и создал сам, папка сервера (включая файлы игрового сервера и бэкапы) удаляется целиком. Заранее скопируйте нужные миры или бэкапы.
  • Для серверов, подключённых через Миграция сервера, файлы игры в исходной папке остаются на месте.

7.4 Удаление Saba-chan

  • Удалите Saba-chan в Windows через Параметры → Приложения → Установленные приложения.
  • Программа удаления сначала корректно останавливает запущенные серверы, затем удаляет папку установки, папку данных (%APPDATA%\saba-chan\) и ярлыки. Файлы и бэкапы серверов, созданных Saba-chan, по умолчанию тоже лежат в этой папке данных, поэтому перед удалением скопируйте миры, которые хотите сохранить. Если отметить Keep game servers, сохранятся файлы серверов, миры, бэкапы и настройки отдельных серверов, а если отметить Keep settings — настройки приложения и подключение к Discord; после переустановки всё продолжит работать. Если папку данных ещё использует другая установка Saba-chan, она не удаляется.

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

  • Если в консоли появились красные строки, начните с поиска этого сообщения дословно. Saba-chan показывает вывод самого игрового сервера без изменений.
  • Проверить сервер и Разобрать журнал на вкладке Сведения ищут проблемы конфигурации и известные ошибки в последних журналах.
  • Если это не помогает, на странице Устранение неполадок собраны типичные сценарии и способы их решения.
  • Если вы столкнулись с новой проблемой, сообщите о ней в GitHub Issues, приложив вывод консоли. Журналы GUI хранятся в %APPDATA%\saba-chan\logs\, а открыть эту папку можно кнопкой Открыть папку журналов в окне, которое появляется при нажатии на состояние демона вверху. Приложенные файлы журналов сильно ускоряют диагностику.