daweedpanic/papermc

daweedpanic/papermc

镜像概述

daweedpanic/papermc是PaperMC的非官方Docker镜像，通过自动化CI任务构建。每当PaperMC官方网站发布新版本构建时，该镜像会在10分钟内完成构建并推送，确保用户能够快速获取最新版本。

核心功能与特性

• 自动化构建：通过CI任务自动监测官方版本发布，无需手动干预
• 快速更新：官方发布新版本后，镜像构建和推送的最大延迟仅为10分钟
• 标准兼容：遵循Docker最佳实践，提供稳定的运行环境
• 数据持久化：支持通过卷挂载实现配置、日志、插件和世界数据的持久化存储

使用场景

适用于需要部署和运行PaperMC Minecraft服务器的场景，包括但不限于：

• 个人或小型团队搭建Minecraft服务器
• 游戏服务器托管服务
• 需要频繁更新PaperMC版本的服务器管理员

使用方法

docker-compose配置示例

yml
version: '3.8'

services:
  minecraft:
    image: daweedpanic/papermc:1.16.5  # 指定PaperMC版本，如1.16.5
    container_name: mc_example  # 容器名称
    stdin_open: true  # 保持标准输入打开，支持与服务器交互
    tty: true  # 分配伪终端，支持控制台操作
    stop_grace_period: 1m  # 服务器关闭的宽限期，确保数据正确保存
    restart: always  # 容器退出时自动重启
    ports:
      - '25565:25565'  # 映射Minecraft默认端口
    volumes:
      - '/srv/minecraft/example/config:/server/config'  # 配置文件目录
      - '/srv/minecraft/example/logs:/server/logs'  # 日志文件目录
      - '/srv/minecraft/example/plugins:/server/plugins'  # 插件目录
      - '/srv/minecraft/example/worlds:/server/worlds'  # 游戏世界数据目录

配置说明

• 镜像版本：通过标签指定PaperMC版本，如:1.16.5
• 交互支持：stdin_open: true和tty: true确保可以通过docker attach与服务器控制台交互
• 关闭宽限期：stop_grace_period: 1m允许服务器在收到停止信号后有1分钟时间保存数据并安全关闭
• 端口映射：默认映射Minecraft服务器端口25565，可根据需要修改
• 数据持久化：通过卷挂载将关键目录映射到宿主机，避免容器重启导致数据丢失，包括：
  • config：服务器配置文件目录
  • logs：日志存储目录
  • plugins：插件存放目录
  • worlds：游戏世界数据目录