05jchambers/legendary-minecraft-purpur-geyser Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

传奇Java版Minecraft + Geyser + Floodgate + Purpur专用服务器Docker镜像

!Minecraft Geyser容器

镜像概述

这是基于Purpur服务端的Docker容器化Minecraft服务器，集成Geyser和Floodgate组件，允许Bedrock版玩家连接Java版服务器实现跨平台游戏。该镜像源自适用于Linux/Raspberry Pi的Minecraft Java版Paper服务器脚本，经过容器化改造并增强跨平台连接功能。

相关资源：

• 官方支持博客文章
• 带Floodgate和Geyser的Paper版本
• 不带Floodgate和Geyser的Paper版本
• GitHub仓库
• Docker Hub仓库
• Bedrock版Docker容器

核心功能与特性

• 支持Java和Bedrock客户端同时连接的完整Minecraft服务器环境
• 运行高效的Purpur服务端，兼容Purpur/Paper/Spigot/Bukkit插件生态
• 集成Geyser实现协议转换，Floodgate提供Bedrock账号验证机制
• 使用Docker命名卷存储服务器数据，支持自动备份和高级Docker管理功能
• 内置OpenJDK 18（后续更新至21）运行环境
• 服务器重启时自动创建数据备份，存储于backups目录
• 启动时自动更新至最新服务端版本
• 支持所有Docker平台及架构，包括ARM/Raspberry Pi

使用方法

前置准备：创建命名卷

首先创建用于存储服务器数据的Docker命名卷：

bash
docker volume create yourvolumename

启动命令示例

默认端口配置

bash
docker run -it -v yourvolumename:/minecraft -p 25565:25565 -p ***:***/udp -p ***:*** --restart unless-stopped 05jchambers/legendary-minecraft-purpur-geyser:latest

自定义端口配置

（示例：Java端口***，Bedrock端口54321）

bash
docker run -it -v yourvolumename:/minecraft -p ***:*** -e Port=*** -p 54321:54321/udp -p 54321:54321 -e BedrockPort=54321 --restart unless-stopped 05jchambers/legendary-minecraft-purpur-geyser:latest

指定Minecraft版本

（需Purpur API服务器支持的版本）

bash
docker run -it -v yourvolumename:/minecraft -p 25565:25565 -p ***:***/udp -p ***:*** -e Version=1.17.1 --restart unless-stopped 05jchambers/legendary-minecraft-purpur-geyser:latest

设置内存限制

（防止低内存平台崩溃，单位：MB）

bash
docker run -it -v yourvolumename:/minecraft -p 25565:25565 -p ***:***/udp -p ***:*** -e MaxMemory=2048 --restart unless-stopped 05jchambers/legendary-minecraft-purpur-geyser:latest

配置时区

bash
docker run -it -v yourvolumename:/minecraft -p 25565:25565 -p ***:***/udp -p ***:*** -e TZ="Asia/Shanghai" --restart unless-stopped 05jchambers/legendary-minecraft-purpur-geyser:latest

服务器配置与文件访问

定位服务器文件

通过以下命令获取卷的挂载路径：

bash
docker volume inspect yourvolumename

返回结果中的Mountpoint字段即为实际路径，例如：

json
{
    "Mountpoint": "/var/lib/docker/volumes/yourvolumename/_data"
}

各平台默认路径参考：

• Linux: /var/lib/docker/volumes/yourvolumename/_data
• Windows（WSL）: \\wsl$\docker-desktop-data\version-pack-data\community\docker\volumes\yourvolumename\_data
• Mac: 需先通过screen ~/Library/Containers/com.docker.docker/Data/com.docker.driver.amd64-linux/tty访问Docker VM，再使用上述挂载路径

主要配置文件

• 服务器核心配置：server.properties（修改后需重启容器）
• Geyser配置：plugins/Geyser-Spigot/config.yml
• Floodgate配置：plugins/floodgate/config.yml
• 备份文件：存储于backups目录

环境变量详解

时区设置可参考Linux时区列表

插件安装

Purpur服务端兼容Purpur/Paper/Spigot/Bukkit插件，安装步骤：

1. 下载插件JAR文件（推荐来源：Bukkit插件库）
2. 将JAR文件放入服务器文件的plugins目录
3. 重启容器使插件生效

注意：部分插件可能需要特定依赖，请参考插件安装说明。

常见问题解决

Oracle云虚拟机连接问题

若使用Oracle云虚拟机，需同时配置：

1. 虚拟云网络（VCN）安全列表中的入站规则（开放对应TCP/UDP端口）
2. 实例关联的网络安全组入站规则

Hyper-V UDP连接故障

Hyper-V环境下可能出现Bedrock连接问题，解决方案：

1. 使用第1代虚拟机并选择"Legacy LAN"网络适配器
2. 安装ethtool禁用TX卸载：

   bash
   sudo apt install ethtool
   ethtool -K eth0 tx off  # 临时生效
   

   或在/etc/network/interfaces中添加offload-tx off实现永久生效

更新历史摘要

• 2025年7月：支持多架构构建，默认版本更新至1.21.8
• 2024年12月：修复ViaVersion更新，服务器以非root用户运行
• 2024年5月：升级至OpenJDK 21，默认版本1.20.6
• 2023年3月：添加ViaVersion支持跨版本连接
• 2022年9月：初始发布版本