ratomas/pokehaan-craft

Pokehaan Craft Docker镜像

镜像概述和主要用途

该Docker容器用于部署和运行Pokehaan Craft Minecraft模组包服务器。首次运行时，容器会下载并安装与标签版本一致的Pokehaan Craft模组包（此过程可能耗时，可通过日志查看进度）；后续运行则直接启动服务器，简化模组包服务器的搭建与维护流程。

核心功能和特性

• 自动部署：首次运行自动获取并安装对应版本的Pokehaan Craft模组包
• 持久化支持：需挂载数据目录以确保服务器数据（如世界文件、配置）持久化存储
• 灵活配置：通过环境变量自定义JVM参数、服务器信息、世界设置等关键配置
• 管理员管理：支持通过环境变量快速添加Minecraft服务器管理员账号

使用场景和适用范围

适用于需要快速部署Pokehaan Craft模组包Minecraft服务器的用户，无需手动处理模组安装和依赖配置，适合个人玩家、小型社群或游戏服务器管理者使用。

详细使用方法和配置说明

环境要求

• 数据目录挂载：必须将容器内的/data目录挂载到宿主机的持久化磁盘，用于保存服务器数据（世界文件、配置文件等）
• EULA同意：必须将EULA（最终用户许可协议）设置为true，通常通过修改挂载的/data/eula.txt文件实现（首次运行后生成该文件）

配置参数（环境变量）

可通过设置以下环境变量覆盖默认配置，具体说明如下：

添加Minecraft管理员

通过设置OPS环境变量添加服务器管理员，格式为逗号分隔的玩家名列表。示例：

bash
# 添加玩家"OpPlayer1"和"OpPlayer2"为服务器管理员
OPS="OpPlayer1,OpPlayer2"

Docker部署示例

1. 使用docker run命令快速部署

bash
docker run -d \
  --name pokehaan-server \  # 容器名称
  -p 25565:25565 \  # 映射Minecraft默认端口（宿主机端口:容器端口）
  -v /path/to/your/data:/data \  # 挂载宿主机持久化目录到容器/data
  -e EULA=true \  # 同意EULA（首次运行后需确认/data/eula.txt文件内容）
  -e OPS="YourPlayerName" \  # 添加管理员（替换为实际玩家名）
  -e JVM_OPTS="-Xms4096m -Xmx8192m" \  # 自定义JVM内存（根据服务器配置调整）
  -e MOTD="我的Pokehaan Craft服务器" \  # 自定义服务器公告
  ratomas/pokehaan-craft  # 镜像名称

2. 使用docker-compose配置部署

创建docker-compose.yml文件，内容如下：

yaml
version: '3'
services:
  pokehaan-craft:
    image: ratomas/pokehaan-craft
    container_name: pokehaan-server
    ports:
      - "25565:25565"  # 端口映射
    volumes:
      - /path/to/your/data:/data  # 持久化数据目录（替换为宿主机实际路径）
    environment:
      - EULA=true  # 同意EULA
      - OPS=AdminPlayer,AnotherAdmin  # 管理员列表（逗号分隔）
      - JVM_OPTS=-Xms4096m -Xmx8192m  # JVM内存配置
      - MOTD=Pokehaan Craft服务器 - 欢迎加入  # 服务器公告
    restart: unless-stopped  # 除非手动停止，否则容器异常时自动重启

保存后，执行docker-compose up -d启动服务。

源码和相关链接

• GitHub源码仓库：https://github.com/Ratomas/pokehaan-craft
• Docker Hub镜像地址：https://hub.docker.com/r/ratomas/pokehaan-craft