itzg/minecraft-server Docker 环境变量配置指南从启动到调优的一次搞定【免费下载链接】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本文面向第一次用 Docker 部署 Minecraft 服务器的读者围绕itzg/minecraft-server镜像讲清楚环境变量该怎么配哪些是启动必需的哪些按玩家规模调整出问题时从哪里排查。跟着做你可以完成“能启动、能连接、能调优、能排查”的完整流程。itzg/minecraft-server Docker run 与 compose 写法对照图先判断你的部署目标不同目标下你重点要看的变量完全不同单人练习只关心TYPE和VERSION内存保持默认即可。朋友联机重点在访问控制白名单和端口映射内存适当上调。插件/模组服务器TYPE要换成对应类型如PAPER、FABRIC内存和启动耗时都会明显增加。多人公共服务需要 JVM 优化标志、稳定日志、远程管理能力并固定版本号。最小可运行配置下面这份 compose 片段只保留启动服务器所必需的变量适合作为起点services: mc: image: itzg/minecraft-server ports: - 25565:25565 environment: EULA: true TYPE: PAPER VERSION: LATEST volumes: - ./minecraft-data:/data restart: unless-stopped各变量作用EULA必须为true否则容器会拒绝启动。TYPE服务器类型如VANILLA、PAPER、FORGE、FABRIC。VERSIONLATEST表示跟随最新版生产环境建议写死具体版本。数据卷世界数据存放在/data挂载目录不挂载则重启后世界丢失。restart: unless-stopped让容器在崩溃或宿主机重启后自动拉起。按目标选择关键配置目标场景TYPE / VERSION玩家规模内存建议访问控制日志策略单人练习VANILLA/ 固定版本1 人保持默认 1G无需特殊配置默认即可朋友联机PAPER/ 固定版本2–10 人2–4G开启白名单默认即可模组/插件服FORGE、FABRIC等 / 与模组匹配的版本5–20 人4G 起白名单 RCON开启滚动归档公共服务PAPER等 / 固定版本20 人以上8G 起按docker stats观察白名单 强密码 RCON滚动 控制保留份数两点提醒模组包对VERSION有严格匹配要求装不上多半是版本对不上内存列只是起点最终以你的硬件为准。性能与资源调优MEMORY同时设置初始与最大堆大小默认 1GINIT_MEMORY、MAX_MEMORY可分别单独调整。玩家越多垃圾回收压力越大可开启USE_AIKAR_FLAGStrue使用 Aikar 的 GC 调优参数官方也提供USE_MEOWICE_FLAGS可作对照。不建议直接写死具体 JVM 参数镜像内置标志已经做了基础处理确有调优需求时再用JVM_XX_OPTS之类的高阶变量并逐项验证。改完内存后运行docker stats观察实际占用避免“配了 16G 实际只用 3G”或频繁 GC 卡顿。访问控制与风险防护⚠️25565端口对外开放后任何人都能找到并加入你的服务器公网部署前必须处理访问控制。下面这份片段补齐了白名单与 RCON 管理environment: EULA: true TYPE: PAPER VERSION: 1.21 ENABLE_WHITELIST: true WHITELIST: alice,bob ENABLE_RCON: true RCON_PASSWORD_FILE: /data/rcon-password白名单ENABLE_WHITELIST配合WHITELIST控制可加入的玩家。RCONRCON_PASSWORD用强密码更稳妥的是用RCON_PASSWORD_FILE从文件读取避免密码出现在 compose 明文里。RCON 端口不要直接映射到公网建议通过 SSH 或内网访问。敏感值建议统一放到.env文件或挂载文件中不要硬编码在仓库里的 compose 文件中。运行维护与问题排查镜像启动时会按脚本依次完成下载、部署、世界准备再拉起 Java 进程排查时按“现象 → 检查点 → 处理”走容器秒退查docker logs。多数是EULA未设true或类型/版本组合无效。首次启动特别慢镜像在下载服务器 jar 和模组看日志确认下载进度属正常现象。玩家连不上先确认端口映射与防火墙再确认对方名字在白名单里。卡顿、GC 频繁用docker stats看内存是否吃紧再考虑上调堆或开启 GC 优化标志。日志文件过大镜像现已默认启用滚动日志归档文件在数据目录的logs/下可通过保留份数类变量控制数量。无人时浪费资源私有服可开ENABLE_AUTOPAUSEtrue配合AUTOPAUSE_TIMEOUT_EST在无人连接时自动暂停。想确认服务是否健康镜像自带健康检查能力可在 compose 中查看状态细节以官方文档为准。上线前检查清单已备份数据目录/data特别是已有世界。EULA为trueTYPE与VERSION匹配生产环境使用固定版本。内存与硬件匹配docker stats实际占用在预期内。公网部署已开启白名单RCON 使用强密码且端口未暴露。restart: unless-stopped已配置宿主机重启后服务能自动恢复。日志可查看、可滚动归档磁盘空间足够。实际进游戏测试能加入、能生存、MOTD 与权限符合预期。按需先跑通最小配置再按玩家规模逐项加上访问控制和调优项每次只改一两个变量并重启验证。完整变量说明可查阅仓库内的 docs/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），仅供参考