APK 装好了，点开图标，概览页却先弹出「初始化运行环境」，下面还有一张「Java 运行环境」缺装卡。你可能会想：我不是已经装好应用了吗，怎么还要装东西？
因为 Minexa 本身只是个“管理壳”，真正跑服务端的是它内部准备的 Linux 运行环境和 Java。Java 不是手机自带的，运行环境也要现场下载，所以“装完 APK”最多算走完三分之一。
这一页按第一次打开的真实顺序走一遍：先核对手机能不能装，再装包、授权、等初始化、装 Java，最后看一眼“全部就绪”长什么样。每一步都写了成功标志，也写了失败先看哪里。顺序别跳，跳了会在后面的步骤里以另一种报错的形式还给你。
装之前只核对三件事：arm64 架构、Android 8.0 以上、至少 5 GB 空间。
首次打开会下载 约 50 MB 的运行环境，只做一次，中途退出会继续。
Java 要单独装：大多数情况选 Termux JDK 21；1.17～1.20.6 用 17；Java 8 只能在 PRoot 的 Ubuntu 20.04 里装。
文件权限不是可选项：没有「所有文件访问」，下载和备份都会失败。
全部就绪的标志：三张条件卡都消失，概览的启动按钮变成实心绿色。
装之前先核对三件事：架构、系统、空间#
先别急着点下载。Minexa 对手机有三个硬要求，任何一条不满足，后面的步骤都会在某处失败，而且报错通常不会直白地告诉你“是架构不对”。
| 核对项 | 要求 | 不满足时会怎样 |
|---|---|---|
| 系统版本 | Android 8.0（API 26）及以上 | 安装被系统拒绝，或装上后打开就闪退 |
| 处理器架构 | arm64-v8a | 安装时报解析包失败，或装上也跑不起来 |
| 可用空间 | 至少 5 GB | 初始化、装 Java、生成世界、备份会轮流失败 |
| 网络 | 首次必须联网 | 初始化长期停在 0%，Java 装不上 |
架构是最容易踩的一项。安装包里只带 arm64-v8a 的原生库，名字里带 armeabi 或 x86 的包不是给这类手机准备的。不确定也不用查参数：近几年的安卓手机基本都是 arm64，挑文件名带 arm64-v8a 的那个就行。
空间也要提前留。50 MB 的运行环境只是个开头，Java 另算，之后还有世界、备份、插件和日志。空间不足时最先报警的往往不是安装，而是世界保存和备份。所以动手前按 至少留 5 GB 可用空间 准备。
如果你的手机是 32 位老机器、或者系统还停在 Android 7，那这一版确实装不了，别反复试，直接看 Minexa 是什么 里的系统要求。
下载和安装：四个动作#
打开 Releases 页面：用手机浏览器访问 MineServe-Mobile Releases，找最上面的最新版本。
选 arm64-v8a 的 APK：在 Assets 列表里挑文件名带 arm64-v8a 的那一个。别下旁边的 Source code 压缩包，那不是安装包。
允许这一次安装：点开 APK，系统提示“未知来源应用”时，进设置打开“允许来自此来源的应用”，再返回安装界面继续。
确认版本号：装完先别急着开服，进「设置」→「关于」看「当前版本」。这套说明书写给 1.5.0，版本差太远时界面对不上。
第三方渠道的 APK 可能被改过签名，也可能停在旧版本。更新时应用会校验包名和签名，签名不一致会拒绝安装，这本身就是一道保护。看到“签名不一致”不要想办法绕过。
装完后可以把“安装未知应用”这项权限关回去。Minexa 不需要这个长期权限，只有你自己更新 APK 时才临时用一次。
第一次打开：三张卡，先处理哪张#
第一次进入应用会落在「概览」。这时可能出现三张条件卡，顺序不要弄反：
| 卡片 | 出现条件 | 先做什么 |
|---|---|---|
| 初始化运行环境 | 新安装、运行环境还没准备好 | 等它自动下载完，失败再点重试 |
| Java 运行环境 | 当前选的 Java 版本还没装 | 初始化完成后点「安装 Java」 |
| 一键安装依赖 | 缺 wget、rclone、proot 或 frpc 引擎 | 前两步完成后再补 |
顺序不能反，因为三张卡有依赖关系：Java 要装进运行环境里，运行环境没就绪时，Java 卡点下去也装不成；依赖（wget、proot 这些命令行小工具）同样是往运行环境里装。所以 初始化没完成，启动按钮一直是灰的。
如果只看到前两张，说明依赖已经齐了，不用管第三张。页头的「依赖与环境管理」是这些操作的统一入口，后面装 Java、换来源、卸载环境都在那里，见 运行环境管理。
权限：文件、通知，以及暂时不用管的 VPN#
Minexa 会在需要时引导授权，不会一上来把所有权限都要一遍。三个权限的轻重缓急差别很大：
| 权限 | 什么时候要 | 拒绝的后果 |
|---|---|---|
| 所有文件访问（Android 11+） | 第一次下载核心、导入服务器、备份前 | 下载、建服、备份全部失败 |
| 通知（Android 13+） | 第一次启动服务端前后 | 能开服，但锁屏后不知道服务器还在不在 |
| VPN | 只在启用 EasyTier 组网时 | 只影响 EasyTier，其他功能不受影响 |
先说最重要的所有文件访问。服务端固定放在 /storage/emulated/0/Minexa/Minecraftserver/，备份放在 /storage/emulated/0/世界与服务器的备份/，都在公共存储里。没有这个权限，应用会提示“无法在统一存储目录创建服务器”，下载和备份也会失败。授权入口在系统设置的“所有文件访问”里。
通知是 Android 13 及以上才需要，用于前台服务常驻通知、启动完成提醒、异常退出提醒。拒绝不影响开服，但锁屏后你很难知道服务器还在不在——这也是很多人误以为“服务端自己崩了”的原因之一。
VPN 只有 EasyTier 组网才要，第一次启用时才会弹框，现在不用管。
Android 10 及以下用的是普通存储权限，系统会在需要时弹窗；Android 11 及以上必须在系统设置里开「所有文件访问」，只给普通存储权限不够。
Android 11 之后，应用没有这个权限就写不进公共目录。有人看到“下载失败”就去重装核心，其实是权限没给。先回到系统设置确认权限，再重试下载。
初始化运行环境：约 50 MB，不能跳过#
首次进入应用后，初始化会自动开始，不需要你按任何按钮。卡片会显示“正在下载并解压 Termux 运行环境”、百分比、速度和一行控制台输出；失败时才会出现「重试」。
这一步做的事，是在应用私有目录里准备一套迷你 Linux（可以理解成“装在 App 里的小型操作系统”）：后面启动服务端、装依赖、扫描插件、跑 installer 都要经过它。整个流程只需要做一次，以后启动不会再下载。
成功标志：初始化卡片消失，概览页不再显示进度。
大概耗时：网络好时几分钟；晚高峰可能十几分钟。
中途退出：重新打开会继续，不用从头再来，但别反复强行停止应用。
镜像：卡上有「切换到下个镜像源」，当前源慢的时候可以换；换完要重新初始化才会生效。
进度大致分四段：下载文件系统（5%～45%）、解压（约 50%）、初始化配置（约 90%）、完成（100%）。界面只显示百分比和速度，所以数字长时间停着时，先看速度那一栏：还在走就继续等，归零再考虑换源。数字卡住不动时，先看速度是不是 0。
初始化要下的文件是固定的，差别在网络。晚高峰、校园网、部分运营商的限速，都会把这 50 MB 变成十几分钟。这期间别切飞行模式，切了会从头解析。
运行环境没初始化好时，几乎所有操作都会被拦。唯一能先做的是安装 Pojav JRE：它是 Android 原生 JRE，不依赖 Termux。其他 Java 来源、依赖、插件、配置都要求 Termux 就绪。
安装 Java：大多数情况选 Termux 21#
初始化完成后，回到概览。如果「Java 运行环境」卡还在，点「安装 Java」；也可以走页头的「依赖与环境管理」→「Java 版本」→ 展开 Termux JDK → 选 Java 21 → 点「安装」。
该装哪个版本，看服务端核心和游戏版本，不要凭“越新越好”：
| 服务端情况 | 选什么 | 说明 |
|---|---|---|
| 1.21 及以上的 Paper / Fabric / Forge | Termux JDK 21 | 最常见，省事 |
| 1.17～1.20.6 | Termux JDK 17 | 用 21 可能起不来 |
| 1.16 及以下 | PRoot + Ubuntu 20.04 + Java 8 | Termux 和 Pojav 都没有 Java 8 |
| 26.x 新版本号 | Termux JDK 25 | 以核心官方文档为准 |
| PocketMine-MP | PHP 8.2 | 不用装 Java |
| Allay | Java 21 及以上 | 基岩协议，但跑在 JVM 上 |
Java 8 是个特殊存在：只有 PRoot 的 Ubuntu 20.04（focal）提供，Termux 和 Pojav JRE 都没有。所以玩 1.16 及更老的服务端时，你要先接受“多下载一个 Linux 容器”这件事，要 Java 8 只能选 PRoot 的 focal。
应用会在启动前按版本自动匹配 Java，但规则是只升版本、不换来源。你选的是 Termux，它不会替你切到 PRoot；如果 Termux 没有目标版本，它会报错让你自己换。完整对照见 游戏版本与 Java 版本，来源差异见 运行环境管理。
安装时状态会显示“正在安装 …”，首次下载要等几分钟，期间最好别切页面。装好后版本行会标“已安装”，并自动设为当前选用。
环境页的「卸载」「重装」「安装」三个按钮，作用于当前选中的来源 + 版本，不是全部 Java。卸载只删这一份，其他来源和其他版本都保留，服务端存档不受影响。服务器运行中这三个按钮全部禁用，要先停服。PRoot 另有独立的容器删除操作，会连带删掉容器内所有 Java 版本。
想先弄清版本号是怎么来的
Minecraft 服务端是 Java 程序，编译时用的 Java 版本决定了它最低需要多新的运行环境：1.21 之后基线是 21，1.17～1.20.6 是 17，1.16 及更老停在 8。
初始化失败，按这三步处理#
失败时卡片会变成「初始化失败」，下面有错误文本、控制台最后几行和「重试」。不要急着重装应用，按顺序来：
换下载源：点卡片上的「切换到下个镜像源」，或去「设置」→「下载源设置」换一个镜像，再重试。下载源只影响初始化包，不影响已经装好的东西。
看控制台末几行：常见是网络超时、镜像 404、解压失败。把最后两三行记下来，对照 启动失败排查 的关键词。
重试或重装运行环境：先点「重试」；连续失败再去「依赖与环境管理」→「Termux」，先卸载再重新初始化。卸载只删运行环境，不动服务端存档。
如果换了两三个源、换了 Wi-Fi 和移动数据都不行，再看 下载页 里关于镜像与网络的说明。不要在没有日志的情况下反复点重试。
| 现象 | 可能原因 | 处理 |
|---|---|---|
| 长时间 0%，速度也是 0 | 镜像不可达或被网络限制 | 换镜像，切 Wi-Fi / 移动数据 |
| 卡在 50% 或 90% | 解压或配置失败，常见于空间不足、包损坏 | 清理空间后重试；仍失败就重装环境 |
| 失败后点重试又立刻失败 | 当前源持续不可用 | 先切源，再重试 |
| 显示完成，但仍提示未初始化 | 文件校验没通过 | 去环境页卸载运行环境，再重新初始化 |
装完之后，怎么确认一切就绪#
三张卡都处理完，别急着下载核心。花一分钟核对下面四处，能省掉后面一大半“点了没反应”的困惑。
| 检查位置 | 应该看到 | 看不到说明什么 |
|---|---|---|
| 概览页 | 没有初始化卡、Java 卡、依赖卡 | 还有一步没完成 |
| 依赖与环境管理 → Java 版本 | 目标版本标着“已安装”，且被选中 | 装错了版本，或没设为当前 |
| 下载页 | 能点开版本列表，能点「开始下载」 | 环境或权限还没就绪 |
| 概览的启动卡 | 启动按钮是实心绿色 | 缺核心（还没下载服务端） |
最后一项要解释一下：三张卡都清了、但还没下核心时，启动按钮依然点不动，这是正常的——缺的不是环境，是服务端核心本身。这时候去做下一步：下载页。
语言、更新与旧版迁移#
语言：设置 →「语言」→「更改」，可选跟随系统、简体中文、繁體中文、English、فارسی。选完立即生效，不用重启。
检查更新：设置 →「关于」→「检查更新」。应用启动后约 1 秒也会自动检查一次。更新会校验包名和签名，签名不一致不会让你装；「本次不更新」只对这次运行有效。
旧版迁移：如果你以前用过旧版本，冷启动时可能弹出「迁移旧版服务器」提示。旧版的私有目录只作为迁移源，不再参与运行。建议迁移：应用会先完整复制，再比对文件数和总字节，确认一致后才删源目录。
更新应用本身一般不动存档，但更新对话框会明确提醒“可能导致服务器核心和世界数据丢失”。升级前先做一次整服备份，并导出到电脑或另一台设备；不要只依赖手机里的那一份。
概览页没有「初始化运行环境」「Java 运行环境」两张卡了。
「依赖与环境管理」→「Java 版本」里，目标版本那行标着“已安装”。
系统设置里 Minexa 的「所有文件访问」是开启状态。
下载页能点开版本列表，不需要重试就能看到版本号。
进「设置」→「关于」，「当前版本」显示的是 1.3.x。
下一步#
想先弄清每个页面管什么：界面总览
该下载第一个核心了：下载页：选核心、选版本与下载
初始化或启动卡住：启动失败排查