Sub-Store 使用指南：怎么转换和管理订阅

更新于 2026-11-04 · xiaomitizi.top

简答：Sub-Store 是一个订阅管理与转换工具，适合把一个或多个远程订阅集中管理，再过滤、重命名、合并并输出为客户端可用格式。最快流程是：先连接后端，再添加单条订阅，按需创建组合订阅，配置处理规则，最后用通用链接或 target 参数导入客户端。

定义：Sub-Store 是用于统一管理、处理、合并、转换和托管订阅链接、节点及配置文件的工具，前端网页需要连接后端后才能执行实际处理。

先看功能怎么选：单条、组合、文件还是同步

如果你只是把一个订阅转换成客户端能读取的格式，使用“单条订阅”即可；如果要把多个订阅合并成一个链接，使用“组合订阅”；如果需要生成完整的 mihomo 或 sing-box 配置文件，使用“文件”；如果客户端经常拉取超时，或者希望后台定时生成一个稳定链接，再考虑“同步”。官方文档把这几类功能分开设计，初次使用不建议一开始就配置脚本。

官方定义可参考Sub-Store 快速开始、订阅概览、文件概览和同步概览。

第一步：选择部署方式并连接前端与后端

Sub-Store 由前端和后端组成：前端负责网页操作，后端负责拉取订阅、处理节点和生成输出。官方文档明确说明，打开前端后需要在“我的”页面设置后端地址，否则页面即使能打开，也不能完成订阅处理。

1. 代理 App 内置或模块：适合已经在使用支持模块或插件的移动端用户，安装对应配置后，用浏览器打开前端并连接该后端。
2. Docker 或服务器：适合希望长期运行、多个设备共用，或需要同步、定时处理等功能的用户。官方安装页列出了 Docker 自建方式，但镜像参数和高级功能要求应以当前镜像说明为准。
3. Android 模块或应用：适合在 Android 设备上运行。模块方式可能需要 root；普通应用的高级功能支持情况需要按官方安装说明核对。
4. 官方前端：官方文档列出可用的前端地址，但它只是前端，仍需搭配自定义后端。
5. NAS 或软路由：官方安装页没有单独列出这两类设备作为独立部署方式。若设备能运行 Docker，可按 Docker/服务器思路评估；具体架构、端口和权限需核实。

新手的最小可行路径是：先使用已有代理 App 的内置或模块方式完成一次流程；如果需要多设备长期使用，再迁移到 Docker 或其他持续运行的设备。安装选项和限制请以官方安装文档为准。

安全提醒：订阅链接通常包含可直接访问节点的凭据，不要把完整链接发到公开页面、截图或公共配置中。使用自建后端时，优先限制管理页面访问范围，并定期更换已经公开过的订阅链接。

第二步：添加单条订阅，再完成过滤和整理

进入前端的“订阅”页面，新建一条单条订阅。你需要准备服务提供方给出的远程订阅链接；如果手里是本地节点或订阅文本，也可以使用本地内容方式保存。名称和显示名称不要混用：官方文档说明，name主要用于内部引用、脚本和链接参数，displayName用于界面显示。

1. 点击“订阅”并新建单条订阅。
2. 填写内部名称，例如source-a，再填写显示名称，例如“办公线路”。如果当前版本字段名称不同，以页面实际显示为准。
3. 填入远程订阅链接，或改用本地节点/订阅内容。
4. 按需设置 User-Agent。部分订阅会根据 User-Agent 返回不同内容；如果不确定，先保持默认，不要随意开启 User-Agent 透传。
5. 先保存并刷新，确认能看到节点数量或订阅内容，再配置处理规则。
6. 按需添加过滤、重命名、排序、去重或脚本处理。处理规则建议一次只改一项，方便判断是哪条规则造成节点减少。

保存后通常会得到类似/download/<name>的通用输出路径。实际域名、端口和显示按钮会随部署方式变化，因此不要照抄别人的完整域名；应从你自己的前端复制输出链接。

如果添加后节点数量为零，先关闭过滤和重命名规则，直接测试原始订阅；如果原始订阅也无法拉取，再检查链接是否过期、后端是否能访问远程地址、User-Agent 是否正确，以及缓存是否仍是旧结果。

