05jchambers/legendary-bedrock-container

Minecraft Bedrock专用服务器Docker镜像，支持带时间戳的日志记录、多架构（包括树莓派）、自动备份、版本自动更新及多实例运行，可快速部署可运行的Bedrock服务器。

6 收藏0 次下载active05jchambers镜像

Legendary Bedrock Container - Docker版Minecraft Bedrock专用服务器

这是Linux版Minecraft Bedrock专用服务器的Docker容器化版本。

主要博客文章（也是获取支持的最佳位置）。
***GitHub仓库。
***Docker Hub仓库。

支持Geyser允许Bedrock玩家连接的Java版容器
常规Java版Docker容器。

特性

搭建***Minecraft Bedrock服务器（当前处于alpha测试阶段）
几分钟内即可部署完全可运行的Minecraft Bedrock版服务器
添加带时间戳的日志至“logs”目录
多架构支持 - 支持所有Docker平台，包括树莓派
容器/服务器重启时自动备份
支持多实例 - 可在同一系统上运行多个Bedrock服务器
启动时自动更新至最新版本或用户指定版本
文件存储在命名Docker卷中，便于访问/编辑，并可利用Docker高级功能（如自动卷备份）

使用方法

首先必须创建命名Docker卷，可通过以下命令完成：

bash
docker volume create yourvolumename

现在可使用以下任一Docker启动命令启动服务器并开放必要端口：

默认端口：

bash
docker run -it -v yourvolumename:/minecraft -p ***:***/udp -p ***:*** -p ***:***/udp -p ***:*** --restart unless-stopped 05jchambers/legendary-bedrock-container:latest

自定义端口：

bash
docker run -it -v yourvolumename:/minecraft -p ***:***/udp -p ***:*** -p ***:***/udp -p ***:*** -e PortIPV4=*** -e PortIPV6=*** --restart unless-stopped 05jchambers/legendary-bedrock-container:latest

仅IPV4：

bash
docker run -it -v yourvolumename:/minecraft -p ***:***/udp -p ***:*** --restart unless-stopped 05jchambers/legendary-bedrock-container:latest

配置/访问服务器文件

服务器数据存储在Docker卷的位置，通常是主机OS上与容器共享挂载的文件夹。
可通过以下命令查找确切路径：

bash
docker 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/

若在Mac上使用Docker Desktop，需先通过以下命令访问Docker VM：

bash
screen ~/Library/Containers/com.docker.docker/Data/com.docker.driver.amd64-linux/tty

然后可使用docker volume inspect找到的路径正常访问Docker卷。

大多数用户需要编辑server.properties，修改后重启容器即可生效。
Minecraft服务器备份在每次启动时创建，存储在“backups”文件夹中。
带时间戳的日志文件存储在“logs”文件夹中。

版本覆盖

某些情况下可能需要运行特定版本的Bedrock服务器，可通过“Version”环境变量实现：

bash
docker run -it -v yourvolumename:/minecraft -e Version=1.18.33.02 -p ***:***/udp -p ***:*** --restart unless-stopped 05jchambers/legendary-bedrock-container:latest

这在Microsoft未同时发布客户端和专用服务器版本时非常有用，可匹配玩家能连接的版本。

清理环境变量

若服务器启动遇到问题，可清理下载文件夹并强制重新安装最新版本：

bash
docker run -it -v yourvolumename:/minecraft -e Clean=Y -p ***:***/udp -p ***:*** 05jchambers/legendary-bedrock-container:latest

TZ（时区）环境变量

可将默认时区“America/Denver”修改为自定义时区：

bash
docker run -it -v yourvolumename:/minecraft -e TZ="America/Denver" -p ***:***/udp -p ***:*** 05jchambers/legendary-bedrock-container:latest

Linux时区列表

QuietCurl环境变量

可使用QuietCurl环境变量抑制curl的下载输出，使日志更整洁，但可能难以诊断问题。若运行正常，启用此选项是安全的，出现问题时可关闭以查看输出：

bash
docker run -it -v yourvolumename:/minecraft -p ***:***/udp -p ***:*** -e QuietCurl=Y 05jchambers/legendary-bedrock-container:latest

NoPermCheck环境变量

可通过NoPermCheck环境变量跳过权限检查（在大型服务器上可能较慢）：

bash
docker run -it -v yourvolumename:/minecraft -e NoPermCheck="Y" -p ***:***/udp -p ***:*** --restart unless-stopped 05jchambers/legendary-bedrock-container:latest

故障排除说明 - Oracle虚拟机

使用Oracle虚拟机时常见问题是，其配置比其他产品复杂得多。
症状是无法连接服务器，这不是启动后显示的第二组端口导致的（这是Bedrock多年的已知bug，所有服务器都会出现），而是因为需要执行以下步骤开放端口：

在虚拟云网络（VCN）安全列表中设置入站端口（TCP/UDP）
并在分配给实例的网络安全组中设置入站端口

这两项设置通常都需要配置才能连接VM实例，这纯粹是配置问题，与脚本或Minecraft服务器本身无关。
不推荐此平台，因其配置复杂，但成功配置后使用体验良好，请注意大多数用户会在配置过程中遇到困难。

