Palworld: REST API и RCON — как включить и зачем они нужны

Обычный игрок заходит на сервер Palworld по адресу и паролю, а администратор и бот управляют им иначе. Есть два способа. RCON — протокол удалённой консоли, знакомый по другим играм. REST API — HTTP-интерфейс, который встроен в сам сервер. Оба дают команды вроде «показать игроков», «сохранить мир» или «кикнуть». Разберём, как их включить и не открыть лишнего.

Коротко

REST API включается ключом RESTAPIEnabled=True и работает на порту RESTAPIPort, по умолчанию 8212 по TCP. RCON включается ключом RCONEnabled=True, порт RCONPort, по умолчанию 25575 по TCP. Оба интерфейса защищены паролем AdminPassword из PalWorldSettings.ini. Наружу открывайте порт только тем адресам, которым доверяете.

Разница между RCON и REST API

RCON — текстовый протокол удалённой консоли. Вы подключаетесь по TCP, вводите пароль и отправляете команды вроде ShowPlayers или Save. Его используют боты и программы, которые умеют говорить на этом протоколе.

REST API — набор HTTP-запросов к серверу с ответами в формате JSON. По справочникам по Palworld в нём есть информация о сервере, список игроков, сохранение, объявления, кик, бан, выключение и метрики. Это удобнее для мониторинга и веб-панелей.

Что выбрать? Если нужны только «сохранить» и «список игроков», хватит RCON. Если строите панель мониторинга или интеграцию, берите REST API. Можно включить оба, но открывайте наружу только то, чем пользуетесь.

Шаги: включаем и проверяем

1. Остановите сервер и откройте файл настроек PalWorldSettings.ini (подробности — в статье настройка PalWorldSettings.ini).
2. Задайте админский пароль и включите нужные интерфейсы. Строка OptionSettings будет выглядеть так:

OptionSettings=(AdminPassword="длинный-уникальный-пароль",RCONEnabled=True,RCONPort=25575,RESTAPIEnabled=True,RESTAPIPort=8212)

3. Сохраните файл и запустите сервер. Дождитесь готовности: в журнале должна появиться строка о запуске.
4. Проверьте выдачу портов. В панели EGN откройте раздел «Сеть»: там видно адрес подключения и список портов тарифа. Порт RCON выдаётся отдельно. Если нужного порта в списке нет, его придётся выдать, иначе снаружи до сервера не достучаться.
5. Проверьте REST API с другой машины. Он использует базовую аутентификацию HTTP: логин admin, пароль — значение AdminPassword. Запрос без пароля должен получать отказ, это признак того, что защита работает.

# Проверка REST API с вашего компьютера (замените адрес и пароль)
curl -u admin:ВАШ_ADMIN_PASSWORD http://ВАШ_IP:8212/v1/api/info

Пути вида /v1/api/... соответствуют справочникам по REST API Palworld. Версии игры меняют набор запросов, поэтому перед использованием сверяйтесь с документацией вашей версии.

6. Для RCON используйте клиент с поддержкой Source RCON. Подключитесь к адрес:25575 с тем же AdminPassword, отправьте ShowPlayers и убедитесь, что пришёл ответ со списком.

Пример: бот, который сохраняет мир каждый час

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

export PAL_ADMIN_PASSWORD='ВАШ_ADMIN_PASSWORD'

Для сохранения мир через REST API используется запрос POST /v1/api/save. Перед написанием бота проверьте метод и путь в документации своей версии. Скрипт запускайте по расписанию на отдельной машине, например на VPS. Если бот работает на той же машине, что и сервер, обращайтесь к 127.0.0.1 и не открывайте порт наружу совсем.

Как сделать в панели EGN

Команды администратора удобно отправлять из раздела «Консоль» панели: там же видно, что сервер пишет при старте и при сохранении.

Порты для RCON и REST API проверяйте в разделе «Сеть»: там адрес подключения и список выданных портов. Если порт не выдан, сервер не откроет протокол на нужном адресе, даже с правильным файлом настроек.

Внешние интеграции, например бот или мониторинг, работают через RCON или REST API, а не через консоль панели. Поэтому порт должен быть выдан и открыт именно для того адреса, с которого идёт запрос.

Безопасность: что не делать

Не открывайте REST API в интернет без нужды

Тот, кто знает AdminPassword, управляет сервером целиком: кикает игроков, банит, останавливает сервер. Пароль из примера — только пример. Придумайте свой, длинный и уникальный. Если пароль утёк, смените его в файле и перезапустите сервер.

Правила простые:

• не используйте один пароль для RCON, REST API и входа в игру;
• открывайте RCON и REST API только для адресов, которым доверяете;
• если бот работает на той же машине, обращайтесь к 127.0.0.1;
• регулярно проверяйте, что порты закрыты для всех, кроме нужных адресов.

Имейте в виду: REST API по HTTP передаёт пароль с каждым запросом. Поэтому открывать его в интернет без фильтрации адресов не стоит.

Какой интерфейс выбрать для новых инструментов

Справочники расходятся: одни называют RCON устаревающим и советуют REST API, другие перечисляют оба способа как рабочие. Для новых инструментов разумно начинать с REST API и проверять состояние RCON в документации вашей версии игры.

Частые ошибки

Таблица: что проверить, если RCON или REST API не отвечает

Пройдите по таблице сверху вниз, прежде чем менять что-то ещё. Большинство проблем решаются в первых двух строках.

Два интерфейса независимы: если RCON работает, а REST API нет, проверяйте только ключи REST API и порт 8212.

Пример: проверка RCON через клиент

Возьмите любой клиент с поддержкой Source RCON. Подключитесь к адресу сервера на порт RCONPort, введите AdminPassword и отправьте ShowPlayers. Если пришёл список игроков (или пустой список, когда никого нет), RCON работает. Если клиент пишет «authentication failed», проблема в пароле. Если не подключается вовсе, проблема в порте, фаерволе или выдаче порта в панели.

Тот же приём годится для команд из статьи админ-команды Palworld и ARK: сначала проверьте связь простой командой, а потом пишите автоматизацию.

Схема ниже помогает разложить порты: какой порт для игры, какой для REST API и какой для RCON.

Как устроен доступ по сети

Порт, который вы открываете, — точка входа. Для RCON и REST API она должна вести только к вам или к вашему боту. Если бот на отдельном VPS, открывайте порт для адреса этого VPS, а не для всех. Если бот работает на той же машине, что и сервер, он обращается к 127.0.0.1, и наружу порт не выходит.

Итог

REST API и RCON — два инструмента администрирования Palworld. Включайте их ключами RESTAPIEnabled и RCONEnabled, проверяйте выдачу портов в разделе «Сеть» и защищайте AdminPassword. Открывайте порты наружу только тогда, когда без этого не обойтись, и сразу проверяйте, что доступ закрыт для посторонних. Соседние темы: перенос мира Palworld и админ-команды Palworld и ARK.

Вопросы и ответы

Какой порт у REST API Palworld?

По умолчанию RESTAPIPort равен 8212 по TCP. Его можно поменять в файле настроек, но тогда новый порт должен быть выдан серверу.

Какой порт у RCON Palworld?

По умолчанию RCONPort равен 25575 по TCP. Включается ключом RCONEnabled=True.

Что использовать для логина в REST API?

Логин admin и пароль из AdminPassword. Это базовая аутентификация HTTP.

Можно ли включить оба интерфейса сразу?

Да, но открывайте наружу только нужный. Если бот работает на той же машине, достаточно адреса 127.0.0.1.

Сервер под Palworld за пару минут — egnetwork.ru.