cmunroe/bukkit

Bukkit、Spigot和PaperMC Docker镜像

镜像概述和主要用途

基于Alpine Linux构建的Docker镜像，用于快速部署Bukkit、Spigot和PaperMC Minecraft服务器。支持数据持久化存储、通过环境变量配置服务器参数，并提供多种版本标签选择，适用于个人或小型团队快速搭建Minecraft服务器环境。

核心功能和特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 多服务器类型：支持Bukkit、Spigot和PaperMC三种主流Minecraft服务器类型
• 版本灵活性：提供latest（最新版）和具体版本号（如1.16.2）两种标签选择
• 数据持久化：通过挂载主机目录到容器/data目录，实现地图和服务器数据持久化
• 环境变量配置：支持通过环境变量自定义server.properties参数，无需手动编辑配置文件
• Java内存控制：可通过InitRAM和MaxRAM环境变量调整JVM内存分配

标签信息

镜像提供以下标签风格，可在Docker Hub查看完整标签列表：

• Bukkit：cmunroe/bukkit:latest、cmunroe/bukkit:1.16.2（https://hub.docker.com/r/cmunroe/bukkit/tags%EF%BC%89
• Spigot：cmunroe/spigot:latest、cmunroe/spigot:1.16.2（https://hub.docker.com/r/cmunroe/spigot/tags%EF%BC%89
• PaperMC：cmunroe/papermc:latest、cmunroe/papermc:1.16.2（https://hub.docker.com/r/cmunroe/papermc/tags%EF%BC%89

运行服务器

基本启动命令

启动服务器并接受EULA协议（需传递EULA=true环境变量），建议挂载数据目录以实现持久化：

bash
# 运行Bukkit服务器
docker run -it -v ./data:/data -p 25565:25565 -e EULA=true --name mc_server docker.xuanyuan.run/cmunroe/bukkit

# 运行Spigot服务器
docker run -it -v ./data:/data -p 25565:25565 -e EULA=true --name mc_server docker.xuanyuan.run/cmunroe/spigot

# 运行PaperMC服务器
docker run -it -v ./data:/data -p 25565:25565 -e EULA=true --name mc_server docker.xuanyuan.run/cmunroe/papermc

后台运行

如需后台运行，添加-d标志（推荐生产环境使用）：

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

注意：目前强烈推荐使用-it标志，否则服务器可能会出现100% CPU占用问题，该问题正在修复中。

配置说明

数据持久化与自定义配置

可挂载现有数据目录到容器/data目录，实现自定义配置：

bash
docker run -it -v /path/to/your/data:/data -e EULA=true docker.xuanyuan.run/cmunroe/bukkit

支持通过环境变量直接配置服务器参数，例如：

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

说明：容器仅在server.properties文件不存在时自动生成该文件。如需强制重新生成，可删除现有文件或设置FORCE_CONFIG=true环境变量。

Java内存控制

通过InitRAM和MaxRAM环境变量控制JVM内存分配（分别对应-Xms和-Xmx参数），默认值为1g和2g。如需支持更多玩家或插件，建议增加这些值：

bash
docker run -e InitRAM=2g -e MaxRAM=4g -e EULA=true docker.xuanyuan.run/cmunroe/bukkit

更多内存配置建议参考Minecraft服务器需求文档。

环境变量文件

对于大量配置项，建议使用环境变量文件（如env.list）：

# env.list示例
ALLOW_NETHER=false
level-seed=123456789
EULA=true
MOTD="我的Docker Minecraft服务器"

使用环境变量文件启动容器：

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

环境变量列表

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

Docker Compose配置

yaml
services:
  bukkit:
    stdin_open: true  # 保持标准输入打开
    restart: always   # 容器退出时自动重启
    tty: true         # 分配伪终端
    env_file:
      - env.list       # 从环境变量文件加载配置
    volumes:
      - './data:/data'  # 挂载数据目录
    ports:
      - '25565:25565'  # 映射服务器端口
    image: docker.xuanyuan.run/cmunroe/bukkit
    container_name: minecraft  # 容器名称

致谢

本镜像最初基于https://github.com/bbriggs/docker-bukkit%E5%BC%80%E5%8F%91%EF%BC%8C%E7%94%B1Cameron Munroe进行现代化改造以支持GitLab。