Stash 使用教程:导入 Clash 配置与订阅

先说结论

Stash 客户端读取与 Clash 配置兼容的 YAML,你可以把整份配置导入,也可以只让节点用远程集合自动更新。能不能直接用,要看配置里的写法是否在官方文档的兼容范围内,导入后务必逐项核对。

StashApp Store 应用

类型
官方文档称是自研的 系iOS 付费客户端
内核
官方文档称是自研的
支持系统
Windows、macOS、安卓、iPhone / iPad
获取方式
App Store 付费应用,需要非中国大陆地区的 Apple ID;版本与价格以商店页面为准
官方地址
stash.ws/download

如果你原本就在用 Clash 系客户端,换到 iPhone 上,Stash 是少数能沿用 Clash 配置思路的选择。这篇 Stash 使用教程不教你从零写配置,而是帮你判断:手里这份配置能不能搬、订阅怎么挂、搬过去之后怎么确认没丢东西。客户端本身的定位和授权信息见 Stash 档案。

这份 Stash 使用教程适合谁,你先属于哪一种起点

不同起点,走的路不一样:

你的起点 建议做法 重点
服务提供方给了一个订阅链接 优先看对方给的是不是 Clash 兼容的配置 链接要当凭证保管
手里有一份自己维护的 YAML 导入后逐段核对 兼容范围看官方文档
只有若干节点链接 先转换成 Clash 配置再导入 用本地方式转换
完全没有节点 这篇帮不上,先去读订阅是什么 先弄清概念

没有节点的话,先读 机场订阅是什么,再回来。手里只有节点链接,则看 订阅转换怎么做才安全,不要把链接丢进陌生的在线转换站。

获取:它是付费应用,需要注意地区与授权

Stash 是 App Store 的付费应用,不在中国大陆区商店上架,需要其他国家或地区的 Apple ID。价格以商店页面为准。梯子岛不提供、也不引导任何共享账号,共享账号的风险见 共享账号靠谱吗,账号地区怎么处理见 苹果梯子怎么选。官方入口汇总在 下载导航。

授权方面,官方说明:

  • iOS/iPadOS 授权与 Mac 版授权互不通用;
  • iOS 授权有同时使用的设备数量上限,具体以官方页面为准;
  • Windows 与安卓版本官方标注为早期构建,本文不讨论。

导入方式一:把整份 Clash 配置放进去

这是兼容思路最直接的用法。通用步骤是:

  1. 在客户端里找到添加配置的入口,选择从链接下载或从文件导入,按钮叫法以当前版本为准。
  2. 粘贴订阅地址,或选取本地的 YAML 文件。
  3. 保存后打开这份配置的详情,先浏览节点、策略组、规则三大块是否都有内容。
  4. 切换为当前使用的配置,再开启连接。

关键提醒是“兼容”不等于“完全一致”。官方对内核的表述是自研的、与 Clash 配置标准兼容的加强型内核,字段层面的差别要以文档为准。配置文件的结构可以先读 Clash 配置文件怎么看,再回来对照。

导入方式二:让节点列表自己更新

如果你有自己的规则骨架,只想让节点跟着服务方变化,官方文档里的远程节点集合就是为这个设计的:配置里写一个集合,指定地址和更新方式,节点列表便按地址自动拉取。

这样分工的好处是:规则由你掌控,节点由服务方维护。更新后节点名可能变化,策略组里按名称引用节点的地方要留意,否则会出现引用失效。用名称过滤或自动选择的策略组,会比写死某个节点名更耐变化,策略组的类型区别见 Clash 策略组是什么。

导入方式三:托管配置和流量显示

官方还有一种“服务提供商托管配置”:在配置首行写上约定的订阅标记加地址,客户端就会定时更新这份配置,并读取订阅响应里的用量信息头,把已用流量显示出来。

使用时记住三点:

  • 首行写法只能照官方文档,多一个空格或少一个符号都可能失效;
  • 能不能显示流量,取决于服务方有没有返回对应信息,没显示不一定是客户端的问题;
  • 托管配置会被定时覆盖,你在里面手改的内容可能被冲掉,想保留自定义就另存一份。

