Skip to content

Support and License

Aethersailor edited this page Aug 23, 2026 · 5 revisions

🤝 上游关系、支持与许可证

项目来源

SubConverter-Extended 基于 asdlokj1qpi233/subconverter 深度演进。项目继续保留常见 subconverter 请求接口、外部配置和多种传统输出,同时增加多客户端远程资源、Mihomo 解析桥、安全、诊断、统计和多平台交付。

与上游的关系

本项目不是简单替换名称的镜像,也不承诺逐提交自动合并上游。上游变更需要结合当前解析器、生成器、安全和兼容性边界评估后选择性吸收。

仍然兼容的上游概念包括:

  • /sub 基本接口;
  • 多输入合并、筛选、重命名和外部配置;
  • 传统客户端目标和简单订阅;
  • 规则集、模板、别名和可选上传。

本项目扩展包括但不限于:

  • Clash/ClashR Mihomo 解析桥和 Provider;
  • Surge、QuanX、Loon、Surfboard、Stash 客户端原生远程资源;
  • Stash、Shadowrocket、v2rayN/v2rayNG 等独立目标能力;
  • explain=true/inspectX-Request-ID
  • Dashboard、统计和认证限制;
  • lanpublicstrict
  • 明确出站代理和 bypass 策略;
  • ruleprependruleappendno-resolve
  • 多架构镜像、便携包和 OpenWrt APK。

🎯 维护重点

项目优先完善 Mihomo 用户需要的能力。clashclashr 的节点解析、Proxy Provider 和协议参数支持是首要优化方向。

Surge、Quantumult、Quantumult X、Loon、Surfboard、Stash、Sing-box 及传统订阅格式同样会持续维护和优化,并在各自格式能力范围内尽量提供完整、可靠的转换结果。实际支持仍以当前正式 Release 的文档、源代码和可验证行为为准;闭源客户端的最终导入与连通性需要在对应版本中确认。

支持边界

项目可以验证:

  • 请求路由和参数;
  • 输入解析和目标生成;
  • 配置语法和稳定回归样例;
  • Docker/便携包/APK 的构建与基本冒烟;
  • 公开实例的服务端行为。

项目不能单独保证:

  • 第三方订阅长期可访问;
  • 节点真实连通;
  • 所有闭源客户端版本的导入和连接;
  • 用户网络、DNS、运营商、WAF 或 CDN 行为;
  • 用户自定义模板、脚本和规则的正确性;
  • 未经验证的设备架构和第三方打包。

正式版本

正式 Release 是面向用户的发布版本。Docker latest 在正式 Release 完成验证后更新,并指向该 Release 的版本镜像。

交付形式 版本来源 用途
Docker latest 最新正式 Release 默认安装和更新
Docker vX.Y.Z 对应正式 Release 固定版本和回滚
便携包与 OpenWrt APK 对应正式 Release 原生部署与完整性校验

提交问题时,请提供 /version 显示的版本和源代码修订。

获取支持

先按问题类型选择入口:

问题类型 入口
转换、配置、部署或兼容性缺陷 Bug 反馈
功能建议或用户文档改进 功能建议
未修复的安全漏洞 GitHub 私密漏洞报告

第三方公共实例的运行、WAF、频率限制或版本滞后问题,应先联系对应服务提供者。官方公共实例或项目本身的可复现行为,可使用上述 Bug 表单。在公共实例复现不是提交 Issue 的必要条件;不要为了复现而向公共服务发送敏感订阅。

提交公开 Issue 前:

  1. 阅读故障排查常见问题
  2. 使用 explain=true 构造脱敏诊断。
  3. 确认问题可以在当前正式 Release 复现。
  4. 记录 /version 中的版本和源代码修订,以及部署方式、客户端、target、HTTP 状态码和 X-Request-ID
  5. 删除订阅 URL、节点凭据、Token、Cookie、密码和私有主机名。
  6. 提供最小公开复现输入,并在粘贴 explain 或日志前再次人工检查。

仓库:https://github.com/Aethersailor/SubConverter-Extended

许可证

SubConverter-Extended 按 GNU General Public License v3.0 发布。

Mihomo 解析桥使用的 MetaCubeX/mihomo 依赖同样遵循 GPL-3.0。具体模块版本以仓库 bridge/go.mod 为准。

使用、修改或分发时,需要遵守仓库许可证及所有第三方依赖许可证。项目名称、文档和公开服务不授予第三方订阅、节点或规则内容的再分发权利。

合规说明

本项目保持中立,不提供订阅服务、代理节点或规避监管制度的功能。项目用于计算机技术学习和合法场景中的配置转换。使用者需要遵守所在地法律法规、网络服务条款和数据保护要求。

致谢

Clone this wiki locally