Minexa说明书
新手必看APP 使用说明

Minexa 是什么:能力、边界与系统要求

Minexa 能在安卓手机上做什么、不做什么;三种运行方式、18 个核心、数据放在哪、需要什么权限。

你大概是在群里看到有人说“手机也能开服”,于是装了一个 Minexa。点开图标,概览页先冒出「Termux 运行环境」「Java 版本」「服务端核心」几个词,每个字都认识,连起来却不知道该先动哪一个。

这种卡住不是你的问题,是顺序没铺开。先把定位说清楚:Minexa 是一个运行在 Android 手机上的 Minecraft 服务端管理器。服务端在它这里就是一个普通子进程,不需要 Root,也不会替换系统、不会刷机、不会改你的系统分区。

所以它更像“遥控器 + 管家”:真正跑游戏逻辑的是 Minecraft 官方或社区发布的那个服务端程序(下文叫核心),Minexa 只负责把 Java 或 PHP、核心文件、目录和进程安排明白。理解了这一层,报错就好懂了——它们基本都是 Minecraft 自己的,Minexa 只是把原文转给你看。

这一页不教你点按钮,只把地图摊开:能做什么、做不到什么、手机要满足什么条件、数据最后落在哪。

本页要点
  • 一句话定位:Minexa 是遥控器,真正干活的是核心;出问题先想“核心在说什么”,而不是“App 坏了”。

  • 它确实能干:18 个核心选项、Java/PHP 环境、插件模组、备份还原、隧道联机、定时任务、MCP 与 FTP。

  • 它确实干不了:不能给你公网 IP,也不能让 Java 版和基岩版互通,手机被系统清掉就下线。

  • 门槛:Android 8.0 以上、仅 arm64-v8a、建议 4 GB 内存 + 5 GB 空闲存储。

  • 数据只有一个根目录 Minexa/Minecraftserver/,别自己另找地方放服务端。

这四件事它做不到,先降低预期#

新手最容易翻车的地方,不是不会点,而是预期不对。下面四条不是“缺点”,是手机和服务端的物理限制,早点接受能少折腾很久。

  1. 它不是 PC 服务端的替代品。 手机的内存、散热和持续性能都有限。2~5 人的原版或轻量插件服可以跑得不错;十几人的公网服、大型科技整合包、需要大量预生成地图的模组服,不适合放在主力手机上长期开。真要长期开,用旧手机专门挂机比用主力机靠谱。

  2. 它不是云服务器。 手机关机、断网、被系统清理、电池耗尽,服务器就没了。Minexa 的前台服务和保活开关只能尽量降低被杀的次数,不能保证 7×24 小时在线。

  3. 它不能凭空给你公网 IP。 同一个 Wi-Fi 下用局域网地址最省事;朋友在外网,需要 FRP、STUN 或 EasyTier,或者你自己在路由器上做端口映射。运营商给的是内网地址(CGNAT,可以理解成整栋楼共用一个对外门牌号)时,端口映射也救不了。

  4. 它不能直接让 Java 版和基岩版互通。 两边的网络协议、账号体系和端口都不同。Minexa 提供的是两边各自的服务端核心,没有内置 Geyser 之类的跨平台桥。想让手机版玩家进 Java 服,得自己在服务端装第三方桥接插件,那是 Minecraft 通用做法,不是应用自带功能。

第一次用,只要盯住三件事

初始化运行环境、装一个 Java、下载一个核心。其他卡片和开关都可以先不管,它们不改也不会挡住你开服。走完这条线,再看 安装与首次启动 和 下载页。

它管什么、不管什么,一张表分清#

分不清“这是应用的事还是核心的事”,就会一直在错的页面里找按钮。下面这张表按层拆开:

层面Minexa 负责仍然要你自己决定
运行环境下载并初始化 Termux 运行时、装 Java 或 PHP、切换来源选哪个来源、哪个 Java 版本
服务端程序拉版本列表、下载核心、跑 Forge 系 installer选哪个核心、哪个游戏版本
配置提供 server.properties 等文件的编辑入口每一项填什么值、改完要重启
玩法内容插件/模组的启停、删除、上传、搜索安装装哪些、版本对不对、会不会冲突
进程启动、停止、强制停止、崩溃自动重启什么时候该停、要不要重启
网络提供 FRP / STUN / EasyTier 三条通道有没有账号、对面 NAT 行不行
数据备份、还原、世界导入导出备几份、放哪里、多久备一次

一句话记法:Minexa 提供入口和流程,判断和取舍仍然在你。所以看到“没有这个按钮”时,先确认当前核心类型支持不支持、服务端是不是正在运行。

从装好到第一次开服,会经过这七步#

