从零到上线：Mindustry 服务器搭建完整指南（编译、配置与故障排查）

从零到上线Mindustry 服务器搭建完整指南编译、配置与故障排查【免费下载链接】MindustryThe automation tower defense RTS项目地址: https://gitcode.com/GitHub_Trending/min/Mindustry开服第一天就翻车host打完没人进日志里刷着一堆看不懂的红字。Mindustry 服务器本身不复杂但端口、数据目录、启动指令这三处最容易踩空。这篇面向新手的实战指南按最短路径 → 配置机制 → 故障速查 → 生产加固展开跟着命令先把 Mindustry 服务器跑通再搞懂每个配置项为什么这么写最后把进程和备份安排明白。最短路径四步跑通 Mindustry 服务器java -version # 必须输出 17.xsettings.gradle 检测到低于 17 会直接拒绝构建git clone https://gitcode.com/GitHub_Trending/min/Mindustry cd Mindustry编译服务器模块耗时视机器配置而定首次会拉取 Gradle 依赖系统命令产物Linux / macOS./gradlew server:distserver/build/libs/server-release.jarWindowsgradlew server:dist同上server/build.gradle 中dist任务会把主类、运行时依赖和core/assets资源一起打进这个 jar客户端资源音乐、字体等已被排除所以成品不算大。启动并验证连接java -jar server/build/libs/server-release.jar控制台出现Server loaded. Type help for help.即就绪输入host随机开局。客户端进多人游戏 → 直接连接填 IP 与端口本地用127.0.0.1:6567。开局前客户端会先浏览星球选图Serpulo 与 Erekir 两个行星的默认地图都在包内。端口与 data 目录两个必须搞懂的点端口 6567 从哪来默认端口写在 core/src/mindustry/Vars.java 的port 6567。改端口不用动源码控制台执行config port 6568或修改data/下settings.json中的port客户端再按新端口连。连接侧的解析逻辑在 core/src/mindustry/net/。data 目录里有什么ServerLauncher.java 把配置目录固定为 jar 同级的data/首次启动自动生成settings.jsonport、shufflemode、bans、admins等键值rules.hjson全局规则首启写入reactorExplosions: false等默认值在 ServerControl.java 中定义每次地图加载时应用saves/auto_地图名_时间.msav格式存档autosave配置项控制间隔与保留份数超量的旧存档自动删除logs/、maps/、mods/日志、自定义地图与 Mod 目录。服务端 headless 运行时用这张星空图做背景纹理客户端行星界面同理。启动指令把开局动作写进启动命令启动 jar 时附带的参数会直接当作控制台指令执行ServerControl.java 的setup方法逐条解析java -jar server-release.jar host 12345 survival常用指令host [地图名] [模式]开局、playerlimit 30限制人数、shuffle builtin切地图轮换、status与version看运行状态。config指令列出全部可改项startCommands、autoPause、autosave、debug、socketInput等。注意config的布尔值只认on/off。故障速查表现象原因处理Gradle 报YOU MUST USE JAVA 17 OR ABOVEJDK 低于 17换 JDK 17java -version验证见 README.md./gradlew: Permission denied脚本无执行权限chmod x ./gradlew一次性见 README.md Troubleshooting客户端直连超时6567 被占用或未放行ss -lntp \| grep 6567查占用config port换端口并放行防火墙启动即退出提示Error occurred loading mod contentMod 资源与版本不匹配按报错中的 Mod 名与文件路径修正逻辑在 server/src/mindustry/server/客户端提示版本不符未指定构建版本客户端校验被关闭构建时加-Pbuildversionbuild见 ServerControl.java 启动时的警告改规则不生效规则只在地图加载时应用改data/rules.hjson后host重开一局生产加固systemd 与备份server/run-server 脚本自带-XX:HeapDumpOnOutOfMemoryError和崩溃自动重启循环适合裸跑长期运行建议交给 systemdRestartalways一行顶掉手写循环[Service] Usermindustry WorkingDirectory/opt/mindustry ExecStart/usr/bin/java -Xmx2G -jar /opt/mindustry/server-release.jar Restartalways备份重点是data/rules.hjson、settings.json、saves/与自定义地图。日志默认写入data/logs/开启config socketInput on可把日志转发到 TCP方便外部监控拉取。扩展方面Mod 框架在 core/src/mindustry/mod/内置地图见 core/assets/maps/公开服务器流程参考 SERVERLIST.md。升级时只替换 jar、保留data/即可存档与规则不受影响。监控面板可以贴这张星空图当底图方便运维夜里盯盘。【免费下载链接】MindustryThe automation tower defense RTS项目地址: https://gitcode.com/GitHub_Trending/min/Mindustry创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考