Stash Sub-Store 教程：安装、订阅处理与正确回填方法

更新于 2026-10-24 · youtu2.store

简答：Stash 使用 Sub-Store 的正确流程是：安装官方 Stash 覆写，确认脚本与重写规则生效，生成并信任 MitM 证书，再使用官方前端添加订阅。Sub-Store 输出若只有节点列表，应放入 Stash 的远程代理集或 proxy-providers；只有使用文件功能生成完整配置时，才适合按完整配置导入。最近核验于 2026-10-24。本文是独立教程，不是 Stash 或 Sub-Store 官方页面。

定义：Sub-Store 是用于订阅管理、节点筛选、格式转换和配置生成的工具；Stash 通过覆写、重写、脚本和 MitM 为其提供本地处理环境。

先试这一步：先判断你要的是节点列表还是完整配置

很多“导入后没有规则”并不是 Sub-Store 失效，而是把节点输出误当成了完整配置文件。官方文档说明，Sub-Store 可以生成面向 Stash 的订阅输出，也可以通过“文件”功能基于订阅和模板生成完整配置；两者在 Stash 中的用法不同。可先阅读Sub-Store 官方快速开始。

目标	Sub-Store 中的做法	Stash 中的回填位置	成功标志
只整理节点	订阅页筛选、排序、重命名后生成 Stash 输出	已有配置的远程代理集或 `proxy-providers`	节点出现在代理提供者中，可被策略组引用
保留规则和策略组	使用“文件”功能配合模板生成完整配置	Stash 的配置文件列表或“从 URL 下载”	规则、策略组和节点同时出现
只测试订阅是否可读	先添加原始订阅，不加筛选条件	不急于回填，先确认处理结果	能看到节点或生成结果，不是空文件

速查结论：输出里只有 proxies 或节点数据时，不要直接当作完整配置导入；如果希望一条链接同时带规则和策略组，应使用模板生成完整文件，或继续使用原有配置并把输出作为节点提供者。

开始前准备：Stash、订阅地址和可回滚配置

准备可用的 Stash。官方 iOS 文档显示，Stash 通过配置文件指定代理和网络策略；官方快速上手路径是“设置页面 → 配置文件 → 从 URL 下载”，下载后选中配置并回到首页启动。具体按钮名称可能随版本调整，可对照Stash 官方快速上手文档。
准备原始订阅地址。订阅地址通常包含访问凭据，不要放进公开截图、代码仓库或不明网页。建议在开始前保存一份原始地址和当前 Stash 配置。
确认 Stash 已能正常启动。如果 Stash 本身没有选中的配置，或系统网络权限尚未允许，Sub-Store 覆写不会有稳定运行环境。
准备回滚方式。如果页面打不开或配置出现异常，先停用新增覆写，再恢复原配置测试，不要同时修改订阅、筛选、证书和代理组。

Sub-Store 官方项目支持 Stash 等多个客户端，并把代理 App 模块、官方前端和后端处理引擎分开说明；因此安装页面、处理订阅和导入结果应分别验证，不能只看某一个页面是否打开。参考Sub-Store 官方安装文档。

在 Stash 中安装官方覆写：按页面路径逐项核对

官方配置仓库列出的 Stash 覆写地址为：

https://raw.githubusercontent.com/sub-store-org/Sub-Store/master/config/Stash.stoverride

打开 Stash 的配置文件或覆写管理页面，进入添加远程覆写的入口。
选择“从 URL 安装”或名称相近的按钮，粘贴上面的官方地址并下载。
在已安装覆写列表中确认该文件存在，并打开启用开关。Stash 官方文档说明，覆写文件可以修改现有配置的部分字段，并且多个覆写会按顺序合并；因此下载成功不等于已经生效。参考Stash 覆写文件文档。
回到 Stash 首页，确认相关覆写已应用。若当前版本提供“安装并启用”或“保存并应用”，按页面提示完成；这些按钮名称可能因版本不同而变化。
检查官方配置说明中的 Stash 项目是否仍指向当前仓库地址。官方配置指南目前仍将 Stash 对应方式列为安装 Stash.stoverride。

Stash iOS 路径速查：配置文件/覆写管理 → 添加远程覆写 → 粘贴 URL → 下载 → 启用 → 保存并应用。若找不到完全相同的文字，优先寻找“配置文件”“覆写”“远程 URL”这几个功能入口，不要把订阅地址直接当成覆写地址。

官方配置指南还说明，代理 App 版安装后应确认模块或覆写下载成功、开关已开启，并信任 MitM 证书。相关地址和安装方式可查看Sub-Store 官方配置指南。

开启脚本、重写和 MitM：只处理必要主机名

这几个功能负责不同环节：覆写把 Sub-Store 相关配置加入 Stash；HTTP 重写负责匹配并改写请求；脚本负责执行请求或节点处理逻辑；MitM 则让 Stash 能对指定 HTTPS 请求进行查看、改写或脚本处理。Stash 官方文档明确指出，HTTPS 请求要进行查看、改写或执行脚本，必须启用 MitM，并让设备信任对应 CA 证书，参考Stash 官方 MitM 文档。

