ashdev/docker-spigot

Minecraft Spigot服务器镜像

此镜像替代旧镜像：https://hub.docker.com/r/ashdev/docker-spigot

镜像概述

该Docker镜像提供基于Spigot的Minecraft服务器，启动时自动下载最新稳定版本，支持1.13及以上Minecraft版本。包含多种插件选项和灵活的配置参数，可快速部署、管理多人游戏服务器。

核心功能

1. 自动版本更新：启动时自动获取最新稳定版Spigot服务器
2. 灵活配置：通过环境变量自定义游戏模式、OP权限、世界种子等参数
3. 插件支持：可启用Dynmap、Essentials、PermissionsEx等常用插件
4. 数据持久化：支持挂载主机目录保存服务器数据（世界文件、配置等）
5. JVM优化：可调整Java内存参数以适配服务器资源
6. 交互能力：支持通过Docker命令与服务器控制台交互、执行游戏指令

使用场景

• 个人/小团队搭建Minecraft多人联机服务器
• 测试Minecraft插件或服务器配置
• 快速部署临时游戏服务器供朋友联机

配置说明

基础部署示例

运行最新版本服务器（需接受EULA）

bash
docker run -d -e EULA=TRUE -p 25565:25565 ashdev/minecraft-spigot:latest

指定Minecraft版本（如1.13）

bash
docker run -d -e EULA=TRUE -e REV=1.13 -p 25565:25565 ashdev/minecraft-spigot:latest

挂载数据目录（持久化）

bash
docker run -d -e EULA=TRUE -v /本地路径:/minecraft -p 25565:25565 ashdev/minecraft-spigot:latest

自定义游戏模式（创造模式）

bash
docker run -d -e EULA=TRUE -e MODE=creative -p 25565:25565 ashdev/minecraft-spigot:latest

常用环境变量

• EULA：必填，接受Minecraft EULA（值为TRUE）
• OPS：管理员用户名列表（逗号分隔，如user1,user2）
• SEED：世界生成种子（如1785852800490497919）
• MOTD：服务器标语（如"我的Minecraft服务器"）
• PVP：是否开启PVP（true/false）
• JVM_OPTS：Java内存参数（如-Xmx2048M -Xms2048M）

插件配置

启用Dynmap地图插件（暴露8123端口）

bash
docker run -d -e EULA=TRUE -e DYNMAP=true -p 25565:25565 -p 8123:8123 ashdev/minecraft-spigot:latest

启用Essentials工具插件

bash
docker run -d -e EULA=TRUE -e ESSENTIALS=true ashdev/minecraft-spigot:latest

服务器交互

附加到控制台

bash
docker attach <容器名/ID>

（按Ctrl-P Ctrl-Q分离）

执行游戏命令（如授予OP权限）

bash
docker exec <容器名/ID> /spigot_cmd.sh op AshDevFr

注意事项

• 首次运行必须添加-e EULA=TRUE以接受Minecraft EULA
• 挂载数据目录时，可通过-e UID指定主机用户ID确保权限正确
• 根据服务器资源调整JVM参数优化性能
• 添加插件后需重启容器生效