Просмотр кода страницы Minecraft в 2026 году

<div class="portal-header">
<div class="portal-title">Minecraft Java Server</div>
<div class="portal-subtitle">
Установка и эксплуатация выделенного сервера Minecraft на Ubuntu 24.04 LTS
</div>
</div>

<div class="portal-card">
'''Minecraft Java Server''' — выделенный сервер для Minecraft Java Edition.

В этой статье рассматривается установка сервера на '''Ubuntu 24.04 LTS''' с отдельным системным пользователем, автоматическим запуском через systemd, RCON-управлением и резервным копированием.

Конфигурация подходит для виртуальной машины, физического сервера или LXC-контейнера.
</div>

__TOC__

== Архитектура ==

Базовая схема сервера:

<syntaxhighlight lang="text">
                    Игроки
                       │
                       │ TCP :25565
                       ▼
               ┌───────────────┐
               │   Minecraft   │
               │ Java Server   │
               └───────┬───────┘
                       │
              ┌────────┴────────┐
              │                 │
              ▼                 ▼
          systemd              RCON
                                  │
                                  ▼
                               mcrcon
</syntaxhighlight>

В production-конфигурации Minecraft запускается не вручную, а как системная служба.

== Системные требования ==

{| class="wikitable"
! Параметр
! Минимально
! Рекомендуется
|-
| CPU
| 2 vCPU
| 4+ производительных ядра
|-
| RAM
| 4 ГБ
| 8 ГБ и более
|-
| Диск
| 20 ГБ
| 50+ ГБ SSD
|-
| ОС
| Ubuntu 24.04 LTS
| Ubuntu 24.04 LTS
|-
| Сеть
| 25565/TCP
| Статический IP или NAT
|}

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

== Подготовка системы ==

Обновляем систему:

<syntaxhighlight lang="bash">
apt update
apt upgrade -y
</syntaxhighlight>

Устанавливаем необходимые инструменты:

<syntaxhighlight lang="bash">
apt install -y \
    wget \
    curl \
    git \
    nano \
    unzip \
    build-essential
</syntaxhighlight>

Проверяем время и часовой пояс:

<syntaxhighlight lang="bash">
timedatectl
</syntaxhighlight>

При необходимости:

<syntaxhighlight lang="bash">
timedatectl set-timezone Europe/Moscow
</syntaxhighlight>

== Установка Java ==

Версия Java зависит от версии Minecraft.

Перед установкой рекомендуется проверить требования конкретной версии сервера.

Для современных версий Minecraft обычно используется Java 21:

<syntaxhighlight lang="bash">
apt install -y openjdk-21-jdk
</syntaxhighlight>

Проверяем:

<syntaxhighlight lang="bash">
java -version
</syntaxhighlight>

Пример:

<syntaxhighlight lang="text">
openjdk version "21"
OpenJDK Runtime Environment
OpenJDK 64-Bit Server VM
</syntaxhighlight>

=== Проверка установленной Java ===

Путь до Java:

<syntaxhighlight lang="bash">
which java
</syntaxhighlight>

Обычно:

<syntaxhighlight lang="text">
/usr/bin/java
</syntaxhighlight>

== Создание пользователя Minecraft ==

Minecraft не следует запускать от имени root.

Создаём отдельного системного пользователя:

<syntaxhighlight lang="bash">
useradd \
    --system \
    --create-home \
    --user-group \
    --home-dir /opt/minecraft \
    --shell /bin/bash \
    minecraft
</syntaxhighlight>

Проверяем:

<syntaxhighlight lang="bash">
id minecraft
</syntaxhighlight>

Переходим под него:

<syntaxhighlight lang="bash">
su - minecraft
</syntaxhighlight>

Домашним каталогом пользователя будет:

<syntaxhighlight lang="text">
/opt/minecraft
</syntaxhighlight>

== Структура каталогов ==

Создаём:

