外观
本页覆盖两个客户端编辑器「订阅设置」页面里的三组选项:订阅配置、面板 API 请求、SSPanel-Metron 专属配置。三组在 Xboard-Mihomo 与 NexGen React 编辑器中都存在。其中「订阅配置」里两个客户端各有一个自己的「自定义订阅域名」,所以该分组在每个编辑器中实际显示的项数比另一端的略多。
订阅配置
这一组决定客户端以什么身份、按什么规则拉取订阅。其中「专用客户端模式」决定两个 UA 字段谁生效:
| 专用客户端模式 | 生效的 UA 字段 | 该字段留空时的回退值 |
|---|---|---|
| 关闭 | 普通模式订阅 UA(subscriptionUserAgent) | Clash Meta |
| 开启 | 专用模式订阅 UA(exclusiveSubscriptionUserAgent) | XBoardMihomo/1.0 |
专用客户端模式
- 控件:开关
专用客户端模式的总开关。开启后客户端改用「专用模式订阅 UA」作为订阅请求标识,用来把专用节点与公开节点隔离开。
注意
开启前请先完成后端面板对接:此开关只让客户端使用专用订阅标识,不会自动修改后端逻辑。完成改造后,专用客户端只获取带「客户端专用」标签的节点,普通第三方客户端只获取未带该标签的节点。后端补丁脚本目前仅用于 xiaov2board,暂不支持 SSPanel 系面板;改造未生效前开启,可能订阅失败或专用节点不生效。
普通模式订阅 UA
- 控件:文本框
- 示例:留空时默认使用 Clash Meta
仅在关闭「专用客户端模式」时生效。开启专用模式后,订阅请求标识改由下方的「专用模式订阅 UA」决定,这里填写的内容不再作为订阅标识使用。
专用模式订阅 UA
- 控件:文本框
- 示例:留空时默认使用 XBoardMihomo/1.0
选填,仅在开启「专用客户端模式」后显示。留空时会回退到默认值 XBoardMihomo/1.0;可以完全自定义,但必须与你给后端补丁脚本输入的专用客户端 UA / 标识保持一致,否则后端无法把请求识别为专用客户端。
订阅解密密钥
- 控件:文本框
- 示例:
your_secret_decrypt_key_here
可选。用于解密订阅服务端返回的加密内容,必须与服务端或远程配置约定的 decrypt_key 完全一致;留空表示不启用订阅解密。
只有面板那边已经开启了订阅加密,这里才能填
必须确认你对接的面板已经加密了订阅,才开启这一项。
面板那边的订阅还是明文、这边却填了解密密钥的话,客户端会按加密内容去解密一段明文,结果是订阅拉不下来——用户端表现为订阅更新失败。
拿不准就先留空。留空表示不启用订阅解密,订阅按明文正常拉取。
自定义订阅域名
- 控件:多行文本
可选,可填写多个,每行一个。配置后,客户端拉取订阅时会从这些域名里随机挑一个开始尝试,某个域名超过 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 或其他面板需要的查询参数。