parzivalspace/papermc

PaperMC Docker镜像

镜像概述和主要用途

本镜像为特定版本的PaperMC Minecraft服务器提供自动化Docker构建。当有新的PaperMC版本发布时，每日会自动生成新镜像。PaperMC是一款优化的Minecraft服务器，支持多种插件（如Bukkit、Spigot、Sponge等）。本镜像提供基础的PaperMC服务器环境，所有自定义配置需用户自行完成。

核心功能和特性

• 自动化构建：针对每个PaperMC版本自动构建Docker镜像
• 每日更新：若有新的PaperMC版本发布，每日生成更新镜像
• 插件支持：兼容Bukkit、Spigot、Sponge等主流Minecraft插件生态
• 简化部署：无需手动管理Java环境，通过Docker快速启动服务器
• 灵活自定义：基础服务器配置，允许用户根据需求调整参数

使用场景和适用范围

适用于需要搭建Minecraft服务器的个人或团队，尤其适合：

• 希望避免管理多个Java版本的服务器管理员
• 需要将Minecraft服务器整合到其他Minecraft相关项目的开发者
• 追求快速部署和版本更新的小型服务器场景

使用方法和配置说明

前提条件

需先安装Docker环境，若未安装，请先完成Docker部署后再使用。

快速设置

通过以下命令可一键创建PaperMC服务器，运行时会自动接受Minecraft EULA。

bash
# 使用Docker Hub
docker run -it -p 25565:25565/tcp -v -/server:/server parzivalspace/papermc:1.20.2

# 使用GitHub Container Registry
docker run -it -p 25565:25565/tcp -v -/server:/server ghcr.io/parzival-space/papermc:1.20.2

上述命令将启动基于最新PaperMC构建的1.20.2版本服务器，满足大多数基础使用场景。如需进一步定制，可通过以下选项调整。

常用配置选项

Docker提供多种命令行参数用于自定义镜像行为，以下是常用选项说明：

端口转发

用于将容器内端口映射到主机，使服务器可被外部访问：

• -p <主机端口>:25565/tcp：映射游戏端口到主机指定端口
• -p <主机端口>:25575/tcp：映射RCON管理端口到主机指定端口

数据卷挂载

通过目录映射实现服务器数据持久化：

• -v <主机目录>:/server：将容器内/server目录（存储游戏数据）映射到主机指定目录

运行模式

• -d：后台运行容器（替代screen命令）
• -it：交互式会话模式（用于访问服务器控制台）

容器管理

• --restart on-failure：配置重启策略，服务器崩溃时自动重启
• --name <容器名称>：为容器命名，便于后续管理（如--name my-papermc-server）

环境变量配置

通过环境变量可进一步调整Java运行参数和服务器启动参数，支持以下变量：

JAVA_ARGS

直接传递给Java运行时的参数，用于配置内存等资源：

bash
-e JAVA_ARGS="-Xms=4G -Xmx=4G"  # 设置Java初始堆内存4G，最大堆内存4G

SERVER_ARGS

传递给PaperMC服务器的启动参数，使用--help可查看完整参数列表：

bash
-e SERVER_ARGS="--help"  # 显示PaperMC服务器帮助信息

相关链接

• Docker Hub镜像：https://hub.docker.com/r/parzivalspace/papermc
• GitHub容器 registry：https://github.com/parzival-space/papermc-docker/pkgs/container/papermc
• 源码仓库：https://github.com/parzival-space/papermc-docker

许可证

本项目基于GNU GPL v3.0许可证分发，详情参见LICENSE文件。