资源解析器
Quantumult X 自定义资源解析器

让 QX 读懂别家的订阅
节点、分流、重写一次转好

V2RayN、Clash、Surge、Loon、Shadowrocket、SIP008、Hysteria2 的订阅与规则,交给它统一翻译成 Quantumult X 的写法。转换规则可以按关键词筛、按正则改、按策略组分配,全都写在链接的参数里。

resource_parser_url = https://qx.tatalvpai.vip/Scripts/resource-parser.js
查看脚本 GitHub 仓库

安装

三步装好,之后所有资源引用都能用上解析器。

1

写进配置文件

在 QX 配置的 [general] 段落里加一行 resource_parser_url = …,地址见上方复制按钮。

2

勾上「使用解析器」

进「资源引用」,编辑要用的节点订阅、分流、重写,把「使用解析器」打开。

3

刷新资源

下拉刷新引用;若提示「没有自定义解析器」,长按首页右下角图标点左侧刷新,再彻底退出 App 重进。

带参数怎么用
// 参数跟在订阅地址的 # 后面,多个用 & 连接
https://你的订阅地址#emoji=1&udp=1&in=香港+台湾&rename=旧名@新名

// 本地 / iCloud 里的规则文件同样支持(build 951 起),路径上的参数优先
// 特殊字符先 URL-Encode:+ → %2B,空格 → %20,@ → %40,& → %26,, → %2C

支持的格式

节点、规则、重写三类输入,自动识别类型,也可用 type= 强制指定。

节点 V2RayN 节点 Shadowsocks / SSR 节点 ShadowsocksD / SSD 节点 VMess / VLESS(含 REALITY) 节点 Trojan 节点 Hysteria2 节点 AnyTLS 节点 HTTP(S) / SOCKS 节点 Quantumult / Quantumult X 节点 Surge 节点 Clash 节点 Shadowrocket 节点 Loon 节点 SIP008 规则 QX filter 规则 Surge rule-set 规则 Clash rule-provider 规则 domain-set 规则 JSON 规则集 重写 QX rewrite 重写 Surge module 重写 url-regex 重写 Map Local 重写 json-jq 重写 Loon plugin

参数速查

全部参数都在这里,输入关键词可以过滤。

一 · 节点订阅参数
参数作用
emoji=1 / -1 / 2节点名加或去地区旗帜,国行设备用 2
udp=1 / -1批量开或关 udp-relay
tfo=1 / -1批量开或关 fast-open
uot=1SS(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/20、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 的完整订阅地址。

已复制