如何用 docker-minecraft-server 从零搭建 Minecraft 服务器：从首次启动到整合包部署的完整指南

【免费下载链接】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

你是否曾经为了搭一个 Minecraft 服务器，在官网翻找服务端下载链接、手动配置 Forge、逐个搬运 mod，最后还要担心版本不兼容？如果答案是肯定的，那么 docker-minecraft-server 就是为你准备的"一键式"解决方案。这个开源的 Docker 镜像会在容器启动时自动完成服务端下载、版本升级、模组加载器安装和整合包部署，让你把精力留给真正重要的事情——和朋友们一起愉快地开黑。

这个镜像到底帮你省掉了哪些事

在传统流程里，搭建一个带 mod 的服务器通常意味着：下载对应版本的服务端 jar → 安装 Forge 或 Fabric → 上传整合包 → 手动修改 server.properties → 反复调试启动参数。而 docker-minecraft-server 把这一切都封装进了容器的启动脚本中。

上图展示的正是容器启动时的完整处理流程：它会先判断是否启用自动暂停等特性，然后根据你声明的TYPE选择对应的部署脚本，最后依次完成世界目录、数据包、服务端属性等初始化，才真正拉起 Java 进程。这套流程的每一步都可以通过环境变量控制，你只需要告诉它"我想要什么"，剩下的交给它去办。

第一步：5 分钟跑起一个原版服务器

最简配置只需要两个环境变量——同意 EULA 协议，然后声明数据目录。

services: mc: image: itzg/minecraft-server tty: true stdin_open: true ports: - "25565:25565" environment: EULA: "TRUE" volumes: - ./data:/data

保存为compose.yml后执行docker compose up -d，首次启动会自动下载对应版本的原版服务端并完成初始化。之后想要升级版本，只需修改VERSION变量（例如VERSION: 1.20.4）再重启容器，镜像会自动处理升级。

小提示：EULA 必须显式声明为true，这是所有 Minecraft 服务端启动的前提，也是新手最容易卡住的第一关。

第二步：按需选择服务端类型，性能和生态兼得

原版服务端功能有限，绝大多数玩家会选择社区服务端。镜像通过TYPE变量一键切换，常见选项如下：

例如选择 Paper 服务端并开启视距优化，配置如下（完整示例可参考 examples/optimized-server-config/docker-compose.yml）：

environment: EULA: "true" TYPE: "PAPER" VIEW_DISTANCE: 10 MEMORY: 2G

不同服务端类型对应各自的部署脚本，具体差异可查阅 docs/types-and-platforms/index.md。

第三步：整合包与模组，一条命令自动部署

这大概是整个镜像最惊艳的能力。以 CurseForge 整合包为例，只需把TYPE设为AUTO_CURSEFORGE，再提供整合包页面地址即可：

environment: EULA: "true" TYPE: AUTO_CURSEFORGE CF_PAGE_URL: https://www.curseforge.com/minecraft/modpacks/xxx

容器会在启动时自动解析整合包、安装匹配的 Forge/Fabric 版本、下载全部 mod，并把文件落入挂载的下载目录。Modrinth、FTB 等平台同样支持，配合MODS、PLUGINS变量还可以直接按 URL 清单批量安装单个文件，彻底告别手动搬运。

第四步：性能调优，让服务器更跟手

解决了"跑起来"的问题，接下来解决"跑得顺"的问题。JVM 参数是影响性能的第一要素，镜像提供了开箱即用的调优开关（详见 docs/configuration/jvm-options.md）：

• MEMORY：同时设置初始与最大堆内存，例如MEMORY: 4G；
• USE_AIKAR_FLAGS：一键启用 Aikar 团队验证过的 G1GC 垃圾回收参数，在线人数越多收益越明显；
• USE_MEOWICE_FLAGS：针对 Java 17+ 的更新版 GC 优化参数，适合较新版本服务端。

此外，容器内存配额应当比堆内存多留约 25% 给 JVM 的非堆部分，避免因配额过紧导致 OOM 被杀。视距、模拟距离等参数则通过VIEW_DISTANCE等环境变量调整，平衡画质与性能。

避坑清单：这 5 个问题几乎人人都踩过

1. 忘了挂载数据卷：数据全在容器内，重建即丢失。务必把/data挂载到宿主机；
2. 内存配额给得太紧：只给容器分配堆内存大小的配额，极易触发 OOM；
3. 世界数据被意外覆盖：需要复制世界时使用FORCE_WORLD_COPY并仔细确认源路径；
4. EULA 未声明：服务端直接拒绝启动；
5. 忽略健康检查：镜像内置了基于 mc-monitor 的健康检查，用docker ps即可看到healthy状态，排查故障时很有用（见 docs/misc/healthcheck.md）。

如何验证优化是否生效

启动完成后，建议依次做三个检查：先看docker ps中的健康状态是否为healthy；再执行docker logs确认启动脚本按预期完成了部署步骤；最后进入游戏实测延迟与 TPS（每秒游戏刻数），配合视距调整找到性能与体验的平衡点。优化从来不是一次性的，它会随着在线人数的变化而持续调整。

动手吧，今晚就上线

从零散的手工配置，到声明式的环境变量部署，docker-minecraft-server 把 Minecraft 服务器的搭建门槛降到了"改一行配置"的程度。无论你是想快速开个原版服，还是部署动辄上百个 mod 的整合包，这套方案都能让你在十几分钟内完成从镜像拉取到开服的全部工作。现在就动手，把compose.yml写好，让你的世界在这一行命令中诞生吧。🚀

【免费下载链接】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