zuzkins/minecraft

Minecraft Docker镜像文档

镜像概述

该镜像提供Docker化的Minecraft服务器环境，版本为1.16.3，旨在简化Minecraft服务器的部署与管理流程。通过容器化方式，实现服务快速启动、数据持久化存储及灵活的资源配置，适用于个人或小型团队搭建Minecraft游戏服务。

核心功能与特性

• 数据持久化：通过卷挂载本地目录，确保服务器数据（如世界存档、配置文件）持久化存储，容器重启或重建后数据不丢失
• JVM参数自定义：自1.14.4版本起支持JAVA_OPTS环境变量，可配置JVM参数（如内存分配）
• 服务稳定性：支持容器自动重启配置，保障服务持续运行
• 标准端口映射：默认映射Minecraft服务器标准端口25565，便于客户端连接

使用场景

适用于需要快速搭建Minecraft服务器的场景，包括但不限于：

• 个人玩家搭建私人服务器
• 小型游戏社区部署多人游戏服务
• 开发/测试环境中快速部署临时服务器

使用方法

前提准备

需先创建本地数据目录，用于存储服务器数据：

bash
mkdir /minecraft/data

基本部署命令

通过卷挂载数据目录启动容器，基本命令如下：

bash
docker run -d --restart=always -p 25565:25565 -v /data/minecraft:/data --name=minecraft docker.xuanyuan.run/zuzkins/minecraft

参数说明：

• -d：后台运行容器
• --restart=always：容器退出时自动重启
• -p 25565:25565：将容器内25565端口映射到主机25565端口（Minecraft默认端口）
• -v /data/minecraft:/data：挂载本地/data/minecraft目录到容器内/data目录（数据持久化）
• --name=minecraft：指定容器名称为minecraft
• zuzkins/minecraft：使用的Docker镜像名称

自定义JVM配置

如需调整服务器资源（如内存分配），可通过JAVA_OPTS环境变量配置JVM参数。例如，设置服务器最大可用内存为2GB：

bash
docker run -d --restart=always -p 25565:25565 -v /data/minecraft:/data -e JAVA_OPTS="-Xmx2048m" --name=minecraft docker.xuanyuan.run/zuzkins/minecraft

环境变量说明：

• JAVA_OPTS：JVM配置参数，常用参数包括：
  • -Xmx<size>：设置JVM最大堆内存（如-Xmx2048m表示2GB）
  • -Xms<size>：设置JVM初始堆内存（如-Xms1024m表示1GB）