05jchambers/legendary-java-minecraft-paper

Paper Minecraft Java服务器Docker容器，具备自动备份、日志记录和多架构支持，可快速部署高性能Minecraft服务器，兼容Paper/Spigot/Bukkit插件，支持 Raspberry Pi 等平台。

2 收藏0 次下载active05jchambers镜像

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

中文简介版本下载

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

Legendary Minecraft Java Paper容器 - Docker版Minecraft Java版Paper专用服务器

!Legendary Minecraft Java容器

这是我的Linux/Raspberry Pi版Minecraft Java Paper专用服务器脚本的Docker容器化版本。

主博客文章（支持最佳来源）
***GitHub仓库
***Docker Hub仓库

基岩版Docker容器在此处可用。本容器适用于Java版Minecraft。

特性

几分钟内即可搭建完全可运行的Minecraft服务器
运行高效的"Paper" Minecraft服务器
使用命名Docker卷安全且易于访问地存储服务器数据文件（支持自动卷备份等高级Docker功能）
支持Paper + Spigot + Bukkit插件
安装并配置OpenJDK 18
服务器重启时自动备份至minecraft/backups目录
服务器启动时自动更新至最新版本
支持所有Docker平台，包括Raspberry Pi

用法

首先必须创建命名Docker卷，命令如下：

bash
docker volume create yourvolumename

然后可使用以下Docker启动命令之一启动服务器并开放必要端口：

默认端口

bash
docker run -it -v yourvolumename:/minecraft -p 25565:25565 --restart unless-stopped 05jchambers/legendary-java-minecraft-paper:latest

自定义端口

bash
docker run -it -v yourvolumename:/minecraft -p ***:*** -e Port=*** --restart unless-stopped 05jchambers/legendary-java-minecraft-paper:latest

自定义Minecraft版本（添加-e Version=1.X.X，需Paper API服务器存在该版本）

bash
docker run -it -v yourvolumename:/minecraft -p 25565:25565 -e Version=1.17.1 --restart unless-stopped 05jchambers/legendary-java-minecraft-paper:latest

最大内存限制（可选，防止内存有限平台崩溃，-e MaxMemory=2048）

bash
docker run -it -v yourvolumename:/minecraft -p 25565:25565 -e MaxMemory=2048 --restart unless-stopped 05jchambers/legendary-java-minecraft-paper:latest

使用不同时区

bash
docker run -it -v yourvolumename:/minecraft -p 25565:25565 -e TZ="America/Denver" --restart unless-stopped 05jchambers/legendary-java-minecraft-paper:latest

跳过特定文件夹备份（多个路径用逗号分隔）

bash
docker run -it -v yourvolumename:/minecraft -p 25565:25565 -e NoBackup="plugins/ftp,plugins/test" --restart unless-stopped 05jchambers/legendary-java-minecraft-paper:latest

跳过权限检查

bash
docker run -it -v yourvolumename:/minecraft -p 25565:25565 -e NoPermCheck="Y" --restart unless-stopped 05jchambers/legendary-java-minecraft-paper:latest

配置 / 访问服务器文件

服务器数据存储在Docker卷中，通常是主机OS上的共享挂载文件夹。可通过以下命令查找确切路径：

bash
docker volume inspect yourvolumename

输出将包含卷的完整路径，如下所示：

json
{
    "CreatedAt": "2022-05-09T21:08:34-06:00",
    "Driver": "local",
    "Labels": {},
    "Mountpoint": "/var/lib/docker/volumes/yourvolumename/_data",
    "Name": "yourvolumename",
    "Options": {},
    "Scope": "local"
}

Linux通常路径：/var/lib/docker/volumes/yourvolumename/_data
Windows通常路径：C:\ProgramData\DockerDesktop，使用WSL时可能为\wsl$\docker-desktop-data\version-pack-data\community\docker\volumes\

Mac通常路径：~/Library/Containers/com.docker.docker/Data/vms/0/
Mac上使用Docker Desktop需先通过以下命令访问Docker VM：

