缥缈墟 - 发布页

Sub-Store 使用指南:从添加订阅到导入客户端

更新于 2026-11-13 · piaomiaoxu.site

简答:Sub-Store 可以把多条订阅集中管理,再进行合并、过滤、重命名、排序和格式转换,最后生成适合 mihomo、sing-box、Surge、Loon、Shadowrocket 等客户端的输出链接。最快的成功路径是:先选一个后端部署方式,打开前端并连接后端,添加一条订阅,保存后复制输出链接,再按目标客户端选择格式导入。本文不含具体服务商价格、状态或可用性评价。

定义:Sub-Store 是一个由前端界面和后端处理引擎组成的订阅管理工具,负责拉取、处理、转换、生成和托管订阅或配置文件。

先试这一步:根据使用场景选择部署方式

Sub-Store 不是只打开一个网页就能完成处理的单体工具。官方文档说明,前端负责操作界面,后端负责拉取订阅、处理节点和转换格式;前端必须连接后端后才能工作。可先按下面的场景选择,避免安装后找不到后端。

你的情况建议方式完成标准需要注意
只在 iPhone 或 iPad 上使用代理 App 模块或插件打开前端后能看到订阅管理界面要开启重写、脚本、MitM,并信任证书
Android 设备使用Android App 或模块前端能连接本机后端并创建订阅模块方案通常需要 root;App 方案能力可能不同
已有支持内置功能的桌面客户端使用客户端内置的 Sub-Store在客户端内打开内置页面并完成后端初始化部分高级功能可能无法直接使用
电脑长期运行并供多台设备使用Docker 自建部署机和其他设备都能通过安全地址打开前端跨设备时不要只绑定 127.0.0.1,应使用反向代理、HTTPS 和访问控制
只想测试前端界面官方前端搭配可用后端在“我的”中成功保存后端地址官方前端本身不是完整后端

安装方式、代理 App 入口和 Docker 示例可参考Sub-Store 官方安装文档;不同版本的菜单名称、镜像标签和参数可能变化,未在当前资料中核实的版本号不要直接套用。

第一条可用订阅:前端、后端和输出链接怎么配合

可以把它理解为四个部分:前端是操作页面,后端是处理引擎,原始订阅是输入,输出链接是给客户端读取的结果。只打开前端而没有配置后端时,通常无法完成拉取和转换。

  1. 准备输入。准备一条可正常访问的远程订阅链接,或准备本地节点内容。订阅链接通常包含授权信息,不要粘贴到公开帖子、截图或工单中。
  2. 安装后端。按上面的部署表选择代理 App、Android、内置功能或 Docker。代理 App 方案应确认模块或插件下载成功,并开启重写、脚本和 MitM;Docker 方案应保留数据目录。
  3. 打开前端。使用项目文档列出的前端地址,或使用自建前端。进入“我的”或类似设置页面,填写后端地址并保存。
  4. 添加订阅。进入“订阅”页面,新建订阅,填入远程订阅链接;如果使用本地内容,则切换到“本地内容”输入框。
  5. 保存并检查。保存后应能看到订阅名称、节点数量或预览结果。若显示为空,先检查链接是否过期、后端是否能访问该地址,以及 User-Agent 是否被限制。
  6. 复制输出。订阅或组合订阅保存后,复制通用输出链接,再导入目标客户端。官方文档说明,通用链接可以根据请求的 User-Agent 自动返回格式,也可以用 target 参数指定目标格式。

官方快速开始文档列出的基本流程是安装、添加订阅、处理节点和生成输出;可查看Sub-Store 快速开始文档核对页面结构。

泄露提醒:原始订阅链接和 Sub-Store 输出链接都可能包含访问凭据。复制链接进行测试后,建议及时清理剪贴板,不要将完整链接放入公开仓库;如果怀疑泄露,应回到订阅提供方重新生成或撤销对应链接。

添加远程订阅、本地节点和组合订阅

远程订阅

在订阅编辑页填写远程 URL,保存后等待后端拉取。第一次建议只添加一条,先确认能显示节点,再添加更多来源。这样可以区分是单条订阅失败,还是组合配置有问题。

