SubConverter使用教程，不同订阅格式一键转换

SubConverter是一款开源订阅转换工具,支持将SS、VMess、Trojan等协议格式转换为Clash YAML配置，解决多协议节点统一管理难题，本文详解安装配置、转换规则及常见问题。

SubConverter核心功能与适用场景

SubConverter（简称SubC）主要解决节点订阅格式不统一的问题，机场提供的订阅链接可能是Base64编码、JSON或纯文本，而Clash客户端仅支持YAML格式，通过SubConverter可实现：

• 多协议统一转换为Clash格式
• 自定义代理组策略（Select/URL-Test/Fallback）
• 过滤低质量节点,保留高带宽线路
• 自动生成带本地配置的订阅链接

跨境办公、学术资源访问、国际网络加速等场景均可使用。

Windows/Mac/Linux安装配置

下载与安装

访问GitHub Release页面下载对应系统版本：

# Linux/macOS终端运行
chmod +x subconverter
./subconverter -h

Windows用户双击subconverter.exe即可。

配置文件结构

创建config.yaml基础配置：

# 基础设置
target: clash
# 输出文件
output: ./proxies.yaml
# 代理组策略
proxy_groups:
  - name: 手动选择
    type: select
    proxies:
      - 自动选择
      - 香港节点
      - 日本节点
  - name: 自动选择
    type: url-test
    url: http://www.gstatic.com/generate_204
    interval: 300

核心概念：代理组类型详解

Select（手动选择）

适合需要手动切换节点的用户：

- name: 手动选择
  type: select
  proxies:
    - 香港-01
    - 日本-01
    - 美国-01

URL-Test（自动测速）

自动选择延迟最低的节点：

- name: 自动选择
  type: url-test
  url: http://www.gstatic.com/generate_204
  interval: 300  # 每5分钟测速一次
  tolerance: 50  # 延迟差距小于50ms不切换

Fallback（故障转移）

主节点不可用时自动切换备用节点：

- name: 备用线路
  type: fallback
  url: http://www.gstatic.com/generate_204
  interval: 300
  proxies:
    - 香港-01
    - 香港-02

分流规则写法与优先级

规则类型

类型	写法	适用场景
DOMAIN	DOMAIN,google.com	精确域名
DOMAIN-SUFFIX	DOMAIN-SUFFIX,youtube.com	域名后缀匹配
IP-CIDR	IP-CIDR,10.0.0.0/8	IP段匹配
GEOIP	GEOIP,CN	国家/地区匹配

规则优先级

Clash规则自上而下匹配，命中即停止，建议顺序：

1. 代理规则（REJECT/DIRECT）
2. 域名分流（国内直连，国际代理）
3. IP段分流
4. 兜底策略（FINAL）

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

TUN模式与系统代理区别

特性	TUN模式	系统代理
流量接管	所有TCP/UDP流量	仅HTTP/HTTPS
游戏加速	支持	不支持
性能消耗	略高	较低
兼容性	需要TUN网卡驱动	少数应用不兼容

玩国际服游戏、UDP需求场景建议开启TUN模式；普通网页浏览系统代理足够。

常见问题FAQ

现象：转换后节点显示但无法连接

原因：机场订阅包含不支持的协议（如WireGuard）

解决方法：在配置中添加exclude_protocol: true过滤，或手动删除不支持的节点

现象：代理组显示为空

原因：机场订阅未包含对应节点，或节点名称不匹配

解决方法：使用./subconverter -i input.yaml -o output.yaml --debug查看详细日志

现象：测速URL无法访问

原因：目标测速网站被墙或国内无法访问

解决方法：更换为国内可访问的测速URL（如http://www.baidu.com）

节点选择建议

不同使用场景对节点要求不同：

• 4K视频：选择高带宽线路，带宽≥100Mbps
• 游戏加速：选择低延迟节点，延迟≤80ms
• 跨境办公：优先稳定性，丢包率＜1%

判断节点服务商靠不靠谱,看三点：是否提供测速页面、是否有客服响应、线路是否长期稳定，避免选择超低价且无保障的渠道。