FTB Presents Stoneblock 2 Docker镜像文档

目录

• 镜像概述与主要用途
• 核心功能与特性
• 使用场景与适用范围
• 使用方法与配置说明
• 故障排除
• 相关资源

镜像概述与主要用途

本Docker镜像用于部署和运行FTB Presents Stoneblock 2 modpack服务器。容器首次启动时，会自动下载并安装与标签版本一致的FTB Presents Stoneblock 2服务端文件（此过程耗时较长，可通过日志监控进度）。首次安装完成后，后续启动将直接运行服务器。

注意：镜像未预装任何modded Minecraft文件，所有服务端及mod文件均在运行时动态下载。

核心功能与特性

• 自动部署：首次启动时自动下载并安装指定版本的FTB Presents Stoneblock 2服务端
• 灵活配置：支持通过环境变量自定义JVM参数、服务器MOTD（欢迎消息）、世界名称等核心配置
• 操作员管理：通过环境变量快速添加Minecraft服务器操作员（OP）
• 数据持久化：依赖外部挂载卷存储服务器数据（世界文件、配置等），确保数据不丢失
• Unraid优化：默认用户ID（uid 99）和组ID（gid 100）适配Unraid服务器环境

使用场景与适用范围

• 主要适用环境：Unraid服务器（镜像设计目标环境）
• 兼容场景：其他Linux发行版或Docker环境（需注意文件权限配置）
• 核心用途：快速搭建FTB Presents Stoneblock 2多人游戏服务器，简化服务端部署与维护流程

使用方法与配置说明

前置要求

1. 数据卷挂载：必须将宿主机目录挂载至容器内/data路径，用于持久化存储服务器配置、世界文件等数据
2. 端口映射：需映射容器内25565/tcp端口（Minecraft默认服务器端口）至宿主机，供玩家连接
3. EULA接受：必须通过环境变量设置EULA="true"，表示同意Mojang EULA（用户需自行承担接受EULA的***责任，默认值为false）

环境变量配置

以下环境变量可在运行时自定义，覆盖默认值：

部署示例

Docker Run命令

bash
docker run -d \
  --name stoneblock2-server \
  -v /path/to/host/data:/data \  # 替换为宿主机实际目录
  -p 25565:25565/tcp \
  -e EULA="true" \               # 必须接受EULA
  -e JVM_OPTS="-Xms4G -Xmx6G" \  # 自定义JVM内存参数（示例：4G初始/6G最大）
  -e MOTD="我的Stoneblock 2服务器" \  # 自定义服务器欢迎消息
  -e LEVEL="my_world" \          # 自定义世界名称
  -e OPS="AdminPlayer,ModPlayer" \  # 添加操作员
  goobaroo/stoneblock2

Docker Compose配置

yaml
version: '3'
services:
  stoneblock2:
    image: goobaroo/stoneblock2
    container_name: stoneblock2-server
    volumes:
      - /path/to/host/data:/data  # 宿主机数据目录
    ports:
      - "25565:25565/tcp"
    environment:
      - EULA="true"
      - JVM_OPTS="-Xms4G -Xmx6G"
      - MOTD="Stoneblock 2 Server [Docker]"
      - LEVEL="survival_world"
      - OPS="Owner,Admin"
    restart: unless-stopped  # 异常退出后自动重启

故障排除

EULA未接受

症状：服务器启动失败，日志提示EULA未同意。
解决：确保启动时设置环境变量EULA="true"（必须显式接受Mojang EULA）。

文件权限错误

症状：/data目录下文件读写失败，日志显示权限拒绝。
原因：镜像默认使用uid 99/gid 100运行（适配Unraid），其他系统中挂载的/data目录可能权限不匹配。
解决：调整宿主机挂载目录权限，确保uid 99和gid 100有读写权限（如通过chown -R 99:100 /path/to/host/data）。

安装或升级失败

症状：服务器启动卡在安装阶段，或版本不匹配。
解决：删除/data目录下已下载的服务端文件（如FTBServer-*.jar），容器将重新触发下载与安装流程。

相关资源

• GitHub源码：[***]
• Docker镜像仓库：[***]