本地节点或完整内容

官方文档说明,本地内容可以按行输入协议 URI、JSON5、YAML,也可以混写部分代理 App 原生格式。例如下面只是结构示例,域名、端口和密钥均为占位值:

demo = socks5, 192.0.2.10, 1080

也可以使用 mihomo 风格的单行 JSON5:

{ name: 'demo', type: 'ss', server: 'example.com', port: 8388, cipher: 'aes-128-gcm', password: 'REPLACE_ME' }

不要把真实密码、私钥或完整订阅放进示例页面。官方文档还提醒,部分客户端导出的 URI 可能不是标准 URI,导入失败时优先使用原始订阅或规范格式。详情见本地节点与订阅文档。

组合订阅

需要合并多个来源时,先分别创建并验证单条订阅,再新建组合订阅并选择这些来源。组合订阅的结果仍然是一个输出对象,客户端只需要导入组合后的链接。若某一条远程来源经常失败,可检查是否有“忽略失败的远程订阅”之类的选项;具体名称以当前界面为准。

筛选、重命名、排序和去重:可直接照着改的思路

处理规则的目标是减少无关节点、统一名称并方便客户端内选择。不同版本的字段名称和操作顺序可能变化,因此下面使用通用规则表达,不把未核实的界面名称当成固定事实。

目标规则思路结果判断
只保留某地区在筛选中保留名称包含目标关键词,例如 JP|Japan|日本预览结果只剩包含任一关键词的节点
排除测试或过期节点排除名称匹配 过期|测试|官网预览中不再出现这些关键词节点
统一命名将名称中的多个地区写法替换为统一标签,例如把 Tokyo|东京|JP 统一为 日本客户端内显示的名称格式一致
保留序号在原名称后追加序号或来源标签,例如 原名称 - A同名节点仍能区分来源
去重启用去重操作,或按节点关键字段去重预览数量减少且没有重复名称或重复地址
排序按名称、地区或处理后的标签排序输出顺序与预期一致

建议每次只改一类规则:先筛选,保存并预览;再重命名;最后排序和去重。一次改太多时,如果结果为空,很难判断是哪条规则造成的。节点处理、订阅转换和组合订阅的功能边界,可对照官方订阅转换文档。

输出格式怎么选:订阅链接不等于完整配置文件

这是最容易混淆的一点。输出订阅链接通常提供节点列表或客户端可读取的订阅内容;组合订阅是把多条来源合并后的输入集合;完整配置文件则可能进一步包含代理组、规则、DNS 和其他客户端设置。导入后只有节点、没有策略组或规则,往往是因为复制了订阅输出,而不是通过“文件”功能生成完整配置。

需求优先选择说明
只需要节点列表通用输出链接让客户端根据 User-Agent 读取,或使用 target 指定格式
使用 Clash Meta 或 mihomomihomo / Clash.Meta 输出适合导入节点订阅;策略组和规则需要另行配置或生成文件
使用 sing-boxsing-box 输出或文件模板完整配置通常需要模板、脚本或文件功能
使用 Surge、Loon、QX、Stash、Shadowrocket对应客户端格式先确认协议是否被该客户端支持
排查转换结果Plain JSON便于查看节点字段和判断输入是否被正确解析

官方格式说明列出了输入协议、客户端原生格式和输出目标;旧版 Clash 输出已被标记为弃用,若必须使用,需要明确指定对应参数。格式支持以官方支持的格式文档为准。

按客户端导入:最小可行操作路径

