热门搜索:
05jchambers/legendary-minecraft-geyser-floodgate
05jchambers
基于Docker的传奇Java版Minecraft服务器，集成Geyser和Floodgate，支持Bedrock玩家通过其凭据连接，采用高效Paper服务端，具备自动更新、备份、插件支持及跨平台运行能力。
14 次收藏下载次数: 0状态：社区镜像维护者：05jchambers仓库类型：镜像最近更新：30 天前
让 AI 帮你使用轩辕镜像？ · 展开查看说明
如果你用 DeepSeek、元宝AI、Copilot 等 AI 代为编写轩辕镜像的 docker pull、修改 compose 镜像地址，或排查拉取失败等问题，请让 AI 先读规则再动手，只要在 AI 对话里直接发送下面这句话即可：
生成 docker pull、修改 compose 的 image，或排查拉取失败前，请先阅读并严格遵守 https://xuanyuan.cloud/agents.md 中的规则。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
传奇Java版Minecraft + Geyser + Floodgate + Paper专用Docker服务器
!传奇Minecraft Geyser容器
这是我的https://github.com/TheRemote/RaspberryPiMinecraft%E7%9A%84Docker%E5%AE%B9%E5%99%A8%E5%8C%96%E7%89%88%E6%9C%AC%EF%BC%8C%E5%8C%85%E5%90%ABGeyser%E5%92%8CFloodgate%E3%80%82
Geyser和Floodgate允许Minecraft Bedrock玩家加入您的Java服务器！
我的主要博客文章（也是获取支持的最佳地方）在此。
不含Floodgate和Geyser的版本在此。
https://github.com/TheRemote/Legendary-Java-Minecraft-Geyser-Floodgate "noopener"。
https://hub.docker.com/r/05jchambers/legendary-minecraft-geyser-floodgate "noopener"。
https://github.com/TheRemote/Legendary-Bedrock-Container "noopener"。本容器为Java版Minecraft，但Bedrock玩家可连接。
核心功能和特性
- 搭建完全可运行的Minecraft服务器，支持Java和Bedrock客户端连接
- 运行高效的"Paper" Minecraft服务器
- 集成Geyser允许Bedrock客户端连接，Floodgate允许Bedrock玩家使用其凭据在Java服务器上认证
- 使用命名Docker卷安全便捷地存储服务器数据文件（支持自动卷备份等高级Docker功能）
- 支持Paper + Spigot + Bukkit插件
- 安装并配置OpenJDK
- 服务器重启时自动备份至minecraft/backups目录
- 启动时自动更新至最新版本
- 支持所有Docker平台，包括树莓派
- 支持所有Kubernetes平台，包括树莓派
Docker使用方法
首先需创建命名Docker卷，命令如下：
bashdocker volume create yourvolumename
然后可使用以下命令之一启动服务器并开放必要端口：
默认端口
bashdocker run -it -v yourvolumename:/minecraft -p 25565:25565 -p 19132:19132/udp -p 19132:19132 --restart unless-stopped 05jchambers/legendary-minecraft-geyser-floodgate:latest
自定义端口（示例：Java端口***，Bedrock端口54321）
bashdocker run -it -v yourvolumename:/minecraft -p 12345:12345 -e Port=12345 -p 54321:54321/udp -p 54321:54321 -e BedrockPort=54321 --restart unless-stopped 05jchambers/legendary-minecraft-geyser-floodgate:latest
自定义Minecraft版本（添加-e Version=1.X.X，需Paper API服务器支持）
bashdocker run -it -v yourvolumename:/minecraft -p 25565:25565 -p 19132:19132/udp -p 19132:19132 -e Version=1.17.1 --restart unless-stopped 05jchambers/legendary-minecraft-geyser-floodgate:latest
内存限制（可选，防止内存不足崩溃，-e MaxMemory=2048，单位MB）
bashdocker run -it -v yourvolumename:/minecraft -p 25565:25565 -p 19132:19132/udp -p 19132:19132 -e MaxMemory=2048 --restart unless-stopped 05jchambers/legendary-minecraft-geyser-floodgate:latest
自定义时区
bashdocker run -it -v yourvolumename:/minecraft -p 25565:25565 -p 19132:19132/udp -p 19132:19132 -e TZ="America/Denver" --restart unless-stopped 05jchambers/legendary-minecraft-geyser-floodgate:latest
排除特定文件夹备份（逗号分隔）
bashdocker run -it -v yourvolumename:/minecraft -p 25565:25565 -p 19132:19132/udp -p 19132:19132 -e NoBackup="plugins/ftp,plugins/test2" --restart unless-stopped 05jchambers/legendary-minecraft-geyser-floodgate:latest
跳过权限检查
bashdocker run -it -v yourvolumename:/minecraft -p 25565:25565 -p 19132:19132/udp -p 19132:19132 -e NoPermCheck="Y" --restart unless-stopped 05jchambers/legendary-minecraft-geyser-floodgate:latest
Kubernetes使用方法
首先需使用首选StorageClass创建合适的PVC。
在Kubernetes中运行时，需传递环境变量k8s="True"及其他所需变量：
yamlenv: - name: MaxMemory value: '1024' - name: TZ value: Europe/London - name: k8s value: "True"
注意：在Kubernetes中运行时不支持终端功能
可通过Load或TCP/UDP Ingress服务暴露Pod。详见仓库/kubernetes文件夹中的示例清单，基于Longhorn存储后端和Load服务，需根据环境调整。
配置与访问服务器文件
服务器数据存储在Docker卷中，可通过以下命令查看卷路径：
bashdocker 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（Windows Subsystem for Linux），可能位于\wsl$\docker-desktop-data\version-pack-data\community\docker\volumes\ - Mac：通常位于
~/Library/Containers/com.docker.docker/Data/vms/0/；使用Docker Desktop时需先通过以下命令访问Docker VM：
然后通过bashscreen ~/Library/Containers/com.docker.docker/Data/com.docker.driver.amd64-linux/ttydocker volume inspect获取的路径访问卷。
常用配置文件
- 服务器配置：
server.properties（修改后需重启容器生效） - 备份文件：存储在
backups文件夹 - Geyser配置：
plugins/Geyser-Spigot/config.yml - Floodgate配置：
plugins/floodgate/config.yml
TZ（时区）环境变量
默认时区为"America/Denver"，可通过以下命令修改为自定义时区：
bashdocker run -it -v yourvolumename:/minecraft -p 25565:25565 -p 19132:19132/udp -p 19132:19132 -e TZ="Asia/Shanghai" --restart unless-stopped 05jchambers/legendary-minecraft-geyser-floodgate:latest
Linux时区列表参考
BackupCount环境变量
默认保留10个滚动备份（每次容器重启时创建），可通过BackupCount变量修改：
bashdocker run -it -v yourvolumename:/minecraft -p 25565:25565 -p 19132:19132/udp -p 19132:19132 -e BackupCount=20 --restart unless-stopped 05jchambers/legendary-minecraft-geyser-floodgate:latest
QuietCurl环境变量
可通过QuietCurl变量抑制curl下载输出，使日志更简洁（问题排查时建议关闭）：
bashdocker run -it -v yourvolumename:/minecraft -p 25565:25565 -p 19132:19132/udp -p 19132:19132 -e QuietCurl=Y --restart unless-stopped 05jchambers/legendary-minecraft-geyser-floodgate:latest
插件安装
本服务器基于Paper，支持Paper/Spigot/Bukkit插件。安装步骤：
- 在Docker卷中找到"plugins"文件夹（详见访问服务器文件部分）
- 将插件.jar文件放入该文件夹
- 重启容器
部分插件有依赖项，请先阅读插件安装指南。插件获取推荐网站：[***]
故障排除注意事项
Oracle虚拟机
Oracle虚拟机需额外配置端口开放，否则可能导致无法连接，需同时：
- 在虚拟云网络（VCN）安全列表中设置入站端口（TCP/UDP）
- 在分配给实例的网络安全组中设置入站端口
Hyper-V
Hyper-V存在UDP连接问题，解决方案：
- 使用第1代VM并启用Legacy LAN网络驱动
- 安装ethtool并禁用TX卸载：
或在bashsudo apt install ethtool ethtool -K eth0 tx off/etc/network/interfaces中添加持久配置：# 主网络接口 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
***支持
感谢您的支持！可通过以下方式***：
- ***: ***
- Venmo: @JamesAChambers
- CashApp: $theremote
- *** (BTC): ***
更新历史
- 2025年7月26日
- 更新构建流程，使用buildx进行多架构构建
- 2025年7月24日
- 更新默认版本至1.21.8（可通过-e Version=1.21.4手动指定版本）
- 2025年2月8日
- 更新默认版本至1.21.4（可通过-e Version=1.21.4手动指定版本）
- 修复Paper API URL
- 2024年12月1日
- 修复ViaVersion更新
- 容器不再以root运行，改为创建"minecraft"用户
- 更新默认版本至1.21.3（可通过-e Version=1.21.3手动指定版本）
- 2024年6月29日
- 更新默认版本至1.21（可通过-e Version=1.21手动指定版本）
- 2024年5月19日
- 将OpenJDK版本更新至21
- 更新默认版本至1.20.6
- 2024年4月27日
- 更新默认版本至1.20.5（可通过-e Version=1.20.5手动指定版本）
- 2023年12月13日
- 更新默认版本至1.20.4（可通过-e Version=1.20.4手动指定版本）
- 2023年11月26日
- 修复Geyser和Spigot更新（Jenkins变更后）
- 2023年10月1日
- 更新默认版本至1.20.2（可通过-e Version=1.20.2手动指定版本）
- 2023年6月9日
- 更新默认版本至1.20（可通过-e Version=1.20手动指定版本）
- 2023年4月18日
- 添加NoViaVersion环境变量，用于禁用ViaVersion（解决插件兼容性问题）
- 2023年3月25日
- 将paper.yml迁移至paper-global.yml（感谢karl007，#21）
- 2023年3月16日
- 更新至Paper 1.19.4
- 2023年3月15日
- 添加ViaVersion插件，允许新版本客户端连接
- 修复Geyser和Floodgate更新检查
- 2023年1月25日
- 移除终端检查，由Minecraft服务器自行处理环境错误
- 2023年1月14日
- 将连通性检查从google.com改为papermc.io（部分国家屏蔽Google）
- 2023年1月12日
- 移除ScheduleRestart环境变量（需通过OS的docker restart实现定时重启）
- 2022年12月7日
- 更新至1.19.3（感谢WarpOverload，#9）
- 2022年11月19日
- 添加QuietCurl环境变量，抑制curl进度输出（感谢willman42，#6）
- 移除fixpermissions.sh，整合至start.sh
- 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命令修复SIGTERM捕获（感谢vp-en）
- 移除screen依赖
- 2022年9月20日
- 修复Geyser更新代码（感谢vp-en）
- 更新至OpenJDK 18.0.2.1
- 2022年8月29日
- docker-compose.yml模板添加环境变量部分
- 添加TZ环境变量设置时区
- 2022年8月28日
- 为Geyser添加默认config.yml（感谢vecnar，#2）
- 2022年8月27日
- 修复Geyser-Spigot config.yml问题（感谢vecnar，#2）
- 2022年8月22日
- 添加NoScreen环境变量，禁用screen（无需交互终端，但减少日志）
- 修复#1（感谢Sam7，#1）
- 2022年8月18日
- 回滚OpenJDK版本，解决10-11代Intel CPU问题
- 2022年8月17日
- 添加XX:-UseAESCTRIntrinsics参数，解决10代Intel处理器加密问题
- 2022年8月10日
- 调整
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 legendary-minecraft-geyser-floodgate 镜像标签
docker pull docker.xuanyuan.run/05jchambers/legendary-minecraft-geyser-floodgate:<标签>
DockerHub 原生拉取命令
docker pull 05jchambers/legendary-minecraft-geyser-floodgate:<标签>
更多 legendary-minecraft-geyser-floodgate 镜像推荐
itzg/minecraft-server
itzg
这是一款支持动态版本切换、多种服务器类型及丰富模组包的我的世界服务器，玩家可根据需求自由选择适配的游戏版本，体验生存、创造、冒险等多样化服务器模式，并轻松加载各类热门模组包，享受高度自定义的游戏乐趣。
2.2千 次收藏1亿+ 次下载
22 天前更新
itzg/minecraft-bedrock-server
itzg
可选择版本的Minecraft基岩版专用服务器
556 次收藏1000万+ 次下载
26 天前更新
mcp/minecraft-wiki
mcp（Model Context Protocol）
用于浏览官方Minecraft Wiki的MCP服务器，提供页面内容获取、分类管理、搜索及章节检索等功能。
3 次收藏6.2千+ 次下载
8 个月前更新
infinytum/geyser-mc
infinytum
暂无描述
2 次收藏50万+ 次下载
4 年前更新
05jchambers/legendary-minecraft-purpur-geyser
05jchambers
集成Geyser和Floodgate的Minecraft Purpur服务器Docker容器，支持Java和Bedrock玩家跨平台联机游戏，具备自动备份、版本更新和多架构兼容特性。
2 次收藏1万+ 次下载
30 天前更新
projectsyn/floodgate
projectsyn
暂无描述
10万+ 次下载
3 年前更新
轩辕镜像配置手册
探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式
Docker 配置
登录仓库拉取
通过 Docker 登录认证访问私有仓库
用 AI 使用轩辕镜像
发给 Cursor、ChatGPT、豆包等 AI 的说明文档
专属域名拉取
无需登录使用专属域名
K8s Containerd
Kubernetes 集群配置 Containerd
K3s
K3s 轻量级 Kubernetes 镜像加速
Dev Containers
VS Code Dev Containers 配置
Podman
Podman 容器引擎配置
Singularity/Apptainer
HPC 科学计算容器配置
其他仓库配置
ghcr、Quay、nvcr 等镜像仓库
Harbor 镜像源配置
Harbor Proxy Repository 对接专属域名
Portainer 镜像源配置
Portainer Registries 加速拉取
Nexus 镜像源配置
Nexus3 Docker Proxy 内网缓存
系统配置
需要其他帮助？请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
镜像拉取常见问题
使用与功能问题
配置了专属域名后，docker search 为什么会报错？
docker search 限制
Docker Hub 上有的镜像，为什么在轩辕镜像网站搜不到？
站内搜不到镜像
机器不能直连外网时，怎么用 docker save / load 迁镜像？
离线 save/load
docker pull 拉插件报错（plugin v1+json）怎么办？
插件要用 plugin install
WSL 里 Docker 拉镜像特别慢，怎么排查和优化？
WSL 拉取慢
轩辕镜像安全吗？如何用 digest 校验镜像没被篡改？
安全与 digest
第一次用轩辕镜像拉 Docker 镜像，要怎么登录和配置？
新手拉取配置
轩辕镜像合规吗？轩辕镜像的合规是怎么做的？
镜像合规机制
轩辕镜像支持 docker push 上传本地镜像吗？
不支持 push
错误码与失败问题
docker pull 提示 manifest unknown 怎么办？
manifest unknown
docker pull 提示 no matching manifest 怎么办？
no matching manifest（架构）
镜像已拉取完成，却提示 invalid tar header 或 failed to register layer 怎么办？
invalid tar header（解压）
Docker pull 时 HTTPS / TLS 证书验证失败怎么办？
TLS 证书失败
Docker pull 时 DNS 解析超时或连不上仓库怎么办？
DNS 超时
docker 无法连接轩辕镜像域名怎么办？
域名连通性排查
Docker 拉取出现 410 Gone 怎么办？
410 Gone 排查
出现 402 或「流量用尽」提示怎么办？
402 与流量用尽
Docker 拉取提示 UNAUTHORIZED（401）怎么办？
401 认证失败
遇到 429 Too Many Requests（请求太频繁）怎么办？
429 限流
docker login 提示 Cannot autolaunch D-Bus，还算登录成功吗？
D-Bus 凭证提示
为什么会出现「单层超过 20GB」或 413，无法加速拉取？
413 与超大单层
账号 / 计费 / 权限
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"