Stash 使用教程:订阅导入、节点选择与连接排障
简答:Stash 使用教程的核心流程是准备 Stash/Clash 格式订阅或完整配置文件,导入并选中配置,再启动代理和验证连接。排查时依次检查格式、配置状态、策略组、模式与 VPN 权限。
定义:Stash 是一款基于规则分流的网络客户端,需要导入 Stash、Clash Premium 或 Clash 格式配置文件后,才能根据配置连接代理服务器并执行网络策略。
先按这 6 步完成 Stash 配置

本文仅作使用教程;DH123 与 Stash 项目及其开发者无隶属关系。Stash 官方文档说明,启用 Stash 的前提是导入一份 Stash/Clash 格式配置文件;配置可以来自服务提供商的 URL,也可以来自 iCloud、OneDrive 或 AirDrop 中的本地文件。可先按下面顺序操作,菜单名称可能因设备和版本不同略有差异。
- 准备配置:向服务提供方获取 Stash、Clash Premium 或 Clash 格式订阅链接,或者准备完整的 YAML 配置文件。只有单个节点分享链接时,通常不能直接替代完整配置文件,是否支持需要向服务提供方核对。
- 导入远程订阅:打开 Stash 设置,进入“配置文件”,在配置列表中选择“从 URL 下载”,粘贴订阅地址并下载。以上路径来自Stash 官方快速上手文档。
- 选中配置:下载完成后,确认目标配置处于选中状态。配置文件已下载但没有选中时,首页启动可能仍使用旧配置。
- 启动代理:返回 Stash 首页,点击“启动”;首次启动时,系统可能要求确认 VPN 配置或网络权限,应按系统提示完成授权。
- 选择节点:进入配置中的策略组,选择一个具体节点或自动选择策略。若策略组为空,先回到配置页面检查节点是否成功解析。
- 验证连接:先确认 Stash 首页显示运行状态,再访问一个普通网页;如果能启动但网页打不开,继续检查策略组、规则模式、DNS 和节点连通性。
判断标准:正常状态至少应满足“配置已选中、首页已启动、策略组有可选节点、测试网页能够打开”四项;缺哪一项,就从对应环节开始排查。
Stash 订阅、配置文件、节点和策略组分别是什么
新手最容易把订阅链接、配置文件和节点混为一谈。可以把它们理解为一套从“入口”到“执行”的关系:
| 对象 | 作用 | 你需要检查什么 |
|---|---|---|
| 订阅链接 | 用于下载或更新远程配置的地址 | 是否由服务提供方明确标注为 Stash、Clash Premium 或 Clash 格式 |
| 配置文件 | 保存代理节点、规则、DNS、策略组等设置 | 能否成功解析,下载后是否被选中 |
| 节点 | 具体的代理服务器或出站连接 | 名称是否出现、测试是否超时、协议是否被当前版本支持 |
| 策略组 | 决定使用哪个节点或哪类节点 | 是否有节点、当前是否选中有效出站 |
| 规则 | 根据域名、IP 或其他条件决定流量走向 | 规则模式下目标网站是否被分配到正确策略组 |
Stash 官方资料将远程配置和本地配置都作为配置文件导入方式;本地文件可以通过 AirDrop,或从 iCloud、OneDrive 打开后选择 Stash 导入。详情可查看Stash Quick Start。
如果你拿到的是一串单独的节点链接,而不是可下载的完整配置,先不要反复粘贴到“从 URL 下载”页面。应先确认该链接是否确实返回 Clash/Stash 配置内容;若返回的是单节点文本、网页登录页或错误提示,就不属于可直接导入的完整配置。
iPhone 和 iPad 导入 Stash 配置的操作路径
- 打开 Stash,进入设置中的配置文件管理页面。
- 选择“从 URL 下载”,粘贴订阅地址并执行下载。
- 等待配置完成后,在配置列表中点选要使用的文件。
- 回到首页,点击启动并完成系统 VPN 授权。
- 打开策略组,选择具体节点;如果策略组显示自动测速、手动选择或故障转移,可先使用手动选择,便于确认实际使用的是哪个节点。
- 先采用规则模式进行普通访问;若某个目标无法打开,再临时切换到全局模式作对照。测试结束后,是否长期使用哪种模式,应以配置规则和个人需求为准。
Stash 在 App Store 页面被描述为规则型网络工具,并列出规则集、策略组、DNS、Override 等功能;但具体可用功能会受当前 App 版本、配置内容和设备系统影响,不能仅凭功能名称判断某个订阅一定兼容。设备要求和当前价格应以Apple App Store 的 Stash 页面为准。
Mac 上怎么导入和启动 Stash
App Store 页面列出 Stash 的 Mac 兼容条件,包括 macOS 13.0 或更高版本,以及 Apple 芯片 M1 或更高版本的 Mac;购买、兼容性和可用平台应以商店当前页面为准。安装后可按以下顺序操作:
- 从 App Store 安装 Stash,首次打开时完成系统权限提示。
- 在配置文件页面选择从 URL 下载,输入 Stash/Clash 格式订阅地址;如果已有本地 YAML 文件,也可以通过系统文件选择器打开并交给 Stash。
- 确认配置文件被选中,返回首页启动代理。
- 进入策略组选择节点,再用浏览器访问普通网页进行验证。
- 如果 Mac 已经有其他网络代理、VPN 或系统代理设置,先暂时关闭冲突项,再判断 Stash 本身是否正常。
Mac 端和 iPhone/iPad 的菜单文字可能不同,但排查逻辑一致:先看配置是否成功,再看是否选中,之后看策略组和启动状态,最后才判断线路或 DNS 问题。
规则、全局、直连模式怎么选
| 模式 | 适合场景 | 排查用途 | 注意点 |
|---|---|---|---|
| 规则模式 | 日常使用,希望不同网站按规则分流 | 确认目标域名是否被分配到正确策略组 | 规则错误时,可能出现部分网站打不开 |
| 全局模式 | 需要让大部分流量统一经过当前节点 | 用来对照判断规则是否导致异常 | 流量范围更大,使用后应恢复合适模式 |
| 直连模式 | 暂时不使用代理,或验证本地网络 | 比较代理前后的访问差异 | 直连下无法访问不代表 Stash 配置有问题 |
策略组是节点选择层,规则模式是流量分配层,两者不是同一个开关。选择了节点但仍无法访问,可能是规则把目标请求分配到了直连或无效策略组;切换全局模式只适合做对照,不应直接作为所有问题的长期解决方案。
Stash 常见故障:按症状逐项排查
| 症状 | 优先检查 | 可执行处理 |
|---|---|---|
| 点击下载后提示失败 | 订阅地址和返回内容 | 重新复制地址;确认链接没有多余空格、登录页或过期提示;向服务提供方确认是否为 Stash/Clash 格式 |
| 配置导入成功但没有节点 | 配置是否完整、节点是否被隐藏 | 打开配置内容检查是否存在代理与策略组;若只有策略组没有节点,要求提供方重新生成配置 |
| 有节点但首页无法启动 | 配置解析、系统权限、其他 VPN | 重新选中配置;关闭冲突的 VPN 或代理;重新启动 Stash 并按系统提示授权 |
| 已经启动但网页打不开 | 当前节点、模式、DNS | 先换一个节点,再用全局模式做对照;若全局可用而规则不可用,检查规则和策略组 |
| 只有部分网站异常 | 规则匹配、DNS、IPv4/IPv6 | 记录异常域名,比较规则模式与全局模式结果;不要直接修改大量配置,先做单变量测试 |
| 订阅更新后手动修改消失 | 远程配置覆盖关系 | 把长期修改放到 Override 或本地配置中;更新前保存原配置,避免直接改远程订阅内容 |
排查时建议一次只改一个变量。例如先固定同一设备和同一节点,只比较规则模式与全局模式;再固定模式,只更换节点。这样才能判断问题来自配置、策略组、规则还是网络环境。
连接成功后如何做最小验证
- 验证启动:确认 Stash 首页处于运行状态,并检查系统状态栏或 VPN 设置是否出现对应连接状态。
- 验证节点:在策略组中确认当前选中的节点名称,避免只看到“已启动”就误以为节点可用。
- 验证网页:先访问普通网页,再访问实际需要使用的目标服务;两个结果不同,说明可能存在规则、DNS 或目标服务差异。
- 验证模式:记录规则模式结果,再短暂切换全局模式作对照。只有模式改变后结果也改变,才有理由优先检查规则分流。
- 验证更新:更新订阅后重新确认配置是否仍被选中、节点数量是否正常、策略组是否仍有有效出站。
不要把一次成功访问当成长期稳定证明,也不要把单次延迟或测速结果当成所有时段的结论。本文只提供配置与连接排查方法,不对任何第三方服务的持续可用性作保证。
常见问题
Stash 怎么导入订阅链接?
打开 Stash 设置,进入配置文件,选择从 URL 下载,粘贴 Stash、Clash Premium 或 Clash 格式订阅地址并下载;完成后选中配置,返回首页启动。若链接返回的是登录页、错误页或单节点内容,通常不能按完整配置直接导入,应先向提供方核对格式。
Stash 导入后没有节点怎么办?
先确认下载的配置确实被选中,再打开配置内容检查是否包含代理节点和策略组。如果配置只有策略组没有节点,或节点字段无法解析,应重新获取兼容 Stash/Clash 的完整配置;不要只反复切换代理模式。
Stash 启动了但网页打不开,怎么排查?
先换一个节点,再比较规则模式和全局模式。如果全局模式能访问而规则模式不能,优先检查规则和策略组;如果两种模式都不能访问,再检查节点、DNS、系统网络和其他 VPN 冲突。
Stash 支持 iPhone、iPad 和 Mac 吗?
Apple App Store 页面列出 iPhone、iPad 和 Mac 等平台,Mac 兼容条件包括 macOS 13.0 或更高版本及 Apple M1 或更高版本设备。具体兼容性、价格和当前功能以 App Store 页面为准。
Stash 订阅更新后,为什么手动修改不见了?
远程配置更新可能重新载入原始内容,直接修改远程配置不适合作为长期方案。需要保留的设置应考虑使用 Override 或本地配置,并在更新前备份原配置;不同配置的支持方式需要结合实际文件核对。
相关阅读
参考资料
- 快速上手 – Stash 用户文档(stash.wiki)
- Quick Start – Stash Wiki(stash.wiki)
- Stash - Rule Based Proxy App Store