buddyspencer/papermc

Minecraft Paper服务器Docker镜像

镜像概述和主要用途

本Docker镜像用于快速部署和运行Minecraft Paper服务器，其核心特点是始终构建并使用最新版本的Paper（Minecraft的高性能服务端软件）。通过简单的配置即可实现服务器的启动、管理和数据持久化，适用于需要便捷更新和维护Minecraft服务器的场景。

核心功能和特性

• 自动更新Paper版本：Dockerfile始终构建并使用最新版本的Minecraft Paper服务端
• 多架构支持：提供AMD64和ARM64架构的容器镜像，适配不同硬件环境
• 内存配置灵活：通过环境变量MEMORYSIZE可自定义服务器内存大小
• 数据持久化：支持通过卷挂载/data目录，确保服务器数据（如世界、配置文件）持久保存
• 交互式管理：支持交互式运行模式，可直接连接容器进行服务器命令操作

使用场景和适用范围

• 个人Minecraft服务器快速部署
• 小型游戏社区的Paper服务器搭建
• 需要频繁更新Paper版本的服务器管理员
• 在AMD64或ARM64架构设备（如PC、树莓派等）上部署Minecraft服务器

使用方法和配置说明

前提条件

• 已安装Docker引擎（支持AMD64或ARM64架构）
• 具备基本Docker命令操作能力

镜像拉取

通过以下命令拉取最新版本镜像：

sh
docker pull buddyspencer/papermc

启动服务器容器

使用以下命令启动Minecraft Paper服务器容器：

sh
docker run \
  --rm \  # 容器停止后自动删除
  --name mc \  # 容器名称设为"mc"
  -e MEMORYSIZE='1G' \  # 设置服务器内存大小（示例为1GB）
  -v /path/to/volume:/data:rw \  # 本地目录挂载到容器/data目录（数据持久化）
  -p 25565:25565 \  # 映射Minecraft默认端口（25565）
  -i buddyspencer/papermc:latest  # 交互式运行镜像

参数说明

• --rm：容器停止后自动清理，避免残留容器文件
• --name mc：自定义容器名称，便于管理
• -e MEMORYSIZE='1G'：环境变量，设置服务器可用内存，可根据需求调整（如2G、512M等）
• -v /path/to/volume:/data:rw：本地目录/path/to/volume（需替换为实际路径）挂载到容器/data目录，用于持久化服务器数据（世界文件、插件、配置等）
• -p 25565:25565：端口映射，将容器内25565端口（Minecraft默认端口）映射到主机相同端口，确保客户端可连接
• -i：交互式模式，允许后续通过docker attach连接容器进行服务器命令操作

连接服务器容器

启动容器后，通过以下命令连接到容器，进行服务器管理（如输入命令、查看日志等）：

sh
docker attach mc

提示：若需退出容器但不停止服务器，可使用Ctrl+P+Q组合键 detach 容器。

参考链接

• GitHub项目地址：https://github.com/cooperspencer/paper-docker