热门搜索:
portiz93/geysermc-proxy
portiz93
非官方Docker镜像，包含GeyserMC独立代理，允许Bedrock版Minecraft客户端连接到Java版服务器。
1 次收藏下载次数: 0状态：社区镜像维护者：portiz93仓库类型：镜像最近更新：29 天前
让 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 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Docker GeyserMC Proxy（非官方）
https://github.com/pjortiz/docker-geysermc-proxy/actions/workflows/build.yml/badge.svg](https://github.com/pjortiz/docker-geysermc-proxy/actions/workflows/build.yml) !https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fraw.githubusercontent.com%2Fpjortiz%2Fdocker-geysermc-proxy%2Frefs%2Fheads%2Fmain%2Fbuild-info.json&query=version&label=%E9%95%9C%E5%83%8F%E7%89%88%E6%9C%AC !https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fraw.githubusercontent.com%2Fpjortiz%2Fdocker-geysermc-proxy%2Frefs%2Fheads%2Fmain%2Fbuild-info.json&query=geyser.version&label=API%E7%89%88%E6%9C%AC !https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fraw.githubusercontent.com%2Fpjortiz%2Fdocker-geysermc-proxy%2Frefs%2Fheads%2Fmain%2Fbuild-info.json&query=geyser.build&label=%E6%9E%84%E5%BB%BA%E7%89%88%E6%9C%AC !Docker Pulls
镜像概述和主要用途
本镜像包含GeyserMC独立代理，允许Bedrock版Minecraft客户端连接到Java版Minecraft服务器。有关更多信息，请参考GeyserMC官方网站。
核心功能和特性
- 实现Bedrock版与Java版Minecraft服务器的协议转换
- 支持多种认证方式（Floodgate、在线模式、离线模式）
- 可配置的MOTD（服务器状态消息）和玩家数量显示
- 支持资源包转发和自定义内容
- 提供丰富的游戏玩法配置选项（如冷却显示、坐标显示等）
- 数据持久化存储，配置文件可通过卷挂载管理
使用场景和适用范围
- 个人Minecraft服务器：允许Bedrock版玩家与Java版玩家共同游戏
- 社区服务器：扩大玩家群体，支持多平台接入
- 教育场景：方便不同设备（如手机、平板、PC）的用户共同参与游戏
使用方法和配置说明
命令行部署
bashdocker run -d \ --name geyser-proxy \ --restart unless-stopped \ -e JAVA_ADDRESS=mc \ -e JAVA_AUTH_TYPE=floodgate \ -v geyser-data:/Geyser/data \ -v /path/to/floodgate/key.pem:/Geyser/floodgate/key.pem \ portiz93/geysermc-proxy:latest
Docker Compose部署
yamlvolumes: geyser-data: geyser-proxy: image: portiz93/geysermc-proxy:latest # 添加Minecraft服务器服务依赖，等待其健康状态 # depends_on: # mc: # condition: service_healthy environment: # Minecraft服务器服务名称或IP地址 JAVA_ADDRESS: mc # Minecraft服务器端口，默认为25565 # JAVA_PORT: 25565 # 认证类型，默认为online JAVA_AUTH_TYPE: floodgate restart: unless-stopped volumes: - geyser-data:/Geyser/data # 将本地Floodgate key.pem文件路径替换为实际路径 - /path/to/floodgate/key.pem:/Geyser/floodgate/key.pem
Floodgate配置
如果计划使用Floodgate，需要将Floodgate的key.pem文件直接挂载到容器内的/Geyser/floodgate/key.pem路径。
环境变量配置
有关Geyser的详细设置，请参考GeyserMC官方文档。
| 变量 | 默认值 | 描述 |
|---|---|---|
| BEDROCK_ADDRESS | 0.0.0.0 | Geyser绑定以监听Bedrock连接的IP地址。通常仅在需要限制可连接IP时修改。 |
| BEDROCK_PORT | *** | Geyser监听Bedrock连接的端口。由于Minecraft: Bedrock版使用UDP，此端口必须允许UDP流量。 |
| JAVA_ADDRESS | 127.0.0.1 | Java版服务器的IP地址。 |
| JAVA_PORT | 25565 | Java版服务器的端口。 |
| JAVA_AUTH_TYPE | online | Bedrock玩家登录Java服务器时使用的认证类型。可选值为"floodgate"（参见[***]"online"或"offline"。 |
| JAVA_FORWARD_HOSTNAME | true | 是否将Bedrock客户端用于连接的主机名转发到Java服务器。用于代理的强制主机功能。 |
| MOTD_PRIMARY_MOTD | Geyser | 广播给Bedrock客户端的主MOTD。如果"passthrough-motd"设为true，则此设置无效。若为空，默认值为"Geyser"。 |
| MOTD_SECONDARY_MOTD | Another Geyser server. | 广播给Bedrock客户端的次要MOTD。 |
| MOTD_PASSTHROUGH_MOTD | true | 是否将Java服务器的MOTD中继给Bedrock玩家。 |
| MOTD_MAX_PLAYERS | 100 | 最大可连接玩家数（仅视觉效果，仅在passthrough-motd禁用时生效）。 |
| MOTD_PASSTHROUGH_PLAYER_COUNTS | true | 是否将Java服务器的玩家数量和最大玩家数中继给Bedrock玩家。 |
| MOTD_PING_PASSTHROUGH_INTERVAL | 3 | 刷新MOTD和玩家数量的Java服务器ping间隔（秒）。 |
| GAMEPLAY_SERVER_NAME | Geyser | 发送给Bedrock客户端的服务器名称，在暂停菜单和设置菜单中可见。 |
| GAMEPLAY_SHOW_COOLDOWN | title | 是否显示虚假冷却指示器。Bedrock玩家默认看不到冷却（因使用1.8战斗机制）。可选值："title"（标题栏）、"actionbar"（动作栏）或"disabled"（禁用）。注意：启用时部分用户可能在冷却期间看到黑框，可在Bedrock设置的辅助功能中将"文本背景不透明度"设为0解决。 |
| GAMEPLAY_COMMAND_SUGGESTIONS | true | 是否发送命令建议。禁用可解决Bedrock客户端首次打开命令提示符时可能出现的冻结问题。 |
| GAMEPLAY_SHOW_COORDINATES | true | 控制是否向玩家显示坐标。 |
| GAMEPLAY_DISABLE_BEDROCK_SCAFFOLDING | false | 是否阻止Bedrock玩家使用脚手架式搭桥。 |
| GAMEPLAY_NETHER_ROOF_WORKAROUND | false | Bedrock版阻止在 Nether Y127以上放置和显示方块。启用此选项通过将Nether维度ID改为End ID解决，但整个Nether将使用相同的红色雾效。 |
| GAMEPLAY_EMOTES_ENABLED | true | 是否向其他Bedrock玩家显示Bedrock版表情。 |
| GAMEPLAY_UNUSABLE_SPACE_BLOCK | minecraft:barrier | 用于标记Bedrock玩家 inventory中不可用槽位的物品。例如创造模式中的2x2合成格或自定义大小的inventory菜单。默认为屏障方块，可设为任何Bedrock物品标识符，自定义物品格式为"geyser_custom: |
| GAMEPLAY_ENABLE_CUSTOM_CONTENT | true | 是否添加Bedrock版中通常不存在的物品和方块。仅在使用不支持"传输数据包"式服务器切换的代理时需禁用。禁用后，熔炉矿车将映射为漏斗矿车，方块、物品和头颅映射系统也将禁用。修改需重启Geyser。 |
| GAMEPLAY_FORCE_RESOURCE_PACKS | true | 是否强制客户端加载所有资源包。设为false时，用户可在不下载资源包的情况下连接。 |
| GAMEPLAY_ENABLE_INTEGRATED_PACK | true | 是否自动向所有连接的Bedrock玩家提供部分Geyser功能所需的资源包。启用时会自动启用force-resource-packs。 |
| GAMEPLAY_FORWARD_PLAYER_PING | false | 是否将玩家ping转发到服务器。启用可使Bedrock玩家获得更准确的ping，但可能增加超时概率。 |
| GAMEPLAY_XBOX_ACHIEVEMENTS_ENABLED | false | 是否允许解锁Xbox成就。启用后，输入未知命令会收到"作弊已禁用"消息，其他命令正常工作。 |
| GAMEPLAY_MAX_VISIBLE_CUSTOM_SKULLS | 128 | 每个玩家可显示的最大自定义头颅数量。增加可能降低弱设备性能。0禁用所有，-1显示所有头颅（不考虑距离和数量）。 |
| GAMEPLAY_CUSTOM_SKULL_RENDER_DISTANCE | 32 | 玩家周围显示自定义头颅的半径（方块）。 |
| DEFAULT_LOCALE | system | 客户端请求的语言不可用时使用的默认语言。设为"system"则使用系统语言。 |
| LOG_PLAYER_IP_ADDRESSES | true | 是否记录玩家IP地址。 |
| SAVED_USER_LOGINS | 仅在线模式认证。存储应在登录后保存Java版账户的Bedrock玩家用户名列表。保存可重用的认证令牌（不保存***或密码）。从列表中移除名称将在下次启动时删除缓存的登录信息。令牌保存在与配置文件同目录的"saved-refresh-tokens.json"中。 | |
| PENDING_AUTHENTICATION_TIMEOUT | 120 | 仅在线模式认证。用户授权Geyser访问其Microsoft账户的等待时间（秒）。期间用户可断开连接。 |
| NOTIFY_ON_NEW_BEDROCK_UPDATE | true | 是否在控制台和管理员处提醒有支持新版本Bedrock的Geyser更新可用。建议启用，因许多Bedrock平台自动更新。 |
| ADVANCED_CACHE_IMAGES | 0 | 玩家皮肤图片缓存到磁盘的天数（0为禁用）。 |
| ADVANCED_SCOREBOARD_PACKET_THRESHOLD | 20 | 每秒Scoreboard数据包超过此阈值时，Geyser将Scoreboard更新限制为每秒4次，以避免高负载时的严重延迟。 |
| ADVANCED_ADD_TEAM_SUGGESTIONS | true | 是否在命令建议中发送团队名称。若有大量不需要的团队，可禁用。 |
| ADVANCED_RESOURCE_PACK_URLS | 发送给Bedrock客户端下载的远程资源包URL列表。Bedrock客户端对格式要求严格，详见GeyserMC资源包文档。 | |
| ADVANCED_JAVA_USE_HAPROXY_PROTOCOL | false | 连接Java服务器时是否启用HAPROXY协议。仅在Java服务器支持且使用Velocity或BungeeCord并启用该选项时使用。不了解则不要修改。 |
| ADVANCED_BEDROCK_BROADCAST_PORT | 0 | 向Bedrock客户端广播MOTD时使用的端口（0表示使用上面指定的端口）。仅在Geyser运行端口与连接端口不同时修改。 |
| ADVANCED_BEDROCK_COMPRESSION_LEVEL | 6 | 对Bedrock客户端网络流量的压缩级别（-1禁用，0-9，越高CPU占用越高但带宽使用越少）。 |
| ADVANCED_BEDROCK_USE_HAPROXY_PROTOCOL | false | 是否期望Bedrock客户端使用HAPROXY协议连接。仅在Geyser前运行UDP反向代理时使用。不了解则不要修改。 |
| ADVANCED_BEDROCK_HAPROXY_PROTOCOL_WHITELISTED_IPS | 允许使用HAPROXY协议的代理IP地址/子网列表。仅在"use-proxy-protocol"启用时有效，建议在无法使用防火墙时使用。空列表表示无IP白名单，支持IP、子网和纯文本文件链接。 | |
| ADVANCED_BEDROCK_MTU | 1400 | 网络MTU值（互联网最大为1492，1400为默认值，可避免数据包分片问题）。 |
| ADVANCED_BEDROCK_VALIDATE_BEDROCK_LOGIN | true | 是否禁用Bedrock玩家连接时的认证步骤。可用于允许ProxyPass和WaterdogPE连接，但需确保用户无法直接连接到此Geyser实例（参考防火墙指南，使用UDP）。其他场景禁用不支持，会导致用户名伪造安全风险，且Floodgate功能（皮肤上传、账户链接）将失效。 |
| ENABLE_METRICS | false | 是否启用bStats统计（完全***，仅跟踪基本信息如在线人数、服务器数量、OS等）。详见bstats和GeyserMC bStats页面。 |
| METRICS_UUID | 40fd3d2f-a494-4428-ba05-c156ed02582b | bstats统计UUID，请勿修改！ |
| DEBUG_MODE | false | 是否在控制台输出调试消息。 |
许可证
所有非由GeyserMC创建或管理的软件和文件均采用MIT许可证。
详见GeyserMC的https://github.com/GeyserMC/Geyser/blob/master/LICENSE%E3%80%82
免责声明
本项目与GeyserMC及其开发者无关联，为非官方镜像。
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 geysermc-proxy 镜像标签
docker pull docker.xuanyuan.run/portiz93/geysermc-proxy:<标签>
DockerHub 原生拉取命令
docker pull portiz93/geysermc-proxy:<标签>
更多 geysermc-proxy 镜像推荐
haproxytech/haproxy-debian
haproxytech
HAProxy社区版Docker Debian镜像，提供高性能的开源负载均衡和应用交付控制功能，支持TCP/HTTP代理、SSL终止、健康检查等特性，适用于构建可靠的流量管理解决方案。
9 次收藏1000万+ 次下载
12 天前更新
haproxytech/haproxy-alpine
haproxytech
HAProxy社区版Docker镜像，基于Alpine Linux构建，提供高性能负载均衡与反向代理功能，适用于构建轻量级、高可用的Web服务或应用集群。
18 次收藏500万+ 次下载
11 天前更新
haproxytech/haproxy-ubuntu
haproxytech
HAProxy社区版Docker Ubuntu镜像
6 次收藏100万+ 次下载
11 天前更新
haproxytech/haproxy-qns
haproxytech
该Docker镜像包含用于HAProxy的QUIC互操作性测试文件
2 次收藏10万+ 次下载
12 天前更新
library/haproxy
Docker 官方镜像
HAProxy是一款可靠的高性能负载均衡器，主要用于TCP和HTTP协议的流量分发，能够有效均衡服务器负载、提高系统可用性与响应速度，广泛应用于Web服务、数据库集群等场景，通过智能流量调度确保服务稳定运行，是构建高可用、高性能网络架构的关键工具。
2.0千 次收藏10亿+ 次下载
14 天前更新
envoyproxy/envoy
envoyproxy
云原生高性能边缘/中间层/服务代理
181 次收藏10亿+ 次下载
11 天前更新
轩辕镜像配置手册
探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式
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访问体验非常流畅，大镜像也能快速完成下载。"