bash
screen ~/Library/Containers/com.docker.docker/Data/com.docker.driver.amd64-linux/tty

然后使用docker volume inspect获取的路径访问Docker卷。

大多数用户需要编辑server.properties文件，修改后重启容器即可生效。备份文件存储在"backups"文件夹中。

插件

这是"Paper" Minecraft服务器，支持Paper/Spigot/Bukkit插件。

安装简单：Docker命名卷中有"plugins"文件夹。在主机OS上导航到服务器文件（如不清楚位置，参见访问服务器文件部分），将插件的.jar文件放入"plugins"文件夹，重启容器即可。

部分插件有依赖项，请先阅读插件安装指南。获取插件的常用网站：[***]

TZ（时区）环境变量

可通过该环境变量将默认时区"America/Denver"更改为自定义时区：

bash
docker run -it -v yourvolumename:/minecraft -e TZ="America/Denver" -p 25565:25565 05jchambers/legendary-java-minecraft-paper:latest

Linux时区列表

BackupCount环境变量

默认服务器保留10个滚动备份（每次容器重启时生成），可通过BackupCount环境变量覆盖：

bash
docker run -it -v yourvolumename:/minecraft -e BackupCount=20 -p 25565:25565 05jchambers/legendary-java-minecraft-paper:latest

QuietCurl环境变量

使用该变量可抑制curl的下载输出，保持日志整洁，但可能难以诊断问题。运行正常时启用，需要调试时禁用：

bash
docker run -it -v yourvolumename:/minecraft -p 25565:25565 -p ***:***/udp -p ***:*** -e QuietCurl=Y 05jchambers/legendary-java-minecraft-paper:latest

故障排除说明 - Oracle虚拟机

Oracle虚拟机常见问题是端口配置复杂，导致无法连接。需完成以下两步：

在虚拟云网络（VCN）安全列表中设置入站端口（TCP/UDP）
在分配给实例的网络安全组中设置入站端口

这是配置问题，与脚本或Minecraft服务器本身无关。不推荐此平台，但配置后使用体验良好。相关链接：

[***]
[***]
[***]
[***]

故障排除说明 - Hyper-V

Hyper-V存在破坏Minecraft服务器UDP连接的问题，有两种修复方法：最简单的是使用第1代VM和Legacy LAN网络驱动。相关链接：

[***]
[***]

第二种修复方法由bpsimons分享：先安装ethtool（sudo apt install ethtool），然后在/etc/network/interfaces文件底部添加"offload-tx off"（问题与TX卸载有关）。示例：

bash
# 主网络接口
auto eth0
iface eth0 inet static
address 192.168.1.5
netmask 255.255.255.0
network 192.168.1.0
broadcast 192.168.1.255
gateway 192.168.1.1
offload-tx off

也可通过以下ethtool命令非持久化设置：

bash
ethtool -K eth0 tx off

更新历史

