「装不上」「找不到 Java 8」「朋友进不来」「BDS 报缺库」——这些高频问题大多不是 bug,而是固定前提没满足。这一页把 20 个问题按场景分组,每个给 2~4 句结论加一条延伸阅读链接,方便先对上号再深挖。
读之前先记住一件事:Minexa 的所有「不行」,几乎都能归到三个前提上——设备架构、运行环境、网络关系。设备不对装不上,环境不对开不起来,网络不对进不来。判断出你落在哪一类,答案基本就出来了。
如果只想快速找一个答案,先看下面的对照表;想系统了解某个方向,再往下翻对应小节。
只支持 Android 8.0+ 与 arm64-v8a,32 位手机和 iPhone 都不行。
Java 8 只有 PRoot focal 提供,Termux 和 Pojav 都没有。
BDS 要单独初始化 PRoot + box64 环境才能启动,转译运行、性能约为原生一半。
还原点一下即执行,没有二次确认,所以动手前必须先另存一份。
先对号入座:症状 → 该看哪一节#
二十个问题不用全看,按现象找更快:
| 你遇到的现象 | 八成这样 | 看哪一节 |
|---|---|---|
| 安装包解不开、装完打不开 | 架构或系统版本不对 | 安装与系统 |
| 点了启动没反应、按钮是灰的 | 环境没初始化完、没选核心、Java 没装 | 启动与运行 |
| 启动到一半失败或卡住 | Java 版本不匹配、端口被占、核心损坏 | 运行环境 / 启动与运行 |
终端有 Done,朋友进不来 | 网络关系不对(不同 Wi-Fi、没隧道) | 网络与联机 |
| 玩着玩着服务端自己没了 | 被系统清理,不是崩溃 | 看 后台保活与桌面小组件 |
| 插件/模组装了像没装 | 核心类型不对、没重启 | 启动与运行 |
| 存档打不开、世界丢了 | 需要从备份还原 | 数据与安全 |
第一,跑一次「更多 → 运行诊断」,看有没有红色项;第二,去「更多 → 崩溃报告」看看有没有新报告。带着这两样东西再问,别人能直接给答案;只写「开不起来」,谁也没法判断。方法见 运行诊断与崩溃报告。
安装与系统#
Minexa 支持什么手机?模拟器能装吗?#
只支持 Android 8.0(API 26)及以上、arm64-v8a 架构的设备,APK 没有 32 位版本,所以 32 位老手机装不上;不需要 Root,服务端是应用管理的普通子进程。模拟器未确认,以实际安装结果为准——模拟器若是 x86_64 架构,通常连安装都过不了,即使能装,表现也不代表真机。真机安装步骤见 安装与首次启动。
支持 iPhone 或 iPad 吗?#
不支持。Minexa 是 Android 应用,iOS 上没有对应版本,也不能把服务端跑在 iPhone 上再让朋友连。苹果设备只能作为客户端连别人开的服,具体协议区别见 Java 版与基岩版服务端有什么区别。
为什么一定要给「所有文件访问」权限?不给会怎样?#
因为备份和世界导出要写到公共目录 /storage/emulated/0/世界与服务器的备份/,Android 11 起写这个位置必须有「所有文件访问」。不给的话最直接的表现是备份页出现红色横幅、「备份世界」「备份整个服务器」按钮变灰,点了也没反应。细节见 备份、还原与世界管理。
运行环境#
初始化很慢,或者一直失败怎么办?#
首次要下载约 50 MB 的 Termux 兼容运行环境,慢通常卡在网络上。先点概览初始化卡里的「切换到下个镜像源」再重试;还不行就去 设置与「更多」 把「下载源设置」换成别的镜像,或者点闪电图标自动选一个可用源。失败时卡片会显示控制台最后几行,照着报错判断是超时还是解压失败。不要反复杀应用重开,中断后重新进应用会继续下。
Java 8 为什么在列表里找不到?#
因为 Java 8 只有 PRoot 的 Ubuntu 20.04(focal)容器提供,Termux JDK 和 Pojav JRE 都不提供。要装它,得把运行环境切到「PRoot Linux 容器」,发行版选 20.04,再在版本列表里选 Java 8——切发行版时应用会同时对齐可用版本,不会让你选出「jammy + Java 8」这种装不上的组合。完整对照见 运行环境与依赖管理。
容器里为什么没有 Java 25?#
PRoot 两个发行版能装的版本不一样:Ubuntu 20.04 是 8 / 11 / 17,Ubuntu 22.04 是 11 / 17 / 21,两个发行版都没有 25。要 Java 25 只能用 Termux JDK 或 Pojav JRE。反过来,Termux 和 Pojav 也都没有 Java 8,所以「1.16 服务端 + Termux」这个组合本来就不成立。版本对应关系见 游戏版本与 Java 版本。
BDS 下载了却起不来?#
官方 BDS 只发布 Linux x86_64 + glibc 构建;手机是 arm64 + Android bionic,架构和运行库都对不上。应用的做法是在 PRoot Ubuntu 容器里用 box64 把 x86_64 指令转译成 arm64 执行,box64 与基础运行库随 APK 内置,所以 1.4.1 起 BDS 可以真跑起来,代价是启动慢、性能约为原生一半。第一次用之前要到「依赖与环境管理 → BDS」点「初始化环境」,不初始化点启动会被拦住。完整步骤见 官方基岩版(BDS)开服。
启动与运行#
点了启动没反应,或者按钮点不动怎么办?#
先看三种最常见的前提:运行环境还没初始化完时,启动长条是半透明、点不动的;没有选用任何核心时,点启动会提示先选核心;所选 Java 没装时,概览会弹出「Java 运行环境」卡片并带「安装 Java」按钮。按提示补齐再看按钮是否变绿,排查顺序见 启动失败排查。
为什么服务器老是被系统杀掉?#
因为 Android 会清理它认为不重要的后台进程,锁屏、内存紧张、厂商「清理后台」都会触发。Minexa 已经做了前台服务、常驻通知、开服期间持有唤醒锁、每 15 分钟检查一次,但只能尽力,不能承诺永不被杀。要降低概率,去把电池优化豁免和自启动权限打开,具体步骤见 后台保活与桌面小组件。
判断「被杀」还是「崩了」只看一处:终端最后有没有收尾日志或异常堆栈。戛然而止就是被杀。
改完配置为什么没生效?#
大部分 server.properties 项要重启服务端才生效,保存只是写文件。端口改完还要重启,且隧道若正在运行,停掉重开一次让转发端口按新端口对齐。另外 PowerNukkitX 在服务端运行时会直接拒绝保存,要先停服。逐项说明见 服务器配置页。
插件或模组装了没反应?#
先确认核心类型对不对:Paper 系只认 Bukkit/Spigot/Paper 插件,Fabric/Forge 只认对应加载器的模组,放错目录等于没装。再确认装完有没有重启服务端——绝大多数插件必须重启才加载。如果还是没反应,多半是版本不匹配或缺前置依赖,用 插件与模组管理 里的冲突检测和日志对照。
网络与联机#
朋友进不来,从哪查起?#
先分清你们处在哪种网络关系,处理方式完全不同:
| 情况 | 表现 | 该做什么 |
|---|---|---|
| 同一个 Wi-Fi | 你复制局域网地址给他,他连不上 | 确认地址是 手机IP:端口、服务端已出 Done、手机没开 AP 隔离 |
| 不同网络 | 局域网地址必然无效 | 需要 FRP / STUN / EasyTier 其中一种,见 我该用哪种联机方式 |
| 有公网地址 | 地址能通但连不上 | 检查隧道状态、端口是否与服务端一致、正版验证 |
另外别忘了最基础的一条:客户端版本要和服务端一致,1.21.4 进不了 1.21.1。逐层排查见 联机排错。
两个服务器能同时开吗?#
未确认,以实际为准。 应用支持安装多个服务端并切换「当前活动服务器」,组件和 MCP 都跟着活动服务器走;但同时运行几个实例,说明书没有确认过。实际使用时更现实的做法是一次只开一个:手机内存有限,两个 JVM 很容易互相挤爆,端口也可能冲突。内存怎么分见 内存分配。
Java 版和基岩版能互通吗?#
不能直接互通。两者协议、端口(TCP 25565 / UDP 19132)、账号体系都不同,Minexa 里也没有集成 Geyser 这类跨协议方案,所以 Java 客户端进不了基岩服,反过来也一样。选核心前先确认朋友用哪个版本,见 Java 版与基岩版服务端有什么区别。
数据与安全#
备份能跨手机用吗?#
能。备份是普通的 zip,存在公共目录 /storage/emulated/0/世界与服务器的备份/,卸载应用也不会删;把它拷到新手机的同名目录,备份列表里就能看到。不要改文件名:整服还原要靠文件名里的服务器目录和核心类型来识别,改了会变成「未知核心」。跨设备迁移的完整流程见 备份策略与恢复演练。
还原为什么没有二次确认?#
这是当前版本的实际行为:世界还原和整服还原点一下就执行,只有删除备份、以及整服还原遇到重名目录时才有确认框。所以「先备份再还原」不是建议,是必须——尤其你想试一个新存档时,先手动备份当前世界,再点还原。风险清单见 备份、还原与世界管理。
还原是覆盖式的:点下去,当前世界就换成备份里的那一份,没有「撤销」。养成习惯——动手前先在备份页手动打一次包,确认列表里出现了新文件,再去点还原。多花 30 秒,能省掉一次「存档没了」。
更新应用会不会丢数据?#
更新对话框自己就写着「更新应用可能导致服务器核心和世界数据丢失,请先自行备份后再更新」。覆盖安装通常不会清应用数据,但跨版本变化、系统清理都可能出意外,没人能给你打包票。稳妥做法是先手动备份一次,再更新,见 安装与首次启动。
MCP 和 FTP 安全吗?#
看你怎么用。MCP 默认只听 127.0.0.1 并要求 Bearer 令牌,本机使用是安全的;一旦打开局域网访问,就是明文 HTTP,令牌泄露等于服务器控制权。FTP 默认端口 2121、默认允许写入、默认不开匿名、同样是明文,只适合可信局域网,用完就停。分别见 MCP 远程管理 和 文件管理页。
其它#
日志页在哪?为什么找不到?#
因为没有独立的日志查看页。看实时输出用「终端」,它有颜色分级、300 行上限和复制功能;查崩溃原因用「更多 → 崩溃报告」,那里有分析、复制和分享。设置页里也没有日志开关或日志级别选项,这是设计如此,不是你的版本缺功能。用法见 终端与控制台。
怎么反馈问题、加群?#
设置页有两条路:「意见反馈」会打开邮件应用,收件人是 167245484@qq.com,主题已填好;「QQ 交流群」群号是 593682033。也可以在 GitHub 仓库提 issue,入口位置见 设置与「更多」。无论走哪条,附上崩溃报告里的完整日志和诊断截图,处理速度会快很多。
你的手机是 arm64 架构、Android 8.0 以上,安装包能正常装上。
「运行诊断」跑过一遍,没有红色项,或者知道红的是哪一项。
服务端启动时终端出现过
Done,不是一直卡在启动阶段。你知道自己属于「同一 Wi-Fi」还是「不同网络」,并选好了对应的联机方式。
做过至少一次整服备份,知道它在
/storage/emulated/0/世界与服务器的备份/。崩溃报告能打开,并且知道「分享」发的是完整日志。