Compatibility

🧭 客户端与目标格式

本页说明当前正式 Release 可接受的 target、远程订阅处理方式和节点解析路径。

“客户端更新”表示生成的配置引用原订阅 URL，后续由客户端拉取。“后端解析”表示 SubConverter-Extended 下载或读取输入后再生成目标格式。

完整目标矩阵

target	主要输出	远程 HTTP 订阅	节点解析路径
clash	Clash/Mihomo YAML	Mihomo proxy-providers；list=true 时由后端解析	Mihomo 解析桥
clashr	ClashR YAML	ClashR proxy-providers；list=true 时由后端解析	Mihomo 解析桥
surge	Surge 配置	policy-path，由客户端更新	兼容解析器
quan	Quantumult 配置	后端解析	兼容解析器
quanx	Quantumult X 配置	server_remote，由客户端更新	兼容解析器
loon	Loon 配置	Remote Proxy，由客户端更新	兼容解析器
surfboard	Surfboard 配置	policy-path，由客户端更新	兼容解析器
stash	独立 Stash YAML	Stash proxy-providers，由客户端更新	兼容解析器，并按 Stash 字段投影
mellow	Mellow 配置	后端解析	兼容解析器
singbox	Sing-box JSON	后端解析	兼容解析器
ss	Shadowsocks SIP002	后端解析	兼容解析器
ssd	SSD	后端解析	兼容解析器
ssr	ShadowsocksR	后端解析	兼容解析器
sssub	SS Android 订阅	后端解析	兼容解析器
v2ray	历史 VMess 订阅	后端解析	兼容解析器
v2rayn	v2rayN 内部订阅	后端解析并按目标能力过滤	兼容解析器
v2rayng	v2rayNG 可读取的内部订阅	后端解析并按目标能力过滤	兼容解析器
shadowrocket	分享链接订阅	后端解析并按目标能力过滤	兼容解析器
trojan	Trojan 单类型订阅	后端解析	兼容解析器
vless	VLESS 单类型订阅	后端解析	兼容解析器
hysteria2	Hysteria 2 单类型订阅	后端解析	兼容解析器
mixed	多种分享链接混合订阅	后端解析	兼容解析器

Note

“兼容解析器”是项目为非 Mihomo 目标保留并持续维护的解析路径。不同目标会根据客户端格式和实际需求继续完善。

target=auto

target=auto 会根据请求的 User-Agent 尝试选择目标。响应诊断中会记录 AUTO_TARGET_RESOLVED 对应的目标和 UA 家族。

自动识别存在三个限制：

• 反向代理或前端可能改写 User-Agent；
• 新客户端或少见客户端可能无法识别；
• 相同客户端名称不一定代表相同内核或格式版本。

能够控制请求时，优先显式填写 target。

Mihomo 路径的边界

• 只有 clash 和 clashr 节点链接进入 Mihomo 解析桥。
• 默认远程 HTTP 订阅生成 Provider，SubConverter-Extended 不下载订阅正文。
• list=true 表示需要节点列表，会让远程订阅进入后端解析路径。
• Provider 由客户端更新，后端的 proxy_subscription 不影响客户端后续更新。

客户端原生远程资源

Surge、Quantumult X、Loon、Surfboard 和 Stash 会生成各自能够表示的远程资源。这些格式并不共享同一组字段：

• Surge 可为 policy-path 指定有效的正更新间隔；
• Quantumult X 可生成 server_remote 并按需指定资源标签和间隔；
• Loon 生成 Remote Proxy，但不接受本项目的 interval: 扩展；
• Surfboard 生成 policy-path，更新间隔由客户端默认行为决定；
• Stash 生成独立 proxy-providers，不接受 Mihomo 的 provider_proxy_direct。

详细语法见远程订阅与客户端拉取和特色参数与扩展语法。

兼容性确认

确认客户端兼容性时，需要依次检查：

1. 输入解析器能否识别节点或订阅。
2. 内部模型能否保留必要字段。
3. 目标生成器能否无损表示这些字段。
4. 实际客户端版本能否导入并连接。

项目会过滤目标格式无法表示的节点。若没有任何有效节点或远程资源，请求返回 HTTP 400。

闭源客户端和不同客户端版本仍需要使用者在实际设备上验证。提交问题时请提供客户端名称、版本、target、脱敏诊断和可公开复现的输入。