<syntaxhighlight lang="bash">
mkdir -p ~/server
mkdir -p ~/backups
mkdir -p ~/tools
</syntaxhighlight>

Структура:

<syntaxhighlight lang="text">
/opt/minecraft/
├── server/
│   ├── server.jar
│   ├── server.properties
│   ├── eula.txt
│   ├── world/
│   └── logs/
│
├── backups/
│
└── tools/
</syntaxhighlight>

Назначение:

* '''server''' — сервер Minecraft;
* '''backups''' — резервные копии;
* '''tools''' — вспомогательные утилиты.

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

'''mcrcon''' используется для отправки команд Minecraft через RCON.

Клонируем проект:

<syntaxhighlight lang="bash">
git clone https://github.com/Tiiffi/mcrcon.git ~/tools/mcrcon
</syntaxhighlight>

Компилируем:

<syntaxhighlight lang="bash">
cd ~/tools/mcrcon
make
</syntaxhighlight>

Проверяем:

<syntaxhighlight lang="bash">
./mcrcon -v
</syntaxhighlight>

== Установка Minecraft Server ==

Переходим:

<syntaxhighlight lang="bash">
cd /opt/minecraft/server
</syntaxhighlight>

Актуальный файл '''server.jar''' необходимо скачивать с официального сайта Minecraft/Mojang.

После получения ссылки:

<syntaxhighlight lang="bash">
wget -O server.jar \
'https://piston-data.mojang.com/.../server.jar'
</syntaxhighlight>

Проверяем:

<syntaxhighlight lang="bash">
ls -lh server.jar
</syntaxhighlight>

== Первый запуск ==

Первый запуск нужен для генерации конфигурации:

<syntaxhighlight lang="bash">
java -Xms2G -Xmx4G -jar server.jar nogui
</syntaxhighlight>

Сервер остановится, поскольку EULA ещё не принята.

После запуска появятся:

<syntaxhighlight lang="text">
eula.txt
server.properties
logs/
</syntaxhighlight>

== Принятие EULA ==

Открываем:

<syntaxhighlight lang="bash">
nano eula.txt
</syntaxhighlight>

Меняем:

<syntaxhighlight lang="text">
eula=false
</syntaxhighlight>

на:

<syntaxhighlight lang="text">
eula=true
</syntaxhighlight>

Сохраняем файл.

== Базовая настройка server.properties ==

Открываем:

<syntaxhighlight lang="bash">
nano server.properties
</syntaxhighlight>

Основные параметры:

<syntaxhighlight lang="properties">
server-port=25565

max-players=100

online-mode=true

enable-command-block=false

view-distance=10
simulation-distance=10

motd=RAMBA-ART Minecraft Server
</syntaxhighlight>

Для публичного сервера рекомендуется оставлять:

<syntaxhighlight lang="properties">
online-mode=true
</syntaxhighlight>

Это включает проверку учётных записей Mojang/Microsoft.

== Настройка RCON ==

В `server.properties`:

<syntaxhighlight lang="properties">
enable-rcon=true
rcon.port=25575
rcon.password=CHANGE_THIS_PASSWORD
broadcast-rcon-to-ops=true
</syntaxhighlight>

После изменения сервер необходимо перезапустить.

=== Безопасность RCON ===

RCON не рекомендуется публиковать напрямую в Интернет.

Предпочтительная схема:

<syntaxhighlight lang="text">
mcrcon
   │
   │ 127.0.0.1:25575
   ▼
Minecraft Server
</syntaxhighlight>

То есть порт `25575` должен использоваться только локально либо через защищённую административную сеть/VPN.

== Проверка ручного запуска ==

Запускаем:

<syntaxhighlight lang="bash">
cd /opt/minecraft/server

java -Xms4G -Xmx6G \
    -jar server.jar \
    nogui
</syntaxhighlight>

Если сервер успешно загрузился, в консоли появится сообщение примерно:

<syntaxhighlight lang="text">
Done (...)! For help, type "help"
</syntaxhighlight>