这七步是固定顺序,跳步会让后面的按钮变灰或者直接报错。

  1. 安装并打开应用:首次进入会提示初始化运行环境,约 50 MB。

  2. 等初始化完成:完成后才能下载核心、装依赖、扫插件。这一步不能跳过(Pojav JRE 是唯一例外)。

  3. 装一个 Java:大多数 1.21.x 核心选 Termux JDK 21;1.16 及以下才需要 PRoot 里的 Java 8。

  4. 下载核心:在下载页选核心、选版本、填名称、开始下载。

  5. 回概览启动:确认「当前核心」和「当前运行环境」匹配,点绿色「启动」。

  6. 等终端出现 Done:第一次要生成世界,1~3 分钟正常,别在这期间反复点。

  7. 发地址、加白名单、备份:先让同一个 Wi-Fi 的朋友进来,再做长期打算。

第 2 步和第 3 步是最容易被忽略的两步:它们不在“开服流程”的直觉里,却是后面所有操作的前提。第 6 步的判断标准只有一条——终端里出现 Done,在这之前状态显示“运行中”也不算就绪。

它到底能做什么#

能力在 Minexa 里的样子
下载核心从官方接口拉版本列表,下载到每个服务器独立的目录
导入服务器文件夹、压缩包、单个 JAR、Modrinth .mrpack 四种方式
插件与模组只对支持的核心显示;可启停、删除、上传、从 Modrinth 搜索安装
改配置Java 系编辑 server.properties,PowerNukkitX 编辑 pnx.yml
玩家管理在线列表、OP、白名单、封禁四个标签
文件与终端浏览、上传、编辑文本;发控制台命令、看日志
备份世界备份、整服备份、自动备份、还原
联机FRP 隧道、STUN 直连、EasyTier 组网
省心功能定时任务、后台保活、桌面组件、崩溃报告
远程管理MCP 给 AI 客户端用;FTP 给电脑管文件

表格里每一行都有前提,不是“装好就全都能用”。插件和模组只对支持的核心显示;备份还原要先停服;MCP 默认只监听本机;FTP 只适合局域网。遇到“这个按钮怎么没有”,先确认当前核心类型和运行状态,再往下看对应的文章。

四种运行方式:你只需要记住一种#

Minecraft 服务端不是原生安卓程序,得先有运行环境(可以理解成“服务端的翻译层”,它让为 Linux 写的程序能在手机上跑)。Minexa 提供三种 Java 来源,外加一个 PHP 运行时:

运行方式适合谁能装的 Java代价
Termux JDK大多数 Java 核心,默认首选11 / 17 / 21 / 25要先初始化约 50 MB 的运行环境;没有 Java 8
Pojav JRE不想依赖 Termux 的人17 / 21 / 25每个版本约 37~62 MB;没有 Java 8
PRoot 容器需要 Java 8,或需要标准 glibc 的核心focal:8 / 11 / 17;jammy:11 / 17 / 21容器几百 MB;没有真实 Root,也没有 Java 25
PHP跑 PocketMine-MPPHP 8.2约 10 MB,多个 PocketMine 服务器共享

绝大多数人用 Termux JDK + Java 21 就够了:Paper、Fabric、Forge 的 1.21.x 都吃这一套。只有服务端明确要求 Java 8(典型是 1.16 及以下)时,才需要切到 PRoot 的 Ubuntu 20.04。版本与来源的对应关系、安装和卸载,集中在 运行环境管理。

这四种方式不能随便混搭:PHP 只给 PocketMine-MP;Java 8 只在 PRoot 的 focal 里;Allay 强制 Java 21 及以上。选错来源时应用会报错并让你改,不会偷偷替你换来源。启动设置里的改动也只影响下一次启动,不会打断正在运行的服务端。

BDS 能跑,但要先初始化环境

官方 BDS 只发布 Linux x86_64 构建,依赖 glibc;而 Minexa 的安装包只有 arm64-v8a,Android 用的是 bionic。应用的做法是在 PRoot Ubuntu 容器里用 box64 转译执行,box64 与基础运行库随包内置,所以 BDS 从 1.4.1 起可以真跑起来。代价是三件事:第一次要手动初始化环境、启动更慢、性能约为原生一半。见 官方基岩版(BDS)开服。

18 个核心选项,不是 16 个#

