本文详解Sub-Converter自建环境搭建与配置方法，通过Docker或二进制方式部署转换服务，实现Clash、Surge、Quantumult X等主流客户端的节点格式互通，并提供YAML配置示例与常见问题解决方案。
什么是Sub-Converter
Sub-Converter是一款开源的节点格式转换工具，支持将不同协议的订阅链接转换为统一格式，它能够处理Clash、Surge、Quantumult X、v2rayN等多种客户端的配置格式，是自建节点管理系统的核心组件，通过Sub-Converter，用户可以将机场提供的单一订阅链接转换为适配多个客户端的配置文件,避免重复配置。
自建环境准备
服务器要求
Sub-Converter对硬件要求极低，1核CPU、512MB内存即可流畅运行，支持Linux（推荐Ubuntu 20.04+）、Docker环境部署，部分服务商会提供一键部署脚本,适合新手快速上手。
Docker部署方式
docker pull tangyuxian/subconverter:latest docker run -d -p 8080:8080 -v /root/subconverter:/app/subconverter tangyuxian/subconverter:latest
部署完成后，通过http://IP:8080访问管理界面。
核心配置文件详解
基础转换配置
创建config.yaml配置文件：
target: clash target_url: https://example.com/api/v1/client/subscribe?token=xxx include_all: true exclude_remarks: (流量|官网|广告) rename: "新节点名称"
代理组类型选择
Clash配置中的代理组类型决定节点选择策略：
- select：手动选择节点，适合需要指定出口的场景
- url-test：自动测速选择延迟最低节点，适合日常上网
- fallback：主节点故障时自动切换备用节点，保障连接稳定性
proxies:
- name: "香港-01"
type: ss
server: hk.example.com
port: 8388
cipher: aes-256-gcm
password: xxxxxx
proxy-groups:
- name: "自动选择"
type: url-test
proxies:
- "香港-01"
- "日本-01"
url: http://www.gstatic.com/generate_204
interval: 300
分流规则写法
规则按优先级从上到下匹配,常用规则类型包括：
- DOMAIN：精确域名匹配
- DOMAIN-SUFFIX：域名后缀匹配
- IP-CIDR：IP段匹配
- GEOIP：国家/地区IP库
rules: - DOMAIN-SUFFIX,google.com,自动选择 - DOMAIN-KEYWORD,netflix,视频线路 - IP-CIDR,10.0.0.0/8,DIRECT - GEOIP,CN,DIRECT - MATCH,全球加速
TUN模式与系统代理区别
系统代理模式
仅处理HTTP/HTTPS流量，兼容性最好，但无法代理游戏、UDP视频等非HTTP协议，适合浏览器上网、办公软件等场景。
TUN模式
通过虚拟网卡接管全部流量，包括UDP和游戏数据，适合需要全协议代理的用户，但可能影响本地网络连接稳定性,部分客户端需手动开启TUN功能。
常见问题FAQ
转换后节点无法连接
现象：订阅转换成功但节点显示超时
原因：节点已失效或机场服务器宕机
解决方法：更换机场订阅链接或等待服务商修复
代理组不生效
现象：手动切换节点后仍然使用原节点
原因：规则匹配顺序错误或节点名称不匹配
解决方法：检查proxy-groups中proxies列表是否包含实际节点名称
规则更新后配置失效
现象：修改规则文件后客户端显示旧配置
原因：本地缓存未刷新或订阅链接未更新
解决方法：强制刷新订阅或清除客户端缓存
客户端配置建议
不同设备选择对应客户端以获得最佳体验：Windows推荐Clash Verge Rev，Mac使用ClashX，iOS可选Shadowrocket或Quantumult X，OpenWrt路由器推荐OpenClash插件，部分设备需手动下载APK安装包，华为/鸿蒙系统用户建议从官方渠道获取安装文件。
节点选择建议
根据使用场景选择合适的节点类型：4K视频需要高带宽支持，流媒体解锁需选择专门的解封节点，在线游戏对延迟要求极高，跨境办公则需要稳定可靠的线路，判断节点服务商是否靠谱可参考其提供测试节点、售后服务响应速度、线路稳定性等因素，建议优先选择提供流量明细和在线客服的服务商,避免使用无法验证的免费节点。
