marctv/minecraft-bedrock-server

Minecraft基岩版服务器Docker镜像（1.2X+）

概述

本Docker镜像提供Minecraft基岩版服务器，支持多平台（Windows、iOS、Android、PS、Xbox）连接，且始终保持最新版本。适用于搭建个人或小型社区的Minecraft服务器，支持数据持久化和自定义配置。

核心功能和特性

• 持续更新：镜像始终保持最新版本，无需手动维护服务端更新
• 多平台支持：兼容Windows、iOS、Android、PlayStation和Xbox等设备
• 配置灵活：支持通过server.properties自定义服务器参数（如游戏模式、难度等）
• 安全控制：提供白名单功能（allowlist.json），防止未授权访问
• 数据持久化：通过卷挂载保存世界数据、配置文件，确保数据不丢失

使用场景和适用范围

• 家庭或朋友间搭建共享Minecraft服务器
• 小型社区或团队创建专属游戏空间
• 需要开放互联网访问的私有服务器（配合白名单增强安全性）
• Synology NAS等设备上的轻量级部署

使用方法

更新容器

1. 重新拉取镜像：docker pull marctv/minecraft-bedrock-server:latest
2. 停止当前容器：docker stop mcbedrock
3. 删除旧容器：docker rm mcbedrock
4. 启动新容器：使用下方Docker运行命令重新创建容器

Docker运行命令

前提条件：本地需提前准备allowlist.json和server.properties文件（获取方式见下文）

shell
docker run -d \
  --name mcbedrock \
  --restart=unless-stopped \
  -e TZ="Europe/Berlin" \  # 设置时区，如"Asia/Shanghai"
  -p 19132:19132/tcp \
  -p 19132:19132/udp \
  -v /home/docker/mcserver-bedock/allowlist.json:/bedrock-server/allowlist.json:rw \
  -v /home/docker/mcserver-bedock/server.properties:/bedrock-server/server.properties:rw \
  -v /home/docker/mcserver-bedock:/bedrock-server/worlds:rw \
  marctv/minecraft-bedrock-server:latest 

安装视频教程（Synology NAS）

![观看视频]([***]
***视频链接

卷挂载配置

需挂载以下文件/文件夹以实现数据持久化和配置自定义：

世界数据（worlds）

• 本地文件夹：/volume1/docker/bedrockserver/worlds（Synology NAS示例）或自定义路径
• 挂载路径：/bedrock-server/worlds
• 权限：读写（rw）

服务器配置文件（server.properties）

• 本地文件：/volume1/docker/bedrockserver/server.properties（Synology NAS示例）
• 挂载路径：/bedrock-server/server.properties
• 权限：读写（rw）

白名单文件（allowlist.json）

• 本地文件：/volume1/docker/bedrockserver/allowlist.json（Synology NAS示例）
• 挂载路径：/bedrock-server/allowlist.json
• 权限：读写（rw）

端口设置

服务器需映射以下端口：

• TCP端口：***（本地端口:容器端口 = :）
• UDP端口：***（本地端口:容器端口 = :）

若需开放到互联网，需在路由器中转发上述端口至服务器本地IP。

配置文件说明

获取示例配置文件

• https://raw.githubusercontent.com/mtoensing/Docker-Minecraft-Bedrock-Server/master/server.properties
• https://raw.githubusercontent.com/mtoensing/Docker-Minecraft-Bedrock-Server/master/allowlist.json

编辑配置文件

1. 停止服务器容器
2. 在本地直接编辑server.properties，可修改游戏模式（创造/生存）、难度、白名单启用状态等参数
3. 重启容器使配置生效

注意：启用白名单（allowlist=true）是开放互联网访问时的强烈推荐安全措施。

添加白名单和授予管理员权限

通过容器终端执行命令管理用户权限（以Synology NAS为例，在Docker容器的终端中操作）：

添加用户到白名单

shell
allowlist add [Xbox用户名]

示例：allowlist add MarcTV

授予管理员权限

shell
op [Xbox用户名]

示例：op MarcTV

注意：用户需在线时才能成功执行上述命令。

!Bedrock容器终端

相关资源

• GitHub仓库：https://github.com/mtoensing/Docker-Minecraft-Bedrock-Server
• 支持渠道：https://github.com/mtoensing/Docker-Minecraft-Bedrock-Server/issues
• 德语教程：[***]