danielswebsite/minecraft-spigot-server Docker 镜像 - 轩辕镜像

Minecraft Spigot服务器Docker镜像（1.15.2至1.21.x）

镜像概述和主要用途

该Docker镜像用于运行Minecraft Spigot服务器，支持Minecraft 1.15.2至1.21.x版本。通过标准启动参数配置、日志和插件文件夹的卷挂载，可快速部署和管理Minecraft服务器。项目通过Gitlab CI/CD流水线每日构建、测试并部署最新Minecraft版本的镜像，确保及时更新。

核心功能和特性

• 支持Minecraft 1.15.2至1.21.x多个版本
• 可自定义Spigot启动参数（如最大玩家数、在线模式等）
• 支持插件文件夹和日志文件夹的卷挂载，实现数据持久化
• 采用非root用户运行，提升容器安全性
• 每日CI/CD自动构建、测试和部署最新版本
• 提供详细版本更新记录，便于追踪镜像迭代

使用场景和适用范围

• 快速部署独立Minecraft Spigot服务器
• 需要持久化保存插件配置和日志文件的场景
• 需自定义服务器参数（如玩家数量限制、在线验证模式）的需求
• 定期更新Minecraft服务器版本的管理场景

使用方法和配置说明

必要环境变量

• EULA: 必须设置为true以同意Minecraft最终用户许可协议（EULA）

基础端口映射

默认Minecraft服务器端口为25565，建议通过-p参数映射至宿主机端口（如示例中的25588:25565）

使用示例

带Spigot启动参数

bash
docker run -p 25588:25565 -e EULA=true --name my-spigot-server -it danielswebsite/minecraft-spigot-server:mc-1.16.3 --max-players 600 --online-mode false

带插件文件夹卷挂载

bash
docker run -p 25588:25565 -e EULA=true --name my-spigot-server -v c:\docker\volumes\plugins:/server/plugins -it danielswebsite/minecraft-spigot-server:mc-1.16.3

带日志文件夹卷挂载

bash
docker run -p 25588:25565 -e EULA=true --name my-spigot-server -v c:\docker\volumes\logs:/server/logs -it danielswebsite/minecraft-spigot-server:mc-1.16.3

同时挂载日志和插件卷并配置启动参数

bash
docker run -p 25588:25565 -e EULA=true --name my-spigot-server -v c:\docker\volumes\logs:/server/logs -v c:\docker\volumes\plugins:/server/plugins -it danielswebsite/minecraft-spigot-server:mc-1.16.3 --max-players 1200 --online-mode true

Gitlab项目

项目地址：Gitlab

通过该项目可查看镜像构建过程，每日CI/CD流水线自动构建、测试并部署最新Minecraft版本的镜像。

镜像版本更新记录

• 2020-08-21：新增镜像目标（mc-1.16.2），对应Minecraft 1.16.2版本
• 2020-09-13：新增镜像目标（mc-1.16.3），对应Minecraft 1.16.3版本，并更新镜像目标（mc-1.12.2）
• 2020-09-20：更新镜像目标（mc-1.16.3）的Spigot JAR文件
• 2020-09-20：为所有镜像目标添加Spigot插件和日志文件夹卷挂载支持，并更新Spigot JAR文件
• 2020-11-14：将Spigot JAR更新至1.16.4版本，并新增对应镜像目标
• 2020-12-26：更新Spigot JAR至1.16.4版本的最新Spigot更新
• 2020-12-28：将所有Spigot JAR镜像更新至最新构建版本，并使用非root用户运行以提升安全性
• 2021-05-30：部署自动构建脚本，当Spigot服务器文件需更新时自动构建并发布新镜像
• 2022-02-03：仅添加1.18和1.18.1版本至镜像目标
• 2022-12-05：添加1.19.0和1.19.2版本，并创建自动化构建Git项目：[***]
• 2023-06-01：更新镜像至Minecraft 1.19.4版本
• 2023-07-10：更新镜像至Minecraft 1.20.1版本
• 2023-11-23：更新镜像至Minecraft 1.20.2版本
• 2024-02-21：修复Minecraft 1.20.2版本Docker镜像构建脚本错误
• 2024-11-10：更新镜像至Minecraft 1.21.3版本
• 2024-11-15：Gitlab CI/CD流水线首次成功运行，详情可查看Gitlab项目部分