在 Stash 首页找到MitM → CA 证书。
点击Stash Generated CA生成证书，再点击安装证书；Stash 官方文档说明，随后会跳转 Safari，点击“允许”安装描述文件。
在 iOS 中打开设置 → 通用 → VPN 与设备管理，检查下载的描述文件并完成安装。Apple 说明，手动安装的描述文件可在此处查看和管理，参考Apple 官方描述文件说明。
继续进入设置 → 通用 → 关于本机 → 证书信任设置，在“针对根证书启用完全信任”下开启对应证书。Apple 明确说明，手动安装的证书不会自动获得 SSL/TLS 信任，必须在这里手动开启，参考Apple 官方证书信任说明。
回到 Stash，进入MitM → 主机名，只添加配置实际需要的主机名。不要为了“省事”把 MitM 范围扩大到所有域名；Stash 官方文档支持按域名或通配符添加 MitM 主机名。
确认官方覆写已经包含相关脚本、重写和主机名设置后，再重新应用配置。若覆写已自动提供这些项目，通常不需要另写一套重复规则。

安全边界：证书只能由你在本机生成和安装，不要共享证书，也不要使用网上提供的 CA 证书。完成测试后，如果不再需要 MitM，可关闭对应功能并移除不必要的证书信任。

前端和后端怎么分：不要把 sub.store 当官方网页

Sub-Store 官方快速开始文档把系统分为前端和后端：官方前端是 https://sub-store.vercel.app，后端负责拉取、处理和转换订阅；后端可以运行在代理 App、Android、Docker 或服务器中。前端打开后，还要在“我的”页面设置能够工作的后端地址，不能只打开网页就认为配置完成。参考Sub-Store 官方快速开始。

sub.store的性质不同：官方项目说明它只是模块脚本重写 MitM 使用的域名，并不是项目方持有的公网服务域名。如果请求没有经过 Stash 的重写，数据可能被发送到公网 sub.store。因此，使用代理 App 版时，必须让 Stash 正在运行、官方覆写已启用、重写和 MitM 已生效；停用 Stash 后，依赖该本地接管的链接可能无法工作，也不应复制到其他设备直接使用。详情见Sub-Store 官方项目安全说明。

优先用 Safari 打开官方前端 https://sub-store.vercel.app。
进入前端的“我的”或后端设置页，确认后端地址由 Stash 覆写提供，或按你实际部署方式填写。
如果你使用模块脚本对应的本地接管方式，也可按官方安装文档测试 https://sub.store，但只在 Stash 正在运行且覆写、重写、MitM 均已生效时这样做。
页面成功的标志不是“能看到首页”，而是前端能连接后端，并能进入订阅页读取或保存数据。

添加订阅、筛选节点，再选择正确输出方式

进入 Sub-Store 的订阅页面，新增远程订阅，粘贴原始订阅地址并保存。第一次不要立即添加地区、正则或脚本筛选。
先执行一次更新，确认原始订阅能被读取。若此时已经为空，应先检查地址、User-Agent、证书、网络请求和订阅格式。
在订阅处理中逐项增加规则，例如地区筛选、类型筛选、正则过滤、重命名、排序和去重。一次只改一项，结果为空时更容易定位。
如果只需要节点列表，生成面向 Stash 的输出链接，并将其作为现有配置中的远程代理集或 proxy-providers 使用。Stash 官方文档将远程代理集和服务提供商订阅作为配置能力的一部分，参考Stash 服务提供商订阅文档。
如果需要规则、策略组和节点组成一份完整配置，应在 Sub-Store 使用文件功能配合模板生成整份配置，再把该文件地址放入 Stash 的“配置文件 → 从 URL 下载”流程，而不是把普通节点输出当成完整配置。

问题	应选择的输出	不要这样做
只想集中筛选节点	Stash 节点输出，回填到远程代理集或 `proxy-providers`	直接覆盖原有完整配置
想保留规则和策略组	文件功能生成的完整配置	把只有节点列表的链接当完整配置
只想验证订阅能否读取	先保存原始订阅并单独更新	一开始就叠加多个筛选脚本

正确回填 Stash：节点输出与完整配置分两条路

路线 A：把节点输出放入已有配置

复制 Sub-Store 生成的 Stash 输出链接，并检查协议、参数和末尾字符是否完整。
在 Stash 的配置编辑或远程代理集入口中新增一个提供者，粘贴该链接。
将这个提供者加入已有策略组，或在配置中让策略组引用它。
重新下载并检查节点是否出现，再测试一个具体连接。

这条路线不会自动生成你的规则和策略组；它只把处理后的节点作为现有配置的一部分。若输出链接依赖 Stash 的本地重写，必须保持 Stash 运行和相关覆写启用；在其他设备上直接打开可能失效，也可能触发公网 sub.store 风险。

路线 B：把完整配置放入配置列表

