circleeh/pocketmine

circleeh/pocketmine

镜像概述和主要用途

circleeh/pocketmine是Minecraft Pocket Edition（我的世界口袋版）的服务器软件PocketMine-MP的Docker容器化版本。PocketMine-MP是一款基于PHP开发的轻量级服务器软件，由Circle Eh!团队提供容器化支持，旨在简化我的世界口袋版服务器的部署和管理流程。

!PocketMine-MP

核心功能和特性

• 版本灵活性：支持通过Docker标签选择不同版本的PocketMine-MP，包括开发版、alpha版、beta版和稳定版
• 权限管理：可通过PUID/PGID环境变量配置用户和组ID，避免主机与容器间的数据卷权限问题
• 环境定制：支持设置时区（TZ），适应不同地区的时间配置需求
• 插件自动安装：通过PLUGINS环境变量指定插件PHAR文件URL，实现插件自动下载安装
• 数据持久化：通过数据卷挂载保存服务器配置文件，确保数据不丢失
• 端口映射：包含默认游戏端口（***）和RCON管理端口（25575）的映射支持

使用场景和适用范围

适用于需要快速搭建Minecraft Pocket Edition服务器的个人用户、小型游戏社区或教育机构。无需手动配置PHP环境和依赖项，通过Docker即可一键部署功能完整的我的世界口袋版服务器，支持插件扩展和个性化配置。

使用方法和配置说明

CLI命令部署

bash
docker create --name=pocketmine \
  -v <本地数据路径>:/config \
  -e PGID=<组ID> -e PUID=<用户ID> \
  -e TZ=<时区> \
  -p 19132:19132 \
  -p 19132/udp:19132/udp \
  -p 25575:25575 \
  circleeh/pocketmine

docker-compose.yml配置

yaml
version: "2"
services:
  pocketcraft:
    image: circleeh/pocketmine
    container_name: pocketmine
    environment:
      - TZ=America/Montreal  # 时区设置
      - PUID=1000           # 用户ID
      - PGID=1000           # 组ID
      - PLUGINS=https://poggit.pmmp.io/r/20052/PureEntitiesX_dev-192.phar
                https://poggit.pmmp.io/r/20015/Worlds_dev-16.phar
                https://poggit.pmmp.io/r/17958/XBL_PlayerList.phar  # 插件URL列表（空格分隔）
    volumes:
      - ~/docker/mc:/config  # 本地数据卷挂载路径
    ports:
      - "19132:19132"        # 游戏端口（TCP）
      - "19132/udp:19132/udp" # 游戏端口（UDP）
      - "25575:25575"        # RCON管理端口

注意：端口映射需根据服务器配置文件中的实际设置进行调整。

标签说明

可通过Docker标签选择特定版本的PocketMine-MP，标签命名规则与PocketMine-MP版本一致，同时提供通用标签：

• development：最新开发版
• alpha：最新alpha测试版
• beta：最新beta测试版
• stable：最新稳定版
• latest：默认标签（等同于最新stable版）

示例：

bash
docker pull circleeh/pocketmine:development  # 拉取开发版镜像

参数说明

参数格式为主机端:容器端，左侧为主机配置，右侧为容器内部配置：

用户/组标识符

使用数据卷（-v参数）时，可能出现主机与容器间的权限冲突。通过指定PUID（用户ID）和PGID（组ID）可避免此问题，需确保主机数据卷目录的所有者与指定的PUID/PGID一致。

获取当前用户的PUID和PGID：

bash
id <用户名>
# 示例输出：uid=1000(用户名) gid=1000(组名) groups=1000(组名)

额外信息

• 容器内Shell访问：

  bash
  docker exec -it pocketmine /bin/bash
  

• 实时查看日志：

  bash
  docker logs -f pocketmine
  

• 查看容器版本：

  bash
  docker inspect -f '{{ index .Config.Labels "build_version" }}' pocketmine
  

• 查看镜像版本：

  bash
  docker inspect -f '{{ index .Config.Labels "build_version" }}' circleeh/pocketmine