strausmann/minecraft-bedrock-connect Docker Image Overview

strausmann/minecraft-bedrock-connect

strausmann

基于Pugmatt/BedrockConnect的Minecraft Bedrock Connect服务Docker镜像，支持AMD64和ARM64架构（包括树莓派）

3 次收藏下载次数: 0状态：社区镜像维护者：strausmann仓库类型：镜像最近更新：4 个月前

轩辕镜像，加速的不只是镜像。点击查看

中文简介版本下载

轩辕镜像，加速的不只是镜像。点击查看

Minecraft Bedrock Connect

![Gitlab Pipeline Status]([] ![GitLab Issues]([] ![GitLab License]([] ![Static Badge]([] ![Open in Gitpod]([***]

![Docker Pulls]([] ![Docker Image Version]([] ![Docker Image Size latest by date]([***]

一个可提供Minecraft Bedrock Connect服务的简单Docker镜像，基于Bedrock Connect项目

支持的标签及对应`Dockerfile`链接

标签	描述
`latest`, `2`, `2.*`	最新稳定版 - Debian系统，支持amd64/arm64架构
`beta`, `[object Object]`	测试版，用于新功能预览或测试，可能不稳定
`main`	开发构建版，可能不稳定

快速参考

文档：
- 使用Docker安装2.x版本
获取帮助：***
问题反馈：[***]
维护者：strausmann
支持架构：amd64 arm64
许可证：MIT

⭐ 特性

以Docker容器方式运行Bedrock Connect
支持MySQL数据库作为后端
通过环境变量进行配置
支持通过JSON文件配置custom_servers自定义服务器列表

环境变量

可在启动命令中添加以下参数以调整设置：

参数	描述	默认值
BRC_VERSION	容器启动时使用的Bedrock Connect版本。例如，1.15表示Bedrock Connect 1.15版本，并非Minecraft服务器版本	latest
MYSQL_HOST	MySQL主机地址	localhost
MYSQL_DB	MySQL数据库名称	bedrock-connect
MYSQL_USER	MySQL用户名	root
MYSQL_PASS	MySQL密码
SERVER_LIMIT	新玩家可在服务器列表中添加的服务器数量上限	100
NODB	若为true，使用JSON文件存储数据而非MySQL	false
KICK_INACTIVE	若为true，玩家在服务器列表界面闲置10分钟后将被踢出	true
CUSTOM_SERVERS	自定义服务器文件路径，用于为所有玩家指定服务器列表。详见自定义服务器
USER_SERVERS	若为true，玩家可在服务器列表中添加和删除服务器；若为false，相关选项将隐藏	true
FEATURED_SERVERS	若为true，服务器列表中将显示推荐服务器；若为false，推荐服务器将隐藏	true
WHITELIST	指定包含白名单玩家的文件路径（应为文本文件，每行一个玩家名称）
FETCH_FEATURED_IPS	若为true，动态从域名获取推荐服务器IP；若为false，将生成`featured_server_ips.json`文件，包含硬编码的推荐服务器IP，可手动修改	true
FETCH_IPS	若为true，动态从域名获取玩家尝试加入的服务器IP	false
LANGUAGE	指定包含语言自定义的文件路径。详见修改服务器列表文字指南
STORE_DISPLAY_NAMES	若为true，玩家显示名称将包含在存储的玩家数据中	true
PACKET_LIMIT	每个地址在一个 tick（10ms）内可发送的数据包数量	200
GLOBAL_PACKET_LIMIT	一个 tick（10ms）内可处理的所有数据包数量上限，超过后服务器将开始丢弃入站数据	***

🔧 安装方法

可通过以下命令快速部署Docker镜像，或使用Docker Compose，详见下方示例。

💪🏻 非Docker安装

无Docker环境的安装方法，请参考Pugmatt的说明

🐳 Docker

bash
# 创建卷
docker volume create bedrock-connect

# 启动容器
docker run -d --restart=always -p ***:***/udp -e NODB=true -v bedrock-connect:/data --name bedrock-connect strausmann/minecraft-bedrock-connect:2

暴露端口

UDP ***：Bedrock服务器端口。注意暴露端口时需添加/udp，例如-p [object Object]/udp

🐳 使用Docker Compose部署

yaml
---
services:
  bedrockconnect: 
    image: strausmann/minecraft-bedrock-connect:2
    restart: always
    environment:
      NODB: "true"
      CUSTOM_SERVERS: "/config/serverlist.json"
      SERVER_LIMIT: 25
    ports:
      - ***:***/udp
    volumes:
      - bedrockconnect:/config

volumes:
  bedrockconnect:
    driver: local

🐳 使用Docker Compose配合MySQL后端部署

yaml
---
services:
  bedrockconnect: 
    image: strausmann/minecraft-bedrock-connect:2
    restart: always
    environment:
      MYSQL_HOST: "db"
      MYSQL_USER: "bedrock"
      MYSQL_PASS: "bedrock"
      MYSQL_DB: "bedrock"
      CUSTOM_SERVERS: "/config/serverlist.json"
      SERVER_LIMIT: 25
    ports:
      - ***:***/udp
    depends_on:
      - db
    volumes:
      - bedrockconnect:/config

  db: 
    image: mariadb:10.6
    restart: always
    environment:
      - MYSQL_ROOT_PASSWORD=rootpwbedrock
      - MYSQL_PASSWORD=bedrock
      - MYSQL_USER=bedrock
      - MYSQL_DATABASE=bedrock
      - TZ=Europe/Berlin
      - PGID=1000
      - PUID=1000
    ports:
      - 3306:3306
    volumes:
      - bedrockconnect_database:/var/lib/mysql

volumes:
  bedrockconnect:
    driver: local
  bedrockconnect_database:
    driver: local