cmunroe/spigot

Bukkit、Spigot 和 PaperMC Docker 镜像

![pipeline status]([***]

项目地址：[***]

Docker Hub 镜像：

• https://hub.docker.com/r/cmunroe/bukkit
• https://hub.docker.com/r/cmunroe/spigot
• https://hub.docker.com/r/cmunroe/papermc

镜像概述和主要用途

本镜像基于 Alpine 构建，提供 Bukkit、Spigot 和 PaperMC 三种 Minecraft 服务器环境。适用于快速部署轻量级、可配置的 Minecraft 服务器，支持数据持久化和灵活的环境变量配置。

核心功能和特性

• 轻量级基础：基于 Alpine Linux，镜像体积小，资源占用低
• 多版本支持：提供 latest 标签（最新版）和版本号标签（如 1.16.2）
• 数据持久化：支持挂载主机目录到容器内 /data 目录，实现地图和服务器数据持久化
• 环境变量配置：通过环境变量直接配置 server.properties 参数，无需手动编辑文件
• EULA 自动接受：通过 EULA=true 环境变量一键接受 Minecraft 最终用户许可协议
• Java 内存控制：通过 InitRAM 和 MaxRAM 环境变量配置 JVM 初始和最大内存
• 配置文件生成：自动生成 server.properties（若文件不存在），支持强制重新生成配置

使用场景和适用范围

• 个人或小型团队快速部署 Minecraft 服务器
• 需要频繁调整服务器配置参数的场景
• 希望通过 Docker 简化部署和版本管理的用户
• 对服务器资源占用有要求的轻量级部署环境

详细使用方法和配置说明

标签说明

镜像提供两种版本标签格式：

• 最新版：latest（自动指向最新稳定版本）
• 特定版本：版本号（如 1.16.2，对应具体 Minecraft 版本）

示例：

• Bukkit: cmunroe/bukkit:latest、cmunroe/bukkit:1.16.2
• Spigot: cmunroe/spigot:latest、cmunroe/spigot:1.16.2
• PaperMC: cmunroe/papermc:latest、cmunroe/papermc:1.16.2

运行服务器

基础运行命令

通过以下命令启动服务器并自动接受 EULA，同时挂载主机目录实现数据持久化：

bash
# Bukkit
docker run -it -v ./data:/data -p 25565:25565 -e EULA=true --name mc_server cmunroe/bukkit

# Spigot
docker run -it -v ./data:/data -p 25565:25565 -e EULA=true --name mc_server cmunroe/spigot

# PaperMC
docker run -it -v ./data:/data -p 25565:25565 -e EULA=true --name mc_server cmunroe/papermc

后台运行

添加 -d 标志以后台模式运行（推荐生产环境使用）：

bash
docker run -d -it -v ./data:/data -p 25565:25565 -e EULA=true --name mc_server cmunroe/bukkit

注意事项

强烈建议保留 -it 标志，缺失这些标志可能导致服务器 CPU 占用率异常升高（100%），该问题正在修复中。

配置说明

数据持久化

通过 -v 参数挂载主机目录到容器 /data 目录，确保服务器数据（地图、配置、插件等）持久化存储：

bash
docker run -it -v /path/on/host:/data ...

环境变量配置

可通过环境变量直接设置 server.properties 参数，无需手动编辑文件。容器仅在 /data/server.properties 不存在时生成配置文件；若需强制重新生成，需设置 FORCE_CONFIG=true。

示例：

bash
docker run -e DIFFICULTY=2 -e MOTD="自定义服务器消息" -e SPAWN_ANIMALS=false cmunroe/bukkit

Java 内存配置

通过以下环境变量控制 JVM 内存参数（对应 -Xms 和 -Xmx）：

• InitRAM：初始内存，默认 1g
• MaxRAM：最大内存，默认 2g

示例（调整为 2G 初始内存和 4G 最大内存）：

bash
docker run -e InitRAM=2g -e MaxRAM=4g ...

建议：根据玩家数量和插件需求调整内存，参考 Minecraft 服务器需求文档。

环境变量文件

若需传递大量环境变量，建议使用环境变量文件（--env-file）：

1. 创建环境变量文件（如 env.list）：

ini
# env.list
ALLOW_NETHER=false
level-seed=123456789
EULA=true
InitRAM=2g
MaxRAM=4g

2. 使用文件启动容器：

bash
docker run -d -it --env-file env.list -v $(pwd)/data:/data -p 25565:25565 cmunroe/bukkit

环境变量列表

以下是 server.properties 配置项对应的环境变量及默认值：

Docker Compose 配置

使用 docker-compose.yml 简化部署：

yaml
version: '3'
services:
  minecraft:
    stdin_open: true  # 对应 -i
    tty: true         # 对应 -t
    restart: always
    env_file:
      - env.list      # 环境变量文件路径
    volumes:
      - ./data:/data  # 数据持久化目录
    ports:
      - '25565:25565' # Minecraft 服务端口
    image: cmunroe/bukkit  # 或 cmunroe/spigot、cmunroe/papermc
    container_name: minecraft_server

启动命令：docker-compose up -d

致谢

本镜像基于 https://github.com/bbriggs/docker-bukkit 项目开发，由 Cameron Munroe 现代化改造以支持 GitLab CI/CD。