subconverter

subconverter 是一款开源的代理订阅转换工具，用于解析订阅内容并生成不同代理客户端能够识别的配置格式。

概述

不同网络代理客户端使用的配置结构、节点字段和规则语法并不完全相同，同一订阅通常无法直接用于所有客户端。subconverter 通过统一解析节点信息，再按照目标客户端的格式输出配置，减少手动修改配置文件的工作。

该项目主要作为后端服务运行，可通过接口接收订阅地址、目标格式和配置参数。用户也可搭配第三方网页前端填写参数，但前端页面通常不是 subconverter 本体。它只负责转换和整理配置，不提供代理节点或网络线路。

核心功能

• 订阅格式转换：支持在多种常见代理客户端格式之间转换节点与配置。
• 规则与策略组处理：可结合外部配置模板生成策略组，并整理分流规则。
• 节点筛选：可按照名称等条件包含、排除或重命名节点，便于管理较大的订阅列表。
• 接口化调用：适合自行部署，也可供网页前端、脚本或其他服务调用。
• 开源与跨平台：源代码公开，可在常见服务器及个人计算机环境中运行。

使用与安全注意事项

订阅链接可能包含访问凭证，使用公开转换网站时，链接及节点信息可能被服务运营者获取。处理敏感订阅时，宜自行部署 subconverter，或选择可信服务，并避免随意公开生成后的配置。转换结果仍需与具体客户端版本及配置模板兼容。

常见问题

问：subconverter 是代理客户端吗？答：不是。它是订阅与配置转换后端，不能替代 Clash、Surge 等实际运行代理连接的客户端。

问：subconverter 会提供可用节点吗？答：不会。用户需要自行准备合法获得的订阅或节点信息，它只负责解析、筛选和转换。

问：为什么转换后配置无法使用？答：常见原因包括订阅失效、目标格式选择错误、模板不兼容、规则地址不可访问，或客户端不支持配置中的部分字段。