2025年7月26日
- 更新构建流程以使用buildx进行多架构构建
2025年7月24日
- 默认版本更新至1.21.8（注意，无需等待更新即可更改Minecraft版本，只需使用-e Version=1.21.8）
2025年2月8日
- 默认版本更新至1.21.4（注意，无需等待更新即可更改Minecraft版本，只需使用-e Version=1.21.4）
- 再次修复Paper API URL
2024年12月1日
- 容器不再以root用户运行服务器，而是创建名为"minecraft"的用户
- 默认版本更新至1.21.3（注意，无需等待更新即可更改Minecraft版本，只需使用-e Version=1.21.3）
2024年6月29日
- 默认版本更新至1.21（注意，无需等待更新即可更改Minecraft版本，只需使用-e Version=1.21）
2024年5月19日
- 默认版本更新至1.20.6（注意，无需等待更新即可更改Minecraft版本，只需使用-e Version=1.20.6）
- OpenJDK版本更新至21
2023年12月13日
- 默认版本更新至1.20.4（注意，无需等待更新即可更改Minecraft版本，只需使用-e Version=1.20.4）
2023年9月30日
- 默认版本更新至1.20.2（注意，无需等待更新即可更改Minecraft版本，只需使用-e Version=1.20.2）
2023年6月9日
- 默认版本更新至1.20（注意，无需等待更新即可更改Minecraft版本，只需使用-e Version=1..20）
2023年3月25日
- 将paper.yml迁移至paper-global.yml
2023年3月16日
- 更新至1.19.4（升级前请确保从backups文件夹安全保存备份，因为备份会滚动更新）
2023年1月25日
- 移除终端检查，让Minecraft服务器在环境不合适时抛出错误
2023年1月14日
- 将连接测试从google.com更改为papermc.io，以避免在某些国家被屏蔽
2023年1月12日
- 移除损坏的ScheduleRestart环境变量——需在OS中使用docker restart（通常在Linux中使用crontab，Windows中使用任务计划程序）
2022年12月7日
- 更新至1.19.3
2022年11月19日
- 添加"QuietCurl"环境变量，可抑制curl进度条，使日志更整洁
- 移除fixpermissions.sh，在主start.sh文件中添加3行代码
2022年11月7日
- 如无交互式终端则立即失败（因为Minecraft服务器无终端无法运行）
2022年10月30日
- 添加RISC架构支持
- 从ubuntu:latest切换到ubuntu:rolling
- 从Adoptium切换到ubuntu:rolling OpenJDK
- 移除SetupMinecraft.sh
- 修复新ScheduleRestart环境变量的bug
2022年10月21日
- 添加新环境变量"BackupCount"以控制容器保留的备份数量
- NoBackup可选环境变量现在可接受多个路径，用逗号分隔。例如：plugins/test,plugins/test2
2022年10月20日
- 添加新环境变量"NoBackup"以跳过备份特定文件夹
- 添加新环境变量"NoPermCheck"以跳过启动时的权限检查
- 添加新环境变量"ScheduleRestart"——安排容器在特定时间关闭，结合--restart开关实现每日重启功能
2022年10月8日
- 升级至OpenJDK 19
2022年9月27日
- 通过使用"exec"命令运行java来修复某些情况下的SIGTERM捕获（将执行完全传递给该进程，感谢vp-en）
- 移除screen应用
2022年9月20日
- 更新至OpenJDK 18.0.2.1
2022年8月29日
- 添加TZ环境变量以设置时区
- 将环境变量添加到docker-compose.yml模板
2022年8月22日
- 添加NoScreen环境变量——禁用screen，无需交互式终端（但会禁用部分日志）
2022年8月17日
- 在java启动行添加XX:-UseAESCTRIntrinsics，以防止10代Intel处理器上的加密问题
2022年8月10日
- 调整server.properties中的query.port与主服务器端口相同，以保持"ping端口"正常工作
- 在默认server.properties中添加enforce-secure-profile=false以防止登录错误
- 在容器内添加文本编辑器（nano）用于诊断/故障排除
2022年8月6日
- 更新至1.19.2
2022年7月31日
- 将Adoptium OpenJDK升级至18.0.2
2022年7月27日
- 更新至1.19.1
2022年7月13日
- 更新基础Ubuntu镜像
2022年6月27日
- 更新基础Ubuntu镜像
2022年6月15日
- 修复1.19 paperclip.jar升级问题
2022年6月11日
- 默认安装更新为Paper实验性1.19版本
- 升级前请确保从"backups"文件夹单独保存服务器备份
- 如1.19有问题，需恢复备份以返回1.18，因为添加1.19结构/数据后无法使用1.18服务器数据文件
2022年6月7日
- 添加docker-compose.yml文件供Docker Compose使用
2022年5月25日
- 更新文档（不再需要额外包，基础Docker安装即可）
2022年5月21日
- 添加多架构支持，为每个架构提供单独镜像