pmmp/pocketmine-mp

PocketMine-Docker 镜像文档

镜像概述与主要用途

pmmp/pocketmine-mp Docker镜像用于简化PocketMine-MP服务器的部署流程。PocketMine-MP是一款高性能的Minecraft: Bedrock Edition服务器软件，该镜像通过容器化技术将服务器运行环境封装，支持跨Linux/macOS平台快速部署，提供数据与插件的持久化存储，适用于个人或小型社区搭建Minecraft: Bedrock Edition服务器。

核心功能与特性

• 持久化存储：通过卷挂载data和plugins目录，确保服务器配置、世界数据及插件在容器重启后不丢失
• 安全运行：默认使用非root用户pocketmine（UID 1000）运行，无sudo权限，降低安全风险
• 插件管理：支持通过POCKETMINE_PLUGINS环境变量自动从Poggit下载指定插件
• 端口映射：默认映射UDP端口***（Minecraft: Bedrock Edition标准端口），支持自定义宿主机端口
• 环境隔离：内置PHP运行环境，无需手动配置依赖，避免与宿主系统环境冲突

使用场景与适用范围

适用于需要快速搭建Minecraft: Bedrock Edition服务器的用户，包括：

• 个人玩家搭建私人服务器
• 小型游戏社区部署多人联机服务
• 开发者测试PocketMine-MP插件兼容性
• 需要隔离服务器环境、简化迁移或备份的场景

详细使用方法与配置说明

前提条件

• 已安装Docker环境（参考Docker官方文档）
• 运行环境为Linux或macOS（Windows系统运行Linux容器可能存在兼容性问题）
• 具备基础的命令行操作能力

准备工作

创建数据与插件目录

在宿主机创建用于存储服务器数据和插件的目录：

bash
mkdir data plugins

配置目录权限

容器内使用UID 1000的用户访问文件，需将目录所有者设为UID 1000（可通过echo $UID查看当前用户UID）：

bash
sudo chown -R 1000:1000 data plugins

若当前用户UID已为1000，此操作可能无实际效果；若目录位于系统保护路径，需使用sudo获取权限

• data目录：存储服务器配置文件、世界数据、玩家数据等持久化信息
• plugins目录：存放服务器插件，可在启动前将插件文件放入此目录

启动服务器

交互式运行（推荐新手）

启动服务器并进入实时控制台：

bash
docker run -it -p 19132:19132/udp -v $PWD/data:/data -v $PWD/plugins:/plugins pmmp/pocketmine-mp

参数说明：

• -it：启用交互式终端，支持服务器控制台输入输出
• -p 19132:19132/udp：端口映射（格式：宿主机端口:容器端口/协议），如需使用自定义端口，修改宿主机端口部分（如12345:19132/udp）
• -v $PWD/data:/data：将宿主机当前目录下的data挂载到容器/data目录
• -v $PWD/plugins:/plugins：将宿主机当前目录下的plugins挂载到容器/plugins目录

后台运行

如需在后台运行（守护进程模式），将-it替换为-itd：

bash
docker run -itd -p 19132:19132/udp -v $PWD/data:/data -v $PWD/plugins:/plugins pmmp/pocketmine-mp

后台运行管理命令：

• 查看运行中的容器：docker ps（获取容器ID/名称）
• 进入容器控制台：docker attach <容器ID/名称>（退出控制台使用Ctrl+p Ctrl+q，避免终止容器）
• 查看服务器日志：docker logs <容器ID/名称>
• 停止服务器：docker stop <容器ID/名称>

高级配置说明

卷（Volumes）

容器关键目录说明：

• /data：读写目录，存储服务器核心数据（server.properties、世界文件、玩家数据等），必须通过-v挂载至宿主机以实现持久化
• /plugins：只读目录（默认），存储插件文件，通过-v挂载后可在宿主机直接管理插件（添加/删除插件需重启服务器生效）

环境变量

• POCKETMINE_PLUGINS：插件自动下载配置，格式为插件名1:版本1 插件名2:版本2（版本可选）。示例：

  bash
  docker run -it -e "POCKETMINE_PLUGINS=EconomyAPI:5.7.2 LuckPerms" ... pmmp/pocketmine-mp
  

  容器启动时会检查/plugins目录，自动下载缺失的插件至/plugins目录

服务器目录结构

• /pocketmine：服务器工作目录，包含PocketMine-MP.phar执行文件，为默认用户pocketmine的家目录
• /usr/php：PHP运行环境目录，/usr/bin/php为PHP可执行文件的符号链接，确保服务器依赖正确加载

构建镜像说明

如需自行构建镜像，需指定构建参数PMMP_TAG（对应pmmp/PocketMine-MP仓库的分支或标签）。默认从GitHub拉取源码，不支持本地源码构建（可通过修改git clone命令调整）。

构建命令示例：

bash
docker build --build-arg PMMP_TAG=stable -t pmmp/pocketmine-mp .

构建需联网环境，PMMP_TAG需替换为实际分支/标签（如stable、beta或具体版本号）