djaytan/papermc-server

Docker PaperMC服务器

!兼容性 ![质量门状态]([] ![OpenSSF最佳实践]([] ![OpenSSF评分卡]([***]

一款通用型、符合OCI标准的PaperMC服务器，提供精简且细粒度的自定义选项。

💻 演示（20秒）

点击这里。

📘 使用方法

如需快速启动，可运行以下命令：

bash
$ docker run -d -it \
    --name papermc-server \
    --restart=always \
    -p 25565:25565 \
    -e EULA=true \
    'djaytan/papermc-server:latest'

📜 将EULA环境变量设置为true即表示您已阅读并接受Minecraft最终用户许可协议。

🔰 有关运行服务器的详细说明，包括配置选项和最佳实践，请查看https://djaytan.github.io/docker-papermc-server/%E3%80%82

✨ 核心亮点

• 🏔️ 基于Alpine的镜像 – 构建于https://hub.docker.com/_/alpine%E5%9F%BA%E7%A1%80%E9%95%9C%E5%83%8F
• 🪶 轻量级 – 约125 MB
• 🧘 极简设计 – 仅包含必要依赖，以减小镜像大小和***面
• 🧩 高度可定制 – 提供精简且细粒度的配置选项
• 📚 文档完善 – 全面且结构化的文档，涵盖功能、配置和使用方法（https://djaytan.github.io/docker-papermc-server/%EF%BC%89
• 👤 UID无关性 – 支持使用自定义/任意UID运行服务器（通常在OpenShift中运行容器时需要）
• 🔐 默认无root权限 – 未指定自定义UID时以非root用户运行
• 🧬 多架构支持 – 为linux/amd64和linux/arm64构建（可根据需求提供其他操作系统/架构版本）
• ☕ JRE 21 – 基于https://hub.docker.com/_/eclipse-temurin
  • 使用jlink自定义构建以最小化体积
  • 包含标准Java模块，确保广泛的插件兼容性
• 🩺 健康检查集成 – 通过持续监控服务器健康状态增强弹性和高可用性
• 🔍 频繁质量与安全扫描 – 由SonarQube Cloud和Docker Scout提供支持
• 🔄 定期自动更新 – 每两个月重建以整合上游安全补丁和新的PaperMC构建，其他更新通过Renovate进行跟踪和半自动化管理
• ☸️ Helm Chart – 使用https://github.com/Djaytan/helm-papermc-server%E8%BD%BB%E6%9D%BE%E9%83%A8%E7%BD%B2%E5%88%B0Kubernetes

其他计划功能列表可在https://github.com/Djaytan/docker-papermc-server/blob/main/docs/planned-features.md%E6%9F%A5%E7%9C%8B%E3%80%82

🌍 贡献指南

如您希望帮助改进本项目，可在https://github.com/Djaytan/docker-papermc-server/blob/main/docs/CONTRIBUTING.md%E4%BA%86%E8%A7%A3%E6%9B%B4%E5%A4%9A%E8%B4%A1%E7%8C%AE%E6%96%B9%E5%BC%8F%E3%80%82

有功能需求？欢迎https://github.com/Djaytan/docker-papermc-server/issues%EF%BC%81

🏷️ 版本控制

本项目遵循语义化版本控制。

Docker标签格式为<mc-version>-v<image-version>-<timestamp-YYYYMMDD>（例如1.21.4-v1.2.1-20250406）。

🔒 安全政策

如您发现安全漏洞，请查阅我们的https://github.com/Djaytan/docker-papermc-server/blob/main/docs/SECURITY.md%E3%80%82

📄 许可证

本项目继承了所包含上游项目的许可。因此，它基于GNU GPL v3.0许可证授权，该许可证继承自PaperMC，而PaperMC又继承自原始的Bukkit和CraftBukkit项目。

分发的OCI镜像基于https://hub.docker.com/_/alpine%E6%9E%84%E5%BB%BA%E3%80%82%E4%B8%8E%E6%89%80%E6%9C%89Docker%E9%95%9C%E5%83%8F%E4%B8%80%E6%A0%B7%EF%BC%8C%E5%85%B6%E4%B8%AD%E5%8F%AF%E8%83%BD%E5%8C%85%E5%90%AB%E5%85%B6%E4%BB%96%E5%8F%97%E4%B8%8D%E5%90%8C%E8%AE%B8%E5%8F%AF%E8%AF%81%E7%BA%A6%E6%9D%9F%E7%9A%84%E8%BD%AF%E4%BB%B6%E3%80%82Alpine%E8%BD%AF%E4%BB%B6%E5%8C%85%E7%9A%84%E8%AF%A6%E7%BB%86%E4%BF%A1%E6%81%AF%E5%8F%AF%E5%9C%A8%E6%AD%A4%E5%A4%84%E6%9F%A5%E7%9C%8B%E3%80%82

对于任何预构建镜像的使用，镜像用户有责任确保对本镜像的任何使用均符合其中包含的所有软件的相关许可要求。