Minecraft Server Docker部署实操手册一个镜像跑通4种服务器与自动模组拉取【免费下载链接】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服务器是一串繁琐的活下服务端jar、装对Java、配加载器、再挨个拷模组文件。docker-minecraft-server 就是为此存在的——它是一张面向 Minecraft Java Edition 的Docker镜像容器启动时会自动下载对应版本的服务端、模组加载器和整合包你要做的只是写好一份 YAML。这篇手册按从零开服的真实顺序走完第一台服务器上线、类型选型、版本匹配到整合包拉取的全过程。第一次开服一份 YAML 拉起原版服务器先明确一件事整个流程里硬性要求只有一个——同意用户协议EULA其余都有默认值。最精简的启动配置可以照 examples/docker-compose-simple.yml 来写services: mc: image: itzg/minecraft-server tty: true # 让终端能直接操作服务器控制台 stdin_open: true ports: - 25565:25565 environment: EULA: TRUE VERSION: 1.20.4 volumes: - ./data:/data # 宿主机目录挂进容器数据不随容器丢失VERSION决定装哪个 Minecraft 版本留空则是最新版。tty和stdin_open两项让docker attach进去之后能直接给控制台发指令调试时非常有用。所有数据都落在/data下这也是后面备份迁移的全部依据世界文件/data/world服务端配置/data/server.properties模组目录/data/mods想把世界打包、迁移到另一台机器直接操作这个目录即可细节见 world-data.md。服务器类型怎么选4 种常见选项Minecraft Server Docker 用一个TYPE环境变量统一控制装哪种服务端默认就是 VANILLAMojang 官方原版类型定位什么时候选它文档VANILLAMojang 官方原版无插件纯净生存、最小化配置others.mdPAPERBukkit/Spigot 谱系的优化分支要装插件、做多人服paper.mdFABRIC轻量级模组加载器偏新的模组生态fabric.mdFORGE传统模组平台ATM、RLCraft 这类大型整合包forge.md想开 Paper 服只需在 environment 里加一行TYPE: PAPER服务端 jar 的下载和升级都交给镜像完成。更完整的类型清单见 types-and-platforms/。版本匹配最容易翻车的两处Minecraft 版本由VERSION变量指定docker run场景下这样写docker run -e VERSION1.20.1 -e TYPEVANILLA itzg/minecraft-server可安装的完整版本列表在 minecraft.md。Java 版本则不由你装而是由镜像 tag 决定——这也是新人最容易忽视的点Minecraft 版本范围应选 Java对应镜像 tag1.17 及以上Java 17itzg/minecraft-server:java171.12 到 1.16Java 8itzg/minecraft-server:java8启动日志若出现 class file version 之类的报错优先怀疑 Java 版本和 Minecraft 版本不匹配对照 java.md 里的 tag 说明换镜像即可。 整合包一次拉全CurseForge 与 Modrinth装整合包不用再手动下载解压AUTO_CURSEFORGE模式会按项目 ID 解析依赖并把整个包拉进容器services: mc: image: itzg/minecraft-server environment: EULA: TRUE TYPE: AUTO_CURSEFORGE CF_PROJECT_ID: 325345 # 整合包项目 ID CF_FILE_ID: 456789 # 指定版本的文件 ID ports: - 25565:25565 volumes: - ./data:/dataCF_PROJECT_ID锁定是哪个包CF_FILE_ID锁定具体哪个版本文件。ATM、Pixelmon 等各版本整合包都能直接抄 examples/auto-curseforge/ 里现成的 compose 文件。Modrinth 生态同样支持按项目 slug 或 ID 拉取说明见 modrinth.md。⚡ 上线之后省电、备份与避坑自动暂停没人在线时让服务器休眠Paper 服配ENABLE_AUTOPAUSE: TRUE即可参考 examples/autopause/compose.yml更省心的还有自动关机AUTOSTOP方案。世界备份与迁移把 compose 项目里的数据卷指向新路径再重建容器世界就跟着走示意见下图三个高频坑提前绕开端口冲突25565 被占用时改映射即可如25566:25565冒号左边是主机端口内存调优通过JVM_OPTS-Xms2G -Xmx4G控制分配完整参数见 jvm-options.md行为漂移latesttag 会随构建滚动需要稳定环境时可锁定 release 版本的 tag格式形如2024.4.0-java17。全部可配置项一览在 variables.md照着它排查比翻文档快得多。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考