Home

SubConverter-Extended 用户手册

SubConverter-Extended 是基于 subconverter 深度演进的多目标订阅转换后端。项目针对 Mihomo 提供专用解析桥和 Proxy Provider 优化，同时支持 Surge、Quantumult X、Loon、Surfboard、Stash、Sing-box 以及多种传统订阅输出。

本 Wiki 面向直接使用公共实例的用户、自行部署者和需要排查转换问题的维护人员。页面默认描述当前稳定版 master；开发分支中尚未发布的能力不会写成稳定功能。

Tip

第一次使用时，从快速开始进入。准备自行部署时，优先阅读 Docker 部署。不确定客户端应选择哪个 target 时，查看客户端与目标格式。

按任务开始

需要完成的任务	从这里开始
使用公共实例生成第一个配置	快速开始
判断客户端和目标格式	客户端与目标格式
使用 Docker 长期运行	Docker 部署
部署到 Linux、Windows 或 OpenWrt	原生部署
理解 /sub 请求	基本转换
调整 Provider 名称、间隔、请求头或下载方式	特色参数与扩展语法
使用外部模板或自定义规则	外部配置与模板 · 规则与规则集
配置公网安全、TLS 或出站代理	安全与隐私 · 反向代理与公网部署 · 出站代理
查看诊断报告或运行统计	请求诊断 · Dashboard 与统计
处理转换失败或节点不可用	故障排查
查找全部请求参数	API 参考

项目怎样处理输入

flowchart TD
    A["订阅链接或节点链接"] --> B{"目标格式"}
    B -->|"Clash / ClashR"| C["Mihomo Proxy Provider 或 Mihomo 节点解析"]
    B -->|"Surge / QuanX / Loon / Surfboard / Stash"| D["客户端原生远程资源或 Legacy 节点解析"]
    B -->|"其他目标"| E["后端下载、解析并生成目标格式"]
    C --> F["客户端加载配置"]
    D --> F
    E --> F

Loading

远程订阅是否由后端下载，不能只看输入是不是 HTTP URL。它还取决于目标格式、list 等请求参数和输入是否能够作为客户端原生远程资源表达。详细规则见远程订阅与客户端拉取。

三个重要边界

1. Mihomo 是重点增强方向，但项目不是 Mihomo 专用后端。 只有 clash、clashr 节点链接进入 Mihomo 解析桥，其他目标使用相应的远程资源或 Legacy 转换路径。
2. 公共实例不等于私密存储空间。 Provider 模式可以避免后端下载订阅正文，但请求仍可能携带订阅 URL。敏感订阅建议自行部署。
3. 生成成功不等于客户端一定能够连接。 DNS、客户端版本、订阅可访问性、节点有效性和网络环境都可能影响最终结果。

服务检查

公共稳定实例：

• 版本页：https://api.asailor.org/version
• 请求诊断台：https://api.asailor.org/inspect
• 源代码：https://github.com/Aethersailor/SubConverter-Extended
• 最新 Release：https://github.com/Aethersailor/SubConverter-Extended/releases/latest

自行部署后，将域名替换为实际地址：

http://localhost:25500/version
http://localhost:25500/healthz

/healthz 只表示 HTTP 进程能够响应。判断转换功能时，还需要执行真实 /sub 请求并检查输出。

文档约定

• https://example.com/sub、域名、令牌和节点均为占位符。
• 查询参数示例需要按实际使用入口完成 URL 编码。
• 配置项、环境变量、参数名和命令保持原始大小写。
• 闭源客户端的“支持”表示服务端能够生成相应格式，不代表项目已经完成所有客户端版本的真机连通测试。

下一步：快速开始