Skip to content

本页覆盖两个客户端编辑器「订阅设置」页面里的三组选项:订阅配置面板 API 请求SSPanel-Metron 专属配置。三组在 Xboard-Mihomo 与 NexGen React 编辑器中都存在。其中「订阅配置」里两个客户端各有一个自己的「自定义订阅域名」,所以该分组在每个编辑器中实际显示的项数比另一端的略多。

订阅配置

这一组决定客户端以什么身份、按什么规则拉取订阅。其中「专用客户端模式」决定两个 UA 字段谁生效:

专用客户端模式生效的 UA 字段该字段留空时的回退值
关闭普通模式订阅 UA(subscriptionUserAgentClash Meta
开启专用模式订阅 UA(exclusiveSubscriptionUserAgentXBoardMihomo/1.0

专用客户端模式

  • 控件:开关

专用客户端模式的总开关。开启后客户端改用「专用模式订阅 UA」作为订阅请求标识,用来把专用节点与公开节点隔离开。

注意

开启前请先完成后端面板对接:此开关只让客户端使用专用订阅标识,不会自动修改后端逻辑。完成改造后,专用客户端只获取带「客户端专用」标签的节点,普通第三方客户端只获取未带该标签的节点。后端补丁脚本目前仅用于 xiaov2board,暂不支持 SSPanel 系面板;改造未生效前开启,可能订阅失败或专用节点不生效。

普通模式订阅 UA

  • 控件:文本框
  • 示例:留空时默认使用 Clash Meta

仅在关闭「专用客户端模式」时生效。开启专用模式后,订阅请求标识改由下方的「专用模式订阅 UA」决定,这里填写的内容不再作为订阅标识使用。

专用模式订阅 UA

  • 控件:文本框
  • 示例:留空时默认使用 XBoardMihomo/1.0

选填,仅在开启「专用客户端模式」后显示。留空时会回退到默认值 XBoardMihomo/1.0;可以完全自定义,但必须与你给后端补丁脚本输入的专用客户端 UA / 标识保持一致,否则后端无法把请求识别为专用客户端。

订阅解密密钥

  • 控件:文本框
  • 示例your_secret_decrypt_key_here

可选。用于解密订阅服务端返回的加密内容,必须与服务端或远程配置约定的 decrypt_key 完全一致;留空表示不启用订阅解密。

只有面板那边已经开启了订阅加密,这里才能填

必须确认你对接的面板已经加密了订阅,才开启这一项。

面板那边的订阅还是明文、这边却填了解密密钥的话,客户端会按加密内容去解密一段明文,结果是订阅拉不下来——用户端表现为订阅更新失败

拿不准就先留空。留空表示不启用订阅解密,订阅按明文正常拉取。

相关配置可参考 远程配置与 OSS加密与密钥

自定义订阅域名

  • 控件:多行文本

可选,可填写多个,每行一个。配置后,客户端拉取订阅时会从这些域名里随机挑一个开始尝试,某个域名超过 10 秒仍未取到内容就自动换下一个;全部失败则回退到默认逻辑(后端返回的订阅地址优先,未返回时使用远程配置里的站点地址)。

替换时只改域名——完整订阅链接的路径与 token 仍由后端返回的订阅地址拼出来。留空表示不启用。

适合什么场景

面板域名在某些网络下不稳定、或你想让订阅走自己的加速域名时用这个。多个域名可以理解为「一份候选名单」,客户端会自动挑能用的那个。

面板 API 请求

这一组只影响客户端访问面板 API 的方式,不影响订阅本身。

面板 API 自定义 UA

  • 控件:文本框
  • 示例:留空时不启用自定义 UA

用于面板 API 请求;留空表示不设置自定义 UA。

自定义 API 逻辑前缀

  • 控件:文本框
  • 默认值/api/v1
  • 示例/api/v1

客户端会用这里配置的 API 逻辑前缀替换默认的 /api/v1,站点域名仍然从配置文件中获取。

SSPanel-Metron 专属配置

自定义订阅查询后缀

  • 控件:文本框
  • 示例:留空时默认使用 clash=1

SSPanel-Metron 的 Clash / Mihomo 订阅通常需要 clash=1。留空时客户端默认使用 clash=1,也可以填写 clashmeta=1 或其他面板需要的查询参数。

相关页面

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