在 Sub-Store 的“文件”功能中选择模板和订阅输入，生成包含规则、策略组和节点的完整配置。
复制完整配置文件 URL。
回到 Stash，按官方快速上手路径进入设置 → 配置文件 → 从 URL 下载。
下载后选中该配置，回到首页启动并检查规则、策略组和节点是否同时存在。

如果导入后只有节点没有规则，优先回到路线判断：你很可能使用了节点输出，而不是文件功能生成的完整配置。不要仅靠刷新反复尝试，因为两类输出的结构本来就不同。

故障排查速查卡：按“前端—后端—输出—Stash”定位

层级	检查项	成功标志	失败处理
前端	打开官方前端，进入“我的”设置后端	能进入订阅页并保存数据	检查前端地址、后端地址和浏览器缓存
Stash 运行环境	覆写启用、脚本和重写生效、MitM 证书已信任	相关页面能打开且无错误提示	停用后重新启用覆写，检查证书和主机名
原始订阅	不加筛选先更新	订阅有节点或可生成结果	检查 URL、User-Agent、证书、超时和格式
输出结果	确认是节点列表还是完整配置	结构与导入位置匹配	节点输出放远程代理集，完整配置走配置文件
最终连接	先下载配置，再测试具体节点	节点可加载并能建立连接	记录错误原文，不要直接归因于线路

官方故障排查文档建议从开关、模块、证书、前端访问、请求失败、CORS、主机名和缓存等层级检查。若使用非官方前端，CORS allowlist 需要包含完整的协议、域名和端口，不包含路径；不要长期设置为任意来源。可查看Sub-Store 官方故障排查文档。

如果页面能打开但订阅为空，先删除筛选条件；如果网页正常而 Stash 请求失败，检查 Stash 是否仍在运行及覆写是否启用；如果 Stash 下载成功但没有规则，回到节点输出与完整配置的区别检查。只有当国内站点正常、仅境外站点持续慢或丢包时，才适合进一步判断线路问题。

更新与安全：保留原始订阅，避免把输出链接当唯一备份

建议保留三份信息：原始订阅地址、Sub-Store 的筛选和转换规则、最终使用的 Stash 配置或远程代理集地址。更新时按“原始订阅可读 → Sub-Store 处理结果正确 → Stash 能下载输出 → 节点或完整配置可加载”的顺序操作。

订阅链接可能包含访问凭据，不要将其发送给陌生网页或公开排障。MitM 证书同样不能共享；Stash 官方文档明确提醒不要与他人共享证书，也不要使用互联网上提供的 CA 证书。使用完毕后可以停用不需要的覆写、删除多余主机名并撤销不再使用的证书信任。

若前端长期显示旧版本，先关闭已打开的页面、删除主屏幕上的 PWA 图标，再重新打开官方前端。若使用的是自建后端，则应按官方健康检查和日志方法验证后端，而不是只刷新浏览器。

常见问题

为什么 Sub-Store 页面能打开，但在 Stash 中导入后没有规则？

最常见原因是导入了面向 Stash 的节点输出，而不是完整配置。节点输出通常只解决 proxies 或提供者数据，规则和策略组仍在原有配置中；需要完整配置时，应使用 Sub-Store 的文件功能配合模板生成。

sub.store 和 sub-store.vercel.app 是同一个地址吗？

不是。官方文档把 sub-store.vercel.app 作为官方前端，把 sub.store 说明为模块脚本重写 MitM 使用的域名。前者用于网页界面，后者依赖本地 Stash 重写接管，不应当作普通公网服务直接使用。

关闭 Stash 后，Sub-Store 输出链接还能在其他设备打开吗？

如果该链接依赖 Stash 模块对 sub.store 的本地重写，关闭 Stash 或换到其他设备后可能无法按预期工作。更重要的是，请求可能落到公网 sub.store，因此不要把这类链接当作通用、公开的订阅地址。

安装了覆写，为什么还会提示证书错误？

安装覆写只代表配置文件下载成功，不代表 MitM 证书已经安装并获得系统信任。应在 Stash 中生成并安装 CA，再按 iOS 的证书信任设置开启 SSL/TLS 完全信任，并确认只对必要主机名启用 MitM。

是否必须手动打开脚本和重写开关？

要看当前官方覆写内容和 Stash 版本。有些能力由覆写直接写入配置，有些需要客户端运行 HTTP 引擎。建议先确认覆写已启用，再检查 Stash 的重写、脚本和 MitM 状态；不要重复添加同一规则，以免产生冲突。

订阅为空，是订阅地址失效还是筛选规则有问题？

先在不加地区、正则、类型和脚本筛选的情况下单独更新原始订阅。如果这样能出现节点，问题通常在筛选条件；如果仍为空，再检查订阅地址、User-Agent、证书、请求超时和格式支持。

为什么把输出链接粘贴到 Stash 的配置列表后，下载成功却不能使用？

下载成功只说明地址返回了内容，不代表内容是完整配置。若返回的是节点列表，应放在远程代理集或 proxy-providers，并让已有策略组引用它；只有含规则和策略组的完整文件才适合放入配置文件列表。