После проверки останавливаем:

<syntaxhighlight lang="text">
stop
</syntaxhighlight>

== Создание systemd-службы ==

Выходим из пользователя Minecraft:

<syntaxhighlight lang="bash">
exit
</syntaxhighlight>

Создаём:

<syntaxhighlight lang="bash">
nano /etc/systemd/system/minecraft.service
</syntaxhighlight>

Содержимое:

<syntaxhighlight lang="ini">
[Unit]
Description=Minecraft Java Server
After=network-online.target
Wants=network-online.target

[Service]
Type=simple

User=minecraft
Group=minecraft

WorkingDirectory=/opt/minecraft/server

ExecStart=/usr/bin/java \
    -Xms4G \
    -Xmx6G \
    -jar /opt/minecraft/server/server.jar \
    nogui

Restart=on-failure
RestartSec=10

SuccessExitStatus=0 143

LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
</syntaxhighlight>

Применяем:

<syntaxhighlight lang="bash">
systemctl daemon-reload
systemctl enable --now minecraft
</syntaxhighlight>

Проверяем:

<syntaxhighlight lang="bash">
systemctl status minecraft
</syntaxhighlight>

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

Запуск:

<syntaxhighlight lang="bash">
systemctl start minecraft
</syntaxhighlight>

Остановка:

<syntaxhighlight lang="bash">
systemctl stop minecraft
</syntaxhighlight>

Перезапуск:

<syntaxhighlight lang="bash">
systemctl restart minecraft
</syntaxhighlight>

Статус:

<syntaxhighlight lang="bash">
systemctl status minecraft
</syntaxhighlight>

Логи:

<syntaxhighlight lang="bash">
journalctl -u minecraft -f
</syntaxhighlight>

Последние 100 строк:

<syntaxhighlight lang="bash">
journalctl -u minecraft -n 100
</syntaxhighlight>

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

Под пользователем Minecraft:

<syntaxhighlight lang="bash">
su - minecraft
</syntaxhighlight>

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

<syntaxhighlight lang="bash">
/opt/minecraft/tools/mcrcon/mcrcon \
    -H 127.0.0.1 \
    -P 25575 \
    -p 'CHANGE_THIS_PASSWORD' \
    -t
</syntaxhighlight>

После подключения можно выполнять команды сервера:

<syntaxhighlight lang="text">
list
say Server restart in 5 minutes
save-all
whitelist list
stop
</syntaxhighlight>

Выход из интерактивного режима mcrcon:

<syntaxhighlight lang="text">
Q
</syntaxhighlight>

== Настройка Firewall ==

Для игроков требуется только:

<syntaxhighlight lang="text">
25565/TCP
</syntaxhighlight>

При использовании UFW:

<syntaxhighlight lang="bash">
ufw allow 25565/tcp
</syntaxhighlight>

Проверяем:

<syntaxhighlight lang="bash">
ufw status
</syntaxhighlight>

'''RCON-порт 25575/TCP не следует открывать для всего Интернета.'''

Если сервер находится в LXC или VM под Proxmox, правила можно централизованно управлять через Proxmox Firewall.

== Проверка порта Minecraft ==

Проверяем локально:

<syntaxhighlight lang="bash">
ss -ltnp | grep 25565
</syntaxhighlight>

Ожидаемый результат:

<syntaxhighlight lang="text">
LISTEN ... :25565
</syntaxhighlight>

Также можно проверить процесс:

<syntaxhighlight lang="bash">
ps aux | grep '[s]erver.jar'
</syntaxhighlight>

== Резервное копирование ==

Для корректного backup мира желательно сначала заставить Minecraft записать данные на диск.

Создаём конфигурационный файл для RCON:

<syntaxhighlight lang="bash">
nano /opt/minecraft/.rcon.env
</syntaxhighlight>

Содержимое:

