2026/9/12 16:51:22
FEATURED · 精选文章 
Minecraft 服务器环境变量快速指南10 分钟用 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-serveritzg/minecraft-server是一个开箱即用的 Minecraft Java 版服务器镜像版本、Mod、插件都在启动时自动下载。它的全部配置都靠环境变量完成这篇文章带你从一行命令跑起来到按场景调优最后给一份能直接抄的 Compose 配置和常见坑速查表。 起步先让它跑起来先别贪多整个镜像只有一个环境变量是必填的EULA。少配这一行服务器直接启动失败日志里会写着 You need to agree to the EULA。最简的 Compose 配置就下面这么多docker compose up -d之后客户端连你机器的 IP 25565 端口就能进services: mc: image: itzg/minecraft-server tty: true # 让控制台可交互 stdin_open: true ports: - 25565:25565 # 不暴露这个端口外网玩家就连不上 volumes: - ./data:/data # 世界和存档都在这必须挂载 environment: EULA: TRUE # Mojang 要求同意 EULA必填 restart: unless-stopped这里只有两个选择项值得现在定下来TYPE服务器类型。不填默认VANILLA官方原版想要性能更好、能装插件的填PAPER。VERSIONMinecraft 版本。不填默认LATEST最新稳定版重启容器就自动升级想锁死版本就写具体数字如1.21.4之后怎么重启都不会变。/data目录就是服务器的家世界存档、配置文件、日志全在里面。容器删了它还在但你不挂载它数据就随容器一起没了。更多完整示例可以在仓库的 examples/ 目录里翻几乎每种玩法都有一个现成的。️ 进阶按你的需求挑着配让服务器跑得快、跑得稳内存方面就三个变量MEMORY设初始和最大堆默认1GINIT_MEMORY单独设初始堆MAX_MEMORY单独设最大堆。新手建议直接MEMORY: 4G按你机器实际内存留一半给系统不填就 1G 起步插件一多容易卡。再开一组现成的 JVM 优化参数USE_AIKAR_FLAGS: true是经典 GC 调优参数USE_MEOWICE_FLAGS: true是它的 Java 17 升级版两者选一个就行不填则用默认参数人少时差别不大。让朋友也进来玩MAX_PLAYERS最大在线人数建议按你的硬件填比如20不填默认 20但如果你改了VERSION用老版本默认可能更小。MOTD服务器列表里显示的宣传语建议填一句带颜色的比如A §l§cMinecraft§r server不填就显示Powered by Docker的默认文案。LEVEL世界名默认world即/data/world。想开多个世界就多跑几个容器、各挂不同的LEVEL和数据目录。SEED世界种子不填随机填了比如89283492所有玩家的世界地形就固定了。端口方面只需要25565。如果你的客户端也在同一台宿主机上比如服务器就在家里 NAS、你连着它的 WiFi 访问涉及 NAT 回程路由时可能要留意头发夹hairpin问题防止陌生人进门白名单两步走ENABLE_WHITELIST: true打开白名单不填默认关闭任何人可进WHITELIST: player1,player2填逗号分隔的用户名或 UUID。再加OVERRIDE_WHITELIST: true让每次启动都强制按这份名单重建防止你手动加的人下次启动又生效。RCON 默认就是开着的ENABLE_RCON默认true镜像靠它做健康检查和发送命令。唯一要注意RCON_PASSWORD不填会每次随机生成填一个固定强密码需要外部发命令时再映射25575端口。没人时自动歇着两种模式二选一互斥自动暂停ENABLE_AUTOPAUSE: true最后一名玩家离开AUTOPAUSE_TIMEOUT_EST秒后暂停进程默认 3600建议1800。暂停后玩家一连接就自动恢复体感像瞬开。自动停止ENABLE_AUTOSTOP: true同理用AUTOSTOP_TIMEOUT_EST控制但服务是真的停了重启要等容器拉起。建议选自动暂停配MAX_TICK_TIME: -1关闭卡顿警告。手动接管配置文件所有server.properties里的项都能用同名环境变量管如DIFFICULTY: hard、MODE: creative。想完全自己管这个文件设OVERRIDE_SERVER_PROPERTIES: false想排查我到底生成了什么配置设DUMP_SERVER_PROPERTIES: true启动时会把最终server.properties打到日志里。详细映射见 docs/configuration/server-properties.md。 直接抄一份能用的完整配置services: mc: image: itzg/minecraft-server tty: true stdin_open: true ports: - 25565:25565 volumes: - ./data:/data environment: EULA: TRUE # 必填缺了起不来 TYPE: PAPER # 类型VANILLA / PAPER / FORGE / FABRIC 等 VERSION: 1.21.4 # 锁版本想跟随最新就改成 LATEST MEMORY: 4G # 初始最大堆内存 USE_MEOWICE_FLAGS: true # Java 17 的 JVM 优化参数 MAX_PLAYERS: 20 MOTD: A §l§cFriends§r Minecraft Server SEED: 89283492 DIFFICULTY: normal ENABLE_WHITELIST: true # 只放行下面这些人 WHITELIST: player1,player2 OVERRIDE_WHITELIST: true ENABLE_AUTOPAUSE: true # 没人玩时自动暂停 AUTOPAUSE_TIMEOUT_EST: 1800 MAX_TICK_TIME: -1 # 配合暂停消除卡顿警告 restart: unless-stopped改完配置后重新执行docker compose up -d即可生效无需删除容器。全部变量的默认值对照见 docs/variables.md。 排错配错了怎么定位症状原因怎么改容器秒退日志有 You need to agree to the EULA没设EULA加EULA: TRUE客户端连不上但docker compose ps显示 healthy25565端口没暴露或玩家用错了地址检查ports映射确认客户端连的是宿主机 IP启动报缺 Mod/插件崩溃换了TYPE后旧数据目录里残留不兼容文件给新服务器挂一个干净的数据目录别复用旧data日志刷 Out of Memory 或明显卡顿堆内存不够调大MEMORY并开USE_MEOWICE_FLAGS客户端进不去版本不匹配VERSION: LATEST已自动升级客户端版本落后把VERSION锁成客户端支持的版本环境变量改了但server.properties没变之前手动关过属性同步设DUMP_SERVER_PROPERTIES: true看实际生成内容确认没设OVERRIDE_SERVER_PROPERTIES: false查日志用docker compose logs -f健康状态在docker compose ps的 STATUS 列镜像自带健康检查显示healthy才说明服务器真正起来了。更多细节见 docs/misc/healthcheck.md 和 docs/misc/troubleshooting.md。 收尾几条日常运维习惯升级或大改配置前把data目录里的世界文件夹打包备份。想稳定就用固定VERSION想尝鲜就LATEST 重启容器升级。docker compose ps看healthydocker compose logs -f追日志docker stats盯内存。白名单服务器每次加人后docker compose up -d重新生成名单。删容器前先卸数据data目录才是你的全部家当。【免费下载链接】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），仅供参考
Minecraft 服务器环境变量快速指南：10 分钟用 Docker 拉起自己的服务器
Minecraft 服务器环境变量快速指南10 分钟用 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-serveritzg/minecraft-server是一个开箱即用的 Minecraft Java 版服务器镜像版本、Mod、插件都在启动时自动下载。它的全部配置都靠环境变量完成这篇文章带你从一行命令跑起来到按场景调优最后给一份能直接抄的 Compose 配置和常见坑速查表。 起步先让它跑起来先别贪多整个镜像只有一个环境变量是必填的EULA。少配这一行服务器直接启动失败日志里会写着 You need to agree to the EULA。最简的 Compose 配置就下面这么多docker compose up -d之后客户端连你机器的 IP 25565 端口就能进services: mc: image: itzg/minecraft-server tty: true # 让控制台可交互 stdin_open: true ports: - 25565:25565 # 不暴露这个端口外网玩家就连不上 volumes: - ./data:/data # 世界和存档都在这必须挂载 environment: EULA: TRUE # Mojang 要求同意 EULA必填 restart: unless-stopped这里只有两个选择项值得现在定下来TYPE服务器类型。不填默认VANILLA官方原版想要性能更好、能装插件的填PAPER。VERSIONMinecraft 版本。不填默认LATEST最新稳定版重启容器就自动升级想锁死版本就写具体数字如1.21.4之后怎么重启都不会变。/data目录就是服务器的家世界存档、配置文件、日志全在里面。容器删了它还在但你不挂载它数据就随容器一起没了。更多完整示例可以在仓库的 examples/ 目录里翻几乎每种玩法都有一个现成的。️ 进阶按你的需求挑着配让服务器跑得快、跑得稳内存方面就三个变量MEMORY设初始和最大堆默认1GINIT_MEMORY单独设初始堆MAX_MEMORY单独设最大堆。新手建议直接MEMORY: 4G按你机器实际内存留一半给系统不填就 1G 起步插件一多容易卡。再开一组现成的 JVM 优化参数USE_AIKAR_FLAGS: true是经典 GC 调优参数USE_MEOWICE_FLAGS: true是它的 Java 17 升级版两者选一个就行不填则用默认参数人少时差别不大。让朋友也进来玩MAX_PLAYERS最大在线人数建议按你的硬件填比如20不填默认 20但如果你改了VERSION用老版本默认可能更小。MOTD服务器列表里显示的宣传语建议填一句带颜色的比如A §l§cMinecraft§r server不填就显示Powered by Docker的默认文案。LEVEL世界名默认world即/data/world。想开多个世界就多跑几个容器、各挂不同的LEVEL和数据目录。SEED世界种子不填随机填了比如89283492所有玩家的世界地形就固定了。端口方面只需要25565。如果你的客户端也在同一台宿主机上比如服务器就在家里 NAS、你连着它的 WiFi 访问涉及 NAT 回程路由时可能要留意头发夹hairpin问题防止陌生人进门白名单两步走ENABLE_WHITELIST: true打开白名单不填默认关闭任何人可进WHITELIST: player1,player2填逗号分隔的用户名或 UUID。再加OVERRIDE_WHITELIST: true让每次启动都强制按这份名单重建防止你手动加的人下次启动又生效。RCON 默认就是开着的ENABLE_RCON默认true镜像靠它做健康检查和发送命令。唯一要注意RCON_PASSWORD不填会每次随机生成填一个固定强密码需要外部发命令时再映射25575端口。没人时自动歇着两种模式二选一互斥自动暂停ENABLE_AUTOPAUSE: true最后一名玩家离开AUTOPAUSE_TIMEOUT_EST秒后暂停进程默认 3600建议1800。暂停后玩家一连接就自动恢复体感像瞬开。自动停止ENABLE_AUTOSTOP: true同理用AUTOSTOP_TIMEOUT_EST控制但服务是真的停了重启要等容器拉起。建议选自动暂停配MAX_TICK_TIME: -1关闭卡顿警告。手动接管配置文件所有server.properties里的项都能用同名环境变量管如DIFFICULTY: hard、MODE: creative。想完全自己管这个文件设OVERRIDE_SERVER_PROPERTIES: false想排查我到底生成了什么配置设DUMP_SERVER_PROPERTIES: true启动时会把最终server.properties打到日志里。详细映射见 docs/configuration/server-properties.md。 直接抄一份能用的完整配置services: mc: image: itzg/minecraft-server tty: true stdin_open: true ports: - 25565:25565 volumes: - ./data:/data environment: EULA: TRUE # 必填缺了起不来 TYPE: PAPER # 类型VANILLA / PAPER / FORGE / FABRIC 等 VERSION: 1.21.4 # 锁版本想跟随最新就改成 LATEST MEMORY: 4G # 初始最大堆内存 USE_MEOWICE_FLAGS: true # Java 17 的 JVM 优化参数 MAX_PLAYERS: 20 MOTD: A §l§cFriends§r Minecraft Server SEED: 89283492 DIFFICULTY: normal ENABLE_WHITELIST: true # 只放行下面这些人 WHITELIST: player1,player2 OVERRIDE_WHITELIST: true ENABLE_AUTOPAUSE: true # 没人玩时自动暂停 AUTOPAUSE_TIMEOUT_EST: 1800 MAX_TICK_TIME: -1 # 配合暂停消除卡顿警告 restart: unless-stopped改完配置后重新执行docker compose up -d即可生效无需删除容器。全部变量的默认值对照见 docs/variables.md。 排错配错了怎么定位症状原因怎么改容器秒退日志有 You need to agree to the EULA没设EULA加EULA: TRUE客户端连不上但docker compose ps显示 healthy25565端口没暴露或玩家用错了地址检查ports映射确认客户端连的是宿主机 IP启动报缺 Mod/插件崩溃换了TYPE后旧数据目录里残留不兼容文件给新服务器挂一个干净的数据目录别复用旧data日志刷 Out of Memory 或明显卡顿堆内存不够调大MEMORY并开USE_MEOWICE_FLAGS客户端进不去版本不匹配VERSION: LATEST已自动升级客户端版本落后把VERSION锁成客户端支持的版本环境变量改了但server.properties没变之前手动关过属性同步设DUMP_SERVER_PROPERTIES: true看实际生成内容确认没设OVERRIDE_SERVER_PROPERTIES: false查日志用docker compose logs -f健康状态在docker compose ps的 STATUS 列镜像自带健康检查显示healthy才说明服务器真正起来了。更多细节见 docs/misc/healthcheck.md 和 docs/misc/troubleshooting.md。 收尾几条日常运维习惯升级或大改配置前把data目录里的世界文件夹打包备份。想稳定就用固定VERSION想尝鲜就LATEST 重启容器升级。docker compose ps看healthydocker compose logs -f追日志docker stats盯内存。白名单服务器每次加人后docker compose up -d重新生成名单。删容器前先卸数据data目录才是你的全部家当。【免费下载链接】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），仅供参考 
)
