05jchambers/legendary-bedrock-container

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

这是https://github.com/TheRemote/MinecraftBedrockServer的Docker容器化版本。

主要博客文章（也是获取支持的最佳位置）。
https://github.com/TheRemote/Legendary-Bedrock-Container。
https://hub.docker.com/r/05jchambers/legendary-bedrock-container。

支持Geyser允许Bedrock玩家连接的Java版容器
https://github.com/TheRemote/Legendary-Java-Minecraft-Paper。

特性

• 搭建官方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 19132:19132/udp -p 19132:19132 -p 19133:19133/udp -p 19133:19133 --restart unless-stopped docker.xuanyuan.run/05jchambers/legendary-bedrock-container:latest

自定义端口：

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

仅IPV4：

bash
docker run -it -v yourvolumename:/minecraft -p 19132:19132/udp -p 19132:19132 --restart unless-stopped docker.xuanyuan.run/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 19132:19132/udp -p 19132:19132 --restart unless-stopped docker.xuanyuan.run/05jchambers/legendary-bedrock-container:latest

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

清理环境变量

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

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

TZ（时区）环境变量

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

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

Linux时区列表

QuietCurl环境变量

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

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

NoPermCheck环境变量

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

bash
docker run -it -v yourvolumename:/minecraft -e NoPermCheck="Y" -p 19132:19132/udp -p 19132:19132 --restart unless-stopped docker.xuanyuan.run/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网络驱动。

相关链接：

• [***]
• [***]

第二种修复方法由bpsimons分享：
首先安装ethtool：sudo apt install ethtool，然后在/etc/network/interfaces文件底部添加“offload-tx off”，问题似乎与TX卸载有关。
示例：

# 主网络接口
auto eth0
iface eth0 inet static
address 192.168.1.5
netmask 255.255.255.0
network 192.168.1.0
broadcast 192.168.1.255
gateway 192.168.1.1
offload-tx off

也可通过以下ethtool命令非持久化设置：

bash
ethtool -K eth0 tx off

支持/***

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

• ***: ***
• 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 docker.xuanyuan.run/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，https://github.com/TheRemote/Legendary-Bedrock-Container/issues/2）
• 2022年5月12日
  • 在Dockerfile中添加--platform=linux/amd64，因在aarch64平台上若无此参数容器无法成功启动（感谢Mootch，https://github.com/TheRemote/Legendary-Bedrock-Container/issues/1）
• 2022年5月9日
  • 初始版本 - 感谢所有不断询问促使我最终完成的人！