05jchambers/legendary-java-minecraft-paper

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

!Legendary Minecraft Java容器

这是我的https://github.com/TheRemote/RaspberryPiMinecraft%E7%9A%84Docker%E5%AE%B9%E5%99%A8%E5%8C%96%E7%89%88%E6%9C%AC%E3%80%82

主博客文章（支持最佳来源）
https://github.com/TheRemote/Legendary-Java-Minecraft-Paper
https://hub.docker.com/r/05jchambers/legendary-java-minecraft-paper

https://github.com/TheRemote/Legendary-Bedrock-Container%E3%80%82%E6%9C%AC%E5%AE%B9%E5%99%A8%E9%80%82%E7%94%A8%E4%BA%8EJava%E7%89%88Minecraft%E3%80%82

特性

• 几分钟内即可搭建完全可运行的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 12345:12345 -e Port=12345 --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 19132:19132/udp -p 19132:19132 -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日
  • 添加多架构支持，为每个架构提供单独镜像