我的世界 Java 版 Docker 部署:itzg 镜像的类型、版本、内存与数据卷

用容器跑 Java 服能把核心类型、版本和启动参数写成配置,但数据卷、内存和自动更新配错就会出事故。

先给结论

社区常用的 itzg/minecraft-server 镜像可以通过环境变量选择服务端类型(如原版、Paper、Fabric、Forge 等)、游戏版本、内存和常用配置,适合多实例与标准化运维。部署时要确认 EULA、固定版本、正确挂载数据目录、合理设置内存,并清楚环境变量与配置文件的覆盖关系。容器化让升级回退更清晰,但不会替代备份与测试。

一、为什么用容器跑 Java 服

容器把 Java 运行环境、服务端核心和启动脚本封装在一起,避免宿主机 Java 版本混乱。

多实例时,每个服务器一个容器、一个数据目录、一个端口,结构清晰。

版本切换和回退可以通过修改环境变量和镜像标签完成,世界数据仍保留在宿主机。

容器化也会增加网络、日志和权限理解成本,团队需要熟悉基础容器操作。

小服单实例直接运行也可以,容器的优势在标准化和多服管理。

二、关键环境变量

EULA 必须明确接受,否则服务端不会启动。

TYPE 用于选择服务端类型,例如原版、Paper、Fabric 或 Forge 等,具体以镜像文档为准。

VERSION 用于指定游戏版本,生产环境建议固定具体版本,避免重建容器时被动升级。

内存相关变量决定 Java 堆大小,要根据宿主机总内存和其他服务占用设置。

把环境变量写进 compose 文件,并纳入版本记录。

三、数据卷挂载

容器内数据目录必须挂载到宿主机,否则删除或重建容器会丢失世界、插件和配置。

挂载目录中通常包含世界、插件、模组、配置和日志,是备份的主要对象。

宿主机目录权限要与容器运行用户匹配,权限不足会导致启动或保存失败。

不要把重要数据只放在容器内部层中。

数据目录放在性能稳定的磁盘上,世界越大越重要。

四、内存与 Java 参数

容器内 Java 堆大小不应占满宿主机全部内存,要为系统、数据库、备份和其他容器留余量。

如果容器设置了内存限制,Java 堆还要低于该限制,否则可能被系统终止。

大型模组服需要更多内存,但也要观察实际占用,不要盲目加大。

启动参数和 GC 设置应可追溯,修改后观察停顿时间和 TPS。

内存问题排查时,同时看容器日志、宿主机资源和 Java GC 输出。

五、配置文件与覆盖关系

镜像可能会根据环境变量写入 server.properties 等配置。

如果手工修改配置文件后重启又变回去,通常是环境变量覆盖了配置。

要明确哪些配置由环境变量管理,哪些由文件手工管理。

插件和模组配置通常仍在数据目录中维护,需要单独备份。

把覆盖规则写进文档,避免多人维护时互相覆盖。

六、升级与回退

升级前备份数据目录,再修改 VERSION 或镜像标签。

重建容器后检查日志,确认核心、插件或模组正常加载。

插件服升级还要确认插件兼容性,模组服要确认客户端整合包同步更新。

出现问题时恢复旧 VERSION 与旧数据备份即可回退。

不要让容器在无人知情时自动升级到新版本。

七、常见问题

有人问重建后世界没了。说明数据目录没有挂载到宿主机。

还有人问配置改了不生效。检查环境变量是否在启动时覆盖了文件。

也有人遇到容器被杀。检查内存限制与 Java 堆设置是否冲突。

最后一个常见问题是端口进不去。检查端口映射、宿主机防火墙与云安全组。

执行步骤

  1. 确定服务端类型、游戏版本和内存需求。
  2. 编写 compose 文件并设置 EULA、TYPE、VERSION 与内存变量。
  3. 把数据目录挂载到宿主机。
  4. 映射 Java 版端口并放行防火墙与安全组。
  5. 启动容器并检查日志。
  6. 明确环境变量与配置文件的覆盖关系。
  7. 建立数据目录备份与升级前备份流程。
  8. 固定版本,升级时在测试环境先验证。

验收标准

  • 容器重建后数据仍在。
  • 服务端类型与版本固定。
  • Java 堆小于容器与宿主机可用内存。
  • 配置覆盖规则有文档。
  • 端口外网可连接。
  • 升级回退流程可用。

常见误区

  • 未挂载数据目录。
  • 使用最新版本标签导致被动升级。
  • Java 堆设置超过容器限制。
  • 手工改配置却被环境变量覆盖。
  • 插件或模组未验证就升级。
  • 只做端口映射忘记防火墙。

Docker 能让 Java 服部署变得可复制,但核心仍是数据和版本管理。挂好数据卷、固定版本、控制内存、理清覆盖规则,容器化才真正降低运维成本。