kennethw/minecraft

Minecraft: Java Edition Server 镜像文档

镜像概述

本镜像提供Minecraft Java版服务器的Docker化部署方案，服务器文件直接来源于Minecraft官方网站。通过容器化方式简化Minecraft Java Edition服务器的搭建与管理流程，适用于各类需要快速部署游戏服务器的场景。使用本镜像即表示您同意Minecraft最终用户许可协议和隐私政策。

核心功能与特性

• 官方原版保障：服务器核心文件直接从Minecraft官方渠道获取，确保版本纯正性和安全性
• 容器化部署：通过Docker实现快速部署，减少环境配置复杂度
• 数据持久化支持：可通过数据卷挂载保存游戏世界、配置文件等关键数据，避免容器重启导致数据丢失
• 版本兼容性：支持官方发布的各版本Minecraft Java服务器（通过指定镜像标签实现版本控制）

使用场景

• 个人玩家搭建私人或朋友间的Minecraft多人服务器
• 游戏社区部署公共服务器供成员使用
• 教育机构用于搭建教学用Minecraft创意环境
• 开发测试环境中快速部署临时服务器

使用方法与配置说明

前提条件

• 已安装Docker Engine（推荐版本20.10及以上）
• 阅读并同意Minecraft EULA条款

基础部署命令

通过以下命令启动Minecraft Java版服务器：

bash
docker run -d \
  --name minecraft-server \
  -p 25565:25565 \
  -v /path/to/local/data:/data \
  -e EULA=TRUE \
  minecraft/server:latest

参数说明：

• -d：后台运行容器
• --name minecraft-server：指定容器名称为"minecraft-server"
• -p 25565:25565：映射容器内默认Minecraft服务器端口（25565）到主机
• -v /path/to/local/data:/data：将主机本地目录（需替换为实际路径）挂载到容器内/data目录，用于持久化存储游戏数据
• -e EULA=TRUE：设置环境变量表示同意Minecraft EULA（必须设置为TRUE才能启动服务器）
• minecraft/server:latest：使用最新版本的服务器镜像（可替换标签指定具体版本，如minecraft/server:1.20.1）

高级配置

自定义服务器属性

服务器核心配置文件为server.properties，位于挂载的数据卷目录中。常见配置项包括：

• server-port：服务器端口（默认25565，如需修改需同步调整端口映射）
• max-players：最大玩家数量（默认20）
• difficulty：游戏难度（可选值：peaceful, easy, normal, hard）
• gamemode：默认游戏模式（可选值：survival, creative, adventure, spectator）
• motd：服务器描述信息（显示在客户端服务器列表中）

修改配置后需重启容器生效：

bash
docker restart minecraft-server

资源限制

根据服务器规模调整资源分配（示例限制2GB内存）：

bash
docker run -d \
  --name minecraft-server \
  -p 25565:25565 \
  -v /path/to/local/data:/data \
  -e EULA=TRUE \
  -m 2g \
  --memory-swap 2g \
  minecraft/server:latest

日志与管理

• 查看日志：

  bash
  docker logs -f minecraft-server
  

• 进入容器控制台（需服务器已启动）：

  bash
  docker exec -it minecraft-server sh
  

• 停止服务器：

  bash
  docker stop minecraft-server
  

• 删除容器（数据仍保留在挂载目录）：

  bash
  docker rm minecraft-server
  

注意事项

• 首次启动服务器时会自动生成必要配置文件，可能需要几分钟时间
• 建议定期备份挂载的/data目录，防止数据丢失
• 服务器性能受主机配置影响，推荐至少2GB内存用于基本运行，多人游戏需更高配置
• 如需使用mods或插件，需将相关文件放置于挂载目录的mods/plugins文件夹中（需对应服务器版本）