Pterohost docs

RCON: удалённое управление консолью Minecraft-сервера

Как настроить RCON на Minecraft-сервере: включение в server.properties, подключение через mcrcon, безопасность и примеры команд.

Кратко: RCON позволяет выполнять команды на Minecraft-сервере по сети - без доступа к панели и без физической консоли. Включается в server.properties тремя строками. Использовать только на localhost или через VPN - не открывать порт наружу.

RCON: удалённое управление консолью Minecraft-сервера

RCON (Remote CONsole) - это сетевой протокол, заимствованный из движка Source Engine и встроенный в ванильный Minecraft Java Edition. Он позволяет отправлять консольные команды на работающий сервер по TCP-соединению с паролем - из скрипта, Discord-бота, стороннего дашборда или просто из терминала другой машины. В 2026 году RCON остаётся стандартом интеграции для автоматизации Minecraft-серверов: его поддерживают все популярные ядра - ваниль, Paper, Spigot, Fabric, Forge. Понимание RCON нужно каждому, кто хочет управлять сервером программно или подключить внешние инструменты мониторинга.

Pterohost - надёжный хостинг Minecraft-серверов с NVMe-дисками, DDoS-защитой и поддержкой 24/7. Промокод 4START даёт -20% на первый заказ. Заказать Minecraft хостинг

Что такое RCON и когда он нужен

Консоль в панели управления (Pterodactyl, Multicraft и аналоги) - это прямое чтение stdout процесса Java. Она удобна для ручного администрирования, но недоступна для внешних программ. RCON решает другую задачу: предоставляет машинный интерфейс к консоли через TCP-сокет с аутентификацией по паролю.

Типичные сценарии использования RCON:

  • Discord-боты (Mineflayer, DiscordSRV-интеграции, самописные боты) - отправка команд из чата Discord прямо на сервер.
  • Автоматические бэкапы - скрипт делает save-off, снимает snapshot файловой системы, затем save-on, всё без остановки сервера.
  • Плановые задачи через cron - перезагрузка сервера в ночное время, плановые announce-сообщения, автоматическая выдача наград.
  • Мониторинг - некоторые системы мониторинга используют RCON для получения TPS, онлайна и других метрик.
  • Сторонние панели и дашборды - MineOS, AMP, собственные веб-интерфейсы.

Если нужно просто зайти в консоль и ввести пару команд - используй консоль Pterodactyl, это быстрее. RCON раскрывает себя именно в автоматизации и интеграциях.

Включение RCON в server.properties

Файл server.properties находится в корне директории сервера. Три параметра отвечают за RCON:

enable-rcon=true
rcon.port=25575
rcon.password=ВашНадёжныйПароль

Параметры:

ПараметрПо умолчаниюОписание
enable-rconfalseВключить RCON-сервер
rcon.port25575TCP-порт для RCON-соединений
rcon.password“ (пусто)Пароль; если пустой - RCON не стартует даже при enable-rcon=true

Полный пример рабочего блока в server.properties:

# --- основные параметры ---
server-port=25565
online-mode=true

# --- RCON ---
enable-rcon=true
rcon.port=25575
rcon.password=S3cr3t_P4ss!2026

После изменения файла сервер нужно перезапустить. При успешном старте в логе появится строка:

[Server thread/INFO]: RCON running on 0.0.0.0:25575

Если строки нет - проверь, что rcon.password не пустой и порт не занят другим процессом (ss -tlnp | grep 25575).

Выбор хорошего пароля

Пароль RCON - это полный доступ к серверу. Используй минимум 16 символов со спецсимволами. Не используй тот же пароль, что и для панели управления или аккаунта. Избегай символов " и \ в пароле - некоторые клиенты передают их некорректно; вместо них используй !, @, #, _, -.

Подключение через mcrcon

mcrcon - самый популярный консольный клиент RCON для Minecraft. Написан на C, компилируется за секунды, работает на Linux, macOS и Windows.

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

# Клонируем репозиторий
git clone https://github.com/Tiiffi/mcrcon.git
cd mcrcon

# Компилируем
gcc -std=gnu11 -o mcrcon mcrcon.c

# Копируем в PATH (опционально)
sudo cp mcrcon /usr/local/bin/

На Ubuntu/Debian может потребоваться пакет build-essential:

sudo apt install build-essential -y

Основные команды mcrcon

Интерактивная сессия (вводишь команды одну за другой):

mcrcon -H 127.0.0.1 -P 25575 -p S3cr3t_P4ss!2026

Выполнение одной команды и выход:

mcrcon -H 127.0.0.1 -P 25575 -p S3cr3t_P4ss!2026 "say Сервер перезапустится через 5 минут"

Выполнение нескольких команд подряд:

mcrcon -H 127.0.0.1 -P 25575 -p S3cr3t_P4ss!2026 \
  "save-off" \
  "save-all" \
  "say Бэкап запущен"

Флаги mcrcon:

