phyremaster/papermc

PaperMC Docker镜像

镜像概述和主要用途

该镜像为PaperMC Minecraft服务器提供Linux环境。PaperMC是一款优化的Minecraft服务器，支持Bukkit、Spigot、Sponge等插件。本镜像提供基础的PaperMC服务器功能，所有自定义配置需由用户完成。

核心功能和特性

• 基于PaperMC构建，提供高性能、优化的Minecraft服务端
• 原生支持多种插件系统（Bukkit、Spigot、Sponge等）
• 支持通过环境变量灵活配置服务器参数
• 支持数据持久化存储（通过Docker卷或本地目录挂载）
• 可自定义服务器端口、内存分配及Java运行参数

使用场景和适用范围

适用于需要快速部署Minecraft服务器的用户，包括个人玩家、小型社区服务器管理员。尤其适合希望通过Docker简化部署流程、灵活管理服务器配置的用户。

使用方法和配置说明

前提条件

需已安装Docker环境。如未安装，请先完成Docker安装后再进行操作。

基本启动命令

通过以下命令可快速创建PaperMC服务器（运行此命令即表示同意Minecraft EULA）：

bash
sudo docker run -p 25565:25565 -e EULA="true" phyremaster/papermc

此命令为最基础启动方式，可通过添加更多选项优化服务器配置。

命令行选项

以下为常用命令行选项，用户可根据需求添加：

端口映射（必须指定）

• 设置服务器访问端口，默认使用25565
• 如需使用RCON，需额外映射25575端口
• 示例：

  bash
  -p <12345>:25565  # 映射主端口
  -p <12345>:25565 -p <6789>:25575  # 同时映射主端口和RCON端口
  

数据卷挂载

• 设置服务器数据存储位置，默认为随机生成的Docker卷
• 可指定卷名或本地目录路径
• 示例：

  bash
  -v <my_volume_name>:/papermc  # 使用命名卷
  -v </path/to/local/folder>:/papermc  # 使用本地目录
  

后台运行

• 添加-d参数使容器在后台独立运行
• 示例：-d

终端访问

• 添加-t和-i参数（可合并为-ti或-it），允许通过docker attach访问服务器控制台
• 示例：-it 或 -ti

重启策略

• 设置容器崩溃后的自动重启策略，从服务器控制台停止不会触发重启
• 推荐使用on-failure策略
• 示例：--restart on-failure

容器命名

• 为容器指定名称，默认为随机生成的名称
• 示例：--name "<my-container-name>"

环境变量

通过-e <NAME>="<VALUE>"格式设置环境变量，未设置值将导致空字符串，可能引发问题。支持以下环境变量：

Minecraft版本

• 名称：MC_VERSION
• 作用：指定服务器支持的Minecraft版本
• 注意：必须存在对应版本的PaperMC发布
• 默认：使用PaperMC支持的最新版本
• 说明：在现有服务器上修改会更改版本但不清除数据
• 示例：-e MC_VERSION="<latest>"

PaperMC构建版本

• 名称：PAPER_BUILD
• 作用：指定使用的PaperMC构建编号（非Minecraft版本）
• 默认：使用指定MC_VERSION对应的最新构建
• 说明：在现有服务器上修改会更改构建版本但不清除数据
• 示例：-e PAPER_BUILD="<latest>"

EULA同意

• 名称：EULA
• 作用：设置为true表示接受Minecraft服务器EULA
• 注意：未设置为true时服务器无法启动
• 示例：-e EULA="true"

内存分配

• 名称：MC_RAM
• 作用：指定服务器可使用的RAM量
• 格式：数字加单位（M表示兆字节，G表示千兆字节）
• 默认：Java根据系统/容器总RAM自动分配
• 示例：-e MC_RAM="4G"

Java选项（高级用户）

• 名称：JAVA_OPTS
• 作用：添加额外的Java命令行选项
• 默认：空字符串
• 示例：-e JAVA_OPTS="-XX:+UseConcMarkSweepGC -XX:+UseParNewGC"

进一步配置

服务器配置与其他Minecraft服务器相同，配置文件（如server.properties）位于指定的卷或本地目录中。根据网络环境可能需要配置端口转发，具体方法与常规Minecraft服务器一致。

技术说明

本项目不重新分发Minecraft服务器文件，镜像中的papermc.sh脚本会在安装过程中从官方源下载所需文件。

注意：这是非官方项目，不隶属于PaperMC。PaperMC官方网站

项目页面

• https://github.com/Phyremaster/papermc-docker
• https://hub.docker.com/r/phyremaster/papermc