解决docker-minecraft-server中All The Mods 10(ATM10)模组包的常见问题

2025-05-21 21:16:00作者：贡沫苏Truman

问题背景

在使用itzg/docker-minecraft-server部署All The Mods 10(ATM10)模组包时，许多用户遇到了服务器无法正常启动的问题。这些问题主要与特定模组的兼容性和自动下载机制有关。本文将详细分析这些问题的根源，并提供完整的解决方案。

核心问题分析

经过多个用户的案例研究，发现ATM10模组包在服务器端部署时主要存在以下两类问题：

客户端专用模组被错误包含：如Sodium和Sodium Extra等原本设计为客户端专用的模组被错误地下载到服务器端，导致服务器启动失败。
模组自动下载限制：部分模组作者禁止了自动下载功能，导致容器无法通过常规方式获取这些模组。

解决方案

1. 排除问题模组

通过配置CF_EXCLUDE_MODS环境变量，可以显式排除会导致问题的模组。以下是推荐的排除列表：

CF_EXCLUDE_MODS: |
  986380
  dark-mode-everywhere
  iceberg
  just-enough-mekanism-multiblocks
  model-gap-fix
  packmenu
  reeses-sodium-options
  sodium-extra
  toast-control

这些模组ID对应着已知会引发问题的模组，包括各种UI增强和客户端优化类模组。

2. 处理特殊模组下载限制

对于像Sodium这样禁止自动下载的模组，可以采用以下两种方法：

方法一：从Modrinth获取

MODRINTH_PROJECTS: sodium

方法二：手动下载后挂载 将手动下载的模组文件放入挂载的/mods目录中。

3. 完整配置示例

以下是经过验证可用的完整docker-compose配置示例：

version: '3.8'
services:
  mc:
    image: itzg/minecraft-server
    tty: true
    stdin_open: true
    ports:
      - "25565:25565"
    environment:
      EULA: "TRUE"
      TYPE: "AUTO_CURSEFORGE"
      CF_API_KEY: "your_api_key"
      CF_PAGE_URL: "https://www.curseforge.com/minecraft/modpacks/all-the-mods-10"
      CF_EXCLUDE_MODS:。