cmunroe/papermc

Bukkit、Spigot和PaperMC Docker镜像

基于Alpine构建的Bukkit、Spigot和PaperMC Minecraft服务器Docker镜像，支持多种版本，提供便捷的部署和配置方式。

镜像标签

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

提供两种版本风格：latest（最新版）和具体版本号。

示例：

• 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协议，只需在运行容器时传递EULA=true环境变量。建议将主机目录挂载到容器内的./data目录，以实现地图和服务器数据的持久化存储。

基本启动命令

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参数，否则服务器可能会占用100%的CPU资源。此问题正在解决中。

配置说明

数据持久化与现有配置

可通过-v选项将主机上的现有数据和配置目录挂载到容器的./data目录，实现配置复用：

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

环境变量配置

可通过环境变量传递配置参数，例如：

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

容器仅在server.properties文件不存在时才会尝试生成该文件。若需使用配置工具，请确保未提供现有配置文件，或设置FORCE_CONFIG=true强制生成。

Java内存设置

通过InitRAM和MaxRAM环境变量控制Java内存使用，分别对应-Xms和-Xmx参数，默认值为1g和2g。如需支持更多玩家和插件，建议增加这些值。更多信息参见Minecraft服务器需求。

环境变量文件

由于可能需要传递大量环境变量，建议使用环境变量文件：

示例：env.list

ALLOW_NETHER=false
level-seed=123456789
EULA=true

启动命令：

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

环境变量列表

Docker Compose配置

yaml
services:
  bukkit:
    stdin_open: true  # 保持标准输入打开
    restart: always  # 自动重启
    tty: true  # 分配伪终端
    env_file:
      - env.list  # 环境变量文件
    volumes:
      - './data:/data'  # 数据持久化
    ports:
      - '25565:25565'  # 映射端口
    image: cmunroe/bukkit  # 镜像名称
    container_name: minecraft  # 容器名称

鸣谢

本项目最初基于https://github.com/bbriggs/docker-bukkit%EF%BC%8C%E7%94%B1Cameron Munroe现代化以适配GitLab。