Sub-Store 使用指南：从安装到订阅导入的完整步骤
简答：Sub-Store 是用于统一管理、筛选、合并和转换订阅的工具。最短流程是：先选择运行方式并配置后端，再在“订阅”页添加订阅，按需筛选或合并节点，最后复制输出链接导入代理客户端。只想在一台手机上使用，可优先选择代理 App 模块或内置功能；需要长期运行、跨设备使用或定时处理，则更适合 Docker 或服务器部署。
定义：Sub-Store 是一个由前端界面和后端处理引擎组成的订阅管理工具，可处理远程订阅、本地节点、组合订阅和多种客户端输出格式。
先选部署方式：手机临时用，还是长期跨设备用？
如果你只是想在一台手机上整理订阅，优先选择代理 App 模块、客户端内置功能或 Android App；如果需要长期运行、跨设备访问、定时同步或更完整的高级功能，再考虑 Docker 或服务器部署。官方文档说明，前端只负责界面，后端负责拉取、处理和转换订阅，前端必须连接后端后才能正常工作。可先查看官方快速开始说明确认整体结构。
| 方式 | 适合场景 | 前置条件 | 主要限制 |
|---|---|---|---|
| 代理 App 模块 | 单台 iPhone 或 iPad 使用 | 已安装支持模块的代理 App，并开启模块和 MitM | 依赖该 App 持续运行，跨设备使用不方便 |
| Android App | 在 Android 设备上整理订阅 | 安装对应 App | 官方安装页说明 App 版无法直接使用全部高级功能 |
| Android 模块 | Android 长期运行 | Magisk、KernelSU 或 APatch 等 root 环境 | 需要 root，系统改动和兼容性要求更高 |
| Docker 自建 | 电脑、服务器或多设备访问 | Docker 环境、数据目录和端口配置 | 需要自行维护更新、备份、访问控制和网络 |
| 官方前端 | 已有自建后端，不想部署前端 | 浏览器可打开前端，并准备可访问的后端地址 | 官方前端本身不是完整后端 |
官方安装页列出了代理 App、Android、Docker 和官方前端等方式，具体入口和客户端版本差异应以官方安装文档当前内容为准。
最短流程：添加订阅并生成输出链接
- 准备订阅地址。
先从你的订阅服务商取得订阅链接；不要把包含账户信息或授权参数的链接公开发布。若没有远程链接，也可以在 Sub-Store 中填写本地节点或订阅内容。
- 连接前端和后端。
打开前端后进入“我的”或后端设置位置，填写后端地址并保存。前端无法连接后端时，优先检查地址是否包含正确协议、域名、端口和路径，不能把网页前端地址直接当成后端地址。
- 新增单条订阅。
进入“订阅”页，新建单条订阅，填写名称和远程订阅链接；如服务商要求特定 User-Agent，可按服务商说明设置。官方订阅概览说明，单条订阅可以包含远程链接或本地内容，保存后会生成对应的输出链接。
- 先不处理，验证原始导入。
保存后复制输出链接，在客户端中选择“从 URL 导入”或同类入口。第一次建议先使用默认通用链接，确认节点能显示，再增加筛选、重命名和转换规则。
- 设置处理规则。
在订阅或组合订阅中按需要配置关键词过滤、排序、重命名、去重和标记。每改一项就重新生成或刷新输出，避免一次加入过多规则后难以判断是哪一步造成节点为空。
官方文档给出的基本顺序也是安装、添加订阅、处理节点、生成输出并导入客户端；订阅保存后通常可使用类似/download/名称的输出路径，也可以通过参数指定目标格式。具体输出格式以官方订阅概览和当前界面为准。
多个订阅怎么合并、筛选和重命名？
需要把多个服务商的节点放到同一个客户端时，不要直接把多个原始链接分别导入，而是新建组合订阅，将已有单条订阅加入组合。这样可以集中设置过滤、排序和输出格式，后续更新时也更容易维护。
- 先分别添加并验证每条单独订阅，确认至少能拉取到内容。
- 新建组合订阅，选择需要合并的单条订阅。
- 先使用宽松筛选，例如只排除明显不需要的地区或关键词。
- 再设置重命名、排序和去重；节点为空时，先清空筛选条件回退测试。
- 生成组合订阅输出链接，并在目标客户端执行一次手动更新。
官方说明将组合订阅定义为把多条单条订阅合并为一条输出，适合多个订阅统一使用。不要把“合并成功”当成“所有客户端都兼容”，还需要根据客户端选择合适的输出格式。
格式选择建议：如果客户端支持自动识别，可先用通用链接；如果出现节点格式错误、代理类型丢失或配置无法解析，再在输出设置中明确指定目标格式，例如 mihomo 或 sing-box。不同客户端的字段支持可能不同，遇到异常时应回到原始订阅测试。
如何导入客户端并确认真的可用？
生成输出链接后，在客户端中找到“从 URL 添加订阅”“远程配置”或相近功能，粘贴链接并保存。不同客户端的菜单名称和配置入口会随版本变化，本文不把某个客户端的菜单当成统一标准。
- 导入成功标准：客户端能读取配置，节点数量不是空白，节点名称和协议类型显示正常。
- 连接验证标准：先选择一个节点进行连接，再观察客户端是否显示已连接，并用一个普通网页或应用测试网络是否恢复。
- 更新验证标准：手动刷新订阅，确认更新时间变化；若更新后节点消失，立即切回上一次可用链接或暂时移除筛选规则。
- 安全标准：不要把带授权参数的输出链接放入公开仓库、聊天群、截图或公开分享页；分享前应重新生成受控链接或删除敏感参数。
官方文档列出 mihomo、sing-box、Surge、Shadowrocket、Loon、Stash、Egern 等支持场景，但具体兼容性取决于客户端版本、输入内容和输出格式，不能仅凭“支持列表”保证每条订阅都能导入。
Docker 部署：适合长期运行的基础做法
如果你已经有 Docker 环境，可以参考官方安装页提供的镜像和启动参数。官方示例使用xream/sub-store镜像，将前端端口映射到本机，并把数据目录挂载到容器内的/opt/app/data，这样升级容器时可以保留数据。下面的命令仅适合你明确理解端口、路径和访问范围时使用：
docker run -it -d --restart=always \
-e "SUB_STORE_FRONTEND_BACKEND_PATH=/your-backend-path" \
-p 127.0.0.1:3001:3001 \
-v /root/sub-store-data:/opt/app/data \
--name sub-store \
xream/sub-store请把/your-backend-path替换为你自己设置的随机路径，不要照抄示例中的固定路径。官方文档还提醒，后端接口不应在不了解风险的情况下直接暴露到公网；部署后先访问本机前端，确认页面能打开，再在前端设置对应后端地址。
如果你不熟悉 Docker、端口映射或反向代理，先选择代理 App 或已有客户端内置方式会更容易回退。需要备份时，优先备份挂载的数据目录，并记录环境变量和端口配置。
常见问题：节点为空、前端连不上、更新失败
节点为空怎么办？
先删除或暂停所有筛选、关键词和脚本，只保留原始订阅输出。如果原始输出也为空，检查订阅链接是否过期、是否需要特定 User-Agent、后端是否能访问该地址；如果原始输出有节点，再逐条恢复处理规则。
前端显示无法连接后端怎么办？
检查后端地址是否写错协议、端口或路径；如果是自建后端，再检查跨域允许来源是否包含当前前端的 origin。官方配置说明指出，origin 应包含协议、域名和端口，但不包含路径；不要在未理解风险时把允许来源长期设为任意来源。
订阅更新超时怎么办？
先在后端所在设备测试能否访问原始订阅地址，再降低一次性处理复杂度：暂停脚本、减少合并数量、取消过重筛选，确认原始订阅能更新后再逐项加回。若服务商本身响应慢或限制请求频率，Sub-Store 不能替代服务商解决源站问题。
为什么访问 sub.store 可能不对？
Sub-Store 官方仓库和文档明确说明，sub.store 是模块脚本重写 MitM 使用的域名，并非官方持有的公网域名；官方前端地址是文档列出的前端地址。不要把直接打开某个域名页面当成安装成功标准，应先确认模块、插件、开关和 MitM 配置，再按官方说明验证。
使用前的安全与回退清单
- 订阅链接通常具备授权作用，复制、截图和分享前先遮挡敏感参数。
- 前端、后端和输出链接要分清，不能把公开前端地址当作自建后端地址。
- 首次使用先导入原始输出，再逐步添加筛选、脚本和格式转换。
- 节点为空时先回退到原始订阅；不要继续叠加规则。
- Docker 部署前记录端口、数据目录、环境变量和后端路径。
- 更新模块或客户端后，若菜单变化，优先查看对应项目的当前配置文件和发布说明。
本文按官方快速开始、官方安装说明、官方订阅概览及官方配置指南整理；页面和客户端会更新，具体字段、模块文件和菜单以当前页面为准。
常见问题
Sub-Store 必须安装在电脑或服务器上吗？
不必须。官方文档列出代理 App 模块、Android、Docker、服务器和官方前端等方式。单台设备临时使用可以选择客户端内置或模块方式；需要跨设备、定时处理或长期运行时再考虑 Docker 或服务器。
Sub-Store 能不能直接把多个订阅合并成一个？
可以。先分别添加并验证单条订阅，再新建组合订阅，把多个单条订阅加入其中，最后设置筛选、排序和输出格式。节点为空时应先回退到未筛选的组合结果。
生成的输出链接可以直接导入所有客户端吗？
不能保证。通用链接会根据请求端 User-Agent 尝试输出对应格式，但客户端版本、节点协议和配置字段可能不同。导入失败时，应明确选择目标格式或先用原始订阅排查。
手机关闭代理 App 后，Sub-Store 还能继续更新吗？
如果后端运行在该代理 App 内，通常会依赖该 App 和模块继续工作；这是运行方式的限制。需要脱离手机持续运行，应改用 Docker、服务器或其他独立后端方式。
Sub-Store 的订阅链接安全吗？
订阅和输出链接可能包含授权信息，应当按敏感凭据处理，不公开粘贴、截图或分享。官方仓库也特别提醒，错误访问公共域名或未正确进入重写流程可能带来数据泄露风险，因此应按官方文档配置并验证模块、后端和前端。