/sub
| 路径 | 说明 |
|---|---|
/sub | Clash.Meta / Mihomo YAML 订阅(默认) |
/clash | 同上(YAML 别名) |
/sub?format=base64 | 标准 base64 订阅(旧版行为,含全部协议) |
/sub?format=uri | 明文节点列表,每行一个 URI(等价 raw=1) |
/nodes | JSON 结构化输出(含国家/地区字段)+ 逐资源抓取状态 |
/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 关闭 |
/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
| 标签 | 协议 | 标签 | 协议 |
|---|---|---|---|
HY | hysteria | JUICITY | juicity |
HY2 | hysteria2 | MIERU | mieru |
VLESS | vless | NAIVE | naive+https |
TUIC | tuic | SQUIC | shadowquic |
序号按上游资源顺序固定分配,重名时自动追加 #2、#3。
默认按节点服务器地址反查国家/地区码,写入节点名。查询按以下顺序逐级回退, 任一命中即止;结果按主机缓存 7 天(解析失败的结果只缓存 10 分钟, 以免接口抖动导致长期缺失标识),重复请求不再产生外部调用。
| 顺序 | 接口 | 方式 | 说明 |
|---|---|---|---|
| 1 | ip-api.com/batch | 批量 POST | 1 次子请求解析全部主机(含域名),首选 |
| 2 | api.country.is | 逐条 | HTTPS、免 key |
| 3 | ipwho.is | 逐条 | HTTPS、免 key |
| 4 | ipapi.co | 逐条 | HTTPS、免 key |
限制与降级:单次请求最多解析 64 个主机,逐条回退阶段总预算 8 秒;
超出或全部接口失败时,该节点名自动退化为不含地区标识的旧格式,不影响订阅可用性。
可用 ?geo=0 完全关闭以获得最低延迟。
/nodes 的 JSON 输出中,每个节点附带 country /
countryName 字段,顶层另有 regions 地区分布汇总;
YAML 订阅响应头附 Subscription-Regions: USx3,JPx2。
| 协议 | 节点数 | YAML | base64/URI | 支持的客户端 |
|---|---|---|---|---|
hysteria | 5 | ✅ | ✅ | Mihomo / sing-box / v2rayN 等,广泛支持 |
vless | 2 | ✅ | ✅ | 广泛支持(含 Reality + xhttp) |
hysteria2 | 1 | ✅ | ✅ | 广泛支持 |
naive+https | 2 | ❌ | ✅ | sing-box / NekoRay 等(Mihomo 不支持) |
juicity | 2 | ❌ | ✅ | 仅 Juicity 专用客户端 |
mieru | 2 | ❌ | ✅ | 仅 Mieru 专用客户端 |
shadowquic | 2 | ❌ | ✅ | 仅 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>/<客户端>/<序号>/<配置文件>