FTB OceanBlock Docker镜像文档

镜像概述

本容器用于运行FTB OceanBlock模组包服务器，专为Unraid服务器设计（其他系统可能需要额外配置）。首次启动时会下载与标签版本一致的FTB OceanBlock服务端并完成安装（安装过程可能耗时，可通过日志查看进度），后续启动将直接运行服务器。容器本身不包含任何Minecraft模组文件，所有文件均在运行时下载。

核心功能与特性

• 自动部署：首次运行自动下载并安装FTB OceanBlock服务端
• 持久化存储：支持将服务器数据（世界、配置等）存储在持久化卷中
• 灵活配置：通过环境变量自定义JVM参数、服务器描述、世界名称等
• 玩家管理：支持通过环境变量快速添加服务器管理员（OP）

使用要求

• 数据卷挂载：需将/data目录挂载到持久化磁盘（用于存储服务器数据）
• 端口映射：需映射25565/tcp端口（Minecraft默认服务端口）
• EULA接受：必须设置环境变量EULA="true"（用户需自行承担接受Mojang EULA的责任，容器默认EULA为false）

使用方法与配置说明

基础运行命令

bash
docker run -d \
  -p 25565:25565/tcp \
  -v /path/to/persistent/data:/data \
  -e EULA="true" \
  goobaroo/ftboceanblock

环境变量配置

以下环境变量可在运行时设置以覆盖默认值：

添加服务器管理员（OP）

通过OPS环境变量设置管理员，值为逗号分隔的玩家名称列表：

bash
docker run -d \
  -p 25565:25565/tcp \
  -v /path/to/persistent/data:/data \
  -e EULA="true" \
  -e OPS="OpPlayer1,OpPlayer2" \
  goobaroo/ftboceanblock

故障排除

EULA未接受

问题：服务器无法启动。
解决：检查是否设置环境变量EULA="true"，需显式接受Mojang EULA才能运行服务器。

文件权限问题

问题：/data目录挂载后出现权限错误。
原因：容器内运行用户的UID为99、GID为100（针对Unraid设计），其他系统可能因权限映射导致问题。
解决：调整宿主机/data目录权限，确保UID 99/GID 100有读写权限。

重置安装/升级

问题：服务端安装不完整或需要升级版本。
解决：删除/data目录下的已下载服务端文件，重启容器即可重新触发安装/升级流程。

源码与镜像地址

• GitHub：[***]
• Docker Hub：[***]