docker-minecraft-server 部署3 行配置跑通 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周五晚上想拉几个朋友进游戏但你不想在宿主机上装 Java、下服务端 jar、再改十几个配置文件。docker-minecraft-server 就是一个在启动时自动下载 Minecraft 服务端、安装模组加载器、部署整合包的 Docker 镜像写 3 行配置就能完成部署而且换版本、换服务器类型都不用动宿主环境。项目能力一览这一节把镜像能自动做的事和对应配置项列成一张表后面遇到需求时直接对着改。能力对应配置 / 模块适用场景启动时自动下载指定版本服务端VERSION、TYPE固定某个 Minecraft 版本运行自动安装模组加载器TYPEFORGE / FABRIC / NEOFORGE各类模组服整合包自动部署MODPACK_PLATFORM scripts/start-deployAutoCF 等脚本ATM、FTB 等整合包服从 URL 自动下载插件 / 模组PLUGINS、MODS、MODRINTH_PROJECTS插件服、轻量模组服无人在线自动暂停 / 停止ENABLE_AUTOPAUSE、ENABLE_AUTOSTOP低成本挂机托管世界数据持久化/data卷 scripts/start-setupWorld备份与迁移健康检查与发送指令scripts/shims/mc-health、scripts/shims/mc-send-to-console监控、远程发命令整个启动过程是自动的容器进入 start 脚本后根据环境变量判定服务器类型下载缺失文件写好 server.properties最后才 exec 启动服务端。先跑通再说看不懂流程时看这张图最小可运行配置这一节解决“最快怎么把服务器跑起来”。必填的只有两件事同意 EULA、把/data挂到本地目录其余全部走默认值。先把仓库拉下来示例文件都在仓库里git clone https://gitcode.com/GitHub_Trending/do/docker-minecraft-server最简 compose 文件就 9 行和现成的 examples/docker-compose-simple.yml 含义一致services: mc: image: itzg/minecraft-server ports: - 25565:25565 environment: EULA: TRUE volumes: - ./data:/data启动和验证启动docker compose -f examples/docker-compose-simple.yml up -d验证docker logs -f mc首次启动会下载服务端看到日志出现 Done 和 Starting minecraft server 即就绪需要自动化探测时用镜像自带的健康检查脚本 scripts/shims/mc-health别急着改别的先让它跑起来。唯一建议顺手做的是固定VERSION否则服务端会跟随最新版客户端稍后可能连不上。按目标展开你想实现什么这一节按目标展开每个目标都是在最小配置上加几个环境变量照抄即可。想固定版本和自定义 MOTD目标版本不漂移玩家看到的 MOTD 是自己定的。环境变量示例值说明VERSION1.21默认LATEST固定后不会自动升级MOTDMy server客户端服务器列表里显示的标语MAX_PLAYERS20玩家位数量LEVEL_SEED自定义种子世界种子验证客户端进入服务器列表核对 MOTD或看/data下的 server.properties。server.properties 的完整可选项见 docs/configuration/server-properties.md。想挂插件目标跑 Bukkit 生态插件Essentials、WorldGuard 之类推荐用 Paper 实现性能更好。环境变量示例值说明TYPEPAPER切换为 Paper 服务端PLUGINS插件 zip 的下载 URL多个 URL 空格分隔MEMORY2G插件服内存占用更高参考 examples/paper/compose.yml。验证docker compose exec mc ls /data/plugins能看到插件目录即部署成功。想装模组目标装模组加载器加一批模组。Fabric 适合轻量模组NeoForge 适合重模组。环境变量示例值说明TYPEFABRIC/NEOFORGE选择加载器MODRINTH_PROJECTSfabric-api按 Modrinth 项目 ID 安装MODS模组 jar 的下载 URL可多个参考 examples/fabric/compose.yml 和 examples/neoforge/docker-compose.yml。验证docker compose exec mc ls /data/mods查看已下载的模组。想装整合包目标不逐个挑模组直接从 CurseForge 页面拉全套部署。以 ATM9 为例环境变量示例值说明MODPACK_PLATFORMAUTO_CURSEFORGE启用 CurseForge 自动部署CF_PAGE_URL整合包页面 URL必填容器自己抓文件清单MEMORY4G整合包吃内存首次启动最久整合包动辄好几个 GB下载量大的时候耐心等就行。参考 examples/auto-curseforge/atm9/docker-compose.yml。FTB、Modrinth 等其他平台有对应的MODPACK_PLATFORM取值以 docs/types-and-platforms/index.md 为准。验证下载完成后ls /data/mods | wc -l看模组数量是否符合预期。调优与自定义这一节把最常调的参数合并成一张表别急着改先看看默认值。参数默认值推荐值说明MEMORY1G2G–4GJava 堆上限整合包更高VERSIONLATEST固定版本避免自动升级导致客户端/服务端版本错配USE_AIKAR_FLAGSfalsetrue一套 GC 调优参数多人同时在线时有效JVM_OPTS空按需原始 JVM 参数空格分隔ENABLE_AUTOPAUSEfalse托管时true无人在线暂停服务端玩家来了秒恢复ENABLE_AUTOSTOPfalse托管时true无人在线停止服务端容器需能重启AUTOSTOP_TIMEOUT_EST3600300–1800全员掉线后多少秒停止TZUTCAsia/Shanghai日志时区另外两件事一起说清数据持久化世界、配置、模组全在/data备份和迁移都围绕这一个目录规则见 docs/misc/world-data.md自动启停细节autopause 与 autostop 互斥、状态轮询参数以 docs/misc/autopause-autostop/autopause.md 和 docs/misc/autopause-autostop/autostop.md 为准JVM 参数怎么调的完整说明见 docs/configuration/jvm-options.md。不同部署形态这一节解决单机、容器编排、边缘设备三种形态的差异配置写法不变只换承载平台。单机 compose最常见直接用 examples/ 目录里的文件60 多个场景基本覆盖所有目标容器编排K8s 下关键是 StatefulSet 加 PVC 持久化/data见 examples/k8s/using-statefulset.yml 和 kustomize/边缘设备树莓派等 arm64 设备可用内存是瓶颈MEMORY调低一点见 docs/misc/raspberrypi.md多服务器网络Velocity 代理加多个后端服见 examples/multi-project/排错速查这一节是常见故障和最快处理路径的对照表照着查比翻日志快。现象可能原因处理方式容器反复重启日志提示同意 EULAEULA没设为TRUE补EULA: TRUE客户端连不上宿主机 25565 端口被占用或未放行宿主侧映射改成25566:25565端口被占就这么解决首次启动很慢正在自动下载服务端 / 模组 / 整合包正常现象docker logs -f mc看进度升级后客户端连不上VERSION没固定服务端跟到了新版本固定VERSION与客户端一致卡顿、TPS 掉内存上限低 / JVM 参数没调调大MEMORY开USE_AIKAR_FLAGS容器重建后世界没了/data没挂卷加volumes: ./data:/data装模组后崩溃模组与加载器版本不匹配对齐版本或用 packwiz 锁定清单见 docs/mods-and-plugins/packwiz.md更多症状对照见 docs/misc/troubleshooting.md。延伸阅读docs/variables.md —— 全部环境变量的完整清单找不到某个变量时先查这里examples/ —— 60 多个 compose 示例覆盖几乎所有部署目标改两个值就能用docs/types-and-platforms/index.md —— 支持的服务器类型与模组平台列表docs/sending-commands/commands.md —— 如何向运行中的服务端发送控制台指令docs/misc/world-data.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），仅供参考
docker-minecraft-server 部署：3 行配置跑通 Minecraft 服务器，免环境冲突
docker-minecraft-server 部署3 行配置跑通 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周五晚上想拉几个朋友进游戏但你不想在宿主机上装 Java、下服务端 jar、再改十几个配置文件。docker-minecraft-server 就是一个在启动时自动下载 Minecraft 服务端、安装模组加载器、部署整合包的 Docker 镜像写 3 行配置就能完成部署而且换版本、换服务器类型都不用动宿主环境。项目能力一览这一节把镜像能自动做的事和对应配置项列成一张表后面遇到需求时直接对着改。能力对应配置 / 模块适用场景启动时自动下载指定版本服务端VERSION、TYPE固定某个 Minecraft 版本运行自动安装模组加载器TYPEFORGE / FABRIC / NEOFORGE各类模组服整合包自动部署MODPACK_PLATFORM scripts/start-deployAutoCF 等脚本ATM、FTB 等整合包服从 URL 自动下载插件 / 模组PLUGINS、MODS、MODRINTH_PROJECTS插件服、轻量模组服无人在线自动暂停 / 停止ENABLE_AUTOPAUSE、ENABLE_AUTOSTOP低成本挂机托管世界数据持久化/data卷 scripts/start-setupWorld备份与迁移健康检查与发送指令scripts/shims/mc-health、scripts/shims/mc-send-to-console监控、远程发命令整个启动过程是自动的容器进入 start 脚本后根据环境变量判定服务器类型下载缺失文件写好 server.properties最后才 exec 启动服务端。先跑通再说看不懂流程时看这张图最小可运行配置这一节解决“最快怎么把服务器跑起来”。必填的只有两件事同意 EULA、把/data挂到本地目录其余全部走默认值。先把仓库拉下来示例文件都在仓库里git clone https://gitcode.com/GitHub_Trending/do/docker-minecraft-server最简 compose 文件就 9 行和现成的 examples/docker-compose-simple.yml 含义一致services: mc: image: itzg/minecraft-server ports: - 25565:25565 environment: EULA: TRUE volumes: - ./data:/data启动和验证启动docker compose -f examples/docker-compose-simple.yml up -d验证docker logs -f mc首次启动会下载服务端看到日志出现 Done 和 Starting minecraft server 即就绪需要自动化探测时用镜像自带的健康检查脚本 scripts/shims/mc-health别急着改别的先让它跑起来。唯一建议顺手做的是固定VERSION否则服务端会跟随最新版客户端稍后可能连不上。按目标展开你想实现什么这一节按目标展开每个目标都是在最小配置上加几个环境变量照抄即可。想固定版本和自定义 MOTD目标版本不漂移玩家看到的 MOTD 是自己定的。环境变量示例值说明VERSION1.21默认LATEST固定后不会自动升级MOTDMy server客户端服务器列表里显示的标语MAX_PLAYERS20玩家位数量LEVEL_SEED自定义种子世界种子验证客户端进入服务器列表核对 MOTD或看/data下的 server.properties。server.properties 的完整可选项见 docs/configuration/server-properties.md。想挂插件目标跑 Bukkit 生态插件Essentials、WorldGuard 之类推荐用 Paper 实现性能更好。环境变量示例值说明TYPEPAPER切换为 Paper 服务端PLUGINS插件 zip 的下载 URL多个 URL 空格分隔MEMORY2G插件服内存占用更高参考 examples/paper/compose.yml。验证docker compose exec mc ls /data/plugins能看到插件目录即部署成功。想装模组目标装模组加载器加一批模组。Fabric 适合轻量模组NeoForge 适合重模组。环境变量示例值说明TYPEFABRIC/NEOFORGE选择加载器MODRINTH_PROJECTSfabric-api按 Modrinth 项目 ID 安装MODS模组 jar 的下载 URL可多个参考 examples/fabric/compose.yml 和 examples/neoforge/docker-compose.yml。验证docker compose exec mc ls /data/mods查看已下载的模组。想装整合包目标不逐个挑模组直接从 CurseForge 页面拉全套部署。以 ATM9 为例环境变量示例值说明MODPACK_PLATFORMAUTO_CURSEFORGE启用 CurseForge 自动部署CF_PAGE_URL整合包页面 URL必填容器自己抓文件清单MEMORY4G整合包吃内存首次启动最久整合包动辄好几个 GB下载量大的时候耐心等就行。参考 examples/auto-curseforge/atm9/docker-compose.yml。FTB、Modrinth 等其他平台有对应的MODPACK_PLATFORM取值以 docs/types-and-platforms/index.md 为准。验证下载完成后ls /data/mods | wc -l看模组数量是否符合预期。调优与自定义这一节把最常调的参数合并成一张表别急着改先看看默认值。参数默认值推荐值说明MEMORY1G2G–4GJava 堆上限整合包更高VERSIONLATEST固定版本避免自动升级导致客户端/服务端版本错配USE_AIKAR_FLAGSfalsetrue一套 GC 调优参数多人同时在线时有效JVM_OPTS空按需原始 JVM 参数空格分隔ENABLE_AUTOPAUSEfalse托管时true无人在线暂停服务端玩家来了秒恢复ENABLE_AUTOSTOPfalse托管时true无人在线停止服务端容器需能重启AUTOSTOP_TIMEOUT_EST3600300–1800全员掉线后多少秒停止TZUTCAsia/Shanghai日志时区另外两件事一起说清数据持久化世界、配置、模组全在/data备份和迁移都围绕这一个目录规则见 docs/misc/world-data.md自动启停细节autopause 与 autostop 互斥、状态轮询参数以 docs/misc/autopause-autostop/autopause.md 和 docs/misc/autopause-autostop/autostop.md 为准JVM 参数怎么调的完整说明见 docs/configuration/jvm-options.md。不同部署形态这一节解决单机、容器编排、边缘设备三种形态的差异配置写法不变只换承载平台。单机 compose最常见直接用 examples/ 目录里的文件60 多个场景基本覆盖所有目标容器编排K8s 下关键是 StatefulSet 加 PVC 持久化/data见 examples/k8s/using-statefulset.yml 和 kustomize/边缘设备树莓派等 arm64 设备可用内存是瓶颈MEMORY调低一点见 docs/misc/raspberrypi.md多服务器网络Velocity 代理加多个后端服见 examples/multi-project/排错速查这一节是常见故障和最快处理路径的对照表照着查比翻日志快。现象可能原因处理方式容器反复重启日志提示同意 EULAEULA没设为TRUE补EULA: TRUE客户端连不上宿主机 25565 端口被占用或未放行宿主侧映射改成25566:25565端口被占就这么解决首次启动很慢正在自动下载服务端 / 模组 / 整合包正常现象docker logs -f mc看进度升级后客户端连不上VERSION没固定服务端跟到了新版本固定VERSION与客户端一致卡顿、TPS 掉内存上限低 / JVM 参数没调调大MEMORY开USE_AIKAR_FLAGS容器重建后世界没了/data没挂卷加volumes: ./data:/data装模组后崩溃模组与加载器版本不匹配对齐版本或用 packwiz 锁定清单见 docs/mods-and-plugins/packwiz.md更多症状对照见 docs/misc/troubleshooting.md。延伸阅读docs/variables.md —— 全部环境变量的完整清单找不到某个变量时先查这里examples/ —— 60 多个 compose 示例覆盖几乎所有部署目标改两个值就能用docs/types-and-platforms/index.md —— 支持的服务器类型与模组平台列表docs/sending-commands/commands.md —— 如何向运行中的服务端发送控制台指令docs/misc/world-data.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），仅供参考
