Minexa说明书
入门APP 使用说明

概览页:启动、停止与状态面板

概览页每一张卡在说什么;启动设置抽屉里的 7 项怎么选;停服为什么要等,强制停止什么时候用。

下载完核心,你回到「概览」,看到一张靛蓝色的状态卡、一排数字,还有几张功能卡。点下绿色长条后,页面开始转圈,终端刷出一行行英文——这时最想知道的是:它到底起没起来?还要等多久?

另一个常见场景是:朋友说进不来,你打开概览,看到“服务器运行中”,却不知道该复制哪一行地址;或者你嫌内存太小,翻遍设置页也没找到改内存的地方。

概览页就是 Minexa 的驾驶座。这一页把每张卡读一遍,重点讲三件事:怎么看状态、怎么启动、怎么安全地停。

本页要点
  • 这一页解决什么问题:概览上每张卡在说什么,启动和停止该怎么点。

  • 照做之后你会看到:状态变绿、终端出现 Done,地址卡能复制出 IP:端口。

  • 启动设置抽屉只有 7 项,内存默认 1024 MB。

  • 停止最多等 180 秒,超时也不会自动强杀。

  • 启动是连贯过程,点一次就等,别连点。

页头与顶部的五个数字#

概览顶部右侧有两个入口,都不影响正在运行的服务器:

  • 企鹅图标:打开 QQ 交流群弹窗,群号 593682033,可以复制或直接拉起加群。遇到问题时,群里能拿到最新动态。

  • 「依赖与环境管理」:进入运行环境页,分「Java 版本」「依赖」「Termux」「PHP」四个标签。装 Java、换来源、卸载运行环境、补 frpc 引擎都从这里进,详细操作见 运行环境管理。

再往下是最上面那张渐变卡,也就是状态总览。它一次给你五个数字:

  • 状态行:橙点“正在启动服务端”表示启动流程进行中;绿点“服务器运行中”表示进程活着;灰字“服务器未启动”表示没有进程。后面括号里是当前核心,例如 生存服 (Paper 1.21.4)。

  • TPS:服务器每秒完成的游戏刻,20 是满分,低于 15 就开始明显卡顿。数据来自控制台输出的 TPS 行;没运行时显示 --。

  • 在线:当前人数/最大人数,来自控制台的在线人数回执。刚启动、还没人进时是 0/20。

  • 运行时长:从本次进程启动算起,格式是 Xh、XhYm 或 N分钟。

  • CPU 使用率:整机读数,不是 Minecraft 单独占用,没开服时也会动。

  • 内存:已用 / JVM 上限。分母是启动设置里的最大堆,不是手机总内存。

右上角的刷新按钮会立即重新采集,并顺手向控制台发一次 list;Paper 系还会发 tps。平时不用一直点:前台每 15 秒自动刷新一次,后台大约每 60 秒一次。

状态行下面可能出现两条警告,它们不是错误,是提醒:

警告含义要做什么
正版验证未关闭,离线玩家无法进入online-mode=true没有正版账号的朋友进不来;别为了让人进而随手关验证
白名单已开启 · 仅名单内玩家可进入white-list=true先把朋友加进白名单,否则会被拒之门外

改它们要去 服务器配置页,改完通常要重启才生效。

启动卡:选核心、看环境、点启动#

「启动服务端」卡是每天用得最多的地方,按从上到下的顺序看四样东西:

  • 没有核心时:卡里显示“尚未下载服务端核心”,这行字不能点。去 下载页 下一个,或者导入现成的服务器。

  • 选择服务器核心:下拉列出已安装的核心和版本;基岩核心会标红字“基岩版 · UDP”。选中后底部提示“已选用「…」”。

  • 当前运行环境:Java 模式显示 来源 · 版本,例如 Termux · Java 21;PHP 模式显示 PHP · 8.2。它必须和核心匹配,否则启动会被拦下。

  • 启动长条:未运行时是整条绿色的「启动」;运行环境没初始化时按钮半透明、点不动;运行中会裂成左「强制停止」、右「停止」。

点启动前,应用会做几项校验:核心是否存在、运行环境是否匹配、所选 Java 是否已安装。校验不过不会硬启动,而是给出具体原因——这比启动到一半再崩要省事得多。

你要做的只有一件事:确认核心和环境两个下拉都对,点一次绿色长条,然后去终端等结果。状态变绿不等于已经启动完成,只有终端出现 Done 才代表端口开始接受连接。

停止为什么要等,强制停止什么时候用#

「停止」不是杀进程,而是向服务端控制台发送 stop。Minecraft 收到后会保存世界、关闭连接、再退出。世界越大、玩家越多,这个过程越久,几十秒很正常。

  • 最多等 180 秒。超时后不会自动强杀,只提示“服务端仍在关停中,可点「强制停止」立即结束(有丢失未保存数据的风险)”。

  • 停止中按钮会变成“停止中…”并转圈,这时别去点启动。

  • 没有独立的重启按钮。想重启就停止,等进程退出后再启动。

「强制停止」会立刻结束进程,未写入磁盘的世界数据可能丢失。点它之前会弹确认框,确认按钮是「确认强制停止」。只在两种情况用:停止卡住超过几分钟,或者进程已经假死、控制台没有任何反应。

强制停止是最后手段

正常停止最多等 3 分钟,这不是卡死,是在存盘。强行结束可能丢掉最近的建造、背包和区块数据。真要强停,停完先做一次备份(见 备份、还原与世界管理),再启动检查世界。

启动设置里还有一个「崩溃自动重启」,默认关闭。打开后,进程异常退出会自动重启,最多 3 次,间隔 3 秒、6 秒、12 秒;连续失败 3 次就停手。它只处理“异常退出”,你主动点停止不会触发。