第三步：创建组合订阅，完成多订阅合并

这是很多新手最容易漏掉的一步。组合订阅不是重新填写多个远程链接，而是引用已经保存好的单条订阅。官方流程是：在“订阅”页面新建组合订阅，添加若干条单条订阅，保存后复制组合订阅输出链接。

1. 先确保每个远程来源都已经单独保存，并能分别刷新。
2. 新建一个组合订阅，填写组合订阅名称和显示名称。
3. 在来源列表中选择要合并的单条订阅，按需要调整添加顺序。
4. 先保存并查看合并结果，确认每个来源都出现节点。
5. 在组合订阅层面再添加整体过滤、重命名、排序或去重规则；单条订阅中已有的处理也可以保留。
6. 遇到某个远程来源失败时，先使用严格报错模式定位问题；确认其他来源正常后，再考虑开启“忽略失败的远程订阅”，避免一个来源异常导致整体无法输出。
7. 复制组合订阅的输出链接，选择通用链接或固定目标格式导入客户端。

组合订阅按添加顺序合并，且每条单独订阅仍可保留自己的处理操作。官方文档还提供了严格报错、跳过失败项、静默跳过等失败处理选项，具体字段可能因前端版本变化，建议优先使用界面上的开关，再通过日志定位异常。

如果客户端拉取组合订阅经常超时，可以减少来源数量、缩短单条订阅内容、适当调整超时，或使用同步功能生成后台处理后的链接。组合订阅的流程和失败处理可查看官方组合订阅文档。

第四步：选择输出格式并导入客户端

Sub-Store 提供通用链接，也允许使用target参数固定输出格式。通用链接会根据请求端的 User-Agent 判断格式；固定目标则更适合你明确知道客户端需要哪种格式的情况。

官方文档给出的通用路径是/download/<name>，也可以用类似/download/sub?target=Surge的形式固定目标；实际使用时，请将sub替换成你自己的订阅名称，并从前端复制完整地址。也可以使用多一级路径直接指定目标，例如/download/xxx/ClashMeta，但目标名称和客户端兼容性应以当前官方文档及客户端版本为准。

重要区别：固定 target 只是在输出层指定格式，不保证目标客户端支持订阅内的所有协议，也不保证服务端会按你的预期返回全部节点。官方文档还说明，遇到目标格式本身不支持的协议时，可按需使用includeUnsupportedProxy，但这可能导致客户端无法连接；因此建议先保留原始订阅，逐步启用该参数测试，而不是默认开启。

格式转换参数和支持目标请以官方订阅转换文档为准。

文件配置与同步配置：什么时候不要只用订阅链接

文件配置适合需要完整配置文件的场景，而不仅是节点列表。例如，mihomo 配置可以通过“文件”功能选择订阅或组合订阅，再配合覆写模板生成完整配置；sing-box 通常需要远程模板与脚本操作共同组装。文件保存后会得到文件输出链接，客户端直接拉取该文件。

同步配置适合处理过程较慢、客户端拉取有超时限制，或需要把结果定时上传到 Gist/GitLab Snippet 的场景。官方同步流程包括配置 GitHub Token 和用户名、新建同步配置、执行一次同步、复制生成的链接，再把该链接导入客户端。

1. 只要节点列表和基础过滤：使用单条或组合订阅。
2. 需要合并多个来源：先分别建立单条订阅，再建立组合订阅。
3. 需要规则、代理组、路由等完整配置：使用文件功能，并准备模板或覆写。
4. 客户端经常超时或希望后台定时更新：使用同步功能。

同步时要特别注意 Token 和链接权限。官方文档提醒，自动创建的同步 Gist 为私有，但手工创建的内容可能是公开的；发布或分享前应确认页面显示为 Private，避免把订阅凭据和 Token 写入公开内容。

转换后导入失败、节点变少，按这个顺序排查

