Skip to content

Home

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

📘 SubConverter-Extended 用户手册

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

Important

Mihomo 相关需求是项目的首要优化方向，相关解析、Provider 和协议参数支持会优先完善。对其他客户端的支持也会持续优化，并在各自格式能力范围内尽量提供完整、可靠的转换结果。

本 Wiki 面向直接使用公共实例的用户、自行部署者和需要排查转换问题的维护人员，内容适用于当前正式 Release。Docker 默认使用与最新正式 Release 对应的 latest。

Note

本轮文档已按正式 Release v1.7.1、源代码修订 9c977e4e69b932d458ca82b105fe1e2babf50208 核对（核对日期：2026-08-24）。安装时仍应从最新 Release 获取当前版本，并使用 /version 确认实际运行修订。

🎯 长期愿景

项目的长期目标，是让用户只需维护自己的订阅转换模板，或直接选用公共模板，再附加自己的代理信息（订阅链接或节点链接），即可生成适用于不同客户端的配置文件。

这一目标尚未完全实现。当前不同客户端在配置结构、远程资源表达、协议字段和模板能力方面仍有差异，部分场景仍需按客户端分别配置与处理。当前可用范围见客户端与目标格式。

Tip

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

🧭 按任务开始

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

🔗 与相关项目的关系

项目 主要用途 关系边界
Custom_OpenClash_Rules 提供 OpenClash 模板、规则和使用教程 可作为转换模板和规则来源，也可直接供 OpenClash 使用。
SubConverter-Extended 生成目标客户端配置 不收集 Mihomo MATCH 域名，也不供应订阅或节点。
Rule-Bot Client 从 Mihomo MATCH 连接中收集域名，默认保存在本地，可选发送 用于持续发现可能需要补充的规则，不是转换依赖。
Rule-Bot 检查域名并按策略提交到目标规则仓库 项目公共实例写入 Custom_OpenClash_Rules；自建服务可维护其他仓库。

模板转换流程通常是「Custom_OpenClash_Rules → 可选的 SubConverter-Extended 转换 → Mihomo/OpenClash」。规则反馈是另一条可选流程：「Mihomo MATCH → Rule-Bot Client → Rule-Bot → 目标规则仓库」。两条流程相互独立，无需成套部署。

🔀 项目怎样处理输入

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

远程订阅的下载方由目标格式、list 等请求参数，以及客户端能否表示原生远程资源共同决定。详细规则见远程订阅与客户端拉取。

⚠️ 三个重要边界

  1. 不同目标采用不同的转换路径。 clash、clashr 节点链接进入 Mihomo 解析桥；其他目标使用客户端原生远程资源、对应生成器或兼容解析器。
  2. 订阅 URL 仍可能经过公共基础设施。 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