NexGen Client 使用说明

外观

这一页管什么 ​

登录并进入编辑器后，左侧导航里有一个软件打包区：标题是 软件打包，副标题是 配置并提交软件打包任务。你要打包的客户端、内核、版本和目标平台都在这里选，选完点「开始打包」交给云端编译。

编译完成后，产物会出现在打包记录与产物下载里，等你去下载。

打包用的是已经保存过的那份档案。所以动手打包之前，请先在左侧各项配置里把要改的地方改好、点一次「保存当前档案」，否则打出来的还是上一版配置。

进入「软件打包」 ​

  1. 用激活码登录（见用激活码登录），在 选择客户端入口 里选老客户端或新客户端。
  2. 在编辑器左侧导航里点 软件打包。
  3. 右侧出现标题 软件打包、副标题 配置并提交软件打包任务 的整块表单，从上到下依次是：状态提示、打包队列、选择打包内核、源码分支、版本标签、选择打包平台，最下面是提交按钮。

两个客户端的编辑器（Xboard-Mihomo_sub 老客户端、NexGen Client React 新客户端）都有这一块，选项含义一致。

先看清打包状态和剩余次数 ​

表单最上方会显示当前这个激活码能不能打包：

界面提示含义
软件打包状态：可打包现在可以提交新的打包任务。
软件打包状态：不可打包 或 当前不可打包现在不能提交新的打包任务。先别反复点按钮，等排队中的任务结束后再试；如果一直是这样，就确认一下你的激活码的打包额度。
软件打包状态：管理员不限这个激活码不受次数限制，随时可以打包。
打包次数：不限可打包次数没有上限。
打包次数：已打包 N这个激活码已经打包过 N 次。

这一行还会一并列出几个关键信息，值得先扫一眼：

  • 剩余次数：N 次 —— 还能打几次。
  • 到期日期：... —— 激活码的有效期，过期后就登录不了，也打包不了。
  • 允许平台：... —— 这个激活码被授权可以打的平台范围。

只有打包成功才计次数

打包失败或中途取消的任务不计入「已打包」次数，所以失败了可以放心重试，不会白白消耗额度。

另外，尚未结束的任务会临时占住名额：如果你提交了几个还在排队或编译中的任务，即使它们还没成功，也可能暂时提示「已达最大打包次数」。等它们跑完（成功的计次、失败的释放）就恢复正常。

额度快用完时提前联系，可以免费增加

打包次数默认是 10 次。发现「剩余次数」不多了就提前联系（联系方式见 如何购买），免费增加即可。

不用等到用满——用满之后就没法再提交打包任务，只能先处理额度。提前说一声更顺。

状态是打开页面时读取的，如果刚打完一次，刷新一下页面就能看到次数变化。

打包队列：可提交新打包 还是 队列已满 ​

状态提示下面还有一行「打包队列：」，它跟着一个状态词：

界面提示含义怎么办
正在加载打包队列...正在读取队列状态，还没读到结果。等一两秒，它会自己变成下面两种之一。
可提交新打包队列现在有位置，可以提交。直接继续选参数、点「开始打包」。
队列已满，请稍后云端同时在跑的任务已经排满，现在提交不进去。等正在跑的任务结束、这一行重新变成 可提交新打包 之后再点「开始打包」；急着点也不会入队成。

队列满不是你的激活码出了问题，只表示云端同时在编译的任务太多，等一会儿就好。

选择打包内核 ​

「选择打包内核」是一组单选项，它直接决定下面「选择打包平台」里哪些平台能勾。两个内核的界面原文说明是：

  • Mihomo 内核（角标 当前默认）——全平台打包：Windows、Android、Android TV、Linux、macOS。
  • Xray 内核——目前仅支持 Windows、Android（手机）和 macOS。

