buddyspencer/spigot

Docker Minecraft Spigot镜像

镜像概述

本Docker镜像用于构建并运行最新版本的Minecraft Spigot服务器。Spigot是基于Bukkit的高性能Minecraft服务器软件，提供插件支持和性能优化。该镜像通过自动化构建确保始终使用最新版Spigot，支持多架构部署，简化Minecraft服务器的搭建与运维流程。

核心功能与特性

• 最新版本构建：Dockerfile自动构建并集成最新版本的Spigot服务器，确保获取最新功能与安全更新。
• 多架构支持：兼容AMD64（x86_64）和ARM64（aarch64）架构，适配PC、服务器及ARM开发板（如树莓派）等设备。
• 数据持久化：支持通过数据卷挂载保存服务器配置、世界数据及插件，避免容器重启导致数据丢失。
• 内存灵活配置：通过环境变量自定义服务器内存分配，适应不同规模的服务器需求。
• 快速部署：简化启动流程，无需手动配置Java环境及Spigot安装，一键完成服务器部署。

使用场景

• 个人或小型社区Minecraft服务器搭建，满足多人联机需求。
• 开发测试环境，用于验证插件兼容性或服务器配置调试。
• 轻量级服务器部署，适用于资源有限的设备（如低配置VPS或家庭服务器）。

使用方法

前提条件

• 已安装Docker Engine（推荐版本1.13及以上）。
• 目标设备架构为AMD64或ARM64。

拉取镜像

通过以下命令从Docker Hub拉取最新镜像：

sh
docker pull buddyspencer/spigot

启动服务器容器

使用以下命令启动Spigot服务器容器，根据需求调整参数：

sh
docker run \
  --rm \  # 容器停止后自动删除容器文件
  --name mc \  # 自定义容器名称（示例为"mc"）
  -e MEMORYSIZE='1G' \  # 设置服务器内存大小（如2G表示2GB，根据需求调整）
  -v /path/to/local/data:/data:rw \  # 挂载本地目录到容器/data（替换/path/to/local/data为实际本地路径）
  -p 25565:25565 \  # 映射Minecraft默认端口（主机端口:容器端口，如需修改主机端口可调整左侧数值）
  -i buddyspencer/spigot:latest  # 保持标准输入打开，支持控制台交互

参数说明

• --rm：容器退出时自动清理容器文件，避免残留无效容器。
• --name mc：指定容器名称为"mc"，便于通过docker ps或docker stop mc等命令管理。
• -e MEMORYSIZE='1G'：设置服务器JVM内存分配，建议根据服务器规模调整（如小型服务器1-2G，中型服务器4-8G）。
• -v /path/to/local/data:/data:rw：将本地目录挂载到容器的/data目录，用于持久化存储服务器配置、世界存档及插件文件。
• -p 25565:25565：端口映射，允许外部Minecraft客户端通过主机IP:25565连接服务器。
• -i：保持标准输入流打开，支持后续通过docker attach与服务器控制台交互。

与服务器控制台交互

启动容器后，通过以下命令附加到服务器控制台，执行服务器命令（如 OP 管理、重启等）：

sh
docker attach mc

提示：附加后按Ctrl+P+Q可退出交互模式但不终止服务器；按Ctrl+C将直接终止服务器进程。

架构支持

该镜像支持以下硬件架构：

• AMD64（x86_64）：适用于主流PC、服务器及云主机。
• ARM64（aarch64）：适用于ARM架构设备，如树莓派4/5、ARM服务器等。