Skip to content

这一项是做什么的

云端调度让客户端在连接节点之前,先向 GTM 服务问一次这些机器现在在哪个地址上,再用返回的在线机器信息匹配订阅节点域名,把该节点的地址换成最新公网 IPv4;命中 GTM 总入口时,会在可用的分类入口里随机选一个。

客户端只会用到「GTM 服务地址」和「查询密钥」,不需要其他凭据。请求地址固定,不需要你补路径。

前置条件:GTM 控制台需要单独购买

这个功能依赖一个统一的服务端控制台(GTM 服务)——它负责汇总各机器当前的在线状态和最新公网地址,客户端才能查到该往哪儿连。

这个控制台不是随客户端附带的,需要单独购买/开通。 没有它的话,下面的「GTM 服务地址」和「查询密钥」就无从填写,这一组配置也就用不起来。

购买与开通方式见如何购买

在编辑器里的位置

  • 老客户端编辑器:这一组收在「自定义功能配置」面板里,需要先用对接码验证通过才会显示。
  • 新客户端编辑器:「订阅设置」页面下有独立的「云端调度」分组,属于普通配置项,不需要对接码就能直接改。

两边改的是同一组设置,改哪边都一样;改完仍要重新打包才会体现在客户端产物里,见软件打包

支持情况

  • 老客户端 Xboard-Mihomo_sub:支持(仅默认分支 · 仅旧 UI)
  • 新客户端 NexGen Client React:支持(默认分支、sspanel-maliosspanel-metron · 两套 UI)

注意

老客户端上,这一组只有用默认分支打包才生效——sspanel-uimsspanel-maliosspanel-metron 这几个分支都没有实现云端调度,填了也不会生效。而且它只有旧 UI 有入口,打包成新 UI 时用不上。

新客户端在默认分支、sspanel-maliosspanel-metron 都有实现,两套 UI 都生效;只有 sspanel-uim 分支没有。

字段与取值

说明取值或默认值
云端调度:总开关,开启后客户端才会使用下面的 GTM 服务地址与查询密钥开启 / 关闭;开启时「GTM 服务地址」和「查询密钥」都必填
GTM 服务地址:只填协议、主机和端口即可,客户端固定请求 /api/query/machines网址,示例 https://gtm.example.com;需以 http://https:// 开头
查询密钥:查询 GTM 服务所用的密钥,按 GTM 服务里配置的那一个填写文本;开启「云端调度」时必填
自动调度:开启后客户端按「自动调度间隔(分钟)」定时查询并替换入口 IP开启 / 关闭
自动调度间隔(分钟):每次查询并替换入口 IP 的间隔1 ~ 1440,默认 5
离线兜底回查间隔(分钟):目标入口离线后先切到其他可用入口,到达本间隔后再次允许回查原入口,入口恢复后切回原入口的最新 IP1 ~ 1440,默认 5

保存校验与取值范围

开启「云端调度」时,「GTM 服务地址」和「查询密钥」都是必填,缺一个配置校验都不会通过;「GTM 服务地址」必须以 http://https:// 开头,其它协议不会被接受。

两处间隔的单位都是分钟,允许范围同为 1 ~ 1440(即 1 分钟到 24 小时),默认值都是 5 分钟。

相关页面

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