订阅转换节点筛选:按地区、协议和关键词保留节点
简答:节点上百个、名称中英混杂,一筛就空?先备份原始订阅,再用一个地区关键词测试,确认数量后逐步加入排除项。完整流程是:写规则、做 URL 编码、生成配置、导入客户端、验证连接。
定义:订阅转换节点筛选,是在生成客户端配置前或导入后,按节点名称、协议类型等字段保留或排除部分节点的过程。
30 秒速查卡:先复制规则,再逐条增加条件
订阅节点很多时,不要一开始就写复杂表达式。先单独测试地区关键词,确认有结果后,再加入排除项。以下规则主要匹配节点名称;名称里没有对应文字时,规则不会凭空识别真实地区或协议。
| 目标 | 包含规则 | 排除规则 | 适用说明 |
|---|---|---|---|
| 香港、日本、新加坡 | 香港|Hong Kong|HK|🇭🇰|日本|Japan|JP|🇯🇵|新加坡|Singapore|SG|🇸🇬 | 留空 | 按你的节点命名删减同义词 |
| 只保留日本 | 日本|Japan|JP|🇯🇵 | 留空 | 短缩写可能误匹配,优先保留完整名称或旗帜 |
| 保留香港并排除测试节点 | 香港|Hong Kong|HK|🇭🇰 | 测试|Test|Trial | 包含与排除分开填写,便于定位问题 |
| 排除倍率或倍数标记 | 留空 | 倍率|[xX×]\s*\d|\d(\.\d+)?\s*[xX×倍] | 可能匹配 2x、×2、0.5倍等写法,需按实际名称测试 |
| 排除说明或状态节点 | 留空 | 到期|剩余流量|官网|产品|说明|维护 | 只能清理名称,不能证明节点不可用 |
| 匹配协议名称 | Hysteria2|HY2|TUIC|VLESS|VMess | 留空 | 只有协议写在节点名称中时才可能匹配 |
在正则中,| 表示“或”,括号用于分组,反斜杠用于转义特殊字符。MDN 对分组、字符类和转义有语法说明,可先用普通文字规则测试,再逐步加入特殊符号。查看 MDN 正则分组与组合写法
订阅转换与节点筛选有什么区别?先选正确入口
订阅转换主要负责把原始订阅转换成目标客户端能够读取的格式;节点筛选则负责减少输出节点或导入后的节点集合。两者可以组合,但不要把“节点显示出来”当成“节点一定能连接”。
| 场景 | 推荐入口 | 匹配单位 | 默认值 | 限制 |
|---|---|---|---|---|
| 按地区或名称筛选 | 转换器的 include / exclude 参数 | 节点备注或名称 | 不筛选 | 名称不统一时可能漏掉节点 |
| mihomo 节点提供器名称筛选 | filter / exclude-filter | 节点关键词或正则 | 不筛选 | 多个正则的分隔方式要按文档配置 |
| mihomo 按协议类型排除 | exclude-type | 配置中的代理类型字段 | 不排除 | 不支持正则,使用 | 分隔类型 |
| sing-box 自动选择 | urltest 出站组 | 已导入的出站标签 | 需核实 | 负责测试和选择,不替代订阅格式转换 |
| Surge、Shadowrocket 等客户端 | 当前版本的订阅或策略组入口 | 通常是节点名称或策略组 | 需核实 | 不同版本入口和字段可能不同 |
subconverter 源码中把 URL 参数 include 和 exclude 读取为筛选条件,并对多个正则表达式进行校验;mihomo 文档则分别定义了名称过滤、排除过滤和按代理类型排除。查看 subconverter 参数处理源码 查看 mihomo proxy-providers 文档
第 1 步:保护原始订阅,并决定是否需要转换
原始订阅链接可能包含访问凭据。先把它保存在本地,不要粘贴到公开仓库、截图或不熟悉的在线页面。若客户端已经能直接识别原始格式,优先直接导入;只有在格式不兼容、需要筛选、重命名或生成特定配置时,再使用转换服务。
- 直接导入:客户端支持原始订阅格式,且你不需要筛选。
- 转换后导入:客户端不识别原格式,或需要加入地区、名称、协议等筛选条件。
- 本地或自建:需要长期处理包含敏感凭据的订阅时,优先评估本地转换或自建部署。
在线转换时,至少确认输入链接、生成链接和访问凭据不会被公开保存或分享。无法确认服务端处理方式时,不要把长期有效的原始订阅直接交给陌生页面。
第 2 步:填写包含规则、排除规则并进行 URL 编码
转换链接里的 |、中文、旗帜 Emoji、括号和反斜杠不能总是直接原样放入 URL。建议先对每个参数值做 URL 编码,再拼接生成链接。浏览器 JavaScript 可使用 encodeURIComponent() 对参数值编码。查看 MDN encodeURIComponent 说明
下面是一个使用占位符的完整示例,域名、路径和真实订阅凭据均为示意,不能直接当作可用服务地址:
https://converter.example.invalid/sub?url=https%3A%2F%2Fsub.example.invalid%2Fraw%2Fdemo-token&target=clash&include=HK%7CJP%7CSG&exclude=Test%7CTrial%7C%5BxX%C3%97%5D%5Cs%2A%5Cd其中,url 是占位的原始订阅地址,target 是示意性的目标格式,include 用于保留匹配节点,exclude 用于排除匹配节点。不同转换器的路径、目标格式名称和参数支持可能不同,生成前应以当前部署的接口说明为准。
如果你要传入中文或旗帜 Emoji,先在本地编码,再粘贴到链接中。遇到筛选为空时,第一步就是检查浏览器地址栏里的参数是否仍保留了未编码的中文、空格、竖线或反斜杠。
第 3 步:按地区、线路和协议逐层筛选
推荐采用“一个条件一轮”的顺序,不要一次写入地区、协议、倍率、流媒体和状态等全部条件。
- 先输入一个完整地区词,例如
Japan或日本。 - 生成配置,记录筛选前后的节点数量。
- 再加入同义词,例如
日本|Japan|JP|🇯🇵。 - 最后加入排除项,例如
Test|Trial|维护。 - 确认结果后,再考虑倍率、线路或用途关键词。
短缩写可能误匹配。例如 HK|JP|SG 会在名称中出现这些字母时命中,不一定代表节点属于对应地区。若名称格式稳定,可以使用更明确的词组;若名称中包含旗帜 Emoji,则把旗帜作为独立候选项加入。
如果使用 mihomo 的 proxy-providers,名称筛选可以写成:
filter: "(?i)香港|hk|hong kong|🇭🇰"
exclude-filter: "测试|trial|维护"
exclude-type: "vmess|tuic"mihomo 文档说明,filter 与 exclude-filter 可以匹配关键词或正则,多个正则使用反引号分隔;exclude-type 按配置中的代理类型排除,使用竖线分隔且不支持正则。查看 mihomo 过滤字段和示例
因此,exclude-type: "vmess|tuic" 表示按代理类型排除 VMess 和 TUIC,不能写成依赖复杂正则的协议表达式。若协议只出现在节点名称里,应使用名称规则,但这不能证明配置字段的真实协议类型。
第 4 步:按目标客户端导入,并区分筛选与自动选路
筛选完成后,目标格式必须和客户端能够解析的格式一致。导入时检查三件事:配置是否能打开、节点数量是否符合预期、节点是否能完成实际连接。
| 客户端或核心 | 适合的筛选位置 | 导入前检查 | 导入后验证 |
|---|---|---|---|
| mihomo 系客户端 | 转换器筛选,或 proxy-provider 的过滤字段 | YAML 层级、provider 类型、节点名称 | 查看 provider 列表、节点数量和延迟测试 |
| sing-box | 转换器输出后导入;用出站组管理节点 | JSON 结构、出站标签、协议字段 | 确认出站组成员和实际连接 |
| Surge、Shadowrocket | 当前版本的订阅或策略组入口 | 目标配置格式、协议支持和策略组引用 | 刷新后核对节点数量,再测试连接 |
sing-box 的 urltest 需要一个待测试的出站标签列表,并根据测试地址、间隔和容差选择出站。它解决的是已导入节点的测试与选择,不等同于订阅转换或名称筛选。查看 sing-box URLTest 文档
如果使用 mihomo API 排查,可以查看 provider 内容和节点状态,把“筛选为空”“配置未更新”和“节点无法连接”分成不同问题处理。查看 mihomo API 文档
节点为空、数量骤减或连接失败:按顺序排查
- 删除排除规则:只保留一个普通地区词,判断是否是排除条件过宽。
- 检查 URL 编码:确认
|、中文、Emoji、括号和反斜杠已经编码。 - 检查实际命名:把原始节点名称复制出来,确认使用中文、英文、缩写还是旗帜。
- 检查正则特殊字符:先删除括号、方括号、反斜杠和数量表达式,只保留普通文字。
- 取消筛选重新生成:若无筛选也为空,问题可能在原始订阅、转换服务或访问权限。
- 对比格式:确认生成结果不是错误页面、登录页面或空文件。
- 区分显示与连接:节点能显示但不能连接时,检查协议字段、客户端支持、系统代理和 DNS。
DNS 可以先用系统或客户端的解析测试确认目标域名是否能解析;系统代理则检查客户端是否启用对应模式、浏览器是否使用系统代理,以及是否存在其他代理软件占用端口。若取消筛选后仍无法连接,再处理网络、DNS 或客户端兼容性,不要继续修改正则。
建议保留三份结果:未筛选配置、只按地区筛选的配置、加入排除项后的最终配置。这样能判断节点是被哪一条规则删掉,还是在转换前就没有成功获取。
安全使用建议:筛选不能证明线路稳定或订阅可信
节点名称中的“专线”“低倍率”“流媒体”等文字只是备注,不能单独证明延迟、丢包、线路类型或实际用途。筛选完成后,应在自己的网络环境中测试实际连接,并分别观察网页、长连接或需要特定协议的应用是否正常。
原始订阅链接应当按凭据处理:不公开分享、不放入公开仓库、不在截图中完整展示。若怀疑链接已经泄露,应优先在订阅提供方重新生成或更换链接,再更新本地配置。
对于长期使用场景,优先比较原生订阅、本地转换和自建转换的维护成本与凭据暴露范围;在线转换只在你能够接受其处理风险,并且确认参数、访问方式和更新流程后使用。
常见问题
订阅转换节点筛选和客户端筛选有什么区别?
订阅转换筛选发生在配置生成前,适合减少输出节点;客户端筛选发生在导入后,适合建立策略组或自动选择。先确认客户端支持的格式,再决定筛选位置。
为什么筛选后一个节点都没有?
先删除排除规则,只保留一个普通地区词;然后检查节点实际名称、URL 编码和正则特殊字符。若无筛选也为空,应检查原始订阅和转换结果。
HK、JP、SG 这些短缩写会误匹配吗?
可能会。它们可能出现在其他单词或自定义名称中。优先使用完整地区名、英文名或旗帜 Emoji,并先复制原始节点名称核对。
能不能用名称筛选 Hysteria2 或 TUIC?
可以尝试匹配名称中的 Hysteria2、HY2 或 TUIC,但这只说明名称包含关键词,不能证明配置字段真实使用该协议。按协议类型排除时,可在 mihomo 的 provider 中使用 exclude-type。
为什么节点能显示但连接失败?
先取消筛选导入原始配置,确认原始节点是否能连接;再检查协议字段是否保留、客户端是否支持、系统代理是否启用,以及目标域名是否能正常解析。
在线订阅转换安全吗?
订阅链接可能包含访问凭据。优先考虑原生订阅、本地转换或自建转换;使用在线服务时不要公开原始链接,怀疑泄露后及时更换订阅地址。