nimmis/spigot Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Minecraft服务器 SPIGOT (基于Ubuntu 20.04和Java (Eclipse Adoptium) 8/11/16/17/18/20/21)

![]([***]

现已支持Minecraft 1.20

本次更新对Spigot版本构建逻辑进行了重大调整，部分条件组合可能导致编译异常。如遇问题，请提交issue以便修复。即将发布包含新功能的更新版本。

Java 1.17版本在单核心环境下存在bug，可添加环境变量 -e OTHER_JAVA_OPTS=-Djava.util.concurrent.ForkJoinPool.common.parallelism=1 作为临时解决方法。

镜像概述和主要用途

本Docker镜像用于构建和运行Spigot版本的Minecraft服务器。当Minecraft目录中未找到spigot.jar时，系统会自动拉取BuildTool并从最新发布的minecraft.jar构建新的spigot.jar。每次容器启动时会检查/minecraft/spigot.jar文件，若缺失则启动spigot.jar构建流程。

Spigot进程通过supervisord管理，关于Ubuntu容器中init进程的详细实现说明，请参考nimmis/ubuntu。

核心功能和特性

• 支持在运行中的容器内更改Spigot版本
• 自动检测已有预编译版本的MC目录并使用对应版本
• 根据MC版本自动调整Java版本，必要时下载额外Java版本
• 支持Minecraft 1.20版本
• 支持旧版1.8（1.8.3及以上），需使用Java 8（使用风险自负）

为何不包含预编译Spigot版本

出于***原因，您可以自行构建Spigot，但不能重新分发已编译的jar文件。

使用方法和配置说明

启动容器

运行最新稳定版镜像的命令：

bash
docker run -d -p 25565:25565 -e EULA=true nimmis/spigot

参数说明：

• -e EULA=true：Mojang要求用户接受EULA（详见[***]
• -p 25565:25565：将容器内25565端口映射到宿主机25565端口；若仅指定-p 25565，则会随机映射到宿主机端口

为容器命名

为便于管理，可通过--name参数为容器命名：

bash
docker run -d -p 25565:25565 -e EULA=true --name spigot nimmis/spigot

之后可通过名称启停容器：

bash
docker start spigot
docker stop spigot

首次运行

首次运行需几分钟时间（取决于计算机性能和网络速度），系统会拉取指定版本的BuildTools并构建Spigot.jar。可通过以下命令查看编译过程（假设容器名为spigot）：

bash
docker logs -f spigot

编译完成后服务器将启动，日志会显示类似以下内容：

Success! Everything completed successfully. Copying final .jar files now.
Copying spigot-1.18-R0.1-SNAPSHOT-bootstrap.jar to /build-mc/./spigot-1.18.jar
Saved as ./spigot-1.18.jar
Successfull build of spigot version 1.18
Setting 1.18 as current spigot version
*** Running /etc/my_runalways/85_fix_startsh...
start.sh missing, creating link for /minecraft/start.sh
*** Running /etc/my_runalways/90_eula...
*** Booting supervisor daemon...
*** Supervisor started as PID 781
*** Started processes via Supervisor......
crond                            RUNNING   pid 783, uptime 0:00:04
spigot                           RUNNING   pid 784, uptime 0:00:04
syslog-ng                        RUNNING   pid 785, uptime 0:00:03

按CTRL-C可退出日志查看。

选择编译版本

首次启动时指定版本

若未指定版本，容器会检查Minecraft目录是否有已链接的编译版本，若有则使用该版本；若无（如首次运行），默认编译最新版本。如需指定特定版本，可添加环境变量：

bash
-e SPIGOT_VER=<version>

例如，构建1.18版本：

bash
docker run -d -p 25565:25565 -e EULA=true -e SPIGOT_VER=1.18 --name spigot nimmis/spigot

在运行中更改版本

可通过以下命令在运行中的容器内更改Minecraft版本：

bash
docker exec -it spigot set_mc_ver <version>

执行后，系统会检查Minecraft目录中是否已有编译版本，若无则进行构建。过程包括：停止当前Minecraft服务、调整Java版本（必要时下载）、编译新Spigot（如需）、重启Minecraft服务。不建议降级版本，因世界数据不向后兼容。

支持的版本

请参考BuildTools官方页面获取最新版本信息。

内存配置

通过以下环境变量设置Spigot的初始和最大内存：

MC_MAXMEM

设置最大内存，单位为m（MB）或g（GB），默认1GB。例如设置为2GB：

bash
-e MC_MAXMEM=2g

MC_MINMEM

设置初始内存，单位同上。若未设置，默认与MC_MAXMEM相同。例如设置为512MB：

bash
-e MC_MINMEM=512m

SPIGOT_AUTORESTART

控制Minecraft内执行stop命令后的容器行为：

• -e SPIGOT_AUTORESTART=yes（默认）：执行stop后自动重启服务器
• -e SPIGOT_AUTORESTART=no：执行stop后服务器保持关闭，需通过mc_start命令或重启容器重新启动

OTHER_JAVA_OPS

添加其他Java启动参数：

bash
-e OTHER_JAVA_OPS=<参数>

服务器管理命令

查看Spigot服务器输出

查看最近10行服务器日志并实时输出：

bash
docker exec spigot mc_log

发送命令到服务器控制台

无需交互容器即可发送命令，例如设置时间为白天：

bash
docker exec spigot mc_send "time set day"

设置游戏管理员（OP）

为用户授予管理员权限：

bash
docker exec spigot mc_send op <用户名>

停止服务器

默认情况下，执行stop命令后服务器会自动重启。若设置SPIGOT_AUTORESTART=no，则需手动启动：

bash
docker exec spigot mc_start

启停服务器

• 停止服务器（不停止容器）：

  bash
  docker exec spigot mc_stop
  

• 启动服务器：

  bash
  docker exec spigot mc_start
  

• 重启服务器：

  bash
  docker exec spigot mc_restart
  

停止容器

使用docker stop命令停止容器时，Spigot服务器会优雅关闭以保存数据：

bash
docker stop spigot

宿主机文件挂载

为避免删除容器时丢失Minecraft文件，可将宿主机目录挂载到容器内的/minecraft目录：

bash
docker run -d -p 25565:25565 -e EULA=true -v /host/path/to/mc-data:/minecraft --name spigot nimmis/spigot

挂载卷权限问题

外部挂载卷的所有者UID可能与容器内minecraft用户（UID 1000）不匹配，导致读写权限问题。系统会自动检查/minecraft目录所有者UID与minecraft用户UID，若不匹配则调整minecraft用户UID以匹配目录所有者。

如需手动指定minecraft用户UID，可使用环境变量：

bash
-e SPIGOT_UID=<uid>

例如设置UID为1132：

bash
-e SPIGOT_UID=1132

其他可用命令

get_mc_versions

更新可用Minecraft版本列表：

bash
docker exec -it spigot get_mc_versions

旧版本更新记录

• 将Java版本更新至LTS版本17
• Adopt迁移至Eclipse基金会并更名为Adoptium
• 更新Java至16以支持Minecraft 1.17编译
• 切换至Adopt OpenJDK
• 修复2017年秋季引入的Windows 10和MacOS Docker版本构建Spigot失败问题
• 容器联网时自动检测时区
• 调整minecraft用户UID以匹配挂载卷所有者
• 可配置Java进程内存大小
• 支持选择Spigot版本
• docker stop时优雅关闭服务器
• 提供容器命令：
  • 启停/重启Spigot服务器
  • 发送控制台命令
  • 查看服务器控制台输出

问题反馈

如遇问题或有疑问，请通过GitHub issue提交反馈。提交时请包含：

• 容器内cat /etc/BUILDS/***的输出（如有可能）
• 相关日志
• 容器启动参数（标志、环境变量、挂载卷等）
• 其他有助于解决问题的信息

贡献

欢迎提交新功能、修复或更新，无论大小。我们会尽快处理所有Pull Request。

未来功能

• 自动备份
• 插件支持
• 更多功能开发中...