dawidr/minecraft-docker

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目录，用于持久化服务器数据

自定义配置（环境变量）

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

示例：指定服务器版本为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

执行以下命令启动服务：

bash
docker-compose up -d

服务器管理

• 查看日志：docker logs -f minecraft-server
• 进入容器：docker exec -it minecraft-server /bin/sh
• 停止服务器：docker stop minecraft-server
• 重启服务器：docker restart minecraft-server

注意事项

• 首次启动时，镜像会下载Minecraft服务端文件，耗时取决于网络速度，请耐心等待
• 服务器数据（世界存档、配置文件等）存储在挂载的宿主机目录中，删除容器前请确保数据已备份
• 如需修改服务器配置（如server.properties），可直接编辑宿主机挂载目录中的对应文件，修改后需重启容器生效