补充链接：

[***]
[***]
[***]
[***]

故障排除说明 - Hyper-V

Hyper-V存在一个破坏Minecraft服务器UDP连接的奇怪bug，有两种修复方法：最简单的是使用第1代VM并搭配Legacy LAN网络驱动。

支持/***

很多人对此表示兴趣（你们都是天使，非常感谢）

***: ***
Venmo: @JamesAChambers
CashApp: $theremote
*** (BTC): ***

更新历史

2025年7月26日
- 升级到buildx构建流程以支持多架构镜像
- 移除Box64实验性支持，因其在新版本中长时间无法工作
2025年7月24日
- 修复下载URL问题
2025年2月8日
- 更新依赖项
2024年12月1日
- 修复下载URL问题
2024年5月19日
- 添加树莓派5和RK3588支持
- 拉取镜像05jchambers/legendary-bedrock-container:pi5获取5k块大小，05jchambers/legendary-bedrock-container:pi5-16k获取16K块大小
- 拉取镜像05jchambers/legendary-bedrock-container:rk3588获取RK3588优化的Box64构建
- 根据bedrock_server最新ldd修复依赖项
- 移除OpenSSL 1.1安装，因其不再需要
2023年12月13日
- 刷新软件包和依赖项
2023年10月1日
- 刷新软件包和依赖项
- 修复arm64构建
2023年1月14日
- 将连接测试从google.com更改为papermc，以避免在某些国家被屏蔽
2023年1月12日
- 移除损坏的ScheduleRestart环境变量 - 需在OS中使用docker restart实现（通常在Linux中使用crontab，Windows中使用任务计划程序）
2022年11月19日
- 添加“QuietCurl”环境变量，抑制curl进度条，使日志更整洁
- 移除fixpermissions.sh，将3行代码添加到主start.sh文件中
2022年11月7日
- 若无交互式终端则立即失败（Minecraft服务器需交互式终端才能运行）
2022年10月30日
- 修复新ScheduleRestart环境变量的bug
2022年10月21日
- 添加新环境变量“BackupCount”控制容器保留的备份数量
2022年10月20日
- 添加新环境变量“NoPermCheck”在启动时跳过权限检查
- 添加新环境变量“ScheduleRestart” - 安排容器在特定时间关闭，结合--restart开关实现每日重启功能
2022年9月27日
- 通过使用“exec”命令运行screen/java修复某些情况下的SIGTERM捕获问题（感谢vp-en）
2022年8月29日
- 添加TZ环境变量设置时区
- 在docker-compose.yml模板中添加环境变量
2022年8月22日
- 添加NoScreen环境变量 - 禁用screen，无需交互式终端（但会禁用部分日志）
2022年8月12日
- 在默认server.properties中启用“Content Log”，记录资源和行为包相关错误
- 添加“Clean”环境变量，用于故障排除/修复时强制清理并重新安装bedrock服务器
- 使用时在Docker启动命令中指定-e Clean=Y
2022年8月10日
- 添加nano编辑器，便于在容器内故障排除时使用
2022年8月2日
- 添加aarch64的实验性Box64支持 - 提升64位ARM用户的速度
- 需运行64位OS才能受益于Box64的速度提升（Ubuntu和树莓派OS均有64位版本）
- 检查是否为64位的简单方法：uname -m，若返回“aarch64”则为64位ARM
- 若Box64有问题（请在网站上提交issue/留言告知），可添加-e UseQEMU=Y到命令行以使用QEMU替代Box64
2022年7月14日
- 添加十几个新引入的依赖项 - 通过docker pull 05jchambers/legendary-bedrock-container:latest更新容器获取新依赖
- 从Ubuntu "Impish"更新到Ubuntu "Latest"基础镜像，因bedrock_server依赖项中现在链接了libssl3t64
2022年7月13日
- 更新基础Ubuntu镜像
2022年6月27日
- 更新基础Ubuntu镜像
2022年6月11日
- 添加allowlist.json和permissions.json默认模板文件，防止缺失时崩溃
2022年6月7日
- 添加docker-compose.yml模板供docker-compose使用
2022年6月2日
- 添加几个路径安全检查，以及更多关于Version环境变量使用路径的信息
2022年5月31日
- 添加默认server.properties文件，防止罕见的容器启动问题
2022年5月27日
- 清理qemu-user-static安装
2022年5月26日
- 修复新Version环境变量可能导致的无法工作问题
2022年5月25日
- 添加Version环境变量，示例：-e Version=1.19.10.20
2022年5月22日
- 修复aarch64上的容器启动问题
2022年5月21日
- 添加多架构Docker镜像
- 减小镜像大小
2022年5月17日
- 将Dockerfile基础镜像更新为ubuntu:latest
- 添加libssl1.1手动安装到基础镜像中
2022年5月15日
- 在start.sh开头添加screen -wipe，防止存在“死”screen实例时的启动问题（感谢grimholme，issue #2）
2022年5月12日
- 在Dockerfile中添加--platform=linux/amd64，因在aarch64平台上若无此参数容器无法成功启动（感谢Mootch，issue #1）
2022年5月9日
- 初始版本 - 感谢所有不断询问促使我最终完成的人！