magicalyak/pocketmine

Pocketmine Docker镜像

镜像概述和主要用途

该镜像为Minecraft Bedrock Dedicated Server的Docker实现，允许Minecraft Pocket Edition客户端（包括iOS、Android、Windows 10、Xbox、Switch）连接至自托管服务器。容器运行微软官方Bedrock Dedicated Server，基于Debian Slim基础镜像优化，在保持与现有设置完全兼容的前提下，容器体积减少近50%。

本项目参考了以下开发者的代码：

• https://github.com/nmarus/docker-pocketmine
• https://github.com/nguyer/bedrock-server
• https://github.com/Roemer/bedrock-server
• https://github.com/subhaze/bedrock-server
• https://github.com/toasterlint/minecraft_bedrock

核心功能和特性

• 运行微软官方Minecraft Bedrock Dedicated Server
• 基于Debian Slim优化，容器体积减少近50%（153MB vs 294MB）
• 支持数据卷持久化配置，确保服务器设置、世界数据不丢失
• 兼容x86_64和ARM架构（需启用Rosetta模拟）
• 提供完整的服务器管理控制台交互

系统要求

• 已安装并运行Docker
• ***/UDP端口可用
• ARM架构系统（M1/M2 Mac、树莓派等）：需启用Docker Desktop的Rosetta模拟

使用方法和配置说明

创建Docker容器

基础创建命令（不推荐，配置文件会在容器停止后丢失）：

bash
docker create -it -p 19132:19132/udp --name pocketmine magicalyak/pocketmine

推荐创建命令（使用数据卷持久化配置）：

1. 首先在主机创建存储目录：

   bash
   mkdir /srv/pocketmine
   

2. 创建容器并映射卷：

   bash
   docker create -it -p 19132:19132/udp -v /srv/pocketmine:/data --name pocketmine magicalyak/pocketmine
   

可选参数：--restart=unless-stopped 确保容器在主机重启后自动启动

配置Minecraft PE服务器

1. 配置server.properties
   根据需求修改服务器设置文件，如服务器名称、最大玩家数、难度等。

2. 配置白名单（whitelist.json）
   当server.properties中设置white-list=true时生效。xuid为可选，玩家首次连接后会自动添加。示例：

   json
   [
       {
           "ignoresPlayerLimit": false,
           "name": "MyPlayer"
       },
       {
           "ignoresPlayerLimit": false,
           "name": "AnotherPlayer",
           "xuid": "274817248"
       }
   ]
   

3. 配置权限（permissions.json）
   定义玩家权限，包括member（成员）、visitor（访客）、operator（管理员）。xuid可从玩家首次连接后的白名单文件中获取。示例：

   json
   [
       {
           "permission": "operator",
           "xuid": "274817248"
       }
   ]
   

启动容器

若容器已停止（可通过docker ps -a查看状态），启动命令：

bash
docker start pocketmine

停止容器

如需重启主机或更新配置文件，停止容器命令：

bash
docker stop pocketmine

服务器管理交互

进入服务器控制台：

bash
docker attach pocketmine

退出控制台：按CTRL-P+CTRL-Q（若使用CTRL-C会终止容器）

控制台命令说明：

查看实时日志

bash
docker logs -l pocketmine

按CTRL-C退出日志查看

更新服务器版本

bash
docker stop pocketmine
docker pull magicalyak/pocketmine:latest
docker start pocketmine

从旧版本升级

新镜像与现有数据卷完全兼容，世界、配置和设置将被保留。仅容器镜像体积减小（153MB vs 294MB），更高效。

变更日志

• 09.19.25：重大更新，切换至Debian Bookworm Slim基础镜像（体积减少约50%），更新至Bedrock Server 1.21.51.02，修复下载逻辑，添加x86_64 ARM兼容模拟
• 07.26.20：更新至最新版本，操作系统更新为1.0.0-bionic
• 10.02.19：更新至v1.9.0.15
• 04.02.19：修复控制台命令无法使用问题 https://github.com/magicalyak/pocketmine/issues/6
• 03.02.19：Bedrock Server版本1.8.1.2