在docker-minecraft-server中解决CurseForge模组包安装失败问题

在使用itzg/docker-minecraft-server镜像部署CurseForge模组包时，用户可能会遇到"failed to auto-install CurseForge modpack"错误。这个问题通常与模组包ZIP文件的路径或权限设置有关。

问题现象

当尝试通过docker-compose部署CurseForge模组包时，容器日志会显示以下关键错误信息：

java.nio.file.NoSuchFileException: /modpacks/Modded+OneBlock.zip

这表明容器无法在指定路径找到模组包文件。

常见原因分析

1. 文件路径错误：容器内挂载路径与docker-compose配置不匹配
2. 文件权限问题：容器用户(UID 1000)无法访问宿主机上的模组包文件
3. 文件名问题：文件名中包含特殊字符(如空格或加号)可能导致解析问题

解决方案

检查文件路径

确保docker-compose中配置的卷挂载路径与实际情况一致。例如：

volumes:
  - /host/path/to/modpacks:/modpacks:ro

验证文件权限

检查宿主机上模组包文件的权限设置，确保容器用户(UID 1000)有读取权限：

ls -l /host/path/to/modpacks

简化文件名

避免在文件名中使用特殊字符，改为简单的字母数字组合，如"ModdedOneBlock.zip"。

使用数据目录

作为替代方案，可以将模组包ZIP文件直接放入容器的/data目录，该目录默认具有正确的权限设置。

最佳实践建议

1. 在docker-compose配置中使用环境变量而非硬编码路径
2. 为模组包文件设置明确的644权限
3. 在部署前测试文件路径是否可访问
4. 考虑使用更简单的文件名避免解析问题

通过以上方法，大多数CurseForge模组包安装失败问题都可以得到解决。如果问题仍然存在，建议检查容器日志获取更详细的错误信息。