05jchambers/legendary-minecraft-geyser-floodgate Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务
05jchambers/legendary-minecraft-geyser-floodgate05jchambers
基于Docker的传奇Java版Minecraft服务器，集成Geyser和Floodgate，支持Bedrock玩家通过其凭据连接，采用高效Paper服务端，具备自动更新、备份、插件支持及跨平台运行能力。
14 次收藏下载次数: 0状态：社区镜像维护者：05jchambers仓库类型：镜像最近更新：1 个月前
传奇Java版Minecraft + Geyser + Floodgate + Paper专用Docker服务器
!传奇Minecraft Geyser容器
这是我的Linux/树莓派Java版Minecraft Paper专用服务器脚本的Docker容器化版本，包含Geyser和Floodgate。
Geyser和Floodgate允许Minecraft Bedrock玩家加入您的Java服务器！
我的主要博客文章（也是获取支持的最佳地方）在此。
不含Floodgate和Geyser的版本在此。
官方GitHub仓库在此。
官方Docker Hub仓库在此。
Bedrock版Docker容器在此。本容器为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 ***:***/udp -p ***:*** --restart unless-stopped 05jchambers/legendary-minecraft-geyser-floodgate:latest
自定义端口（示例：Java端口***，Bedrock端口54321）
bashdocker run -it -v yourvolumename:/minecraft -p ***:*** -e Port=*** -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 ***:***/udp -p ***:*** -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 ***:***/udp -p ***:*** -e MaxMemory=2048 --restart unless-stopped 05jchambers/legendary-minecraft-geyser-floodgate:latest
自定义时区
bashdocker run -it -v yourvolumename:/minecraft -p 25565:25565 -p ***:***/udp -p ***:*** -e TZ="America/Denver" --restart unless-stopped 05jchambers/legendary-minecraft-geyser-floodgate:latest
排除特定文件夹备份（逗号分隔）
bashdocker run -it -v yourvolumename:/minecraft -p 25565:25565 -p ***:***/udp -p ***:*** -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 ***:***/udp -p ***:*** -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 ***:***/udp -p ***:*** -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 ***:***/udp -p ***:*** -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 ***:***/udp -p ***:*** -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日
- 调整
itzg/minecraft-server
itzg
这是一款支持动态版本切换、多种服务器类型及丰富模组包的我的世界服务器，玩家可根据需求自由选择适配的游戏版本，体验生存、创造、冒险等多样化服务器模式，并轻松加载各类热门模组包，享受高度自定义的游戏乐趣。
2.2千 次收藏1亿+ 次下载
6 小时前更新
itzg/minecraft-bedrock-server
itzg
可选择版本的Minecraft基岩版专用服务器
552 次收藏1000万+ 次下载
3 天前更新
Minecraft Wiki
A MCP Server for browsing the official Minecraft Wiki!
3 次收藏4.9千+ 次下载
6 个月前更新
redgate/flyway
redgate
Flyway是一款数据库版本控制工具，用于自动化数据库迁移流程，管理数据库结构变更，确保版本一致性与可追溯性，支持多种数据库系统，适用于CI/CD环境集成。
6 次收藏100万+ 次下载
5 天前更新
redgate/sqldatacompare
redgate
Redgate SQL Data Compare命令行工具，用于比较和部署SQL Server数据库内容，支持实时数据库、备份和源代码控制中的SQL脚本，可恢复单行损坏或丢失数据，实现快速零错误变更部署。
2 次收藏50万+ 次下载
5 天前更新
hashicorp/boundary
hashicorp
Boundary提供对主机和服务的简单安全访问。
19 次收藏1000万+ 次下载
1 个月前更新
轩辕镜像配置手册
探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式
Docker 配置
登录仓库拉取
通过 Docker 登录认证访问私有仓库
专属域名拉取
无需登录使用专属域名
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 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 拉取出现 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访问体验非常流畅，大镜像也能快速完成下载。"