让 QX 读懂别家的订阅
节点、分流、重写一次转好
V2RayN、Clash、Surge、Loon、Shadowrocket、SIP008、Hysteria2 的订阅与规则,交给它统一翻译成 Quantumult X 的写法。转换规则可以按关键词筛、按正则改、按策略组分配,全都写在链接的参数里。
安装
三步装好,之后所有资源引用都能用上解析器。
写进配置文件
在 QX 配置的 [general] 段落里加一行 resource_parser_url = …,地址见上方复制按钮。
勾上「使用解析器」
进「资源引用」,编辑要用的节点订阅、分流、重写,把「使用解析器」打开。
刷新资源
下拉刷新引用;若提示「没有自定义解析器」,长按首页右下角图标点左侧刷新,再彻底退出 App 重进。
// 参数跟在订阅地址的 # 后面,多个用 & 连接 https://你的订阅地址#emoji=1&udp=1&in=香港+台湾&rename=旧名@新名 // 本地 / iCloud 里的规则文件同样支持(build 951 起),路径上的参数优先 // 特殊字符先 URL-Encode:+ → %2B,空格 → %20,@ → %40,& → %26,, → %2C
支持的格式
节点、规则、重写三类输入,自动识别类型,也可用 type= 强制指定。
参数速查
全部参数都在这里,输入关键词可以过滤。
| 参数 | 作用 |
|---|---|
emoji=1 / -1 / 2 | 节点名加或去地区旗帜,国行设备用 2 |
udp=1 / -1 | 批量开或关 udp-relay |
tfo=1 / -1 | 批量开或关 fast-open |
uot=1 | SS(R) 打开 udp-over-tcp |
cert=1 / -1 / 域名 | 开或关 TLS 证书校验;填域名时作为 tls-verification 的校验域名(938+) |
csha=xxx | 指定 tls-cert-sha256 |
psha=xxx | 指定 tls-pubkey-sha256 |
alpn=xxx | 指定 over-tls 节点的 alpn |
tls13=1 / -1 | 开或关 tls13 |
tsession=0/1/2 | 0、1 关闭 session-ticket 或 reuse,2 两个都关(771+) |
aead=-1 | 关闭 vmess 的 AEAD |
in=关键词 | 按节点名保留,+ 表示或、. 表示与 |
out=关键词 | 按节点名删除,写法同 in |
regex=正则 | 按节点完整信息(类型、端口、加密方式…)正则保留 |
regout=正则 | 按完整信息正则删除 |
rename=旧@新 | 重命名,支持「旧名@新名」「前缀@」「@后缀」,多组用 + 连接;结尾加 ☠️ 表示删除该字段 |
rrname=… | 同 rename,但排在 emoji 之后执行 |
replace=正则@替换 | 对节点字段做正则替换,改名、改加密方式都能用 |
delreg=正则 | 按正则从节点名里删内容(容易误伤,慎用) |
sfilter=base64 | 传一段 base64 脚本做自定义过滤 |
srename=base64 | 传一段 base64 脚本做自定义重命名 |
ptn=1-8 | 节点名里的英文换成花漾字,8 种样式 |
npt=1-8 | 节点名里的数字换成花漾字,8 种样式 |
cap=1 | 节点名首字母大写 |
suffix=1 / -1 | 给节点名加类型后缀或前缀 |
sort=1/-1/x/规则 | 按名字正序、倒序、随机排序,也可写 HK>SG>JP 这种优先顺序 |
sortx=1 / -1 | 按订阅分组(tag)正序或倒序 |
checkurl=xxx | 指定 server_check_url |
host=xxx | 改已有 host;想新增 host 就在结尾加 ☠️ |
obfs=vhttp/shttp | 强指 shadowsocks-http 或 vmess-http |
relay=策略名 | 把落地节点订阅转成 ip / host 规则,用来做代理链 |
flow=到期:总GB:已用 | 手工补流量信息,如 flow=2026-12-31:1000:54 |
info=1 | 用通知显示机场流量与到期时间 |
UA=1 | 换 Shadowrocket 的 UA 再拉一次订阅 |
| 参数 | 作用 |
|---|---|
in / out | 按关键词保留或删除 rewrite、filter 条目 |
regex / regout | 同上,用正则匹配 |
inhn=xxx | 按 hostname 保留 |
outhn=xxx | 按 hostname 删除 |
policy=xxx | 指定策略组;解析 Surge rule-set 时用它生成策略组 |
pset=正则@策略 | 同一份规则里不同关键词分别给不同策略组,多组用 + |
replace=正则@新正则 | 对重写、分流正文做替换 |
dst=rewrite / filter | 把 module 强制当重写、把 rule-set 强制当分流 |
cdn=1 | 把 github 脚本地址换成 fastly.jsdelivr.net/gh 镜像 |
fcr=1/2/3 | 给规则加 force-cellular / multi-interface / 负载均衡 |
via=接口 | 给规则加 via-interface,填 0 表示 %TUN% |
| 参数 | 作用 |
|---|---|
ntf=0 / 1 | 关或开解析通知,重写与分流默认开、节点默认关 |
type=… | domain-set / rule / module / list / nodes,自动识别失败时强制指定 |
hide=0 | 被筛掉的条目改成注释保留,而不是直接删掉 |
profile=111 | 用 URI-Scheme 一次性导入配置里的远程资源,三位分别代表 服务器 / 分流 / 重写 |
dbg=1 | 调试模式,把中间结果打进通知 |
cnt=1 | 通知里显示解析后的条目数量 |
$type0-7 | 占位符:节点类型,8 种花漾样式,从「𝐬𝐬」到「ˢˢ」 |
$index0-8 | 占位符:节点序号,9 种样式,从 1 到 𝟷 |
$emoji1/2 | 占位符:节点名里的地区旗帜 |
$tag | 占位符:订阅的 tag,后面可跟数字指定花漾样式 |
常见问题
装不上、转不对,多半是下面几种情况。
提示「没有自定义解析器」怎么办?
说明 QX 还没拉到脚本。确认配置文件那行写的是 resource_parser_url = https://qx.tatalvpai.vip/Scripts/resource-parser.js,然后长按首页右下角图标,点左侧的刷新按钮更新资源,再从后台彻底退出 App 重进,直到资源页出现解析器说明。
节点转出来是空的,或者少了几条?
先在链接后加 cnt=1,通知里会告诉你最终条目数;再加 type=nodes 强制按节点解析。如果通知里写明「不支持的节点」,那是协议本身 QX 还不支持(例如部分传输方式的 VLESS、gRPC、mKCP)。
分流规则全都丢了?
检查是不是给规则资源勾了错误的类型:rule-set 想转成分流需要 dst=filter;如果是 module,那本身该走重写。另外 in= 写错关键词会把规则全筛掉,加 hide=0 可以把被筛掉的条目以注释形式留住,方便对照。
订阅更新后策略组名字变成 Minimax 了?
解析 Surge rule-set 时若规则本身没带策略,解析器会给一个默认策略组名 Minimax。想用别的名字,加 policy=你的策略组。
参数里的 + & @ 老是出错?
这三个字符在 URL 里有特殊含义,写进参数前要编码:+ → %2B,空格 → %20,& → %26,@ → %40,, → %2C。中文关键词直接写没问题,但建议也一并编码。
能不能只转某个机场的部分节点?
可以。用 in=香港+台湾 按名字保留,或 regex=iplc 按线路特征保留,再配合 rename= 统一改名。sort=1 可以让节点按名字排好。
关于
这是一个长期维护的个人项目。
来源
由 KOP-XIAO 的资源解析器改写而来,功能保持一致;注释、链接、默认策略名都已换成本项目自己的。内嵌的 Base64 与 YAML 实现保留上游许可声明。
反馈
解析结果不对,去 GitHub 提 issue,附上订阅类型、链接参数和通知里的报错内容即可,不要贴带 token 的完整订阅地址。
资源解析器