Skip to content

Home

Jump to bottom
Aethersailor edited this page Aug 15, 2026 · 10 revisions

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. 不同目标采用不同的转换路径。 clash、clashr 节点链接进入 Mihomo 解析桥；其他目标使用客户端原生远程资源、对应生成器或兼容解析器。
  2. 公共实例不等于私密存储空间。 Provider 模式可以避免后端下载订阅正文，但请求仍可能携带订阅 URL。敏感订阅建议自行部署。
  3. 生成成功不等于客户端一定能够连接。 DNS、客户端版本、订阅可访问性、节点有效性和网络环境都可能影响最终结果。

服务检查

公共稳定实例：

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

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

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

文档约定

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

下一步：快速开始

🏠 手册首页 · 🚀 快速开始 · 🔌 API 参考 · 🧯 故障排查 · 💬 获取支持 · 💻 GitHub 仓库

📘 SubConverter-Extended

🚀 开始使用

📦 部署与更新

🧩 参数与配置

🛡️ 安全、诊断与运维

📚 参考

Clone this wiki locally