docker-minecraft-server 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-serverdocker-minecraft-server 的核心能力就是自动安装 CurseForge 模组包容器启动时自动下载指定模组包的全部模组并装好对应模组加载器一条命令跑起带模组包的服务器。下面以 ATM8 为例走通 CurseForge 模组包自动安装的全流程API key 配置与转义、模组包地址格式、排除客户端模组、内存分配以及手动下载与启动后自检。场景与第一现场ATM8 这类 CurseForge 模组包含几百个模组逐个手动下载不现实docker-minecraft-server 能在启动时读取模组包 manifest自动拉取全部模组和对应模组加载器这就是自动安装的典型场景。装不上时日志最先出现的大概率是两种现场下载过程卡住无进度或者列出一串Mods Need Download再往下就是启动时报class file version错误后崩溃。先把配置一次写对再照自检表对照修复。一份能直接跑的完整配置下面这份 compose 就是标准答案保存为compose.yaml后所有字段都能工作ATM8 完整示例附带网页文件管理可对照 ATM8 官方示例配置services: mc: image: itzg/minecraft-server:java17 # ATM8 基于 Java 17 运行tag 必须跟上 ports: - 25565:25565 environment: EULA: true MODPACK_PLATFORM: AUTO_CURSEFORGE # 开启 CurseForge 模组包自动安装模式 CF_API_KEY: ${CF_API_KEY} # 密钥本体放 .envcompose 只按名字引用 CF_PAGE_URL: https://www.curseforge.com/minecraft/modpacks/all-the-mods-8 # 上面是模组包页面地址启动时自动取最新版文件 MEMORY: 4G # 默认只给 1G模组包不够用 volumes: - mc-data:/data # 服务器数据落在命名卷里持久保存 - ./downloads:/downloads # 无法自动下载的模组放这个目录 volumes: mc-data: {}CF_API_KEY 放哪里、为什么必须转义镜像已内置一个 API key但更稳妥的是用自己的去 CurseForge 开发者控制台生成密钥然后决定放在哪。compose 会对配置里的${...}做变量替换而 CurseForge 密钥本身常含$——直接写进 compose$后面的字符会被当成变量名吃掉所以直接写在 compose 时每个$都要翻倍写成$$。更省事的做法是把密钥写进.env放在 compose 同目录compose 会自动加载用单引号包住就无需任何转义CF_API_KEY$11$22$33aaaaaaaaaaaaaaaaaaaaaaaaaa⚠️ 不要把密钥硬编码进 compose 文件.env里保留原文即可compose 里只写CF_API_KEY: ${CF_API_KEY}引用它。模组包地址用哪种格式CF_PAGE_URL有两种写法模组包页面 URL如上例自动取最新文件带/files/4248390的文件 URL锁定具体版本。不想用 URL 时可以改用CF_SLUGURL 里/modpacks/后面的短名如all-the-mods-8再搭配CF_FILE_ID数字文件 ID或CF_FILENAME_MATCHER文件名子串或/正则/匹配。锁了模组包版本模组加载器版本也随之锁定。⚠️ 选文件时别选server file服务器 jar它缺少 manifest自动安装流程会直接失效。为什么要排除客户端模组模组包里常混着客户端专用模组装到服务器上必然崩溃。CF_EXCLUDE_MODS接收逗号或空格分隔的模组 project slug 或 ID例如creative-core, default-options反过来的情况——模组被错标成客户端专用——用CF_FORCE_INCLUDE_MODS强制包含。镜像默认已内置一份排除清单 files/cf-exclude-include.json覆盖了常见的客户端模组不用逐个手动罗列。内存给多少、Java 版本怎么选把MEMORY设到至少4G这是文档给出的模组包底线ATM8 这类大包建议直接给6G–8G。镜像 tag 决定容器内 Java 版本ATM8 需要 Java 17所以用:java17完整 tag 对照表见 Java 版本说明。启动与自检.env和compose.yaml放在同一目录后用这两条命令启动并跟踪日志首次安装要下载全部模组耗时较长属正常docker compose up -d docker compose logs -f下载完成、服务器进入启动阶段即代表这次自动安装成功。之后对照下表排查日志现象一行修复下载卡住、超时加CF_PARALLEL_DOWNLOADS: 2降低并行下载数默认 4列出Mods Need Download用浏览器手动下载文件放进./downloads/mods目录class file version/UnsupportedClassVersionError镜像 tag 换成模组包要求的 Java 版本如:java17OutOfMemoryError或启动即崩MEMORY提到6G或8G反复出现Re-installing due to missing files把该文件加进CF_IGNORE_MISSING_FILES自打补丁的模组常见日志安静到无法定位问题时在 environment 里加上这两个调试开关启动过程会输出完整命令执行细节environment: DEBUG: true # 输出容器启动全过程报问题时也应附这份日志 DEBUG_EXEC: true # 只输出启动 Minecraft 服务用的命令行排查内存分配问题则改用DEBUG_MEMORY。处理 Mods Need Download手动下载流程日志输出Mods Need Download说明部分模组不允许自动下载——CurseForge 要求这类文件必须用浏览器下载。容器为此预留了/downloads路径同名文件会直接从那里取子目录mods、modpacks、worlds同样会检查。流程四步在 compose 文件旁边建一个downloads目录用浏览器逐个下载清单里的文件放进downloads/mods确认 compose 里有./downloads:/downloads挂载容器路径必须是/downloads重新执行docker compose up -d⚠️ 别用 curl/wget 硬抓这些文件宿主机没有图形界面时在其他机器上下载后用scp传过去。进阶选项低频操作CF_FORCE_SYNCHRONIZE: true强制重新评估模组的排除/包含规则改过排除配置后需要它CF_EXCLUDE_INCLUDE_FILE指向你自己的 JSON 排除文件结构参照 默认排除文件设为空字符串则关闭默认清单CF_MOD_LOADER_VERSION覆盖模组加载器版本如43.4.22与模组包声明差异过大可能不兼容CF_MODPACK_ZIP/CF_MODPACK_MANIFEST使用未公开发布的私有模组包 zip 或 manifest仍需提供 slugCF_OVERRIDES_EXCLUSIONS从模组包 overrides 里排除指定文件如mods/iris*.jarCF_DOWNLOADS_REPO修改手动下载文件的来源目录设为空字符串可禁用该功能配置一次写对之后容器每次启动都会自动完成下载模组 → 安装模组加载器 → 启动服务器发现 CurseForge 上有新版本时还会自动升级世界数据则永远不会被自动删除。卡住时先开调试开关拿到完整日志再按自检表逐项对照。延伸阅读CURSEFORGE_FILES 单独安装模组的完整说明Auto 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 模组包自动安装一次跑通 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-serverdocker-minecraft-server 的核心能力就是自动安装 CurseForge 模组包容器启动时自动下载指定模组包的全部模组并装好对应模组加载器一条命令跑起带模组包的服务器。下面以 ATM8 为例走通 CurseForge 模组包自动安装的全流程API key 配置与转义、模组包地址格式、排除客户端模组、内存分配以及手动下载与启动后自检。场景与第一现场ATM8 这类 CurseForge 模组包含几百个模组逐个手动下载不现实docker-minecraft-server 能在启动时读取模组包 manifest自动拉取全部模组和对应模组加载器这就是自动安装的典型场景。装不上时日志最先出现的大概率是两种现场下载过程卡住无进度或者列出一串Mods Need Download再往下就是启动时报class file version错误后崩溃。先把配置一次写对再照自检表对照修复。一份能直接跑的完整配置下面这份 compose 就是标准答案保存为compose.yaml后所有字段都能工作ATM8 完整示例附带网页文件管理可对照 ATM8 官方示例配置services: mc: image: itzg/minecraft-server:java17 # ATM8 基于 Java 17 运行tag 必须跟上 ports: - 25565:25565 environment: EULA: true MODPACK_PLATFORM: AUTO_CURSEFORGE # 开启 CurseForge 模组包自动安装模式 CF_API_KEY: ${CF_API_KEY} # 密钥本体放 .envcompose 只按名字引用 CF_PAGE_URL: https://www.curseforge.com/minecraft/modpacks/all-the-mods-8 # 上面是模组包页面地址启动时自动取最新版文件 MEMORY: 4G # 默认只给 1G模组包不够用 volumes: - mc-data:/data # 服务器数据落在命名卷里持久保存 - ./downloads:/downloads # 无法自动下载的模组放这个目录 volumes: mc-data: {}CF_API_KEY 放哪里、为什么必须转义镜像已内置一个 API key但更稳妥的是用自己的去 CurseForge 开发者控制台生成密钥然后决定放在哪。compose 会对配置里的${...}做变量替换而 CurseForge 密钥本身常含$——直接写进 compose$后面的字符会被当成变量名吃掉所以直接写在 compose 时每个$都要翻倍写成$$。更省事的做法是把密钥写进.env放在 compose 同目录compose 会自动加载用单引号包住就无需任何转义CF_API_KEY$11$22$33aaaaaaaaaaaaaaaaaaaaaaaaaa⚠️ 不要把密钥硬编码进 compose 文件.env里保留原文即可compose 里只写CF_API_KEY: ${CF_API_KEY}引用它。模组包地址用哪种格式CF_PAGE_URL有两种写法模组包页面 URL如上例自动取最新文件带/files/4248390的文件 URL锁定具体版本。不想用 URL 时可以改用CF_SLUGURL 里/modpacks/后面的短名如all-the-mods-8再搭配CF_FILE_ID数字文件 ID或CF_FILENAME_MATCHER文件名子串或/正则/匹配。锁了模组包版本模组加载器版本也随之锁定。⚠️ 选文件时别选server file服务器 jar它缺少 manifest自动安装流程会直接失效。为什么要排除客户端模组模组包里常混着客户端专用模组装到服务器上必然崩溃。CF_EXCLUDE_MODS接收逗号或空格分隔的模组 project slug 或 ID例如creative-core, default-options反过来的情况——模组被错标成客户端专用——用CF_FORCE_INCLUDE_MODS强制包含。镜像默认已内置一份排除清单 files/cf-exclude-include.json覆盖了常见的客户端模组不用逐个手动罗列。内存给多少、Java 版本怎么选把MEMORY设到至少4G这是文档给出的模组包底线ATM8 这类大包建议直接给6G–8G。镜像 tag 决定容器内 Java 版本ATM8 需要 Java 17所以用:java17完整 tag 对照表见 Java 版本说明。启动与自检.env和compose.yaml放在同一目录后用这两条命令启动并跟踪日志首次安装要下载全部模组耗时较长属正常docker compose up -d docker compose logs -f下载完成、服务器进入启动阶段即代表这次自动安装成功。之后对照下表排查日志现象一行修复下载卡住、超时加CF_PARALLEL_DOWNLOADS: 2降低并行下载数默认 4列出Mods Need Download用浏览器手动下载文件放进./downloads/mods目录class file version/UnsupportedClassVersionError镜像 tag 换成模组包要求的 Java 版本如:java17OutOfMemoryError或启动即崩MEMORY提到6G或8G反复出现Re-installing due to missing files把该文件加进CF_IGNORE_MISSING_FILES自打补丁的模组常见日志安静到无法定位问题时在 environment 里加上这两个调试开关启动过程会输出完整命令执行细节environment: DEBUG: true # 输出容器启动全过程报问题时也应附这份日志 DEBUG_EXEC: true # 只输出启动 Minecraft 服务用的命令行排查内存分配问题则改用DEBUG_MEMORY。处理 Mods Need Download手动下载流程日志输出Mods Need Download说明部分模组不允许自动下载——CurseForge 要求这类文件必须用浏览器下载。容器为此预留了/downloads路径同名文件会直接从那里取子目录mods、modpacks、worlds同样会检查。流程四步在 compose 文件旁边建一个downloads目录用浏览器逐个下载清单里的文件放进downloads/mods确认 compose 里有./downloads:/downloads挂载容器路径必须是/downloads重新执行docker compose up -d⚠️ 别用 curl/wget 硬抓这些文件宿主机没有图形界面时在其他机器上下载后用scp传过去。进阶选项低频操作CF_FORCE_SYNCHRONIZE: true强制重新评估模组的排除/包含规则改过排除配置后需要它CF_EXCLUDE_INCLUDE_FILE指向你自己的 JSON 排除文件结构参照 默认排除文件设为空字符串则关闭默认清单CF_MOD_LOADER_VERSION覆盖模组加载器版本如43.4.22与模组包声明差异过大可能不兼容CF_MODPACK_ZIP/CF_MODPACK_MANIFEST使用未公开发布的私有模组包 zip 或 manifest仍需提供 slugCF_OVERRIDES_EXCLUSIONS从模组包 overrides 里排除指定文件如mods/iris*.jarCF_DOWNLOADS_REPO修改手动下载文件的来源目录设为空字符串可禁用该功能配置一次写对之后容器每次启动都会自动完成下载模组 → 安装模组加载器 → 启动服务器发现 CurseForge 上有新版本时还会自动升级世界数据则永远不会被自动删除。卡住时先开调试开关拿到完整日志再按自检表逐项对照。延伸阅读CURSEFORGE_FILES 单独安装模组的完整说明Auto 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），仅供参考
)
)