ФлагОписание
-HХост (IP или hostname)
-PПорт RCON
-pПароль
-tЗавершить сессию после выполнения команд
-w NОжидать N секунд между командами

Альтернативные клиенты и инструменты

rcon-cli (Go)

Если mcrcon по каким-то причинам не подходит, есть rcon-cli - написан на Go, доступен как бинарник без компиляции.

# Скачиваем под Linux amd64
wget https://github.com/gorcon/rcon-cli/releases/latest/download/rcon-cli_linux_amd64.tar.gz
tar xzf rcon-cli_linux_amd64.tar.gz

# Запуск
./rcon -a 127.0.0.1:25575 -p S3cr3t_P4ss!2026 "list"

RCON через Python (скрипты и боты)

Библиотека mcrcon для Python:

pip install mcrcon

Пример скрипта для отправки сообщения:

from mcrcon import MCRcon

with MCRcon("127.0.0.1", "S3cr3t_P4ss!2026", port=25575) as mcr:
    resp = mcr.command("list")
    print(resp)
    mcr.command("say Привет из скрипта!")

Тот же модуль используют большинство Discord-ботов на Python, интегрирующихся с Minecraft.

RCON в Discord-ботах

Популярные боты с RCON-интеграцией в 2026 году:

  • DiscordSRV (плагин для Paper/Spigot) - синхронизация чата, но для выполнения команд использует встроенный API сервера, а не RCON. Тем не менее при желании можно настроить совместно.
  • Pterodactyl Discord Bot (pterodactyl-discord-bot и форки) - подключается через API панели, не через RCON напрямую.
  • Самописные боты на discord.py или discord.js, использующие mcrcon-библиотеку - самый гибкий вариант.

Веб-панели с поддержкой RCON

ПанельТипПримечание
PterodactylХостинговая панельИспользует прямой stdin, RCON опционален
AMP (Application Management Panel)СамохостингВстроенная RCON-интеграция
MineOS ReloadedСамохостингRCON поддерживается в настройках профиля
Crafty ControllerСамохостингВстроенный RCON-клиент в интерфейсе

Если сервер хостится на Pterodactyl (как у Pterohost) - консоль панели обычно покрывает 90% задач. RCON нужен для скриптов и интеграций извне панели.

Безопасность RCON: главное правило

Никогда не открывай RCON-порт в публичный интернет. Это правило важнее любых других советов по безопасности.

Кто знает пароль RCON - тот имеет полный доступ к консоли: может остановить сервер, выдать op, удалить мир через save-off + stop, выполнить команды системы через встроенные плагины. Подбор пароля по сети реален, если порт открыт всем.

Настройка firewall

На Ubuntu/Debian с ufw:

# Запрещаем RCON снаружи полностью
sudo ufw deny 25575

# Разрешаем только с конкретного IP (например, 192.168.1.10)
sudo ufw allow from 192.168.1.10 to any port 25575 proto tcp

С iptables:

# Блокируем RCON для всех
iptables -A INPUT -p tcp --dport 25575 -j DROP

# Разрешаем только localhost
iptables -I INPUT -p tcp -s 127.0.0.1 --dport 25575 -j ACCEPT

Если нужен доступ с удалённой машины - используй SSH-туннель:

# На своей машине пробрасываем RCON через SSH
ssh -L 25575:127.0.0.1:25575 user@адрес_сервера

# Теперь подключаемся локально
mcrcon -H 127.0.0.1 -P 25575 -p S3cr3t_P4ss!2026

Туннель шифрует трафик и не требует открывать порт 25575 наружу.

Дополнительные меры

  • Уникальный порт - смени rcon.port с дефолтного 25575 на нестандартный (например, 35575). Это не панацея, но снижает автоматическое сканирование.
  • Смена пароля - меняй пароль при смене персонала или при малейшем подозрении на компрометацию. Пароль хранится в server.properties открытым текстом - ограничь чтение файла: chmod 600 server.properties.
  • Логирование - мониторь логи сервера на предмет неожиданных RCON-подключений. В логе каждое RCON-подключение оставляет след.

Полезные команды через RCON

После подключения через RCON доступны все консольные команды сервера. Наиболее используемые:

Управление игроками

list                        # Список онлайн-игроков
kick Игрок Причина          # Кикнуть игрока
ban Игрок Причина           # Забанить игрока
ban-ip 192.168.1.1          # Забанить по IP
pardon Игрок                # Разбанить игрока
op Игрок                    # Выдать права оператора
deop Игрок                  # Снять права оператора

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

save-all                    # Принудительное сохранение
save-off                    # Отключить автосохранение (перед бэкапом)
save-on                     # Включить автосохранение (после бэкапа)
time set day                # Установить день
time set night              # Установить ночь
weather clear               # Убрать дождь
gamerule doDaylightCycle false  # Остановить смену дня и ночи

Широковещательные сообщения

