Docker Minecraft Server 容器自动停止问题排查指南

问题背景

在使用 itzg/docker-minecraft-server 镜像部署 Minecraft 服务器时，用户遇到了服务器在20分钟不活动后自动停止的问题。虽然用户已经按照文档设置了 ENABLE_AUTOSTOP=FALSE 并创建了 .skip-stop 文件，但问题仍然存在。

关键发现

1. 镜像自带的自动停止功能确认已禁用
   通过检查 compose 文件中的环境变量配置 ENABLE_AUTOSTOP: "FALSE"，可以确认 itzg 镜像原生的自动停止功能确实已被正确禁用。日志中也未出现该功能相关的启动信息。

2. 日志中的异常信息
   服务器日志中出现了来自 EssentialsXGeoIP 插件的错误，提示缺少 GeoIP 数据库文件。虽然这个错误与自动停止问题无关，但值得注意并单独处理。

3. 第三方插件导致的自动停止
   深入分析日志后发现，实际触发自动停止的是 vane-admin 插件。该插件内置了自己的自动停止功能，与容器本身的自动停止机制无关。

解决方案

1. 对于 vane-admin 插件的自动停止

   • 查阅插件文档，找到禁用其自动停止功能的方法
   • 修改插件配置文件中的相关设置
   • 或者考虑使用其他替代插件

2. 对于 EssentialsXGeoIP 的错误

   • 获取合法的 GeoIP 许可证密钥
   • 下载并放置正确的 GeoIP 数据库文件到指定目录

经验总结

1. 问题排查方法论

   • 当遇到意外行为时，首先确认相关功能是否确实来自当前使用的平台/工具
   • 仔细阅读日志，区分不同组件产生的日志信息
   • 逐步排除法能有效定位问题根源

2. 容器化 Minecraft 服务器的最佳实践

   • 明确区分容器层面的功能和服务内部插件功能
   • 保持插件更新并熟悉其完整功能
   • 定期检查日志以发现潜在问题

3. 性能优化建议

   • 根据服务器负载调整 JVM 内存参数
   • 考虑使用更高效的垃圾回收策略
   • 监控服务器资源使用情况

后续建议

对于使用 itzg/docker-minecraft-server 镜像的用户，建议：

• 完整阅读插件文档，了解其全部功能
• 建立系统的日志分析习惯
• 在添加新插件时，先在小规模测试环境中验证
• 定期备份重要数据和配置

通过这次问题排查，我们不仅解决了具体的自动停止问题，更重要的是建立了一套完整的容器化 Minecraft 服务器问题诊断方法，这对日后维护和优化服务器性能都有重要参考价值。