下面只讲导入处理后的输出,不涉及各客户端的完整安装教程。每个客户端都先完成“复制输出链接”,再在对应的订阅管理入口添加 URL。

  • Clash Party:如果客户端内置 Sub-Store,先在客户端内更新或启用内置页面,再创建订阅并复制输出;如果直接导入外部输出链接,则在订阅管理中添加 URL。内置方案和外部后端的功能可能不同。
  • mihomo 客户端:导入时选择 mihomo 或 Clash.Meta 格式。若只看到节点而没有策略组、规则和 DNS,改用 Sub-Store 的“文件”功能生成完整配置,再导入配置文件链接。
  • Surge:官方安装文档列出 Surge 模块入口和不同模块文件。下载模块后,在 Surge 的模块管理中添加对应模块,开启模块和 MitM,再用 Safari 打开 https://sub.store 验证前端是否能加载。模块地址以安装文档中的配置目录为准。
  • Shadowrocket:官方安装文档列出可使用的模块文件。导入模块后,确认模块已启用、重写已开启并信任 MitM 证书,再打开前端;如果刷新失败,可降低请求并发或先检查模块是否下载完整。
  • Loon:安装文档列出 Loon 插件,以及较新版本可用的资源解析器插件。以当前版本设置页显示的入口为准,安装后开启插件并完成证书信任。
  • Quantumult X:使用对应重写配置;如果需要定时任务,还要单独配置任务文件。先确认重写已开启,再访问前端验证后端。
  • Stash:安装对应覆写配置并开启;导入输出时选择 Stash 格式,若节点缺失,回到输出格式和协议支持处检查。
  • Egern:使用对应配置文件并开启相关功能;如果只需要节点列表,可直接使用 Egern 输出,不要把 mihomo 完整配置当成 Egern 配置导入。

代理 App 方案的共同完成标准不是“模块显示已安装”,而是模块、重写、脚本和 MitM 都已生效,并且前端请求确实进入本地后端。

Docker 自建:本机使用与跨设备访问的区别

官方安装文档给出了 Docker 镜像、前端端口、后端路径和数据目录示例。为了避免把示例误用于公网,先区分两种场景:

  • 只在部署机使用:可以让前端端口只绑定本机地址,例如 127.0.0.1:3001:3001。此时手机或其他电脑无法直接访问,这是预期结果。
  • 需要手机或其他设备访问:不能继续只绑定 127.0.0.1。应由反向代理对外提供 HTTPS,使用访问控制或身份认证,并只暴露前端入口;后端 API 端口不要直接开放到公网。

官方示例还说明数据目录应挂载到容器数据目录,以便更新容器时保留数据。示例命令中的路径、前缀和域名都应替换为自己的值:

docker run -d --restart=always \
  -e "SUB_STORE_FRONTEND_BACKEND_PATH=/YOUR_BACKEND_PATH" \
  -p 127.0.0.1:3001:3001 \
  -v /your/local/data:/opt/app/data \
  --name sub-store \
  xream/sub-store

如果要跨设备访问,把端口绑定和反向代理配置调整为实际部署方案,不要直接照抄本机绑定方式。启动后可先在部署机执行:

curl http://127.0.0.1:3001/YOUR_BACKEND_PATH/api/utils/env

返回包含版本信息的 JSON,说明本机前端到后端的链路基本可用。再依次测试部署机 IP、反向代理域名和 HTTPS 域名。Docker 参数和健康检查路径以官方安装文档及其引用的镜像说明为准,未在本次资料中确认的变量不要自行推断。

常见故障排查:按链路逐层定位

排查时不要直接反复更换订阅链接,先判断故障位于前端、后端、输入订阅还是输出客户端。

  1. 前端能打开,但保存后端失败:检查后端地址是否包含正确路径;如果前端是 HTTPS、后端是 HTTP,浏览器可能阻止混合内容。优先使用同为 HTTPS 的反向代理地址。
  2. 代理 App 打开前端报错:检查模块或插件是否下载成功,重写和脚本是否开启,MitM 证书是否信任。再检查请求是否真的被重写到本地后端。
  3. 访问环境接口没有版本信息:官方排查文档建议检查 https://sub.store/api/utils/env;但该域名依赖重写,重写失效时可能请求到公网,因此不要在未确认重写生效前提交真实订阅链接。可按官方域名说明进行本地映射后再验证。
  4. 订阅拉取失败:先在浏览器或命令行确认原始链接可访问,再检查 User-Agent、超时、TLS 证书和分流路径。浏览器能访问而后端失败时,可能是订阅方限制了 User-Agent。
  5. 导入后节点数量不对:检查筛选规则是否过严、目标格式是否支持原协议,以及是否启用了不兼容协议的排除选项。
  6. 输出只有节点没有规则:这是订阅输出与完整配置文件的区别,不一定是转换失败。需要在“文件”功能中配置模板、覆写或脚本。
  7. 更新后页面还是旧版本:先清理浏览器或 PWA 缓存,再重新打开前端。界面名称和参数会随版本变化,版本号以当前发布渠道为准。