启动设置抽屉:只有这 7 项#

点启动卡右上角的齿轮,会从底部滑出「服务器启动设置」。这是抽屉的唯一入口,别在设置页里找。

项目可选值说明
运行环境Termux Java / Pojav JRE / PRoot Linux 容器 / PHP决定用哪套运行时
Linux 发行版Ubuntu 20.04 (focal) / 22.04 (jammy)仅 PRoot 出现,排在 Java 版本之前
版本按来源列出Termux 11/17/21/25;Pojav 17/21/25;PRoot 按发行版;PHP 8.2
JVM 内存上限256~65536 MB,默认 1024落成 -Xmx,建议不超过设备可用内存的 60%
使用自定义启动命令开 / 关打开后填完整命令,覆盖自动生成的那条
崩溃自动重启开 / 关,默认关异常退出后最多重启 3 次
跳过启动中进度开 / 关概览不再显示阶段进度,直接按运行中显示

几个最容易误解的点,按重要性排:

  1. 抽屉里没有端口,也没有 EULA,更没有视距。端口在 server.properties(Java 默认 25565,基岩 19132),去服务器配置页或文件里改;EULA 在下载或导入时由应用自动写入 eula=true,没有询问界面;视距同样是配置文件里的事,见 视距与模拟距离。

  2. 内存是输入框,不是滑块。 超出 256~65536 会自动收敛并提示。4 GB 手机给 1024~1536 MB,6 GB 给 1536~2048 MB。给太大反而会被系统连进程一起杀掉,推导见 内存分配。

  3. 改动只影响下一次启动。 服务器运行中,除了「崩溃自动重启」「跳过启动中进度」,其他项全部置灰。-Xmx 是 JVM 启动参数,改完必须重启才生效。

  4. 换来源不会自动装 Java。 这里只能“选”,安装要去依赖与环境管理。选了没装的版本,概览会重新出现缺装卡。

  5. PRoot 没有 Java 25。 focal 提供 8/11/17,jammy 提供 11/17/21。要 Java 8 只能选 focal,要 21 选 jammy。

改完记得点抽屉右上角的「完成」,直接按返回等于取消。

地址卡:三种地址,什么时候出现#

「服务器地址」卡的第一行永远是「局域网」,格式是 手机IP:端口,右侧可以刷新 IP、复制。端口取自服务端配置文件,不是缓存值——你改了 server-port,这里会跟着变。

下面两行按条件出现:

地址类型什么时候出现谁需要用
局域网始终显示同一个 Wi-Fi 下的朋友
FRP 公网地址FRP 通道运行中且拿到地址外网朋友,走 frp 隧道
STUN 公网地址STUN 通道运行中且拿到地址外网朋友,且双方满足 NAT 条件

没开隧道时看不到后两行,这是正常的,不是地址丢了。三种联机方式的取舍见 联机与内网穿透。

复制地址时整行复制,别只复制 IP:没有端口,客户端会连到默认的 25565,等于没写对。

缺东西时出现的三张条件卡#

概览会根据缺什么,临时插入三张卡。它们出现的顺序,就是你应该处理的顺序:

  • 初始化运行环境:全新安装时出现,约 50 MB。有进度、当前镜像源、「切换到下个镜像源」和失败后的「重试」。这一步没完成,启动按钮是灰的。

  • Java 运行环境:所选 Java 没装时出现,按钮是「安装 Java」。Termux 来源要求环境已初始化,Pojav 来源不用。

  • 一键安装依赖:缺 wget、rclone、proot 或 frpc 引擎时出现,按步骤串行安装。

这三个卡里的「查看日志」只是文字,点不动。要看安装过程,切到「终端」Tab。

启动阶段在做什么,卡住了怎么判断#

点下启动后,Hero 卡会显示阶段进度,常见阶段包括准备环境、下载依赖、启动 Java、加载核心、创建世界、启动网络。它不是装饰——卡在哪个阶段,就说明问题出在哪一层:卡在“下载依赖”是网络,卡在“加载核心”多半是 Java 版本。

第一次启动要生成世界,1~3 分钟很正常,第二次会快很多。判断标准不是等多久,而是终端有没有新输出:

  • 有新行在刷:在干活,继续等。

  • 超过 3 分钟一行都不动:记下最后一行,去 启动失败排查。

  • 出现 Done (…s)! For help, type "help":启动完成,可以把地址发给朋友了。

启动成功的唯一标准

状态变绿不等于就绪,终端出现 Done (…s)! For help, type "help" 才算。

新手最容易犯的三个错#

  1. 连点启动。启动是连续过程,连点只会让状态更乱。点一次,切到终端看输出。

  2. 以为灰按钮是坏了。运行中大部分设置项置灰是设计如此:改 -Xmx、换运行环境都要先停服。

  3. 关服直接划掉应用。那样等于掐断进程,世界可能没存盘。正确做法是回概览点「停止」,等它自己退出。

成功后第一件事是备份:现在世界干净、体积小,备份最省事。

上机自查
  • 概览状态行显示的是绿点“服务器运行中”,括号里是你选的核心。

  • 终端出现过 Done (...s)! For help, type "help",不是停在 Starting server。

  • 地址卡的「局域网」一行能复制出完整的 IP:端口。

  • 点齿轮打开启动设置,能数出 7 项,且找不到端口和 EULA。

  • 点「停止」后按钮变成“停止中…”,几秒到几十秒后状态回到灰点。

下一步#

读到这儿了,给你点个赞。如果这页内容帮你解决了问题,说明说明书的方向是对的;如果发现错误、过时信息或看不懂的地方,欢迎到 GitHub Issues 告诉我们。

⚡ 回到极速开服 📖 查术语表