Stash for Windows
新手入门

Stash 怎么导入节点:订阅设置方法说明

本文从订阅来源、配置文件与策略组引用入手,梳理 Windows 版 Stash 导入节点时的查看顺序与失败处理。

Stash 的节点来源主要有两种:一是直接粘贴或导入已有的 Clash YAML 配置,二是通过订阅链接拉取远程配置。理解这两条路径的差别,是搞清楚 stash怎么导入节点 的第一步。本文以桌面端(Windows)为例,说明从获取配置到查看 YAML、再到验证节点可用的完整过程,并给出常见失败情形的处理思路。

需要先说明:本站并非 Stash 官方途径,内容基于对官方文档与公开资料的理解整理,具体界面与行为请以你安装的版本和官方文档为准。

一、先弄清 Stash 的配置模型

Stash 在桌面端通过后台服务与托盘界面协同工作:后台服务负责加载配置、启动 HTTP 引擎、执行规则匹配与路由,托盘界面负责展示状态、切换节点与策略组。安装后台服务通常需要管理员权限,因此首次安装或更新服务时,系统会弹出提权提示,这是正常现象。

官方文档涵盖的对象包括配置文件、规则、订阅、策略组、HTTP 引擎与脚本。Stash 的内核兼容 Clash 配置标准,这意味着一个结构正确的 Clash YAML 可以直接作为 Stash 的配置来源;反过来,你在 Stash 中维护的配置也应保持 Clash 标准下的字段结构,才能被内核正确解析。

由此可以得出一个重要判断:导入节点的本质是把一份含 proxies 与 proxy-groups 的 YAML 交给 Stash 内核。订阅只是“自动获取这份 YAML”的方式,手动导入则是“自己提供这份 YAML”的方式。两者最终都要落到同一份配置上。

二、stash添加订阅:通过订阅链接导入

步骤 1:准备订阅链接

从你的服务提供方处获得订阅地址。订阅地址通常返回一份 YAML 文本,而非网页。可以先在浏览器中打开该链接确认:若浏览器直接显示大段 YAML 文本或触发下载,说明链接形态正确;若显示登录页、错误提示或 HTML 页面,则订阅本身有问题,先解决它再谈导入。

桌面客户端配置文件与策略组设置示意图
示意图:在桌面配置面板整理策略组

步骤 2:在 Stash 中添加订阅

在托盘界面进入订阅管理入口,新增一条订阅,填入名称与订阅地址。部分版本支持设置自动更新间隔,建议开启,便于后续节点变动时自动同步。保存后触发一次手动更新,观察是否成功拉取。

步骤 3:让订阅内容生效

订阅拉取成功不等于节点已可用。需要确认该订阅生成的配置被设为当前生效配置,内核才会按其中的 proxies、proxy-groups 与 rules 建立连接与路由。若同时存在多份配置,注意区分“已下载”与“正在使用”。

三、stash添加节点:手动导入与单节点补充

当你不使用订阅,或需要在现有配置中补充节点时,可选择手动导入。

方式 A:导入完整 YAML 文件

将本地 YAML 文件导入 Stash 的配置目录或通过界面导入。导入后查看文件是否为合法 YAML:缩进必须使用空格,不能用制表符;冒号后需有空格;列表项的短横线与内容之间需有空格。这些细节看似琐碎,却是导入失败最常见的原因。

方式 B:在配置中手工追加节点

在 proxies 列表下按 Clash 标准追加节点条目,字段包括名称、类型、服务器、端口以及该协议所需的认证或加密参数。添加后必须同步处理两处:一是把节点名加入合适的 proxy-groups 的 proxies 列表,否则该节点虽存在却无法被策略组选中;二是确认规则能命中该策略组,否则流量不会走到新节点。

这一步是 stash添加节点 中最容易出错的地方——很多人只改了 proxies,忘了策略组引用,结果“导入了却用不上”。

四、配置查看:逐项检查 YAML

导入或添加完成后,建议按以下顺序查看配置,而不是急着测试连通性。

第一,看 YAML 结构。 确认顶层存在 proxies、proxy-groups、rules 三个关键段落,且缩进层级正确。任何一处缩进错误都可能导致整份文件解析失败。

第二,看节点字段。 每个节点应具备唯一且易读的名称、正确的类型标识、服务器地址与端口。名称重复会导致引用歧义,务必保证唯一。

第三,看策略组引用。 检查每个 proxy-groups 中列出的节点名是否都能在 proxies 中找到对应项。引用不存在的名字,轻则该组失效,重则配置加载报错。同时注意策略组的类型设置是否与你的使用意图一致。

第四,看规则与路由。 规则按顺序匹配,靠前的规则优先。确认关键规则指向的策略组确实存在,且该组内有可用节点。规则引用不存在的策略组,同样会造成加载或路由异常。

第五,看订阅与本地配置的关系。 若订阅开启了自动更新,本地手动修改可能在下一次更新时被覆盖。需要长期保留的改动,应放在不会被订阅覆盖的位置,或关闭该订阅的自动更新。

第六,看脚本与 HTTP 引擎相关配置。 官方文档包含脚本与 HTTP 引擎能力,若配置中引用了脚本,需确认脚本路径或内容可被正确读取;引用了不存在的脚本同样会引发加载问题。

五、失败处理:按现象定位

现象一:订阅更新失败。 先在浏览器验证订阅地址是否可访问、是否返回 YAML。若地址本身正常,检查网络环境是否影响了对该地址的访问,以及订阅是否需要特定请求头。不要反复重试同一地址,先确认链接有效性。

桌面客户端路由规则整理流程示意图
示意图:在桌面面板梳理路由规则

现象二:配置加载报错。 多为 YAML 语法问题。逐段注释排查:先只保留 proxies 与最小的 proxy-groups,确认能加载,再逐步加回规则与其他段落,定位出错位置。缩进与冒号空格是首要怀疑对象。

现象三:节点已导入但无法选中。 回到策略组引用检查:节点名是否被写进某个策略组,策略组是否被规则或当前选择使用。命名不一致(多一个空格、大小写不同)是常见原因。

现象四:界面正常但无流量。 检查当前生效配置是否正确、HTTP 引擎是否已启动、规则是否把目标流量导向了预期策略组。托盘界面通常能反映服务运行状态,后台服务未正常运行时应先修复服务,再谈节点。

现象五:服务安装或启动异常。 安装服务需要管理员权限,权限不足会导致安装不完整。以管理员身份重新安装服务通常可解决此类问题;若仍异常,查看日志定位。

六、注意事项

  • 配置与订阅中可能含有账号凭据,妥善保管,不要随意分享含敏感信息的 YAML 截图。
  • 订阅自动更新会覆盖本地改动,长期自定义内容应独立维护。
  • 保持配置符合 Clash 标准,是 Stash 内核正确解析的前提;使用非标准字段前先确认兼容性。
  • 规则顺序影响路由结果,调整规则时注意前后依赖。
  • 桌面端依赖后台服务运行,服务状态异常时,界面上的任何操作都可能不生效。
  • 本文基于公开资料整理,非官方说明;遇到版本差异,以官方文档与实际界面为准。

综上,stash怎么导入节点 可以归纳为一条主线:先获得结构正确的 Clash YAML(订阅或手动),再让 Stash 加载并生效,最后按 proxies、proxy-groups、rules 的顺序逐项查看引用一致性。掌握这条主线后,无论是 stash添加订阅 还是 stash添加节点,都能快速定位问题所在;而 stash节点订阅 的日常维护,也只需关注订阅更新与本地改动的冲突即可。