下载页的核心胶囊一共 18 个:16 个常用核心,加上 BDS 和「未知」。它们不是同一类东西,混着看就会乱:

  • 插件服:Paper、Purpur、Leaves、Leaf、Spigot、CraftBukkit,认 Bukkit/Spigot/Paper 插件。

  • 模组服:Fabric、Forge、NeoForge、Quilt,认对应加载器的模组。

  • 原版:Vanilla,没有插件和模组接口,只有原版机制。

  • 代理端:Velocity、BungeeCord,用来做多个子服的统一入口,本身不装插件也不装模组。

  • 基岩服:PowerNukkitX、PocketMine-MP、Allay,协议是基岩版,默认 UDP 19132。

  • BDS:官方基岩版专用服务器,需先初始化 PRoot + box64 环境,转译运行。

  • 未知:给无法自动识别的导入或还原用,之后可以在服务器管理里改。

怎么快速选:朋友用电脑 Java 版,优先 Paper;要装模组,就在 Fabric、Forge、NeoForge、Quilt 里挑;朋友用手机或主机基岩版,选 PowerNukkitX 或 Allay;只有做多子服统一入口才用代理端。拿不准就先看选型向导,别靠名字猜,每个名字背后的生态差别很大。

每个核心适合谁、默认端口和 Java 要求,见 18 个核心选项总览。

系统和存储要求#

项目要求说明
系统Android 8.0(API 26)及以上更低版本装不上
CPU 架构arm64-v8a只提供这一个架构的安装包,32 位设备不支持
内存建议 4 GB 起4 GB 能开 2~3 人原版;6 GB 以上更稳
存储至少留 5 GB运行时、Java、世界、备份都要占
网络首次初始化需要联网之后启动本地服务器不需要外网

内存不是越大越好。启动设置里的 JVM 内存上限默认 1024 MB,4 GB 手机给 1024~1536 MB 比较稳;给到 3072 MB 反而可能被系统连进程一起杀掉,因为 Android 会优先回收“占内存大户”。具体推导见 内存分配。

存储按 5 GB 起算:运行环境约 50 MB,Java 几百 MB,核心几十 MB,世界几十到几百 MB,每份备份大约等于世界大小。自动备份默认保留 10 份,长期开服还要留出日志和崩溃报告的空间。

数据放在哪、要什么权限#

服务端只有一个根目录,所有服务器都在它下面各占一个文件夹:

文本
/storage/emulated/0/Minexa/Minecraftserver/<目录名>/

备份在 /storage/emulated/0/世界与服务器的备份/。中文显示名在落盘时会被转成 ASCII 并附加 6 位哈希,所以实际文件夹名可能和界面上看到的不一样;写路径、做迁移时用 <目录名> 占位,不要照着中文名去文件管理器里硬找。

旧版本的私有目录(<应用私有目录>/home/home/servers/)现在只作为迁移源,不参与运行。冷启动如果检测到旧服务器,会询问是否迁移;迁移会先复制、再比对文件数和总字节,确认一致后才删源。

权限方面,Minexa 是“用到才要”,不会一上来全部申请:

  • 所有文件访问(Android 11 及以上):用来读写上面两个公共目录。不给会出现“无法在统一存储目录创建服务器”,下载、备份也会被拦。

  • 通知(Android 13 及以上):前台服务常驻通知、启动完成和异常退出提醒。拒绝不影响开服,但后台状态你看不到。

  • VPN 权限:只有用 EasyTier 组网时才需要,普通局域网和 FRP 都不需要。

隐私、安全与版本#

  • 崩溃报告不上传。 崩溃信息在本地生成,是否分享、分享给谁由你决定。

  • MCP 默认只监听 127.0.0.1:8931,并带 Bearer 令牌。改成 0.0.0.0 就等于把管理接口暴露给同网络的人,除非你清楚后果,否则别改。

  • FTP 默认端口 2121,默认允许写入,只适合在局域网里用;根目录是整个 /storage/emulated/0/Minexa,不是单个服务器。

  • 隧道要自备条件。 FRP 需要自建 frp 服务端或 SakuraFrp、ME Frp 账号;STUN 只支持 TCP + 全锥形 NAT(NAT1);EasyTier 每个玩家都要装客户端。应用不会绕过 NAT 或防火墙。

当前源码版本是 1.5.0(versionCode 61),这套说明书写给这个版本。界面文案、核心列表和下载源都可能随版本变化;如果应用里看到的和文章不一致,以应用当前版本为准。升级前请先备份,更新应用的对话框本身也会提醒“可能导致核心和世界数据丢失”。

上机自查
  • 手机「设置 → 关于手机」里,Android 版本 ≥ 8.0,CPU 架构写着 arm64。

  • 手机剩余存储 ≥ 5 GB,而不是只剩几百 MB。

  • 打开 Minexa,底部能看到 8 个入口,概览页没有红字报错。

  • 能在文件管理器里打开 /storage/emulated/0/Minexa/ 这个目录。

  • 「设置 → 关于」里的当前版本显示 1.5.0 或更新。

下一步#

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

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