<syntaxhighlight lang="bash">
RCON_HOST=127.0.0.1
RCON_PORT=25575
RCON_PASSWORD='CHANGE_THIS_PASSWORD'
</syntaxhighlight>

Ограничиваем доступ:

<syntaxhighlight lang="bash">
chown minecraft:minecraft /opt/minecraft/.rcon.env
chmod 600 /opt/minecraft/.rcon.env
</syntaxhighlight>

Создаём backup-скрипт:

<syntaxhighlight lang="bash">
nano /opt/minecraft/tools/backup.sh
</syntaxhighlight>

Содержимое:

<syntaxhighlight lang="bash">
#!/bin/bash

set -e

source /opt/minecraft/.rcon.env

RCON="/opt/minecraft/tools/mcrcon/mcrcon"

BACKUP_DIR="/opt/minecraft/backups"
SERVER_DIR="/opt/minecraft/server"

TIMESTAMP="$(date +%F-%H-%M-%S)"
BACKUP_FILE="${BACKUP_DIR}/minecraft-${TIMESTAMP}.tar.gz"

$RCON \
    -H "$RCON_HOST" \
    -P "$RCON_PORT" \
    -p "$RCON_PASSWORD" \
    "save-off"

$RCON \
    -H "$RCON_HOST" \
    -P "$RCON_PORT" \
    -p "$RCON_PASSWORD" \
    "save-all flush"

tar \
    --exclude='./logs' \
    -czf "$BACKUP_FILE" \
    -C "$SERVER_DIR" \
    .

$RCON \
    -H "$RCON_HOST" \
    -P "$RCON_PORT" \
    -p "$RCON_PASSWORD" \
    "save-on"

find "$BACKUP_DIR" \
    -type f \
    -name 'minecraft-*.tar.gz' \
    -mtime +7 \
    -delete
</syntaxhighlight>

Делаем исполняемым:

<syntaxhighlight lang="bash">
chmod +x /opt/minecraft/tools/backup.sh
chown minecraft:minecraft /opt/minecraft/tools/backup.sh
</syntaxhighlight>

Тестируем:

<syntaxhighlight lang="bash">
su - minecraft -c '/opt/minecraft/tools/backup.sh'
</syntaxhighlight>

Проверяем:

<syntaxhighlight lang="bash">
ls -lh /opt/minecraft/backups/
</syntaxhighlight>

== Автоматическое резервное копирование ==

Переходим:

<syntaxhighlight lang="bash">
su - minecraft
</syntaxhighlight>

Открываем:

<syntaxhighlight lang="bash">
crontab -e
</syntaxhighlight>

Например, ежедневный backup в 04:00:

<syntaxhighlight lang="cron">
0 4 * * * /opt/minecraft/tools/backup.sh >> /opt/minecraft/backups/backup.log 2>&1
</syntaxhighlight>

Проверяем:

<syntaxhighlight lang="bash">
crontab -l
</syntaxhighlight>

== Обновление Minecraft Server ==

Перед обновлением:

# создаём резервную копию;
# останавливаем сервер;
# сохраняем старый `server.jar`;
# устанавливаем новый;
# запускаем сервер;
# проверяем логи и совместимость мира.

Пример:

<syntaxhighlight lang="bash">
systemctl stop minecraft

cp /opt/minecraft/server/server.jar \
   /opt/minecraft/server/server.jar.old
</syntaxhighlight>

После загрузки нового файла:

<syntaxhighlight lang="bash">
systemctl start minecraft
journalctl -u minecraft -f
</syntaxhighlight>

== Проверка ресурсов ==

CPU и память:

<syntaxhighlight lang="bash">
top
</syntaxhighlight>

или:

<syntaxhighlight lang="bash">
htop
</syntaxhighlight>

Память:

<syntaxhighlight lang="bash">
free -h
</syntaxhighlight>

Диск:

<syntaxhighlight lang="bash">
df -h
</syntaxhighlight>

Размер мира:

<syntaxhighlight lang="bash">
du -sh /opt/minecraft/server/world*
</syntaxhighlight>