官方故障排查文档还给出了 Docker 日志、端口和 curl 检查方法,可参考Sub-Store 故障排查文档逐层核对。

安全自查清单:使用前和分享前各检查一次

  • 确认访问的是项目文档列出的前端或自己部署的地址,不要把相似域名自动当成官方服务。
  • 明白 sub.store 在文档中的用途是模块脚本重写 MitM 使用的域名,并非官方持有的公网域名;重写未生效时不要提交真实订阅。
  • 订阅链接、输出链接、节点密码、WireGuard 私钥和同步凭据都按敏感信息处理。
  • Docker 跨设备访问时使用 HTTPS、访问控制和反向代理,不要直接暴露后端 API 端口。
  • 备份配置前先检查是否包含原始订阅链接、脚本参数、同步凭据或其他明文授权信息。
  • 使用 GitHub 同步或 Gist 类功能前,按实际页面要求授予尽可能小的权限;本次资料没有核实具体权限勾选项,因此不要照搬未经确认的权限清单。

补充更新:哪些内容会随版本变化

相对稳定的逻辑是“前端连接后端—添加输入—处理订阅—生成输出”;容易变化的是客户端菜单名称、模块文件、Docker 镜像标签、环境变量、端口参数和高级功能支持情况。官方安装文档明确区分了内置方案、代理 App 模块、Android、Docker 与前端搭配后端的差异,因此升级或迁移时应先看当前安装文档和发布说明,再调整配置。本文没有写入未核实的最新版编号、价格或性能结论。

常见问题

Sub-Store 打开网页后为什么不能直接添加订阅?

因为前端主要负责操作界面,实际拉取、处理和转换由后端完成。进入前端后,需要在“我的”或类似设置页填写可用后端地址;如果使用代理 App 模块、Android 或 Docker,先确认后端已经运行。

Sub-Store 输出链接应该选择通用链接还是指定格式?

如果客户端能正确识别 User-Agent,可以先用通用链接;如果导入后格式不正确,改用 target 参数或多一级路径指定目标格式,例如 mihomo、sing-box、Surge 或 Loon。具体目标名称以当前官方文档支持列表为准。

为什么导入后只有节点,没有策略组和规则?

普通订阅输出通常只提供节点或转换后的订阅内容,不等于完整配置文件。需要策略组、规则和 DNS 时,应在“文件”功能中选择模板、覆写或脚本生成完整配置,再把配置文件链接导入客户端。

代理 App 模块安装成功,但打开前端仍然报错怎么办?

依次检查模块或插件是否下载成功、重写和脚本是否开启、MitM 证书是否信任,以及请求是否真的被重写到本地后端。不要先提交真实订阅链接;可先使用官方排查文档中的环境接口和日志方法验证链路。

Docker 部署后手机为什么访问不到?

如果端口映射写成 127.0.0.1,只有部署机本身能访问,手机无法连接。这是本机绑定的正常结果。跨设备使用时,应通过反向代理提供 HTTPS,并配置访问控制;不要直接开放后端 API 端口。

Sub-Store 支持 WireGuard 节点吗?

官方格式文档列出 WireGuard URI 和部分客户端原生格式的输入与输出支持,但不同客户端对协议字段的支持不同。导入失败时,先用 Plain JSON 检查字段是否被正确解析,再确认目标客户端支持对应协议。

相关阅读

参考资料

  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)
  6. 故障排查 | Sub-Store 文档(sub-store-org.github.io)
  7. Sub-Store 配置指南 | GitHub