dlord/minecraft

Minecraft - 原版服务器镜像

镜像概述

该Docker镜像允许快速运行原版Minecraft服务器，同时也可用作部分模组化Minecraft服务器镜像的基础镜像。通过环境变量可灵活配置服务器属性和JVM参数，支持多种Java版本以适应不同需求，并提供脚本化管理功能。

可用标签

• java15、latest：默认标签，使用Shenandoah GC以实现低延迟
• java8：适用于特定模组包或有明确需求的场景
• java7：用于与较旧Minecraft版本的向后兼容性

使用方法

启动实例

bash
docker run \
    --name minecraft-instance \
    -p 0.0.0.0:25565:25565 \
    -d \
    -it \
    -e DEFAULT_OP=dinnerbone \
    -e MINECRAFT_EULA=true \
    dlord/minecraft

默认启动Minecraft 1.8.8服务器实例。如需启动其他版本，需设置MINECRAFT_VERSION环境变量指定版本号。

必须设置的参数：

• DEFAULT_OP：设置Minecraft管理员用户名，未设置时容器将无法运行
• MINECRAFT_EULA：设置为true表示同意Minecraft EULA，未同意时服务器无法启动

镜像暴露标准Minecraft端口（25565）。首次启动容器时，会检查Minecraft服务器JAR文件是否存在，必要时从Mojang下载（因Minecraft EULA限制无法预打包JAR文件）。建议使用-it参数启动容器，以支持通过docker exec执行控制台命令，并确保docker stop时服务器安全关闭。

命令

镜像使用名为minecraft的入口脚本，支持以下预设命令，未识别的命令将被视为普通shell命令：

• run：运行Minecraft服务器（容器默认命令），可接受Minecraft支持的额外参数
• permissions：更新所有相关文件和文件夹的权限，手动编辑文件后使用
• console：执行控制台命令，支持系统管理员通过脚本执行复杂任务（默认禁用，需配合-it参数启用）

命令示例：

1. 传递额外参数启动服务器：

bash
docker run \
    --name minecraft-instance \
    -p 0.0.0.0:25565:25565 \
    -d \
    -it \
    -e DEFAULT_OP=dinnerbone \
    -e MINECRAFT_EULA=true \
    dlord/minecraft \
    run anotherminecraftoptionthatdoesnotexist

2. 更新运行中容器的文件权限：

bash
docker exec minecraft-instance minecraft permissions

脚本化管理

与其他Minecraft Docker镜像不同，该镜像支持无需附加容器即可执行控制台命令，便于系统管理员通过脚本执行复杂任务（如通过Jenkins部署）。

启用方法：通过docker create或docker run命令添加-it参数（启用STDIN和TTY），此时Minecraft服务器将在tmux会话中运行，同时支持容器停止时的安全关闭。

执行控制台命令示例：

bash
docker exec minecraft-instance minecraft console say hello everybody!

注意事项：

• 不要在docker exec中使用-it参数，否则会导致tmux会话崩溃
• 通过docker attach附加到控制台时，不要使用CTRL-b d分离tmux会话（会停止容器），应使用CTRL-p CTRL-q（Docker标准分离序列）

服务器关闭脚本示例：

bash
#!/bin/bash
docker exec minecraft-instance minecraft console say 服务器将在60秒后关闭！
docker exec minecraft-instance minecraft console say 请停止当前操作！
sleep 60
docker exec minecraft-instance minecraft console say 我们将在1小时后返回！
sleep 5

# 容器会自动向服务器发送停止命令以确保安全关闭
# 也可手动执行：docker exec minecraft-instance minecraft console stop
# 但如果重启策略设为always，这会导致容器重启
docker stop -t 60 minecraft-instance

数据卷

旧版本镜像使用/var/lib/minecraft作为数据卷（包含世界数据），如使用旧版本镜像，需将该目录内容迁移至/opt/minecraft。

当前版本已移除默认数据卷定义，用户需在运行时或扩展镜像时自行声明。对于原版服务器，建议将/opt/minecraft声明为数据卷，简化数据管理并利用镜像的ONBUILD触发器。

环境变量

镜像通过环境变量配置JVM设置和server.properties。

必要环境变量

• MINECRAFT_EULA：必须设置为true以同意Minecraft EULA，否则服务器无法启动
• DEFAULT_OP：必须设置为Minecraft管理员用户名，否则容器无法运行

JVM设置

• MINECRAFT_OPTS：用于调整JVM参数

server.properties相关环境变量

首次启动时，如server.properties不存在将自动创建。可通过环境变量覆盖默认值，变量名对应配置项的大写形式（使用下划线代替连字符）。服务器端口不可修改，需在启动时通过端口映射调整。

可配置的环境变量列表：

• GENERATOR_SETTINGS
• OP_PERMISSION_LEVEL
• ALLOW_NETHER
• LEVEL_NAME
• ENABLE_QUERY
• ALLOW_FLIGHT
• ANNOUNCE_PLAYER_ACHIEVEMENTS
• LEVEL_TYPE
• ENABLE_RCON
• FORCE_GAMEMODE
• LEVEL_SEED
• SERVER_IP
• MAX_BUILD_HEIGHT
• SPAWN_NPCS
• WHITE_LIST
• SPAWN_ANIMALS
• SNOOPER_ENABLED
• ONLINE_MODE
• RESOURCE_PACK
• PVP
• DIFFICULTY
• ENABLE_COMMAND_BLOCK
• PLAYER_IDLE_TIMEOUT
• GAMEMODE
• MAX_PLAYERS
• SPAWN_MONSTERS
• VIEW_DISTANCE
• GENERATE_STRUCTURES
• MOTD

扩展镜像

该镜像设计用于扩展，以便打包自定义地图、模组包和配置为Docker镜像，是服务器管理员推出配置变更和更新的最佳方式。

ONBUILD触发器

镜像包含一个ONBUILD触发器，会将本地文件复制到/usr/src/minecraft。容器首次启动时，该目录内容（除以world开头的文件）将通过rsync复制到/opt/minecraft。

世界模板

支持世界模板（用于打包自定义地图），模板应遵循Minecraft命名 convention（如world、world_nether、world_the_end）。通过ONBUILD触发器将世界模板复制到/usr/src/minecraft，启动时如/opt/minecraft/world为空，将自动复制模板。

Dockerfile中的环境变量

MINECRAFT_HOME（只读！）

指向Minecraft安装目录（/opt/minecraft），用于打包模组包时创建脚本。请勿覆盖此变量，修改将被忽略。

MINECRAFT_VERSION

模组包通常需要特定Minecraft版本，可在Dockerfile中设置此变量指定。

MINECRAFT_STARTUP_JAR

打包模组包时需使用不同的启动JAR文件，可在Dockerfile中设置此变量指定。

MINECRAFT_OPTS

部分模组包有推荐的JVM设置，可在Dockerfile中通过此变量配置。

支持的Docker版本

该镜像已在Docker 1.1.1版本上测试通过。

反馈

欢迎提交https://github.com/dlord/minecraft-docker/issues%EF%BC%8C%E4%B9%9F%E5%8F%AF%E9%80%9A%E8%BF%87Pull Request贡献代码。