phlak/minecraft

docker-minecraft

镜像概述和主要用途

docker-minecraft 是一个用于运行 Minecraft（原版）服务器的 Docker 镜像，旨在提供简单、便捷的 Minecraft 服务器部署方案，支持数据持久化、自定义配置及基本服务器管理功能。

核心功能和特性

• 数据持久化：通过 Docker 数据卷存储世界数据和配置文件，确保服务器重启或升级后数据不丢失。
• JVM 参数自定义：支持设置 JVM 内存参数（最小/最大内存），适应不同服务器规模需求。
• 时区配置：可自定义服务器时区，默认使用 UTC 时区。
• 服务器管理：支持编辑服务器配置文件、添加 OP 权限、执行服务器命令等基本管理操作。
• 自动重启策略：可配置 Docker 重启策略，确保服务器异常退出后自动恢复。

使用场景和适用范围

适用于需要快速部署 Minecraft 服务器的个人用户或小型社区，尤其适合以下场景：

• 个人测试或单人游戏服务器部署。
• 小型朋友/家庭社区服务器，需要简单配置和管理。
• 希望避免直接在主机系统安装依赖，追求环境隔离的用户。

详细的使用方法和配置说明

前提条件

• 已安装 Docker 引擎（参考 Docker 官方文档 进行安装）。

1. 创建数据卷

为持久化存储 Minecraft 世界数据和配置文件，首先创建命名数据卷：

bash
docker volume create --name minecraft-data

2. 启动服务器容器

使用以下命令启动 Minecraft 服务器容器：

bash
docker run -it -d -p 25565:25565 -v minecraft-data:/etc/minecraft --name minecraft-server phlak/minecraft

参数说明：

• -it：交互式终端（用于后续执行服务器命令）。
• -d：后台运行容器。
• -p 25565:25565：映射 Minecraft 服务器默认端口（25565）到主机。
• -v minecraft-data:/etc/minecraft：挂载数据卷到容器内 /etc/minecraft 目录（存储世界数据和配置）。
• --name minecraft-server：指定容器名称为 minecraft-server。

3. 可选配置参数

环境变量配置

通过 -e 参数设置环境变量，自定义服务器行为：

示例：

bash
# 设置 JVM 最小内存 512M、最大内存 4G，时区为 Asia/Shanghai
docker run -it -d -p 25565:25565 -v minecraft-data:/etc/minecraft \
  -e _JAVA_OPTIONS='-Xms512M -Xmx4096M' -e TZ=Asia/Shanghai \
  --name minecraft-server phlak/minecraft

Docker 重启策略

添加 --restart unless-stopped 参数，确保容器异常退出后自动重启（但不会在手动停止后随 Docker 守护进程启动而重启）：

bash
docker run -it -d -p 25565:25565 -v minecraft-data:/etc/minecraft \
  --restart unless-stopped --name minecraft-server phlak/minecraft

4. 编辑服务器配置

Minecraft 服务器核心配置文件为 server.properties，可通过以下步骤修改：

1. 进入运行中的容器并编辑配置文件：

   bash
   docker exec -it minecraft-server vi /etc/minecraft/server.properties
   

2. 修改完成后保存退出，重启容器使配置生效：

   bash
   docker restart minecraft-server
   

配置项说明参考 Minecraft Wiki - server.properties。

5. 添加 OP 权限

通过容器内置命令为玩家授予 OP 权限（管理员权限）：

bash
docker exec minecraft-server ops [PLAYER_NAMES]

参数说明：

• [PLAYER_NAMES]：一个或多个玩家名称（空格分隔）；名称包含空格时需用引号包裹。

示例：

bash
# 为玩家 "Steve"、"Alex" 和 "Notch" 添加 OP
docker exec minecraft-server ops Steve Alex "Notch"

6. 执行服务器命令

通过 docker attach 连接到服务器控制台，执行 Minecraft 服务器命令（如 say、kick、ban 等）：

1. 连接到服务器控制台：

   bash
   docker attach minecraft-server
   

2. 直接输入命令（示例）：

   say 欢迎来到服务器！
   list  # 查看在线玩家
   seed  # 查看世界种子
   

3. 断开连接（保持服务器运行）：按 Ctrl + P 后按 Ctrl + Q。

7. 升级服务器

1. 拉取最新镜像：

   bash
   docker pull phlak/minecraft
   

2. 停止并删除旧容器（数据卷中的数据会保留）：

   bash
   docker rm -f minecraft-server
   

3. 使用原命令重新启动容器（确保参数与之前一致）：

   bash
   docker run -it -d -p 25565:25565 -v minecraft-data:/etc/minecraft --name minecraft-server phlak/minecraft
   

Docker Compose 部署示例

创建 docker-compose.yml 文件，简化部署和管理：

yaml
version: '3'

services:
  minecraft-server:
    image: phlak/minecraft
    container_name: minecraft-server
    ports:
      - "25565:25565"
    volumes:
      - minecraft-data:/etc/minecraft
    environment:
      - _JAVA_OPTIONS=-Xms1G -Xmx4G  # 自定义内存（1G 最小，4G 最大）
      - TZ=Asia/Shanghai             # 设置时区为上海
    restart: unless-stopped          # 自动重启策略

volumes:
  minecraft-data:  # 自动创建数据卷（无需提前手动创建）

启动服务：

bash
docker-compose up -d

故障排除

• 内存不足：根据 Minecraft 服务器需求 调整 _JAVA_OPTIONS 中的内存参数，确保主机有足够内存。
• 时区错误：确认 TZ 环境变量值来自 时区列表 的 TZ 列（大小写敏感）。
• 配置不生效：修改 server.properties 后需重启容器；检查文件路径是否正确（/etc/minecraft/server.properties）。

如需进一步帮助，可通过 https://github.com/PHLAK/docker-minecraft/discussions 或 https://github.com/PHLAK/docker-minecraft/issues 获取支持。

版权信息

本项目基于 https://github.com/PHLAK/docker-minecraft/blob/master/LICENSE 开源。