SkyFactory 4 - 4.2.4 Docker镜像文档

镜像概述

本Docker容器用于运行Minecraft模组包SkyFactory 4 - 4.2.4，主要为Unraid服务器设计，其他系统环境下使用效果可能不同。容器首次运行时会自动下载并安装指定版本的SkyFactory 4，此过程可能因Forge安装程序耗时较长，可通过日志查看进度；后续运行则直接启动服务器。注意：容器不包含预装的Minecraft模组文件，所有文件均在运行时下载。

核心功能与特性

• 自动安装：首次运行自动下载并安装SkyFactory 4 - 4.2.4版本
• 持久化存储：支持将服务器数据挂载到持久磁盘，确保数据不丢失
• 灵活配置：通过环境变量自定义JVM参数、服务器描述、世界名称等
• 操作员管理：支持通过环境变量快速添加Minecraft服务器操作员
• 轻量设计：不包含预装模组文件，运行时动态获取，减少镜像体积

使用场景

• 搭建个人或小型社区的SkyFactory 4模组服务器
• 在Unraid服务器环境中便捷部署和管理Minecraft模组服务器
• 需要快速部署且支持自定义配置的Minecraft模组服务场景

使用方法与配置说明

前置要求

• 数据持久化：需将容器内/data目录挂载到宿主机的持久化存储路径
• 端口映射：映射TCP端口25565（Minecraft默认服务器端口）
• EULA接受：必须设置环境变量EULA="true"，表示您同意Mojang的最终用户许可协议

环境变量配置

部署示例

Docker Run命令

bash
docker run -d \
  --name skyfactory4 \
  -p 25565:25565/tcp \
  -v /path/to/persistent/data:/data \
  -e EULA="true" \
  -e JVM_OPTS="-Xms3072m -Xmx6144m" \
  -e MOTD="我的SkyFactory 4服务器" \
  -e OPS="Player1,Player2" \
  goobaroo/skyfactory4

参数说明

• -d：后台运行容器
• --name skyfactory4：指定容器名称为skyfactory4
• -p 25565:25565/tcp：映射服务器端口
• -v /path/to/persistent/data:/data：挂载持久化数据目录（替换/path/to/persistent/data为实际路径）
• -e EULA="true"：接受Mojang EULA
• 其他环境变量按需配置

故障排除

EULA未接受

问题：服务器无法启动。
解决：检查是否设置环境变量EULA="true"，需显式接受Mojang的最终用户许可协议。

文件权限错误

问题：/data目录下文件读写失败。
原因：容器内运行用户的UID为99、GID为100，与宿主机目录权限不匹配（主要针对非Unraid系统）。
解决：调整宿主机挂载目录的权限，确保UID 99和GID 100有读写权限。

安装不完整

问题：首次运行后服务器未正确安装。
解决：删除/data目录中下载的服务器文件，重启容器将重新触发安装流程。

相关资源

• GitHub源码：[***]
• Docker Hub镜像：[***]