rdall96/minecraft-server

Minecraft Server - Docker镜像文档

一、镜像概述和主要用途

该Docker镜像基于Alpine Linux构建，包含运行Minecraft服务器所需的组件。支持多种Minecraft版本，适用于快速部署个人或小型社区服务器。

支持的Minecraft版本：

• 原版（Java版）- 官方网站
• Forge - Minecraft Forge
• Fabric - Fabric MC
• NeoForge - NeoForged
• Quilt - Quilt Project

二、核心功能和特性

• 多版本支持：覆盖原版Java版、基岩版及主流mod加载器（Forge、Fabric等）
• 轻量基础：基于Alpine Linux，镜像体积小，资源占用低
• 数据持久化：支持通过卷挂载持久化世界数据、配置文件及mods
• 灵活配置：通过环境变量自定义服务器属性（server.properties）
• JVM参数优化：支持自定义JVM运行参数，适配不同硬件环境
• 版本标签化：清晰的标签规则，方便选择特定版本或类型

三、使用场景和适用范围

• 个人/家庭Minecraft服务器搭建
• 小型社区（5-20人）服务器部署
• modded服务器测试与生产环境部署
• 快速演示或临时服务器创建

四、使用方法和配置说明

4.1 镜像获取

4.1.1 拉取镜像

bash
docker pull rdall96/minecraft-server:latest

4.1.2 标签规则说明

Docker标签用于标识Minecraft类型和版本，规则如下：

• 原版Java版：latest（跟踪最新版本）、1.20.1（特定版本，如1.20.1）
• Modded版本：{游戏版本}-{加载器}_{加载器版本}，如1.20.1-fabric_0.14.21（Fabric 0.14.21 + 游戏1.20.1）
• 基岩版：latest-bedrock（最新基岩版）、1.19.2-bedrock（特定基岩版）

注意：Modded版本无latest标签，因mod更新存在延迟，自动更新可能导致不兼容。

4.2 基本部署

4.2.1 启动容器（基础示例）

bash
docker run -d --name minecraft \
  -p 25565:25565 \
  -e EULA=true \
  rdall96/minecraft-server:latest

4.2.2 访问说明

• 服务器地址：localhost:25565 或 <你的IP地址>:25565
• 外部网络访问需配置路由器端口转发（25565端口），建议同时设置DDNS以应对公网IP变化

端口转发风险提示：开放网络端口可能面临安全风险，需谨慎操作。本项目仅提供服务器运行能力，不对端口转发导致的任何损失负责。

4.3 数据持久化

通过卷挂载实现世界数据、配置文件及mods的持久化，避免容器重启或更新导致数据丢失。

4.3.1 世界数据持久化

bash
docker run -d --name minecraft \
  -v ~/minecraft/world:/minecraft/world \  # 挂载世界数据目录
  -p 25565:25565 \
  -e EULA=true \
  rdall96/minecraft-server:latest

4.3.2 配置文件持久化（适用于modded服务器）

bash
docker run -d --name minecraft \
  -v ~/minecraft/world:/minecraft/world \
  -v ~/minecraft/config:/minecraft/configurations \  # 挂载配置目录（含白名单、op列表等）
  -v ~/minecraft/mods:/minecraft/mods \  # 挂载mods目录（modded服务器）
  -p 25565:25565 \
  -e EULA=true \
  rdall96/minecraft-server:1.20.1-fabric_0.14.21

目录说明：容器内/minecraft为根目录，包含world（世界数据）、mods（mod文件）、configurations（配置文件，含whitelist.json、ops.json等）。

4.4 服务器属性配置

通过环境变量自定义server.properties文件，支持以下参数（完整列表见表格）：

更多细节参见Minecraft Wiki - 服务器属性

4.4.1 环境变量使用示例

bash
# 单环境变量
docker run -d --name minecraft \
  -p 25565:25565 \
  -e EULA=true \
  -e MOTD="Docker搭建的Minecraft服务器" \
  -e DIFFICULTY=hard \
  -e MAX_PLAYERS=8 \
  rdall96/minecraft-server:latest

4.4.2 环境变量文件（推荐大量配置时使用）

创建环境变量文件properties.env：

ini
EULA=true
MOTD=Hello from Docker!
DIFFICULTY=hard
MAX_PLAYERS=5
WHITE_LIST=true

通过文件加载环境变量：

bash
docker run -d --name minecraft \
  -v ~/minecraft/world:/minecraft/world \
  -p 25565:25565 \
  --env-file properties.env \
  rdall96/minecraft-server:latest

4.5 JVM参数配置

通过jvm_args.txt文件自定义JVM运行参数（如内存分配），文件路径为容器内/minecraft/configurations/jvm_args.txt（需挂载配置目录持久化）。

示例（设置最大内存为8GB）：

1. 在宿主机配置目录创建jvm_args.txt：

   txt
   -Xmx8G
   -XX:+UseG1GC
   

2. 启动容器时挂载配置目录：

   bash
   docker run -d --name minecraft \
     -v ~/minecraft/config:/minecraft/configurations \
     -p 25565:25565 \
     -e EULA=true \
     rdall96/minecraft-server:latest
   

4.6 Docker Compose配置示例

创建docker-compose.yml：

yaml
version: '3'
services:
  minecraft:
    image: rdall96/minecraft-server:1.20.1
    container_name: minecraft
    restart: unless-stopped
    ports:
      - "25565:25565"
    environment:
      - EULA=true
      - MOTD=My Docker Minecraft Server
      - DIFFICULTY=normal
      - MAX_PLAYERS=10
    volumes:
      - ./world:/minecraft/world
      - ./config:/minecraft/configurations
      - ./mods:/minecraft/mods  # 仅modded服务器需要
    mem_limit: 8G  # 限制容器最大内存（可选）

启动服务：

bash
docker-compose up -d

五、问题反馈

如遇使用问题或改进建议，请发送邮件至：Minecraft Docker - Support

六、开发提示

该镜像可作为自定义Minecraft容器的基础，支持添加mods或修改配置。容器入口脚本位于/minecraft/start_server.sh，世界数据在首次启动后生成。