也就是说：

  • 选 Mihomo 内核，下表 11 个平台全部可以勾选。
  • 选 Xray 内核，只有 Windows ARM64、Windows AMD64、Android（手机）、macOS ARM64、macOS AMD64 能勾，其余平台会变成不可勾选的状态。
  • 另外，全部平台 这个选项在 Xray 内核 下会改名为 全部 Xray 支持平台，勾它同样只会打到 Xray 支持的那几个平台。

注意：内核选错，想要的平台会勾不上

如果你发现某个平台点不动，先回头看这里选的是不是 Mihomo 内核——Android TV、Linux、软路由、iOS 巨魔 IPA 都只有 Mihomo 内核支持。换回 Mihomo 内核后，这些平台就会恢复可勾选。

源码分支与版本标签 ​

源码分支 ​

「源码分支」是一个下拉框，界面上的原文提示是：

请选择与你当前面板类型对应的源码分支：XBoard、V2Board 和 xiaov2board 请选择 main，SSPanel 请选择对应分支。

也就是：你的面板是 XBoard、V2Board 或 xiaov2board，就选 main；是 SSPanel，就选与你面板对应的那个分支。

注意：源码分支选错，包做出来也用不了

这个下拉要和你的面板类型对上。选错不会当场报错，但打出来的客户端连不上你的面板，等于白打一次、白费一次打包次数。提交前花两秒确认一下面板类型。

版本标签 ​

「版本标签」是一个文本框，占位提示是 如: 1.0.0，界面上的原文提示是：

这里请直接填写标准版本号，不要带 v 前缀，直接使用 1.0.0 这种格式。

请按 1.0.0 这种格式直接填，不要写成 v1.0.0。这个标签会体现在产物的文件名上，也是你之后在打包记录与产物下载里区分不同批次产物的依据，所以每次打包建议换一个新的版本号。

打包前看看这个分支改了什么 ​

编辑器左侧还有一页「客户端更新记录」，用来查看客户端源码最近的提交。选好分支后点「刷新记录」，下面会列出最近的提交，顶部还有一行配置摘要。

它的用处是：在打包之前先知道这个版本改了什么。比如你打算升级客户端，可以先翻一眼最近提交，确认没有影响你站点配置的改动，再决定要不要重新打包给用户。

和你自己填的配置无关

这一页只是只读的查看工具，不改任何配置，也不会影响打包结果。不看你也不会少什么东西。

选择打包平台 ​

「选择打包平台」是一组复选框。能勾哪些取决于两个因素：上一节选择的内核，以及你的激活码被授权的平台范围。全部平台 默认是勾上的。

值界面文案支持的打包内核
all全部平台默认勾选
windows-arm64Windows ARM64mihomo、xray
windows-amd64Windows AMD64mihomo、xray
androidAndroid（手机）mihomo、xray
android-tvAndroid TVmihomo
linux-arm64Linux ARM64mihomo
linux-amd64Linux AMD64mihomo
openwrt软路由mihomo
macos-arm64macOS ARM64mihomo、xray
macos-amd64macOS AMD64mihomo、xray
iosiOS 巨魔 IPAmihomo

界面上这组选项的原文提示是：

勾选软路由会同时生成 x86_64、ARM64 两个 IPK 包；“全部平台”包含软路由。Android TV 会生成两个架构的 TV 安装包。iOS 巨魔 IPA 产出无签名 IPA（用 TrollStore 或自签工具安装），不在“全部平台”里，需要单独勾选。

注意：iOS 巨魔 IPA 要单独勾

全部平台 里不包含 iOS 巨魔 IPA。想要这一项，必须在内核为 Mihomo 内核的前提下，单独把它勾上；只勾 全部平台 是拿不到 IPA 的。

其余几条也一并记住：

  • 勾 软路由 会一次生成 x86_64、ARM64 两个 IPK 包。
  • 勾 全部平台 等于把软路由也算在内。
  • 勾 Android TV 会生成两个架构的 TV 安装包。
  • 勾的平台越多、架构越多，云端要编译的份数就越多，排队和整体耗时也越长。只要自己确实要用的平台即可。

