docker-minecraft-server完整实战CurseForge模组包自动安装一次跑通【免费下载链接】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-serverdocker-minecraft-server 容器的模组下载转了二十分钟还没完服务器启动后又直接崩溃——这种场面你大概率遇到过。这个镜像会在容器启动时自动安装/升级 Minecraft 版本、modloader 和 CurseForge 模组包本文以 ATM8 为例带你把这套 CurseForge 模组包自动安装走通照着配就能跑。ATM8 最小可用配置先给一个能直接跑起来的配置让你知道成功长什么样。以下内容放进 compose 文件仓库里的 ATM8 示例 可直接参考services: mc: image: itzg/minecraft-server:java17 # 镜像的 Java 版本必须匹配模组包要求 ports: - 25565:25565 environment: EULA: true MODPACK_PLATFORM: AUTO_CURSEFORGE # 告诉镜像从 CurseForge 自动装包 CF_PAGE_URL: https://www.curseforge.com/minecraft/modpacks/all-the-mods-8 CF_API_KEY: ${CF_API_KEY} # 密钥从 .env 注入不直接写死在文件里 MEMORY: 4G # 大型模组包至少给 4G volumes: - mc-data:/data volumes: mc-data: {}API 密钥在 CurseForge 开发者控制台console.curseforge.com申请存进.env文件再由 compose 通过${CF_API_KEY}引用。密钥里如果包含$字符必须在 .env 里写成双$否则会被当成变量引用导致值被截断CF_API_KEY$$2a$$10$$你的实际密钥 # 两个 $ 代表一个字面的 $想直接拿示例文件克隆仓库即可git clone https://gitcode.com/GitHub_Trending/do/docker-minecraft-server30 秒日志定位表出了问题先翻日志再用这张表对号入座比盲目重试快得多典型现象最可能的原因30 秒验证方法日志出现 401 / 鉴权失败CF_API_KEY 未设、过期或$转义失败docker inspect看容器 env 里密钥是否完整提示找不到匹配的模组包文件CF_FILENAME_MATCHER 没匹配到任何文件对照 CurseForge 文件页核对可用版本模组缺失、服务器起不来客户端专用模组混入服务器启动日志找 client-only 模组对照默认排除规则下载长时间卡住或超时并行下载数过多、网络不稳看日志里是否大量下载任务同时失败出现 OutOfMemoryError内存分配不足检查 compose 里 MEMORY模组包建议 4G 以上三类故障各修各的密钥类日志刷出鉴权错误时先别怀疑网络。按顺序确认三件事CF_API_KEY 是否真的传进了容器.env里的值是否完整重点看含$的地方有没有被吃掉密钥本身是否已过期。确认是密钥问题的话回开发者控制台重新申请一个只改.env即可compose 不用动。引用格式类定位不到文件时指向模组包的方式写错下载自然失败。下面三种写法等价任选其一# 方式1页面 URL拉该页面最新文件URL 指向具体文件则拉指定文件 CF_PAGE_URL: https://www.curseforge.com/minecraft/modpacks/all-the-mods-8 # 方式2项目 slug 数字文件 ID精确锁定某一个文件 CF_SLUG: all-the-mods-8 CF_FILE_ID: 4248390 # 方式3文件名子串或 /正则/ 选版本 CF_SLUG: all-the-mods-8 CF_FILENAME_MATCHER: 1.1.0最常见的两个坑文件 ID 和项目 ID 搞混项目 ID 在 CurseForge 项目页右侧以及 slug 与 URL 里/modpacks/后面的部分不一致。日志提示找不到文件时先把这三项和 CurseForge 页面对一遍。资源类内存和下载扛不住时日志里刷出OutOfMemoryError说明 JVM 内存不够把 MEMORY 提到 6G8G 即可。服务器一启动就崩通常是模组包与 modloader 版本不兼容此时用 CF_FILE_ID 锁定一个已验证兼容的文件最快。下载卡住或超时的话降低并行数CF_PARALLEL_DOWNLOADS: 2 # 默认 4网络扛不住时降到 2还有少数模组需要手动下载把 jar 放进主机的downloads/mods目录再给 compose 加一行挂载volumes: - ./downloads:/downloads镜像会自动识别并放入服务器。排除规则、强制同步与下载调优服务器能跑之后想剔除个别模组或纠正误判用这组变量CF_EXCLUDE_MODS逗号/空格分隔的项目 slug 或 ID支持#注释例如creative-core,default-optionsCF_FORCE_INCLUDE_MODS则用于把被误标为客户端的模组拉回来CF_EXCLUDE_INCLUDE_FILE指向一个 JSON 规则文件镜像内置默认规则是 files/cf-exclude-include.json可挂载自己的文件覆盖environment: CF_EXCLUDE_INCLUDE_FILE: /config/cf-exclude.json volumes: - ./cf-exclude.json:/config/cf-exclude.json:ro自定义文件结构示意与默认文件同构{ globalExcludes: [某客户端专用模组], modpacks: { all-the-mods-8: { excludes: [另一模组] } } }CF_FORCE_SYNCHRONIZE: true修改排除规则后必须开启否则会复用上次同步结果改动不生效DEBUG: true配合DEBUG_EXEC: true把安装脚本的执行过程逐行打出来排障时非常有用上线前的防坑清单.env 里的密钥含$就双写启动后用docker inspect验一次值镜像 tag如 java17必须与模组包要求的 Java 版本一致大型模组包内存给足 4G 起步吃紧就 6G8G改完排除规则记得开CF_FORCE_SYNCHRONIZE否则白改排障前先开 DEBUG 看日志能省一半瞎猜的时间更多细节可查CurseForge 自动安装文档、附加 CurseForge 文件、故障排除指南。【免费下载链接】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模组包自动安装一次跑通
docker-minecraft-server完整实战CurseForge模组包自动安装一次跑通【免费下载链接】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-serverdocker-minecraft-server 容器的模组下载转了二十分钟还没完服务器启动后又直接崩溃——这种场面你大概率遇到过。这个镜像会在容器启动时自动安装/升级 Minecraft 版本、modloader 和 CurseForge 模组包本文以 ATM8 为例带你把这套 CurseForge 模组包自动安装走通照着配就能跑。ATM8 最小可用配置先给一个能直接跑起来的配置让你知道成功长什么样。以下内容放进 compose 文件仓库里的 ATM8 示例 可直接参考services: mc: image: itzg/minecraft-server:java17 # 镜像的 Java 版本必须匹配模组包要求 ports: - 25565:25565 environment: EULA: true MODPACK_PLATFORM: AUTO_CURSEFORGE # 告诉镜像从 CurseForge 自动装包 CF_PAGE_URL: https://www.curseforge.com/minecraft/modpacks/all-the-mods-8 CF_API_KEY: ${CF_API_KEY} # 密钥从 .env 注入不直接写死在文件里 MEMORY: 4G # 大型模组包至少给 4G volumes: - mc-data:/data volumes: mc-data: {}API 密钥在 CurseForge 开发者控制台console.curseforge.com申请存进.env文件再由 compose 通过${CF_API_KEY}引用。密钥里如果包含$字符必须在 .env 里写成双$否则会被当成变量引用导致值被截断CF_API_KEY$$2a$$10$$你的实际密钥 # 两个 $ 代表一个字面的 $想直接拿示例文件克隆仓库即可git clone https://gitcode.com/GitHub_Trending/do/docker-minecraft-server30 秒日志定位表出了问题先翻日志再用这张表对号入座比盲目重试快得多典型现象最可能的原因30 秒验证方法日志出现 401 / 鉴权失败CF_API_KEY 未设、过期或$转义失败docker inspect看容器 env 里密钥是否完整提示找不到匹配的模组包文件CF_FILENAME_MATCHER 没匹配到任何文件对照 CurseForge 文件页核对可用版本模组缺失、服务器起不来客户端专用模组混入服务器启动日志找 client-only 模组对照默认排除规则下载长时间卡住或超时并行下载数过多、网络不稳看日志里是否大量下载任务同时失败出现 OutOfMemoryError内存分配不足检查 compose 里 MEMORY模组包建议 4G 以上三类故障各修各的密钥类日志刷出鉴权错误时先别怀疑网络。按顺序确认三件事CF_API_KEY 是否真的传进了容器.env里的值是否完整重点看含$的地方有没有被吃掉密钥本身是否已过期。确认是密钥问题的话回开发者控制台重新申请一个只改.env即可compose 不用动。引用格式类定位不到文件时指向模组包的方式写错下载自然失败。下面三种写法等价任选其一# 方式1页面 URL拉该页面最新文件URL 指向具体文件则拉指定文件 CF_PAGE_URL: https://www.curseforge.com/minecraft/modpacks/all-the-mods-8 # 方式2项目 slug 数字文件 ID精确锁定某一个文件 CF_SLUG: all-the-mods-8 CF_FILE_ID: 4248390 # 方式3文件名子串或 /正则/ 选版本 CF_SLUG: all-the-mods-8 CF_FILENAME_MATCHER: 1.1.0最常见的两个坑文件 ID 和项目 ID 搞混项目 ID 在 CurseForge 项目页右侧以及 slug 与 URL 里/modpacks/后面的部分不一致。日志提示找不到文件时先把这三项和 CurseForge 页面对一遍。资源类内存和下载扛不住时日志里刷出OutOfMemoryError说明 JVM 内存不够把 MEMORY 提到 6G8G 即可。服务器一启动就崩通常是模组包与 modloader 版本不兼容此时用 CF_FILE_ID 锁定一个已验证兼容的文件最快。下载卡住或超时的话降低并行数CF_PARALLEL_DOWNLOADS: 2 # 默认 4网络扛不住时降到 2还有少数模组需要手动下载把 jar 放进主机的downloads/mods目录再给 compose 加一行挂载volumes: - ./downloads:/downloads镜像会自动识别并放入服务器。排除规则、强制同步与下载调优服务器能跑之后想剔除个别模组或纠正误判用这组变量CF_EXCLUDE_MODS逗号/空格分隔的项目 slug 或 ID支持#注释例如creative-core,default-optionsCF_FORCE_INCLUDE_MODS则用于把被误标为客户端的模组拉回来CF_EXCLUDE_INCLUDE_FILE指向一个 JSON 规则文件镜像内置默认规则是 files/cf-exclude-include.json可挂载自己的文件覆盖environment: CF_EXCLUDE_INCLUDE_FILE: /config/cf-exclude.json volumes: - ./cf-exclude.json:/config/cf-exclude.json:ro自定义文件结构示意与默认文件同构{ globalExcludes: [某客户端专用模组], modpacks: { all-the-mods-8: { excludes: [另一模组] } } }CF_FORCE_SYNCHRONIZE: true修改排除规则后必须开启否则会复用上次同步结果改动不生效DEBUG: true配合DEBUG_EXEC: true把安装脚本的执行过程逐行打出来排障时非常有用上线前的防坑清单.env 里的密钥含$就双写启动后用docker inspect验一次值镜像 tag如 java17必须与模组包要求的 Java 版本一致大型模组包内存给足 4G 起步吃紧就 6G8G改完排除规则记得开CF_FORCE_SYNCHRONIZE否则白改排障前先开 DEBUG 看日志能省一半瞎猜的时间更多细节可查CurseForge 自动安装文档、附加 CurseForge 文件、故障排除指南。【免费下载链接】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），仅供参考