订阅链接一旦外泄,别人就能以你的名义拉取,处理办法见 订阅链接泄露了怎么办。

搬配置时最容易踩的四个坑

照着下面的清单排一遍,能省下大半的来回折腾:

  • 规则集地址失效:原配置里引用的远程规则集如果换了地址,导入后规则会是空的,先逐个打开地址确认还能访问。
  • 策略组引用了不存在的节点:节点改名后,写死名称的引用会断,改成过滤或自动选择更耐变化。
  • 把电脑端的端口和系统代理设置也带过来:手机端不需要这些桌面习惯,保留不会报错,但也没有用,别因此怀疑配置坏了。
  • 一次改太多:先导入原样配置,确认能用,再一条条调整。出了问题才知道是哪一步引入的。

另外,WireGuard 在这个客户端里是转换成代理使用的,官方提醒吞吐量通常低于其他代理协议,不要拿它的表现去套别的协议。

导入后怎么核对,才算真的搬过来了

别只看“导入成功”四个字,建议逐项核对:

  1. 节点:数量和名字是否与原配置大体一致,缺失的节点多半是协议或字段未被识别。
  2. 策略组:能否正常选择,被引用的节点是否都存在。
  3. 规则:随便挑三五条分流条件,访问对应网站确认走向。
  4. 出口:用 IP 与 DNS 检测导航 看开关前后出口是否变化。
  5. DNS:出口对了但个别网站异常时,看 Clash DNS 设置详解。

出现订阅更新失败的情况,可以先看 Clash 订阅导入失败怎么办 的三问排查,思路大体通用。

读完 Stash 使用教程后建议这样走

这篇没有覆盖的

  • 兼容范围只引用官方文档里能核对的描述,没有逐字段对照测试,遇到未列出的字段请先在小范围试用。
  • 本文只写苹果设备上的操作思路,Windows 与安卓版本官方标注为早期构建,梯子岛没有它们的使用结论。
  • 不提供也不引导任何共享账号或来历不明的安装包,获取方式只看官方页面。
  • 没有速度、延迟或稳定性数据,节点好坏取决于你的订阅来源。

本文引用的官方来源

  1. Stash 官方文档(stash.wiki)
  2. Stash 官方主页(stash.ws)
  3. Apple App Store:Stash(apps.apple.com)

以上链接均为官方页面,梯子岛在 2026-10-09 核对过;个别网站会拦截自动化访问,用浏览器直接打开即可。平台规则可能随时调整,以官方页面当前内容为准。

Stash 使用教程常见问题

Stash 能直接用我在电脑上用的 Clash 配置吗?

官方称它与 Clash 配置标准兼容,所以大部分结构可以沿用,但并不等于每个字段都被支持。建议先导入后逐项检查节点、策略组和规则是否都被识别,有报错或缺失的部分再对照官方文档调整,不要整份照搬后就当作没问题。

订阅链接怎么放才能自动更新?

官方提供两条路:一是在配置里用远程节点集合,让节点列表按地址自动拉取;二是使用服务提供商托管配置,在配置首行写上约定的订阅标记和地址,它会定时更新。具体写法以官方文档为准,链接本身等同凭证,不要外传。

为什么装好之后在商店里搜不到?

它不在中国大陆区商店上架,需要使用其他国家或地区的 Apple ID 才能看到。地区切换的规则和限制以苹果官方说明为准,梯子岛不提供也不引导任何共享账号,请用自己的账号操作。

买了 iOS 版,Mac 版也能用吗?

官方说明两者的授权互不通用,需要分别购买。iOS 授权有同时使用的设备数量上限,具体数量与价格以官方页面和商店页面为准。换新设备前先看清楚授权规则,避免重复付费。

能在 Stash 里用 WireGuard 吗?

官方资料写明支持,但它是在用户态转换成代理来使用,官方也提醒吞吐量通常低于其他代理协议。是否适合你,取决于你的使用场景,建议自己跑一次对比再决定。

接着读

文中出现的术语

相关专题

接下来去哪儿?

找官方入口去网址导航,想核对仓库和版本看GitHub 项目导航;需要现成的机场,机场目录收了 28 家的价格与线路资料,性价比机场、便宜机场、VPN 机场分别有专项页。