dawidr/minecraft-docker Docker Image Overview

dawidr/minecraft-docker

dawidr

简单的Docker镜像，用于自动下载并启动Minecraft服务器，简化Minecraft服务端的部署流程。

1 收藏0 次下载

😅 镜像要是出问题，背锅的一定是你

中文简介版本下载

😅 镜像要是出问题，背锅的一定是你

Minecraft Docker镜像文档

镜像概述

本Docker镜像旨在提供一种简单、快捷的方式部署Minecraft服务器。通过容器化技术，用户无需手动下载Minecraft服务端文件或配置运行环境，镜像会自动完成服务端文件的下载与服务器启动，大幅简化Minecraft服务器的搭建流程。

核心功能与特性

核心功能

自动下载服务端文件：无需手动获取Minecraft服务器JAR文件，镜像会自动从官方源下载指定版本的服务端程序
一键启动服务器：容器启动后自动初始化并启动Minecraft服务器，无需额外手动操作
数据持久化支持：通过Docker数据卷挂载，可持久化存储服务器配置、世界数据及玩家档案

主要特性

轻量级设计：基于精简基础镜像，减少资源占用
版本灵活性：支持指定Minecraft服务器版本（如1.18.2、1.19.4等）
配置可定制：通过环境变量调整服务器参数（如内存分配、端口映射等）
兼容性良好：兼容Docker及Docker Compose，支持主流操作系统（Linux、Windows、macOS）

使用场景

个人玩家：快速搭建私人Minecraft服务器，与好友联机游戏
小型游戏社区：为小团体提供稳定的游戏服务，无需复杂的服务器管理知识
开发者测试：在开发环境中快速部署不同版本的Minecraft服务器进行功能测试

使用方法与配置说明

基本部署（docker run）

通过以下命令快速启动Minecraft服务器：

bash
docker run -d \
  --name minecraft-server \
  -p 25565:25565 \
  -v /path/to/minecraft/data:/minecraft \
  drusin/minecraft-docker

参数说明：

-d：后台运行容器
--name minecraft-server：指定容器名称为"minecraft-server"
-p 25565:25565：映射容器内Minecraft默认端口25565到宿主机（如需修改宿主机端口，可调整左侧数值，如-p 25566:25565）
-v /path/to/minecraft/data:/minecraft：将宿主机目录（需替换为实际路径）挂载到容器内/minecraft目录，用于持久化服务器数据

自定义配置（环境变量）

通过设置环境变量可调整服务器参数，常用变量如下：

环境变量	说明	默认值
`MINECRAFT_VERSION`	指定Minecraft服务器版本（如"1.20.1"）	最新稳定版
`JAVA_OPTS`	Java运行参数（如内存分配）	`-Xmx1G -Xms512M`
`SERVER_PORT`	容器内服务器端口（需同步调整端口映射）	25565

示例：指定服务器版本为1.19.4，分配2GB内存

bash
docker run -d \
  --name minecraft-server \
  -p 25565:25565 \
  -v /path/to/minecraft/data:/minecraft \
  -e MINECRAFT_VERSION="1.19.4" \
  -e JAVA_OPTS="-Xmx2G -Xms1G" \
  drusin/minecraft-docker

Docker Compose部署

创建docker-compose.yml文件，配置如下：

yaml
version: '3'
services:
  minecraft-server:
    image: drusin/minecraft-docker
    container_name: minecraft-server
    ports:
      - "25565:25565"
    volumes:
      - ./minecraft-data:/minecraft
    environment:
      - MINECRAFT_VERSION=1.20.1
      - JAVA_OPTS=-Xmx2G -Xms1G
    restart: unless-stopped

执行以下命令启动服务：