docker-minecraft-server CurseForge模组包自动安装失败速查4步彻底解决【免费下载链接】docker-minecraft-serverDocker image that provides a Minecraft Server for Java Edition that automatically installs/upgrades versions, modloaders, modpacks and more at startup项目地址: https://gitcode.com/GitHub_Trending/do/docker-minecraft-server本文适用场景docker-minecraft-server 配置MODPACK_PLATFORM: AUTO_CURSEFORGE后容器启动时下载或安装 CurseForge 模组包失败、反复退出。读完你能从日志判断安装卡在哪一步并逐项修复让服务器正常拉起。 动手前检查一半的安装失败源于前置条件没到位先确认这五项已安装 Docker 与 Docker Compose能正常启动普通容器镜像 tag 与模组包声明的 Java 版本匹配如itzg/minecraft-server:java17tag 对照见 Java 版本文档EULA: true已设置CF_PAGE_URL或CF_SLUG指向你要装的模组包MEMORY至少4G——镜像默认只有 1G大型模组包会直接压垮 JVM 先定位问题AUTO_CURSEFORGE 的安装逻辑在容器启动早期执行失败时容器立即退出。对着下面这张表查日志先判断卡在哪一环日志现象卡住的环节Failed to auto-install CurseForge modpack后退出模组包解析/下载阶段API key 或引用配置有误输出 Mods Need Download 并列出模组名不是报错这些模组禁止自动下载需放入/downloads装完后报class file version错误镜像 Java 版本低于模组包要求JVM 日志出现OutOfMemoryErrorMEMORY分配不足每次启动都出现Re-installing due to missing files模组会自行删除部分文件需用CF_IGNORE_MISSING_FILES忽略启动流程大致如下注意模组包部署发生在世界数据准备之前 修复操作1. API密钥与模组包引用写对失败最集中在这两个变量上。镜像已内置一个可用的 CurseForge API keyCF_API_KEY仅在你想用自己的密钥时才需要从 CurseForge 开发者控制台申请即可。用自己的密钥时注意转义规则直接写在 compose 文件里密钥中每个$都要写成$$放进与 compose 同目录的.env文件值用单引号包裹compose 中写${CF_API_KEY}.env内不需要再转义environment: CF_API_KEY: $$11$$22$$33aaaaaaaaaaaaaaaaaaaaaaaaaa # 双$转义单个$模组包引用三选一页面完整 URLCF_PAGE_URL、模组包 SlugCF_SLUG页面 URL 中/modpacks/后的短标识、或固定版本的CF_FILE_ID。想固定版本还可以用CF_FILENAME_MATCHER按文件名子串匹配。引用填错是 Failed to auto-install 的第一大原因。2. 把 Mods Need Download 放进 /downloads部分模组不允许自动下载安装日志会以 Mods Need Download 列出清单。做法是用浏览器逐个下载放到本地目录再挂载给容器容器内路径必须是/downloads子目录mods、modpacks、worlds都会被查找然后重新upvolumes: - ./downloads:/downloads # 把宿主机目录挂进容器挂载结构如下图所示3. 排除客户端专用模组模组包常携带客户端专用模组服务端加载后会立刻崩溃。把模组的 Slug 或 project ID 写进CF_EXCLUDE_MODS逗号或空格分隔支持#注释。镜像内置规则文件 files/cf-exclude-include.json 默认生效可用CF_EXCLUDE_INCLUDE_FILE指向自己的 JSON设为空字符串则禁用。改完规则必须加CF_FORCE_SYNCHRONIZE: true强制重新求值因为排除规则默认只在首次安装时计算environment: CF_EXCLUDE_MODS: | # 多行列表一行一个 creative-core default-options CF_FORCE_SYNCHRONIZE: true # 强制重新评估排除规则4. Java版本与内存对齐模组包的 Forge/NeoForge 版本绑定特定 Java 版本。装完报class file version说明镜像 Java 太旧OutOfMemoryError说明内存不够。改 tag 和MEMORY即可image: itzg/minecraft-server:java21 # 换成与模组包匹配的Java版本 environment: MEMORY: 4G # 大型模组包建议4G以上✅ 验证成功重启后跟一下日志docker compose up -d docker compose logs -f mc预期正确结果日志中不再出现Failed to auto-install CurseForge modpack模组包安装输出结束后服务器打印Done并进入就绪状态此时从客户端连入能正常看到模组加载。如果仍卡住加DEBUG: true让日志输出完整安装命令再按 排障指南 的方法核对。⚡ 高频报错速查报错原因一句话修法Failed to auto-install CurseForge modpackAPI key 失效/转义错或 URL、Slug 找不到模组包核对CF_API_KEY转义确认CF_PAGE_URL/CF_SLUG准确Mods Need Download 提示部分模组禁止自动下载浏览器下载后放入挂载到/downloads的目录class file version错误 /OutOfMemoryError镜像 Java 版本低或内存不足换java17/java21等 tagMEMORY: 4G起步相关资源AUTO_CURSEFORGE 官方文档ATM8 完整示例配置通用排障指南【免费下载链接】docker-minecraft-serverDocker image that provides a Minecraft Server for Java Edition that automatically installs/upgrades versions, modloaders, modpacks and more at startup项目地址: https://gitcode.com/GitHub_Trending/do/docker-minecraft-server创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 docker-minecraft-server CurseForge模组包自动安装失败速查：4步彻底解决
docker-minecraft-server CurseForge模组包自动安装失败速查4步彻底解决【免费下载链接】docker-minecraft-serverDocker image that provides a Minecraft Server for Java Edition that automatically installs/upgrades versions, modloaders, modpacks and more at startup项目地址: https://gitcode.com/GitHub_Trending/do/docker-minecraft-server本文适用场景docker-minecraft-server 配置MODPACK_PLATFORM: AUTO_CURSEFORGE后容器启动时下载或安装 CurseForge 模组包失败、反复退出。读完你能从日志判断安装卡在哪一步并逐项修复让服务器正常拉起。 动手前检查一半的安装失败源于前置条件没到位先确认这五项已安装 Docker 与 Docker Compose能正常启动普通容器镜像 tag 与模组包声明的 Java 版本匹配如itzg/minecraft-server:java17tag 对照见 Java 版本文档EULA: true已设置CF_PAGE_URL或CF_SLUG指向你要装的模组包MEMORY至少4G——镜像默认只有 1G大型模组包会直接压垮 JVM 先定位问题AUTO_CURSEFORGE 的安装逻辑在容器启动早期执行失败时容器立即退出。对着下面这张表查日志先判断卡在哪一环日志现象卡住的环节Failed to auto-install CurseForge modpack后退出模组包解析/下载阶段API key 或引用配置有误输出 Mods Need Download 并列出模组名不是报错这些模组禁止自动下载需放入/downloads装完后报class file version错误镜像 Java 版本低于模组包要求JVM 日志出现OutOfMemoryErrorMEMORY分配不足每次启动都出现Re-installing due to missing files模组会自行删除部分文件需用CF_IGNORE_MISSING_FILES忽略启动流程大致如下注意模组包部署发生在世界数据准备之前 修复操作1. API密钥与模组包引用写对失败最集中在这两个变量上。镜像已内置一个可用的 CurseForge API keyCF_API_KEY仅在你想用自己的密钥时才需要从 CurseForge 开发者控制台申请即可。用自己的密钥时注意转义规则直接写在 compose 文件里密钥中每个$都要写成$$放进与 compose 同目录的.env文件值用单引号包裹compose 中写${CF_API_KEY}.env内不需要再转义environment: CF_API_KEY: $$11$$22$$33aaaaaaaaaaaaaaaaaaaaaaaaaa # 双$转义单个$模组包引用三选一页面完整 URLCF_PAGE_URL、模组包 SlugCF_SLUG页面 URL 中/modpacks/后的短标识、或固定版本的CF_FILE_ID。想固定版本还可以用CF_FILENAME_MATCHER按文件名子串匹配。引用填错是 Failed to auto-install 的第一大原因。2. 把 Mods Need Download 放进 /downloads部分模组不允许自动下载安装日志会以 Mods Need Download 列出清单。做法是用浏览器逐个下载放到本地目录再挂载给容器容器内路径必须是/downloads子目录mods、modpacks、worlds都会被查找然后重新upvolumes: - ./downloads:/downloads # 把宿主机目录挂进容器挂载结构如下图所示3. 排除客户端专用模组模组包常携带客户端专用模组服务端加载后会立刻崩溃。把模组的 Slug 或 project ID 写进CF_EXCLUDE_MODS逗号或空格分隔支持#注释。镜像内置规则文件 files/cf-exclude-include.json 默认生效可用CF_EXCLUDE_INCLUDE_FILE指向自己的 JSON设为空字符串则禁用。改完规则必须加CF_FORCE_SYNCHRONIZE: true强制重新求值因为排除规则默认只在首次安装时计算environment: CF_EXCLUDE_MODS: | # 多行列表一行一个 creative-core default-options CF_FORCE_SYNCHRONIZE: true # 强制重新评估排除规则4. Java版本与内存对齐模组包的 Forge/NeoForge 版本绑定特定 Java 版本。装完报class file version说明镜像 Java 太旧OutOfMemoryError说明内存不够。改 tag 和MEMORY即可image: itzg/minecraft-server:java21 # 换成与模组包匹配的Java版本 environment: MEMORY: 4G # 大型模组包建议4G以上✅ 验证成功重启后跟一下日志docker compose up -d docker compose logs -f mc预期正确结果日志中不再出现Failed to auto-install CurseForge modpack模组包安装输出结束后服务器打印Done并进入就绪状态此时从客户端连入能正常看到模组加载。如果仍卡住加DEBUG: true让日志输出完整安装命令再按 排障指南 的方法核对。⚡ 高频报错速查报错原因一句话修法Failed to auto-install CurseForge modpackAPI key 失效/转义错或 URL、Slug 找不到模组包核对CF_API_KEY转义确认CF_PAGE_URL/CF_SLUG准确Mods Need Download 提示部分模组禁止自动下载浏览器下载后放入挂载到/downloads的目录class file version错误 /OutOfMemoryError镜像 Java 版本低或内存不足换java17/java21等 tagMEMORY: 4G起步相关资源AUTO_CURSEFORGE 官方文档ATM8 完整示例配置通用排障指南【免费下载链接】docker-minecraft-serverDocker image that provides a Minecraft Server for Java Edition that automatically installs/upgrades versions, modloaders, modpacks and more at startup项目地址: https://gitcode.com/GitHub_Trending/do/docker-minecraft-server创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考