ashdev/minecraft-spigot

Minecraft Spigot服务器Docker镜像

概述

本镜像提供Minecraft Spigot服务器环境，启动时自动下载最新稳定版本，支持1.15 Nether Update等版本，集成常用插件并提供丰富配置选项，方便用户快速搭建和管理Minecraft服务器。

核心功能

• 自动拉取最新稳定版Spigot服务器
• 支持通过环境变量自定义服务器参数（游戏模式、最大玩家数、PVP等）
• 集成Dynmap、Essentials、PermissionsEx等常用插件
• 支持数据目录挂载到主机，便于配置和插件管理
• 可调整JVM内存参数优化性能
• 需接受Mojang EULA协议方可运行

使用场景

• 个人/团队快速搭建Minecraft服务器
• 部署多版本/多配置的服务器实例
• 自定义服务器规则（如创造模式、白名单、资源包）满足特定需求

配置说明

基础部署示例

启动最新版本服务器

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

指定版本（如1.15）

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

挂载数据目录到主机

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

常用配置选项

• 接受EULA：-e EULA=TRUE（必须设置，遵守Mojang用户协议）
• 游戏模式：-e MODE=creative（创造模式）/survival（生存模式）
• 最大玩家数：-e MAXPLAYERS=20
• PVP模式：-e PVP=false（关闭PVP）
• 管理员用户：-e OPS=user1,user2（添加多个管理员）
• 服务器图标：-e ICON=http://示例.com/icon.png（自动下载并转换图标）
• JVM内存：-e JVM_OPTS="-Xmx2048M -Xms2048M"（调整内存限制）

插件配置

• Dynmap地图插件：-e DYNMAP=true -p 8123:8123（暴露地图端口）
• Essentials基础插件：-e ESSENTIALS=true
• PermissionsEx权限管理：-e PERMISSIONSEX=true

服务器交互

• 启动时添加-it参数启用交互：docker run -d -it -e EULA=TRUE --name mc ashdev/minecraft-spigot:latest
• 附加到容器：docker attach mc（按Ctrl-p Ctrl-q退出）
• 执行命令：docker exec mc /spigot_cmd.sh op 用户名（授予管理员权限）