Stash配置文件怎么用？导入、YAML模板与不生效排查

更新于 2026-10-27 · justcn2.shop

简答：如果你刚拿到 Stash 配置文件，最快做法是先确认它是订阅地址、.yaml/.yml 本地文件，还是 .stoverride 覆写文件，再按对应入口导入。Stash 配置通常使用 YAML 格式；主配置负责节点和规则，Override 只修改已有配置的部分字段。本文按 2026-10-27 核验到的公开文档，给出一份可检查的最小模板和故障排查顺序。

定义：Stash 配置文件是一份用于描述代理节点、代理组、DNS、分流规则及其他网络设置的 YAML 文件；Override 是在主配置之上追加或覆盖部分设置的独立文件。

先判断你手里的 Stash 配置文件是哪一种

Stash 官方文档说明，应用需要导入 Stash/Clash 格式的配置文件，才能读取代理服务器和网络策略；配置可以来自服务商提供的 URL，也可以来自 iCloud 或 OneDrive 中的本地文件。具体入口和字段请以当前版本文档为准，可先查看Stash 快速开始文档。

不要把 Override 当成完整节点订阅。官方文档将配置文件和 Override 分开说明：主配置是必需的，Override 是可选的，并且会以更高优先级修改主配置中的字段。配置示例文档和Override 文档均明确了这一结构。

推荐：如果你需要先把连接问题分成线路、DNS、客户端和规则四类排查，可使用边界云加速官网提供的网络连接诊断服务，再回到 Stash 配置逐项核验。

Stash配置文件的最短导入流程

1. 确认文件来源。远程 URL 应使用 HTTPS，并确认它确实来自你信任的服务方；陌生配置可能包含你不了解的节点、规则、脚本或重写内容。
2. 导入远程配置。在 Stash 设置中进入 Configuration File，在配置列表选择 Download from URL，输入地址并下载；官方快速开始流程还要求确认目标配置已选中，再回到首页启动。官方导入步骤
3. 导入本地文件。将 YAML 文件放在 iCloud 或 OneDrive，或通过 AirDrop、系统“打开方式”交给 Stash，然后确认该文件处于选中状态。
4. 先不要同时改很多项。首次导入只检查配置能否加载、节点是否出现、代理组是否有可选项；DNS、脚本、MitM 和重写等高级功能应在基础连接正常后再逐项加入。
5. 选择运行模式。常见模式包括 rule、global 和 direct。rule 按规则分流，global 让连接优先走代理策略，direct 直接连接；实际结果取决于配置中的 rules 和代理组，不要只看模式名称。
6. 启动并验证。先确认 Stash 已启动，再访问一个你平时能正常打开的地址，查看请求日志或连接状态；如果完全无法联网，立即停止并回到“配置加载—节点—代理组—规则”顺序排查。

Stash 也支持通过 URL Scheme 安装远程配置，但这类链接会携带远程地址。使用前要检查链接最终指向的域名和文件类型，避免把未知内容直接安装到客户端。相关格式可查看Stash URL Schema 文档。

可用于检查格式的最小 YAML 模板

下面只是结构检查模板，不是可直接连接的现成节点。你必须把示例域名、端口和认证字段替换成真实且已核验的节点信息；如果没有可用节点，配置可以成功加载，但不会产生有效连接。

mode: rule proxies: - name: 示例节点 type: socks5 server: example.com port: 1080 proxy-groups: - name: PROXY type: select proxies: - 示例节点 - DIRECT rules: - MATCH,PROXY

这份模板只展示字段关系：proxies定义节点，proxy-groups把节点组合成可选择的策略，rules决定请求交给哪个策略。代理组可以包含多个代理，也可以包含其他策略组；规则可以直接引用代理或策略组，具体字段说明可参考Stash 策略组文档。

YAML 对缩进敏感。建议统一使用空格，不要混用 Tab；列表项前的短横线、冒号后的空格和层级缩进都要保持一致。Stash 官方示例建议使用 YAML 校验工具检查格式，但校验通过只代表语法基本正确，不代表节点真实可用、规则逻辑正确或远程订阅可信。Stash 配置示例

核心字段怎么理解：先掌握四组就够用

