外观
登录与权限
登录时提示「激活码无效」
- 先检查激活码本身：粘贴时容易带上首尾空格或漏掉结尾字符，请重新完整粘贴一遍再点「登 录」。
- 确认用的是发给你的那个激活码，而不是其他人的。
- 上面两条都排除后，说明这个激活码已经不存在，请联系把激活码发给你的发放方重新获取一个。
登录时提示「激活码已停用」
- 这个激活码已被发放方停用，属于对方侧的设置，你这边无法自助恢复。
- 联系发放方说明情况，请对方重新启用，或者给你换一个可用的激活码。
- 在停用状态下重复点「登 录」不会有任何变化。
登录时提示「激活码已过期」
- 激活码有有效期，过期后既不能登录，也不能再提交打包。
- 只能联系发放方续期或更换激活码；续期后重新登录即可继续使用。
- 如果你的档案是绑在这个激活码上的，换新激活码前先跟发放方确认一下原来保存的档案怎么处理，避免新码里看不到旧档案。
想换到另一个客户端
- 两个客户端（
Xboard-Mihomo_sub老客户端、NexGen Client React新客户端）都在你的激活码范围内，登录后先看到「选择客户端入口」，点对应卡片进入即可。 - 已经在编辑器里时，右上角有「切换客户端」，点它就能回到选择页。页面会记住你上次选的客户端，下次进来自动高亮。
- 注意两个客户端的档案不互通：在一个里保存的配置不会出现在另一个里，切换过去需要各自配置、各自保存。
提示「激活码已达最大打包次数」
- 先看「软件打包」区域里的那行状态，原文会写成「打包次数：已打包 N 次 / 上限 M 次」，下面还会给出「剩余次数：N 次」和「到期日期：...」，对照一下是不是真的用满了、是不是快到期了。
- 还没跑完的打包会临时占用次数：如果「我的打包记录」里还有「排队等待中...」「正在打包...」的任务，等它们跑完（或点「停止打包」取消）之后再回来看这行状态。
- 额度默认是 10 次，快用完之前联系发放方可免费增加（联系方式见如何购买）。建议不要等到用满——用满后就提交不了新任务了，提前说一声更省事。
- 反复点「开始打包」不会帮你多打一次。
- 顺带说明：只有打包成功的任务才会占用一次次数，打包失败或中途取消的任务不计入「已打包」次数。
登录态多久会失效？失效后怎么办
- 登录状态有效期是 24 小时，从登录成功那一刻开始算，到点自动失效。
- 失效后页面会报登录相关的错误或直接回到登录页，重新输入激活码点「登 录」即可。
- 之前点过「保存当前档案」的配置都还在，不需要重填一遍；只有没保存的改动会丢，所以改完要随手保存。
- 长时间挂着页面跨天工作时留意这一点，遇到提交打包或保存报错先重新登录一次再试。
打包
「开始打包」按钮是灰的点不了
- 按钮上方那行状态原文写着「选择平台和版本后点击“开始打包”」，意思就是：没有勾选打包平台，或者没有填版本标签，按钮就是灰的。
- 按顺序补齐这几项：选「Mihomo 内核」或「Xray 内核」→ 在「源码分支」下拉里选与面板类型对应的分支 → 在「版本标签」里填
1.0.0这种标准版本号 → 至少勾一个打包平台（想省事可以直接勾「全部平台」）。 - 另外两种常见原因也会让按钮变灰：激活码侧的限制（提示「当前不可打包」）和队列满（提示「当前打包队列已满，请稍后再试」）。把鼠标停在灰按钮上，会显示具体是哪一个原因。
提示「当前不可打包」
- 这是激活码层面的限制，不是网络问题：可能已停用、已过期，或者已达最大打包次数。
- 页面上的「软件打包状态」会直接写出原因（形如「软件打包状态：不可打包」），同一区块还会列出「打包次数：已打包 N 次 / 上限 M 次」「剩余次数：N 次」「到期日期：...」「允许平台：...」，先看这几行定位。
- 属于次数或有效期的问题时，联系发放方处理；属于停用或过期时，点「开始打包」不会有任何提交动作。
- 顺带确认一下：「源码分支」没有选中、勾的平台在当前内核下不可用，也会被拦下，逐项核对一遍能省一次来回。
提示「队列已满，请稍后」
- 意思是此刻云端同时在跑的打包任务太多，暂时排不下你的任务。队列那一行会显示「队列已满，请稍后」，鼠标停在灰按钮上是「当前打包队列已满，请稍后再试」。
- 能做的就是等：界面上出现「可提交新打包」时按钮会恢复可点，通常几分钟内就会变化。
- 不要连续点按钮，也不要反复重新提交，那只会让你排在更多任务后面。
- 想尽快腾出位置，可以先到「我的打包记录」里，把不再需要的进行中任务点「停止打包」取消掉。
选错了内核，想选的平台勾不上
- 打包内核决定了可选平台。
Xray 内核当前只支持 Windows ARM64/AMD64、Android（手机）和 macOS ARM64/AMD64，选中它时界面会提示：「Xray 内核当前只支持 Windows ARM64/AMD64、Android（手机）和 macOS ARM64/AMD64；Linux、Android TV 与软路由已自动隐藏。」 - 要打 Android TV、Linux、软路由或 iOS 巨魔 IPA，请把内核切回「Mihomo 内核」（角标
当前默认），这些平台就会重新出现。Mihomo 内核的说明原文是「全平台打包：Windows、Android、Android TV、Linux、macOS。」 - 切换内核后，之前勾上但当前内核不支持的平台不会被打包，请重新核对一遍勾选项再提交。另外，「全部平台」这个选项在 Xray 内核下会改名为「全部 Xray 支持平台」，勾它同理只会打到 Xray 支持的平台。
- 还有一种勾不上与内核无关：激活码本身限制了可打的平台。「软件打包」区域那行状态里的「允许平台：...」就是你的可用范围，不在里面的平台会一直处于灰掉的状态，这时需要联系发放方开通对应平台。
版本标签带了 v 前缀，或格式不对被拦下
- 版本标签只接受
1.0.0这种三段数字格式。填错时输入框会变红并提示：「版本标签格式不正确，请直接填写1.0.0这种格式，不要带v前缀，也不要追加+20260308这类内容。」 - 正确写法：
1.0.0、1.2.3。错误写法：v1.0.0、1.0、1.0.0+20260308。 - 输入框下方的常规提示原文是：「这里请直接填写标准版本号，不要带
v前缀，直接使用1.0.0这种格式。」 - 改成正确格式后红框消失，「开始打包」才能点。
面板是 SSPanel，源码分支该怎么选
- 看「源码分支」下方的提示原文：「请选择与你当前面板类型对应的源码分支：XBoard、V2Board 和 xiaov2board 请选择
main，SSPanel 请选择对应分支。」 - 也就是说：XBoard、V2Board、xiaov2board 一律选
main；SSPanel 则要在下拉里选与你的面板对应的那个分支，不要照着别人的配置抄main。 - 下拉里的分支名来自当前可用的源码列表，选不准时先按面板的实际版本确认清楚再提交。
- 提交完成后可以到「我的打包记录」里核对卡片上的「分支:」是不是你选的那个，选错了要重新打包一次。
打包一直停在「排队等待中...」
- 「排队等待中...」「等待开始」表示任务已经提交成功，正在等前面的任务跑完，属于正常排队，不是卡死。
- 先确认自己的任务在往前走：打开「我的打包记录」点「刷新」，状态会从「排队等待中...」变成「正在打包...」，再变成「打包成功」或「打包失败」。
- 进度面板右上角的
✕只是把面板关掉，不会取消打包；关掉后照样可以在「我的打包记录」里看进展。 - 真的不想等了，就点「停止打包」，等按钮从「停止中...」恢复后再决定是否重新提交。排队期间不要反复点「开始打包」，那只会占用队列。
- 如果同一个版本长时间没有任何状态变化，先刷新记录；仍无变化时，停止这次任务后重新提交一次。
打包失败了，怎么看原因、能不能重试
- 状态会明确显示「打包失败」（提交阶段就没成功时会显示「触发失败」）。用户界面里看不到云端编译的日志，所以按下面几条自查最快：
- 档案有没有点过「保存当前档案」——只改控件不保存，打出来的仍是旧内容；
- 「版本标签」格式是否正确（见上文）；
- 「源码分支」是否与你的面板类型对应；
- 勾选的打包平台是否都在当前内核的支持范围内；
- 「打包次数：已打包 N 次 / 上限 M 次」是否还有余量。
- 可以直接重试：改好上述问题后，重新勾平台、填版本，再点「开始打包」。失败的打包不计入「已打包」次数，所以重试不会白白消耗次数。
- 「软件打包」区域下方的「上次打包记录：」会显示上次用的「版本:」「内核:」「平台:」「时间:」，可以照着它比对这次要改哪里。
- 反复失败时，把「我的打包记录」卡片上的「内核:」「分支:」「平台:」「创建时间:」，连同档案名和版本标签一起发给发放方，请对方帮忙定位。
点了「停止打包」，为什么一直显示「停止中...」
- 停止不是瞬间生效的：点下去之后按钮会变成「停止中...」，提示「已提交停止请求，等待确认取消」，表示请求已经发出、正在等确认。
- 这一阶段重复点是没用的，等状态变成「已取消」就说明停下来了；「我的打包记录」里的卡片状态也会同步变化。
- 如果长时间停在这一步，先点「我的打包记录」的「刷新」看最新状态；仍然不动时，可以「删除记录」把它从列表里清掉，再重新提交一次打包。
- 顺带提醒：「删除记录」会连同这次已经生成的产物一起删掉，确认弹窗里写的是「删除后会同步删除对应的打包产物」，确认前想清楚。
产物
找不到下载入口，或者下载链接很快就失效
- 入口在「软件打包」区域下方的「我的打包记录」：先点「展开」，找到对应记录，再点卡片右侧的「下载文件」（产物还没准备好时，这个按钮显示为「查看产物」）。
- 点开后每个文件后面都有「下载」和「复制链接」两个按钮。界面会写明：「每次获取的下载链接 10 分钟内有效，过期后可重新申请。」
- 链接过期不需要重新打包：关掉下载窗口，再点一次「下载」就会重新申请一条新链接；「复制链接」拿到的链接同样只有 10 分钟有效期，给别人的话请尽快让对方下载。
- 下载过程中可以点「取消下载」中断，之后再点「下载」重来即可。
提示「打包产物已过期，请重新打包后下载。」
- 这说明产物已经被清理掉了：打包产物只保留 15 天，超期会被删除，页面上对应记录的按钮也会变成「文件已过期」。
- 唯一的办法是重新打包：重新选好内核、源码分支、版本标签和平台，点「开始打包」，等新产物出来再下载。
- 想少碰到这种情况，打包成功后尽快把要长期保留的产物下载到自己的电脑或网盘里。
记录只剩 3 条，之前的产物去哪了
- 「我的打包记录」只显示最近 3 条，而且老客户端和新客户端共用这 3 条；更早的记录会从这个列表里消失，界面上也就没有入口再去下载它们对应的产物了。
- 也就是说，记录被挤掉之后就取不回来了（哪怕产物还没到 15 天的保留期），只能重新打包。所以列表里出现有价值的产物时，先点「下载」存到本地。
- 另外注意：「删除记录」不是只删一行文字，确认弹窗会提醒「删除后会同步删除对应的打包产物」，一旦确认，产物也一起消失，无法恢复。
自定义功能
「自定义功能配置」面板里什么都没有
- 这说明你还没有用对接码解锁。这个面板放的是「一部分用户需要、但不适合对所有用户默认开放」的功能（配色、部分入口隐藏、云端调度等），必须先验证对接码才会显示出对应功能项。没有码就是空的，这是正常的。
- 按顺序处理：
- 先在左侧选中要操作的档案，再进这个面板；
- 在「对接码」输入框里填入你拿到的码，点
验证对接码； - 验证通过后会提示形如
对接码验证通过：已授权 N 项，已开启或配置 M 项，下面才会出现你这个码授权的功能。
- 如果你根本没有对接码：它由发放激活码的人按「功能组」配置下发，不同码解锁的功能不一样，在面板里是试不出来的，需要找发码的人开通。
- 如果填了码仍提示
验证失败: ...：先核对有没有输错、有没有带多余空格；确认无误就是没被授权，找发码的人核实。 - 如果提示
后台还没有为该自定义功能配置任何可用的自定义功能组，请先到管理后台系统设置中新增。：这是发码方还没配好功能组，你这边处理不了。 - 完整说明见自定义功能配置。
改了配色或隐藏项，客户端没变化
- 这些功能和普通配置项一样，改完必须先保存、再重新打包，改动才会进入客户端产物。已经分发出去的旧安装包不会自动变。
- 另外注意这个面板是按档案生效的：你在 A 档案里解锁并开启的功能，不会自动出现在 B 档案里。打包时用的是哪份档案，就按哪份档案的配置来。
换了一个对接码，之前开的功能还在吗
- 本面板保存的是功能是否开启这个状态，不是「哪个码开过」的记录。换码重新验证后，你看到的功能项会变成新码授权的那些，之前开过的项只要还在新码的授权范围内，就仍然保持开启状态。
- 如果某项不在新码的授权范围里，它就从这个面板消失了，也就无法继续修改。想确认当前状态，看验证通过后的提示：
已授权 N 项，已开启或配置 M 项。
配置
改了配置，打出来的包却没变化
- 最常见的原因是改完控件没有保存。编辑器底部有「保存当前档案」按钮，页面里多处帮助文案也在反复提醒这一步（例如上传图标后的提示是「上传后仍需点击“保存当前档案”」）；只改不存，打出来的还是上一次保存的档案内容。
- 按这个顺序检查一遍：
- 点「保存当前档案」，等保存成功的提示出现；
- 再点「开始打包」。提交成功的提示会写成「软件打包已提交！档案: <档案名>」，核对这里的档案名是不是你刚改的那一份——档案有多份时，最容易打错另一份；
- 打包完成后重新下载并安装新产物。已经装在你手机或电脑上的旧客户端不会自己变成新的；
- 如果改的是「远程配置文件」区块里的内容（例如内置代理线路、在线客服），这类内容由客户端启动时从 OSS 拉取，改完不需要重新打包：重新「下载配置好的 JSON」，放回你的资源存储，客户端下次启动就会读到新内容。
- 还有一种情况是生效延迟：客户端启用了订阅缓存或自动离线时，订阅与节点相关的改动会按缓存有效期延后生效，详见自动离线与订阅缓存。
加密的 OSS 配置文件 密钥丢了怎么办
- 先确认是不是真的丢了：密钥不会存进「最近保存记录」——那 10 条记录里只有未加密的配置内容，没有密钥。换浏览器、换电脑或清理了浏览器数据之后，密钥就找不回来了。
- 找不回来时只能重新加密一遍：
- 打开「远程配置文件」区块，把「加密密钥（Base64，32字节）」框清空；
- 点「生成密钥并加密配置文件」生成一把新密钥；
- 立刻点「复制密钥」，存进你的密码管理器或其他安全的地方；
- 点「下载加密后的配置文件」，把它放回你的资源存储；
- 把新密钥填写到远程配置源的「加密密钥（可选）」里，保证两处一致。
- 用旧密钥加密的那份文件从此无法读取，必须用新密钥加密的这份替换掉。以后每次「生成密钥并加密配置文件」都要当场保存密钥，别再等下一次。
- 完整的加密与密钥说明见加密与密钥，区块本身的操作步骤见远程配置文件。