thibauddemay/papermc

PaperMC Docker镜像

镜像概述和主要用途

这是一组用于运行PaperMC Minecraft服务器的Docker镜像。基于Amazon Corretto构建（符合官方PaperMC文档推荐），包含从官方PaperMC构建服务器下载的特定版本PaperMC服务器。镜像通过本仓库的Dockerfile构建，并推送到Docker Hub的thibauddemay/papermc命名空间。

核心功能和特性

• 基于Amazon Corretto运行时，符合官方推荐配置
• 支持多级语义化版本标签，便于版本管理（latest、X.y系列、X.y.z特定版本）
• 暴露25565端口，支持Minecraft客户端连接
• 通过环境变量控制EULA接受状态，无需手动修改文件
• 支持数据卷挂载，实现服务器配置和世界数据的持久化存储与自定义

使用场景和适用范围

适用于需要快速部署和管理PaperMC Minecraft服务器的场景，包括：

• 个人或小型团队搭建Minecraft服务器
• 需要版本控制和快速更新的服务器环境
• 希望通过容器化简化部署和迁移的用户
• 需要持久化存储服务器配置、插件和世界数据的场景

支持的标签

每个镜像均以其包含的PaperMC服务器版本作为标签，同时提供基于主版本号和次版本号的分组版本标签（X.y）以及始终指向最新版本的latest标签。

使用方法

您可以使用docker-compose或docker cli创建并运行容器。容器暴露25565端口用于PaperMC服务器连接，需通过设置EULA环境变量为true来接受EULA协议。通过挂载/app/data卷，可以自定义服务器配置并访问服务器数据（如修改配置文件、添加插件等）。

Docker Compose

yaml
---
services:
  papermc-server:
    image: thibauddemay/papermc:latest  # 使用最新版本镜像
    restart: unless-stopped  # 除非手动停止，否则自动重启
    ports:
      - "25565:25565"  # 映射容器25565端口到主机
    environment:
      EULA: "true"  # 接受Minecraft EULA协议
    volumes:
      - /path/to/papermc-data:/app/data  # 挂载数据卷，持久化存储服务器数据

Docker CLI

bash
docker run -d \
  --name papermc-server \  # 容器名称
  -p 25565:25565 \  # 端口映射
  -e EULA="true" \  # 接受EULA协议
  -v /path/to/papermc-data:/app/data \  # 挂载数据卷
  --restart unless-stopped \  # 重启策略
  thibauddemay/papermc:latest  # 使用的镜像

配置参数说明

环境变量