goobaroo/ftbskyfactory3

FTB Presents Skyfactory 3 Docker镜像

概述

该镜像用于运行FTB Presents Skyfactory 3 Minecraft模组包服务器，专为Unraid服务器构建（其他环境可能需要额外配置）。首次启动时会自动下载并安装指定版本的模组包，此过程耗时取决于网络速度和Forge安装器运行时间，可通过日志监控进度。后续启动则直接运行服务器。注意：镜像不包含任何Minecraft模组文件，所有文件均在运行时动态下载。

核心功能与特性

• 自动部署：首次运行自动下载并安装FTB Presents Skyfactory 3指定版本，无需手动配置
• 数据持久化：通过挂载/data目录实现服务器配置、世界数据等关键文件的持久化存储
• 灵活配置：支持自定义JVM参数、服务器描述（MOTD）及世界名称
• 管理员管理：通过环境变量快速添加服务器管理员（OP）
• EULA合规：需显式接受Mojang最终用户许可协议（EULA）方可启动服务器

使用场景

适用于希望搭建FTB Presents Skyfactory 3模组包服务器的用户，尤其推荐Unraid服务器用户使用。可满足个人或小型社群搭建专属模组服务器的需求，支持自定义游戏参数以优化体验。

使用方法与配置说明

基本要求

运行镜像前需满足以下条件：

• 持久化目录挂载：必须将容器内/data目录挂载至宿主机的持久化磁盘，用于存储服务器数据
• 端口映射：映射容器内25565/tcp端口（Minecraft默认服务器端口）至宿主机，供玩家连接
• EULA接受：通过环境变量EULA="true"显式接受Mojang EULA（默认值为false，未接受将无法启动服务器）

环境变量配置

可通过以下环境变量自定义服务器行为（默认值见括号内）：

添加服务器管理员（OP）

通过设置OPS环境变量添加管理员，值为逗号分隔的玩家名称，示例：
OPS="Player1,Player2"（将Player1和Player2设为管理员）

部署示例

Docker Run命令

bash
docker run -d \
  --name ftb-skyfactory3 \
  -p 25565:25565/tcp \
  -v /path/to/host/data:/data \
  -e EULA="true" \
  -e JVM_OPTS="-Xms4096m -Xmx6144m" \
  -e MOTD="My Custom Skyfactory 3 Server" \
  -e OPS="AdminPlayer" \
  goobaroo/ftbskyfactory3

Docker Compose配置

yaml
version: '3'
services:
  ftb-skyfactory3:
    image: goobaroo/ftbskyfactory3
    container_name: ftb-skyfactory3
    ports:
      - "25565:25565/tcp"
    volumes:
      - /path/to/host/data:/data  # 宿主机持久化目录
    environment:
      - EULA="true"               # 必须设为true以接受EULA
      - JVM_OPTS="-Xms4096m -Xmx6144m"  # 自定义JVM内存参数
      - MOTD="My Skyfactory 3 Server"   # 自定义服务器描述
      - LEVEL="my_world"          # 自定义世界名称
      - OPS="Admin,Moderator"     # 添加管理员玩家
    restart: unless-stopped       # 容器退出时自动重启（除非手动停止）

故障排除

EULA未接受

症状：服务器无法启动，日志中出现EULA相关错误提示。
解决：确保运行容器时设置环境变量EULA="true"，显式接受Mojang EULA。

文件权限问题

症状：/data目录下文件读写失败，日志显示权限被拒绝。
原因：容器内运行用户为uid 99、gid 100（适配Unraid环境），其他系统可能存在宿主机目录权限与容器用户不匹配的问题。
解决：调整宿主机挂载目录权限，确保uid 99和gid 100有读写权限；或通过--user参数覆盖容器运行用户（需测试兼容性）。

安装/升级失败

症状：服务器安装或升级过程中断，无法正常启动。
解决：删除/data目录下的下载服务器文件，重启容器以重新触发安装/升级流程。

来源

• GitHub仓库：https://github.com/Goobaroo/docker-ftbskyfactory3
• Docker Hub镜像：https://hub.docker.com/repository/docker/goobaroo/ftbskyfactory3