SubConverter订阅转换配置使用指南

本文详解SubConverter工具的核心用法,包括配置文件编写、参数调优、批量转换等实操步骤，帮助用户快速实现多协议订阅的灵活转换与高效管理。

什么是SubConverter

SubConverter是一款开源的订阅转换工具,支持将不同格式的节点链接转换为Clash YAML格式，它解决了多协议节点统一管理的痛点，用户只需维护一份配置即可适配各种客户端。

核心功能

• 支持SS、VMess、VLESS、Trojan等协议转换
• 自定义代理组策略配置
• 规则集自动更新
• 批量转换多个订阅源

安装与环境准备

SubConverter提供多平台二进制文件,下载方式如下：

# Linux/macOS
wget https://github.com/tindy2013/subconverter/releases/download/2024.12.01/subconverter_linux_amd64.tar.gz
tar -zxf subconverter_linux_amd64.tar.gz
# Windows
# 访问GitHub Release页面下载exe文件

建议将可执行文件移入系统PATH目录,方便后续调用。

配置文件编写

SubConverter通过config.yaml文件控制转换行为：

# 基础配置
target: clash
# 输出格式：clash、surge、quanx、v2ray
# 订阅源
surge:
  - https://example.com/api/v1/client/subscribe?token=xxx
# 代理组配置
proxy_groups:
  - name: 手动选择
    type: select
    proxies:
      - DIRECT
  - name: 自动测速
    type: url-test
    url: http://www.gstatic.com/generate_204
    interval: 300
    tolerance: 50

代理组类型选择

进阶：规则分流配置

在配置文件中添加rules字段实现精细化分流：

rules:
  - DOMAIN-SUFFIX,google.com,自动测速
  - DOMAIN-KEYWORD,netflix,手动选择
  - IP-CIDR,10.0.0.0/8,DIRECT
  - GEOIP,CN,DIRECT
  - MATCH,手动选择

规则优先级

1. DOMAIN（精确域名）> DOMAIN-SUFFIX（域名后缀）> DOMAIN-KEYWORD
2. IP-CIDR（IP段）> GEOIP（国家/地区）
3. MATCH（兜底规则）

./subconverter -i config.yaml -o output.yaml

0 6 * * * /path/to/subconverter -i /path/to/config.yaml -o /path/to/clash.yaml