ChromeGo 订阅聚合 Worker

把 ChromeGo 包内 9 类客户端的云端配置源聚合为一条 Clash.Meta / Mihomo YAML 订阅(同时兼容 base64 / 明文 URI)

订阅地址

/sub

路由

路径说明
/subClash.Meta / Mihomo YAML 订阅(默认)
/clash同上(YAML 别名)
/sub?format=base64标准 base64 订阅(旧版行为,含全部协议)
/sub?format=uri明文节点列表,每行一个 URI(等价 raw=1)
/nodesJSON 结构化输出(含国家/地区字段)+ 逐资源抓取状态
/debug纯文本诊断报告:节点数、状态汇总、逐资源明细

查询参数

参数默认说明
format=yaml输出格式:yaml / base64 / uri
raw=1关闭等价于 format=uri(返回明文)
all=1关闭同时抓取 ipp 与 ip 两套路径(默认只用 ipp,ip 作回退)
extra=0开启剔除无标准 URI 协议的节点(Mieru / ShadowQuic)
dedupe=0开启关闭去重,保留上游全部条目(会有重复节点)
proto=不过滤只保留指定协议,逗号分隔,如 ?proto=hysteria,hysteria2,vless
prefix=ChromeGo自定义节点名前缀,如 ?prefix=CG
endpoint=1关闭在名称末尾附上 主机:端口(默认不附)
geo=code地区标识形式:code(US)/ name(美国)/ 0 关闭

YAML 输出说明

/sub 默认返回一份完整可用的 Mihomo 配置:proxies + 4 个策略组(节点选择 / 自动选择 / 全球直连 / 全球拦截)+ 国内直连分流规则 + fake-ip DNS。直接粘进 Clash Verge / Mihomo Party / OpenClash 的订阅栏即可。

协议取舍:Mihomo 无法解析 juicity、naive+https、 mieru、shadowquic 四种私有协议,YAML 中会跳过这些节点 (跳过数量见文件头注释与响应头 Subscription-Skipped-Count)。 需要完整节点请改用 ?format=base64。

GET /sub                       → text/yaml(Mihomo 配置)
GET /sub?format=base64         → text/plain(base64 节点串)
GET /sub?format=uri            → text/plain(每行一个 URI)

节点命名规则

格式:前缀 序号 地区标识 协议标签。默认不含服务器地址——客户端本来就会在名称下方单独显示,写进名称会重复。

ChromeGo 01 US HY2
ChromeGo 02 JP VLESS
ChromeGo 03 SG JUICITY

地区标识由 ?geo= 控制:

?geo=code   →  ChromeGo 01 US HY2        (默认)
?geo=name   →  ChromeGo 01 美国 HY2
?geo=0      →  ChromeGo 01 HY2           (关闭,最快)

地区标识为纯文本,不含国旗 emoji,避免部分客户端字体渲染异常。

如需把服务器地址拼回名称,加 ?endpoint=1:

ChromeGo 01 US HY2 2001:bc8:32d7:17b::3:22000
ChromeGo 02 FR VLESS 62.210.70.194:37783
标签协议标签协议
HYhysteriaJUICITYjuicity
HY2hysteria2MIERUmieru
VLESSvlessNAIVEnaive+https
TUICtuicSQUICshadowquic

序号按上游资源顺序固定分配,重名时自动追加 #2、#3。

地区识别

默认按节点服务器地址反查国家/地区码,写入节点名。查询按以下顺序逐级回退, 任一命中即止;结果按主机缓存 7 天(解析失败的结果只缓存 10 分钟, 以免接口抖动导致长期缺失标识),重复请求不再产生外部调用。

顺序接口方式说明
1ip-api.com/batch批量 POST1 次子请求解析全部主机(含域名),首选
2api.country.is逐条HTTPS、免 key
3ipwho.is逐条HTTPS、免 key
4ipapi.co逐条HTTPS、免 key

限制与降级:单次请求最多解析 64 个主机,逐条回退阶段总预算 8 秒; 超出或全部接口失败时,该节点名自动退化为不含地区标识的旧格式,不影响订阅可用性。 可用 ?geo=0 完全关闭以获得最低延迟。

/nodes 的 JSON 输出中,每个节点附带 country / countryName 字段,顶层另有 regions 地区分布汇总; YAML 订阅响应头附 Subscription-Regions: USx3,JPx2。

协议支持矩阵(16 个节点的构成)

协议节点数YAMLbase64/URI支持的客户端
hysteria5✅✅Mihomo / sing-box / v2rayN 等,广泛支持
vless2✅✅广泛支持(含 Reality + xhttp)
hysteria21✅✅广泛支持
naive+https2❌✅sing-box / NekoRay 等(Mihomo 不支持)
juicity2❌✅仅 Juicity 专用客户端
mieru2❌✅仅 Mieru 专用客户端
shadowquic2❌✅仅 ShadowQuic 专用客户端

因此默认的 YAML 订阅包含 8 个节点;若客户端只显示 10 个(base64 订阅), 缺的正是最后 3 行的 6 个(juicity + mieru + shadowquic),它们使用私有协议,主流客户端无法解析。

排查:节点数偏少?

上游 ipp/<客户端>/1..N 多个序号经常返回同一个节点(例如 hysteria2 的 1~4 内容完全相同), 去重后数量必然小于资源数。访问 /debug 可看到每个资源的实际状态: OK / DUPLICATE / PARSE_EMPTY / FETCH_FAILED。

YAML 订阅的节点数会再少一截:juicity / naive+https / mieru / shadowquic 四类私有协议被跳过。节点名中的序号与 base64 订阅保持一致 (例如 ChromeGo 16 HY),所以序号不连续属正常现象。

数据源

M1  https://gitlab.com/free9999/ipupdate/-/raw/master/
M2  https://www.67867867.xyz/Alvin9999/PAC/refs/heads/master/
路径  backup/img/1/2/<ipp|ip>/<客户端>/<序号>/<配置文件>