Сервер Minecraft в Docker: образ itzg/minecraft-server

Коротко: создайте compose.yaml с образом itzg/minecraft-server, укажите EULA=TRUE, TYPE=PAPER, VERSION и MEMORY, смонтируйте папку в /data и выполните docker compose up -d. Плагины кладите в data/plugins, команды отправляйте docker exec mc rcon-cli <команда>. Для 26.x берите тег с Java 25, для 1.21.x — с Java 21.

Зачем Docker для сервера Minecraft#

• Java не нужно ставить на хост — нужная версия уже в образе, а для разных серверов можно взять разные теги.
• Всё описано в одном файле: версия, ядро, память, порт. Перенести сервер — значит скопировать папку и compose.yaml.
• Несколько серверов на одной машине не мешают друг другу: у каждого свой контейнер, порт и папка.

Если Docker вам незнаком, а сервер один, проще обычная установка — см. сервер на Linux. Docker окупается, когда серверов несколько или вы уже держите в нём сайт, базу и бота.

compose.yaml для Paper#

services:
  mc:
    image: itzg/minecraft-server:java25   # Java 25 для 26.x; для 1.21.x — тег java21
    tty: true
    stdin_open: true
    ports:
      - "25565:25565"
    environment:
      EULA: "TRUE"
      TYPE: "PAPER"
      VERSION: "26.3"
      MEMORY: "6G"            # и Xms, и Xmx
      STOP_DURATION: "120"    # сколько ждать сохранения мира при остановке
    volumes:
      - ./data:/data
    stop_grace_period: 2m     # не меньше STOP_DURATION
    restart: unless-stopped

1. 1

   Запустите

   docker compose up -d — образ скачает Paper, создаст мир и файлы сервера в ./data.

2. 2

   Посмотрите лог

   docker compose logs -f mc — сервер готов, когда появится строка Done.

3. 3

   Настройте

   server.properties, конфиги Paper и папка plugins — в ./data, как на обычном сервере. После правки — docker compose restart mc.

Java и теги образа#

Память и лимиты контейнера#

MEMORY задаёт кучу Java. Если вы ограничиваете память контейнера (mem_limit или лимиты оркестратора), лимит должен быть больше кучи: документация образа напоминает, что Java расходует память и сверх неё. Без явного MEMORY JVM берёт под кучу 25 % лимита контейнера. Как подобрать объём — в статье сколько памяти нужно.

Команды и консоль#

Почему порт RCON нельзя открывать в интернет — в статье RCON. В compose выше опубликован только игровой порт 25565.

Остановка без потерь#

Когда контейнер получает сигнал остановки, обёртка образа отправляет серверу stop и ждёт, пока он сохранит мир, — по умолчанию 60 секунд, STOP_DURATION меняет срок. Но и сам Docker ждёт ограниченное время, а потом убивает процесс. Поэтому stop_grace_period в compose (или docker stop -t) должен быть не меньше STOP_DURATION. Код выхода 137 значит, что Docker не дождался, — увеличьте оба значения.

Плагины и античит#

Плагины кладут в ./data/plugins и перезапускают контейнер: добавленный на ходу плагин без перезапуска не загрузится. Образ умеет и сам скачивать плагины по списку — например, со Spigot через SPIGET_RESOURCES. Как выбирать и ставить плагины — в статье как установить плагин.

DGuard — лучший античит для современного сервера Minecraft — ставится в контейнер так же: последний релиз PacketEvents и DGuard.jar в ./data/plugins, ключ из панели — в ./data/plugins/DGuard/config.yml, затем docker compose restart mc. Контейнеру нужен исходящий HTTPS к сайту DGuard: там работает облачная проверка с нейросетью боя AI Combat.

Частые вопросы#