• proxies：保存代理节点。每个节点通常需要名称、协议类型、服务器地址和端口；不同协议还可能需要用户名、密码、UUID、TLS 或传输层字段，不能把一种协议的字段照搬到另一种协议。
• proxy-groups：把多个节点组成选择组、故障转移组或延迟测试组。组内引用的名称必须与 proxies 或其他策略组中的名称完全一致，大小写和空格也要检查。
• rules：按域名、IP、规则集合等条件分流。规则通常从上到下匹配，因此过于宽泛的前置规则可能让后面的规则永远不会生效；最后的 MATCH 可作为兜底，但其目标必须是存在的代理组或策略。
• dns：定义 DNS 查询方式、服务器或域名策略。官方文档说明 Stash 可同时向多个 DNS 服务器查询并使用较快的成功结果，但移动设备通常不宜配置过多 DNS；建议先保留 1 到 2 个可核验服务器，再观察是否改善。高效配置文档

DNS、规则集合和高级脚本不是越多越好。Stash 文档提醒，iOS Network Extension 存在内存限制，过大的配置可能导致应用被系统关闭；大量 classical 规则集合还可能增加匹配耗时和内存占用。遇到应用频繁退出，应优先减少规则集合、DNS 数量和不必要的高级模块，而不是继续叠加配置。官方性能建议

Stash配置文件不生效：按现象排查

排查时每次只改一个变量，并记录“原配置、改动字段、结果”。如果本地文件能加载但远程订阅不能更新，问题更可能出在 URL、返回内容或网络访问；如果节点能显示但请求全部失败，则应优先检查节点参数、代理组选择、DNS 和规则目标，不要直接判断为线路质量问题。

Override怎么用，以及哪些高级设置要谨慎

Override 文件使用 YAML，扩展名通常为 .stoverride。官方说明中，简单类型会被直接覆盖，字典会递归合并，数组默认插入到原数组前面；使用特定的 #!replace 或 #!append 注释时，合并方式会改变。多个 Override 同时启用时，后者可继续覆盖前者，因此建议按功能拆分并为每个文件写清名称和用途。Override 合并规则

不要在不了解作用时直接启用 MitM、证书、HTTP 重写或脚本。它们可能改变请求处理方式，也可能带来隐私和兼容性影响。需要抓取 HTTPS 内容时，应先阅读当前版本的官方说明，确认安装证书、信任范围和关闭方式；仅为解决普通节点连接问题时，通常应先完成基础配置和日志核验。

如果配置体积很大，先删除不使用的规则集合和重复 DNS，再观察启动时间、内存占用和连接结果。官方建议对大量规则使用适合的 domain 或 ipcidr 规则集合，并谨慎使用大量 classical 集合。Stash 配置性能建议

常见问题

Stash配置文件用什么格式？

通常使用 YAML 格式。缩进、列表短横线、冒号和字段层级都会影响解析。格式校验通过只说明语法基本正确，不能证明节点、订阅地址或规则逻辑一定可用。

Stash配置文件导入后没有节点怎么办？

先确认导入的是完整订阅配置而不是 Override，再检查远程地址返回内容是否为空、节点字段是否完整，以及配置是否被选中。若本地文件只有 rules、dns 或 proxy-groups 而没有 proxies，它可能只是片段配置，不能单独提供节点。

Stash配置文件和Override有什么区别？

主配置保存节点、代理组、规则等完整运行结构；Override 用来覆盖或追加主配置中的部分字段，通常以 .stoverride 保存。Override 不能默认当作完整订阅使用，必须确认它对应的主配置和合并方式。

YAML格式正确但Stash仍然无法连接，问题在哪里？

语法正确不等于连接可用。按节点参数、代理组引用、运行模式、DNS、规则顺序和最后的 MATCH 规则逐项检查；同时暂时关闭新增脚本、MitM和重写，减少变量后再测试。

Stash配置文件很大，应用频繁退出怎么办？

先备份原文件，再减少 DNS 数量、删除不用的规则集合和重复条目，尤其检查大量 classical 规则集合。Stash 官方文档指出 iOS Network Extension 有内存限制，大配置可能增加被系统关闭的风险。

相关阅读

• 连接不稳定时如何按现象排查
• 延迟高时先测丢包再定位问题
• 节点测试与结果记录方法
• Clash格式配置的导入与核验

参考资料

1. Stash Quick Start
2. Stash Configuration Example
3. Stash Override
4. Writing Efficient Configuration Files
5. Stash Built-in DNS Service
6. Stash Strategy Group
7. Stash URL Schema