== Java и Minecraft ==

Требования Java меняются вместе с Minecraft.

Общее правило:

{| class="wikitable"
! Minecraft
! Java
|-
| 1.20.5 и новее
| Java 21
|-
| Старые версии
| Требования зависят от конкретного релиза
|}

Перед обновлением необходимо проверять требования именно для устанавливаемой версии Minecraft.

Не стоит обновлять Java исключительно потому, что появилась более новая версия JDK.

== Типичные проблемы ==

=== Сервер не запускается ===

Проверяем:

<syntaxhighlight lang="bash">
systemctl status minecraft
journalctl -u minecraft -n 100
</syntaxhighlight>

=== Ошибка памяти ===

Проверяем:

<syntaxhighlight lang="bash">
free -h
</syntaxhighlight>

При необходимости уменьшаем:

<syntaxhighlight lang="text">
-Xmx
</syntaxhighlight>

=== Клиенты не подключаются ===

Проверяем:

<syntaxhighlight lang="bash">
ss -ltnp | grep 25565
</syntaxhighlight>

Затем:

* Firewall;
* NAT;
* проброс портов;
* публичный IP;
* `server-port`;
* `server-ip`.

Обычно `server-ip` рекомендуется оставлять пустым.

=== RCON не работает ===

Проверяем:

<syntaxhighlight lang="bash">
grep -E 'enable-rcon|rcon.port' \
/opt/minecraft/server/server.properties
</syntaxhighlight>

И:

<syntaxhighlight lang="bash">
ss -ltnp | grep 25575
</syntaxhighlight>

== Рекомендации ==

Для production-сервера рекомендуется:

* запускать Minecraft от отдельного пользователя;
* использовать systemd;
* не открывать RCON в Интернет;
* выполнять ежедневные backup;
* хранить резервные копии вне основного сервера;
* использовать SSD;
* контролировать свободное место;
* регулярно проверять логи;
* делать backup перед обновлением;
* обновлять сервер только после проверки совместимости Java и Minecraft.

== Полезные команды ==

{| class="wikitable"
! Задача
! Команда
|-
| Запуск
| <code>systemctl start minecraft</code>
|-
| Остановка
| <code>systemctl stop minecraft</code>
|-
| Перезапуск
| <code>systemctl restart minecraft</code>
|-
| Статус
| <code>systemctl status minecraft</code>
|-
| Логи
| <code>journalctl -u minecraft -f</code>
|-
| Проверить порт
| <code>ss -ltnp | grep 25565</code>
|-
| Проверить Java
| <code>java -version</code>
|-
| Проверить память
| <code>free -h</code>
|-
| Проверить диск
| <code>df -h</code>
|}

== Итоговая архитектура ==

<syntaxhighlight lang="text">
               Minecraft Client
                      │
                      │ TCP :25565
                      ▼
        ┌──────────────────────────┐
        │     Minecraft Server     │
        │                          │
        │        server.jar        │
        └────────────┬─────────────┘
                     │
        ┌────────────┼────────────┐
        │            │            │
        ▼            ▼            ▼
     systemd       mcrcon       backups
                      │
                      ▼
                localhost RCON
</syntaxhighlight>

Такой вариант удобен для постоянной эксплуатации, обновления, диагностики и восстановления сервера.

== См. также ==

* [[Proxmox VE]]
* [[Linux]]
* [[Minecraft]]
* [[Резервное копирование]]
* [[Мониторинг]]

== Внешние ссылки ==

* [https://www.minecraft.net/ Официальный сайт Minecraft]
* [https://www.minecraft.net/download/server Minecraft Java Server]
* [https://github.com/Tiiffi/mcrcon mcrcon]

[[Категория:Minecraft]]
[[Категория:Linux]]
[[Категория:Ubuntu]]
[[Категория:Игровые серверы]]
[[Категория:Администрирование]]
[[Категория:RAMBA ART]]