注意：平台一直灰着，可能是激活码没授权

换回 Mihomo 内核 之后某个平台还是点不动，就与内核无关了——那是你的激活码没有授权这个平台。

回到本页最上方的状态行，看 允许平台：... 那一项，那就是你能打的全部范围。不在范围里的平台会一直处于灰掉的状态，自己也改不了，需要联系发放激活码的人开通。

提交打包 ​

参数选完，点右下角的「开始打包」。

  • 按钮不可点：还没勾任何平台、或版本标签空着的时候，「开始打包」是灰的，点不动。此时按钮旁边的状态栏写着 选择平台和版本后点击“开始打包”。
  • 可以提交：平台和版本都填好、且打包状态为 可打包（或 管理员不限）、队列为 可提交新打包 时，按钮才可点。
  • 提交成功：页面弹出提示 软件打包已提交！档案: <档案名>，<档案名> 就是这次用到的档案名；下方随之出现打包进度面板。

如果点了没反应，按这个顺序排查：打包状态是不是 不可打包、队列是不是 队列已满，请稍后、平台和版本是不是还没选全。

看懂打包进度 ​

提交后出现的面板标题是 打包进度（完整形态类似 打包进度 - xxx）。面板里从上到下是：本次参数的复显、一条总进度条加百分比、以及按平台拆开的任务列表。每个平台算一个任务，各自有独立的状态。

界面上的进度文案和它们的意思：

界面文案含义
正在提交打包请求、等待云端受理请求刚发出去，正在等云端接单。这里停得久通常是在排队，不用重复提交。
排队等待中...云端前面还有别的任务，你的在队列里等着。
等待开始这个平台的任务还没轮到，先等着。
正在编译这个平台正在编译产物，最耗时的一步。
打包任务正在处理中。整批任务还在跑，没有新变化可报告。
正在查询打包状态...面板正在向云端确认最新进度。
打包成功这个平台的产物已经做好了。
打包失败这个平台没编译成功。先确认源码分支和版本标签填对了，再重新打包一次；对着常见问题排查也可以。
已完成这批任务整体结束。
已取消这批任务被取消，不会再产出产物。
查询构建状态失败 / 打包状态查询失败，稍后自动重试面板这一下没读到状态，它会自己重试。不用手动刷新页面。

面板右上角的 ✕ 只是把面板收起来，不会停止云端正在跑的编译。面板关掉后可以重新打开，进度会继续显示。

停止打包 ​

提交后会出现「停止打包」按钮。点它会先弹一个确认框，提示这次打包里已经开始执行的部分会被请求终止。

确认之后，状态会依次变化：先是「已提交停止请求，等待云端确认取消」，直到出现「已确认取消本次打包」，这次打包才算真正停掉。

注意：停止不是立刻生效

点完确认只是发出停止请求，云端要确认之后才会真的取消。这期间：

  • 已经编译完的平台，它的产物仍然算数，能照常下载；已经开始的平台会被请求终止。
  • 如果这批任务已经全部 打包成功，再点停止是没用的。
  • 停止成功后，这次的部分产物仍会出现在打包记录与产物下载里，可以按需下载或删掉。

所以能不中途停就别停。宁可先在提交前把平台和参数核对清楚。

打包后去哪儿拿产物 ​

提交完不用守着这个页面。回到编辑器「软件打包」区下方的 我的打包记录 区块，或在打包记录与产物下载里查看这次任务的进度和产物文件；产物下载链接的有效期只有 10 分钟，及时下载留存。

提示：先保存档案，再打包

改完任何配置项，一定先点页面底部的「保存当前档案」，然后再回到「软件打包」点「开始打包」。顺序反了的话，这次打包用的仍是上一次保存的旧配置——产物看起来是新的，配置却是旧的。

同样地，改完配置后只是重新打包还不够：产物要分发到你自己的用户手上，他们才会拿到新配置。

相关页面 ​

本文档依据 Xboard-Mihomo-builds 源码整理

NexGen Docs