say Привет всем!            # Сообщение в чат от имени сервера
tellraw @a {"text":"Сервер обновляется через 5 минут","color":"yellow"}
title @a title {"text":"ВНИМАНИЕ","color":"red"}

Получение информации

list                        # Количество и список игроков
tps                         # TPS (только с Paper/Spigot)
version                     # Версия сервера
difficulty                  # Текущая сложность

Пример скрипта бэкапа с RCON

#!/bin/bash
# backup-minecraft.sh - бэкап с корректным сохранением через RCON

RCON="mcrcon -H 127.0.0.1 -P 25575 -p S3cr3t_P4ss!2026"
WORLD_DIR="/opt/minecraft/world"
BACKUP_DIR="/backups/minecraft"
DATE=$(date +%Y%m%d_%H%M%S)

# Уведомляем игроков
$RCON "say Начинаю бэкап, возможны лаги..."

# Отключаем автосохранение и сохраняем текущее состояние
$RCON "save-off"
$RCON "save-all"
sleep 5

# Создаём архив
mkdir -p "$BACKUP_DIR"
tar czf "$BACKUP_DIR/world_$DATE.tar.gz" "$WORLD_DIR"

# Включаем автосохранение обратно
$RCON "save-on"
$RCON "say Бэкап завершён."

echo "Бэкап сохранён: $BACKUP_DIR/world_$DATE.tar.gz"

Этот скрипт можно добавить в cron: 0 4 * * * /opt/scripts/backup-minecraft.sh - ежедневный бэкап в 4:00.

Отличие RCON от консоли в панели управления

Понимание разницы помогает выбрать правильный инструмент:

КритерийКонсоль панели (Pterodactyl)RCON
Тип доступаПрямой stdin/stdout процессаTCP-сокет с паролем
АутентификацияУчётные данные панелиПароль RCON
Работа из скриптовНет (нужен API панели)Да - mcrcon, Python, любой TCP-клиент
БезопасностьОпределяется доступом к панелиЗависит от пароля и firewall
Задержка ответаМинимальнаяМинимальная (TCP, локальный хост)
Поддержка плагиновВсе командыВсе команды
ИнтерактивностьПолная (цветной вывод)Ограниченная (текст без ANSI)

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

RCON и Pterodactyl API

Pterodactyl предоставляет собственный API, через который тоже можно отправлять команды:

curl -X POST \
  "https://panel.pterohost.com/api/client/servers/SERVER_ID/command" \
  -H "Authorization: Bearer твой_api_ключ" \
  -H "Content-Type: application/json" \
  -d '{"command": "list"}'

Этот метод предпочтителен, когда сервер хостится у провайдера - не нужно открывать дополнительные порты. RCON остаётся актуальным для локальных скриптов (которые работают на той же машине) или при самохостинге без панели.

Диагностика проблем с RCON

Если подключение не работает - проверяй по шагам:

1. RCON включён в server.properties?

grep -E "enable-rcon|rcon\." server.properties

Вывод должен показать enable-rcon=true и непустой пароль.

2. Сервер стартовал с RCON?

grep -i "rcon" logs/latest.log

Ищи строку RCON running on.

3. Порт слушается?

ss -tlnp | grep 25575

Должен показать процесс Java на этом порту.

4. Firewall не блокирует?

# Для ufw
sudo ufw status | grep 25575

# Тест подключения
nc -zv 127.0.0.1 25575

5. Правильный пароль в клиенте? Пароль чувствителен к регистру и пробелам. Проверь, что в команде mcrcon нет лишних кавычек или пробелов вокруг пароля.

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

ОшибкаПричина
Connection refusedПорт не слушается, RCON не запущен
Authentication failedНеверный пароль
Connection timed outFirewall блокирует порт
Bad loginПустой пароль в server.properties

Связанные материалы

Для полного понимания настройки сервера рекомендуем ознакомиться с полным гайдом по server.properties - там описаны все параметры конфигурации, включая онлайн-режим и защиту. Для работы с файлами сервера (загрузки конфигов, плагинов) читай гайд по подключению через FTP и SFTP. Управление правами операторов и команду /op подробно разбираем в статье как выдать права оператора на сервере.

Заключение

RCON - мощный инструмент для автоматизации Minecraft-серверов, востребованный в 2026 году так же, как и всегда. Включается тремя строками в server.properties, подключается через mcrcon или Python-библиотеку. Главное правило безопасности одно: порт 25575 не должен быть доступен из интернета - только localhost или SSH-туннель. Для ручного администрирования консоль панели остаётся удобнее; RCON раскрывает ценность в скриптах, Discord-ботах и внешних интеграциях. Настрой RCON один раз правильно - и автоматические бэкапы, плановые перезапуски и боты будут работать без вашего участия.

Pterohost - игровой хостинг с NVMe-хранилищем, защитой от DDoS и круглосуточной поддержкой, где RCON работает из коробки. Промокод 4START даёт -20% на первый заказ. Заказать Minecraft хостинг