1. 先测原始单条订阅：暂时绕过组合订阅、过滤、脚本和固定 target，确认远程来源本身能否更新。
2. 再看后端日志：如果前端能打开但保存或刷新失败，检查前端连接的后端地址、端口和后端网络访问能力。
3. 检查 User-Agent：订阅可能根据 User-Agent 返回不同格式。先关闭透传，使用服务方建议的客户端类型重新测试。
4. 检查缓存：官方订阅概览说明远程订阅存在缓存机制；可以先在前端手动刷新。确实需要绕过缓存时，再按当前链接参数使用noCache。
5. 检查过滤规则：关闭地区、协议或关键词过滤，确认节点恢复后，再逐条启用规则。
6. 检查输出目标：格式能下载不等于客户端一定能用。尝试通用链接、目标客户端专用格式或完整配置文件，并核对客户端支持的协议。
7. 检查组合订阅失败策略：如果只有一个来源异常，先单独修复该来源；确认其他来源正常后，再决定是否跳过失败项。

如果你需要判断问题属于客户端导入还是订阅本身，可以先把输出内容下载到本地查看：能下载但客户端报格式错误，优先检查 target 和客户端版本；下载本身失败，则优先检查后端、远程链接、网络、缓存和失败处理。

本文是第三方使用指南，不代表任何订阅服务或客户端的官方页面；具体订阅状态、服务入口和可用性应以对应提供方及客户端当前说明为准。

结论：一套不容易选错的使用顺序

首次使用时，建议严格按“单条订阅→单条测试→组合订阅→整体过滤→固定格式输出→客户端导入”的顺序操作。不要一开始就叠加脚本、文件模板、同步和多层过滤，否则出现节点变少或导入失败时，很难判断是哪一层造成问题。

最小闭环可以概括为：先让一个来源在单条订阅中正常输出，再把两个以上来源放进组合订阅，最后只增加一条过滤规则并重新测试。如果需要长期运行，再根据设备和维护需求选择代理 App、Docker、NAS 或软路由等部署环境；其中 NAS 和软路由是否适用，需以设备能否运行对应后端和网络权限为准。

常见问题

Sub-Store 前端能打开，但为什么不能添加订阅？

Sub-Store 前端和后端是分开的。前端能打开不代表后端已经连接，请进入“我的”页面检查后端地址、端口和连接状态，再查看后端日志。

单条订阅和组合订阅有什么区别？

单条订阅对应一个远程来源或一组本地内容；组合订阅通过名称引用多条单条订阅，把它们按添加顺序合并成一个输出。需要多个来源统一导入客户端时，应先建单条，再建组合。

为什么组合后节点数量变少？

先关闭组合层和单条层的过滤、去重、重命名及脚本，只测试原始来源；再逐条恢复规则。同时检查是否有远程来源拉取失败，以及组合订阅是否启用了跳过失败项。

通用链接和固定 target 应该怎么选？

不知道客户端格式时先用通用链接；明确客户端需要的格式时可以使用 target。固定 target 只指定输出格式，不保证目标客户端支持所有协议。

什么时候应该使用文件功能？

如果只需要节点列表，单条或组合订阅通常够用；如果需要完整的 mihomo、sing-box 配置、规则、代理组或模板，应使用文件功能。

同步配置是不是必须使用？

不是。同步主要用于客户端拉取超时、处理过程较慢、需要定时生成或需要稳定分发链接的场景。普通单条订阅和组合订阅可以直接输出。

Sub-Store 的订阅链接安全吗？

订阅链接可能包含访问凭据，应当按敏感信息处理。不要公开分享完整链接，使用同步功能时确认 Gist 或 Snippet 的权限，并在链接泄露后按提供方规则更换订阅链接。

相关阅读

• Clash Verge Rev 订阅导入与节点切换
• Mihomo 订阅配置与代理模式
• sing-box 添加远程订阅
• sing-box 连接失败排查
• 连接问题排查

参考资料

1. Sub-Store 官方文档：快速开始（sub-store-org.github.io）
2. Sub-Store 官方文档：安装（sub-store-org.github.io）
3. Sub-Store 官方文档：订阅概览（sub-store-org.github.io）
4. Sub-Store 官方文档：组合订阅（sub-store-org.github.io）
5. Sub-Store 官方文档：订阅转换（sub-store-org.github.io）