Управление серверами
Повседневная работа с игровыми серверами в Saba-chan — от добавления, запуска и мониторинга серверов до бэкапов, расписаний, приглашения друзей и интеграции с Discord.
Управление серверами
Этот документ объясняет, как пользоваться Saba-chan с точки зрения пользователя. Даже не трогая код модулей и не создавая собственных расширений, с одной этой страницей можно держать один-два игровых сервера для друзей.
Установка описана в разделе Начало работы, а сопряжение с ботом — в Discord-бот и облачный ретранслятор. Здесь мы считаем, что установка уже завершена, и сосредоточимся на том, что нажимать и на что смотреть при открытом GUI.
1. Общая картина: GUI — это пульт, серверы запускает демон
Сначала запомните: закрытие окна GUI не выключает ваши игровые серверы.
saba-chan-gui(окно): пульт, который отправляет команды демону и отрисовывает экран. CLI (saba-chan-cli) выполняет ту же роль.saba-core(демон): основной процесс, который работает в фоне, запускает игровые серверы и следит за ними. Работающие серверы, бэкапы, задачи по расписанию и подключение к Discord — всё это обрабатывает демон.- Процессы игровых серверов — сами серверы, запущенные демоном (
java,PalServer.exeи т. д.).
Поэтому повседневная работа выглядит так:
- Откройте GUI — вместе с ним запустится демон (если он уже работает, GUI подключится к нему).
- Когда друзья соберутся заходить, нажмите Запустить на экране сервера.
- Во время игры окно можно свернуть или закрыть. При закрытии вы выбираете между Закрыть интерфейс (демон продолжает работать) и Выход полностью (демон тоже останавливается). Чтобы серверы продолжали работать, выберите Закрыть интерфейс.
- Когда закончите, снова откройте GUI и нажмите Остановить.
Выключение ПК выключает и игровые серверы. Демон работает только на вашем собственном ПК. Если нужна работа 24/7, используйте выделенный хостинг.
2. Создание первого сервера (кратко)
Полный пошаговый процесс — в разделе Начало работы. Вкратце:
- На экране Серверы нажмите Добавить сервер.
- Выберите Добавить как новый сервер. Если у вас уже есть папка сервера, Миграция сервера подключит её (файлы останутся на месте).
- Выберите игру (Minecraft / Palworld / Project Zomboid / Terraria и т. д.), затем задайте имя сервера и рекомендуемый пресет.
- Если у игры есть условия, которые нужно принять, это делается здесь. Например, Minecraft требует принять EULA Minecraft, прежде чем сервер сможет запуститься (§3.7).
- Нажмите Добавить сервер. Файлы сервера загрузятся автоматически, а ход загрузки отобразится на экране сервера.
- Когда установка завершится, сервер появится в списке.
Сервер можно назвать как угодно: «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 Друзья извне: роутер поддерживает проброс портов
Проброс портов — это настройка роутера, которая передаёт внешние подключения на ПК с сервером.
- На странице администрирования роутера пробросьте игровой порт на частный IP-адрес ПК с сервером.
- Передайте друзьям адрес
<публичный IP>:<порт>. Узнать свой публичный IP можно на сайтах вроде whatismyip.com. - В брандмауэре 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\, а открыть эту папку можно кнопкой Открыть папку журналов в окне, которое появляется при нажатии на состояние демона вверху. Приложенные файлы журналов сильно ускоряют диагностику.