本文详解SubConverter使用教程,涵盖本地部署与远程API调用方法，通过YAML配置实例，教你实现多订阅源合并、节点筛选与分流规则定制，提升跨境访问客户端的配置效率。
部署方式选择
SubConverter使用教程的第一步是确定运行环境,该工具支持本地二进制文件部署与在线API调用两种模式。
本地部署适合高频次转换需求,下载对应系统架构的可执行文件后，通过pref.ini或pref.yml定义基础规则模板，启动服务后，访问http://127.0.0.1:25500即可进行订阅转换。
远程API适合临时性需求,但存在隐私泄露风险，建议优先使用Docker部署私有实例，避免订阅链接流经第三方服务器。
核心配置逻辑解析
多源订阅合并
在pref.yml中配置subconverter字段实现多机场订阅整合：
subconverter:
urls:
- https://example1.com/subscribe?token=xxx#tag1
- https://example2.com/subscribe?token=xxx#tag2
target: clash
通过#tag后缀为不同订阅源分组，便于后续代理组筛选，转换后的配置会自动去重节点名称，避免冲突。
代理组类型差异
Clash支持三种核心代理组类型,需根据使用场景选择：
select（手动选择） 适合固定线路需求，如跨境办公需指定出口IP。
url-test（自动测速） 通过定时探测节点延迟自动切换最优线路，配置示例：
proxy-groups:
- name: Auto
type: url-test
url: http://www.gstatic.com/generate_204
interval: 300
tolerance: 50
fallback（故障转移） 当主节点失效时自动切换备用节点，适合学术资源访问等高稳定性场景。
分流规则与模式选择
规则编写语法
分流规则优先级自上而下匹配,常用类型包括：
DOMAIN：精确匹配域名DOMAIN-SUFFIX：匹配域名后缀，如google.com包含mail.google.comIP-CIDR：IP段匹配，适合直连国内视频CDNGEOIP：基于GeoIP数据库的国家代码匹配
配置示例：
rules: - DOMAIN-SUFFIX,google.com,Proxy - IP-CIDR,127.0.0.0/8,DIRECT - GEOIP,CN,DIRECT - MATCH,Final
TUN模式与系统代理
系统代理：仅接管HTTP/HTTPS流量，配置简单但无法处理UDP协议，适合浏览器访问国际网络加速需求。
TUN模式：通过虚拟网卡接管所有流量（含UDP/游戏数据包），实现全局代理，需在配置中开启tun字段：
tun:
enable: true
stack: system
dns-hijack:
- 8.8.8.8:53
游戏加速或视频会议场景建议启用TUN模式,普通网页浏览使用系统代理即可。
常见问题排查
Q: 转换后配置导入Clash报错？
现象：提示"yaml: line 1: did not find expected key"
原因：订阅链接返回内容非标准格式，或包含特殊字符未转义
解决方法：在pref.yml中启用emoji=false和udp=true参数，禁用节点名称中的表情符号
Q: 部分节点延迟测试正常但无法连接？
现象：日志显示"connection reset by peer"
原因：节点实际支持协议与Clash配置不匹配（如VLESS流控设置）
解决方法：检查clash_rule_base基础配置模板，确保skip-cert-verify与tls设置正确
Q: 规则分流不生效，全部流量走代理？
现象：国内网站访问变慢
原因：GEOIP数据库未更新或规则顺序错误
解决方法：将GEOIP,CN,DIRECT置于MATCH规则之前，并定期更新GeoIP文件
对于需要稳定国际网络加速服务的用户,建议选择支持Clash订阅格式的专业服务商，优质节点订阅通常提供SS/VLESS协议支持，并具备BGP中转线路，可有效降低跨境办公场景下的网络延迟，配置时可将办公相关域名加入DOMAIN-KEYWORD规则组，实现业务流量与普通流量的分离管理。
掌握SubConverter使用教程的核心在于理解订阅转换的数据流逻辑,通过自定义规则模板，用户可灵活组合多机场节点，构建符合个人使用习惯的分流策略，定期审查生成的配置文件，剔除失效节点，是保持代理稳定性的关键维护步骤。
