pugmatt/bedrock-connect

BedrockConnect 镜像文档

概述

BedrockConnect 是针对 Minecraft Bedrock Edition（基岩版）设计的服务器连接工具，旨在简化玩家与服务器的连接流程。该工具支持跨平台使用（如手机、PC、主机等设备），允许玩家通过域名或直接IP地址连接服务器，并提供服务器列表管理、连接稳定性优化等功能，提升多人游戏体验。

核心功能和特性

• 跨平台兼容：支持 Minecraft Bedrock Edition 所有平台（iOS、Android、Windows 10/11、Xbox、PlayStation、Switch 等）玩家连接
• 服务器连接管理：提供可视化服务器列表，支持添加、编辑、删除常用服务器信息
• 连接优化：内置网络连接优化机制，减少延迟，提升连接稳定性
• 域名/IP 支持：兼容通过域名解析或直接IP地址连接服务器，灵活适配不同部署场景
• 轻量部署：通过 Docker 容器化部署，简化安装和配置流程

使用场景和适用范围

• Minecraft 服务器管理员：需要为玩家提供便捷、统一的服务器连接入口
• 跨平台玩家群体：不同设备玩家需要共同连接同一服务器的场景
• 多服务器管理：需维护多个服务器地址，希望快速切换连接的玩家或管理员
• 网络环境复杂场景：需要优化连接稳定性，减少因网络波动导致的连接问题

使用方法和配置说明

前提条件

• 已安装 Docker 或 Docker Compose 环境
• 服务器端开放 Minecraft Bedrock Edition 默认端口（通常为 UDP ***）
• 客户端设备需安装 Minecraft Bedrock Edition 并处于与服务器相同网络环境或可访问公网

Docker 部署示例

基础 Docker Run 命令

bash
docker run -d \
  --name bedrockconnect \
  -p 19132:19132/udp \
  --restart always \
  docker.xuanyuan.run/pugmatt/bedrockconnect

Docker Compose 配置

创建 docker-compose.yml 文件：

yaml
version: '3.8'
services:
  bedrockconnect:
    image: docker.xuanyuan.run/pugmatt/bedrockconnect
    container_name: bedrockconnect
    ports:
      - "19132:19132/udp"  # 映射默认UDP端口
    restart: unless-stopped
    # 如需自定义配置，可挂载配置文件（具体路径参考GitHub文档）
    # volumes:
    #   - ./config:/app/config

启动容器：

bash
docker-compose up -d

客户端连接方法

1. 启动 Minecraft Bedrock Edition，进入“服务器”选项
2. 点击“添加服务器”，输入 BedrockConnect 服务所在的 IP 地址和端口（默认 ***）
3. 连接后即可通过 BedrockConnect 提供的服务器列表选择目标服务器

详细配置说明

完整配置参数、高级功能（如自定义服务器列表、权限管理等）及更新信息，请参考官方 GitHub 文档：
https://github.com/Pugmatt/BedrockConnect

注意事项

• 容器部署时需确保 UDP *** 端口未被占用，如需修改端口，可调整 -p 参数（如 -p 20000:19132/udp 将容器内 *** 端口映射到主机 20000 端口）
• 跨公网访问时需在路由器或防火墙中配置端口转发规则
• 定期通过 docker pull docker.xuanyuan.run/pugmatt/bedrockconnect 更新镜像至最新版本，获取功能更新和问题修复