分步配置流程

按照以下通用步骤完成安装、授权激活、配置文件载入与分流接管。

01 安装部署

下载与安装

从官方 releases.stash.ws 地址获取 Mac 版安装镜像。该客户端要求 macOS 12.4 或更高版本，同时兼容 Apple 芯片与 Intel 处理器。下载完成后将客户端放入系统的应用程序目录。

提示：版本信息以官方发布为准，具体安装步骤以官方文档为准。

02 授权与配置

导入订阅或配置

通过官方授权管理页面激活个人版、家庭版或终身版授权并管理设备。获取服务订阅后，将通用 YAML 配置文件导入客户端。官方页面说明同一份 YAML 配置可用于 macOS、iOS 与 Android 版本。

提示：配置导入方式与界面按钮名称以官方文档为准。

03 网络接管

启动连接

在客户端中启动代理开关。Stash 基于 Apple 的 Network Extension 框架接管 Mac 的整机流量，网络流量将根据预设的分流规则自动路由、重定向或拦截，无需复杂手动改动。

提示：首次启动系统扩展权限提示请按系统要求允许，具体以官方文档为准。

04 运行验证

检查是否生效

通过访问目标网络验证分流规则是否已正常执行。客户端内置 HTTP 引擎可捕获并修改请求与响应，并支持使用 JavaScript 处理网络请求，可确认流量是否已符合分流预期。

提示：高级改写与规则验证技巧请查阅 stash.wiki 官方文档。

访问 stash.wiki 官方文档前往下载页面

Stash for Mac 配置指南：从安装到规则排错的完整思路

这篇 Stash for Mac 教程围绕一个目标展开：让 Mac 上的网络流量按你整理的 YAML 配置被接管、分流和观察。Stash for Mac 要求 macOS 12.4+，支持 Apple 芯片和 Intel 两种机型；它基于 Apple Network Extension 接管 Mac 网络流量，流量可以按分流规则路由、重定向或拦截，内置的 HTTP 引擎能捕获和修改请求与响应，官方页面也说明可用 JavaScript 处理网络请求。文中提到的机制和入口都以官方文档为准，具体安装包请以官方发布页显示的构建为准。

一、准备：先明确系统与环境边界

动手前先查看 Mac 的系统版本，确认不低于 macOS 12.4。芯片类型不需要纠结，Apple 芯片和 Intel 都在支持范围内，但下载时仍要留意安装包与系统是否匹配。Stash 依赖 Apple Network Extension 工作，这意味着安装后需要在系统层面允许网络扩展接管流量，准备阶段可以先想清楚：哪些流量要走规则、哪些需要被拦截、哪些请求希望被 HTTP 引擎捕获并修改。

配置文件同样要提前准备。Stash 使用 YAML 作为配置载体，分流规则、重定向和拦截逻辑都写在这份配置里。官方页面说明同一份 YAML 配置可用于 macOS、iOS、Android，因此在 Mac 上整理配置时，就应当把它当作跨设备的共用文件来对待，而不是只为本机临时拼凑。

二、安装入口查看：以官方发布为准

安装包入口是 https://releases.stash.ws/Stash-latest.dmg 。需要强调的是，Release 页当前显示的构建以官方发布为准，不要根据第三方转述推断版本或内容。下载来源可以从多个方向查看：一是官方文档 https://stash.wiki/ 中给出的说明与链接，二是上述 releases 入口本身，三是官方页面中提到的其他分发说明。无论走哪个来源，最终都应回到官方发布页确认构建状态，再决定是否安装。

下载完成后按常规方式安装，首次启动时留意系统对 Network Extension 的授权提示。这一步是 Stash 接管网络流量的前提，授权不到位，后续的分流、重定向和拦截都不会按预期生效。安装入口查看的意义就在这里：确认来源、确认构建、确认系统允许，三者都清楚之后再进入配置环节。

三、配置文件整理：按用途分区

整理 YAML 时，建议按用途分区，而不是把所有内容堆在一起。分流规则负责决定流量走哪条路径；重定向与拦截是对特定流量的处理方式；HTTP 引擎相关的部分则服务于请求与响应的捕获和修改，官方页面说明可用 JavaScript 处理网络请求，因此涉及脚本逻辑的内容应单独归置，便于日后排查。

整理时保持命名和层级一致，避免同一类规则散落在多处。由于这份 YAML 还要用于 iOS 和 Android，整理阶段就要考虑可移植性：不写入只对 Mac 有意义的临时内容，不把本机特有的路径或状态混进共用配置。配置文件越干净，导入前的检查就越容易做。

四、导入前检查：先看结构再看内容

导入前先做结构检查：YAML 的缩进、层级和字段是否完整，分区之间是否有明显冲突。再做内容检查：分流规则是否覆盖了你关心的流量类型，重定向和拦截的目标是否明确，涉及 HTTP 引擎和 JavaScript 的部分是否与官方文档描述的能力范围一致。

这一步不需要追求一次到位，而是要把问题暴露在导入之前。配置里的每条规则都应有明确意图，写不清意图的规则宁可先删掉。检查完成后，再通过 Stash 的配置导入入口载入文件，并确认载入的是你整理过的那一份。

五、连接后观察：用现象验证配置

连接之后不要只看“是否连通”，而要观察流量是否按规则被路由、重定向或拦截。分流规则生效时，不同流量应走向不同路径；拦截规则生效时，对应流量应被阻止；HTTP 引擎工作时，请求与响应应能被捕获，需要时可按配置修改。观察的重点是现象与预期是否一致，而不是某个抽象指标。

如果现象与预期不符，先回到配置本身，确认规则顺序、匹配条件和目标是否写对，再确认 Network Extension 是否处于正常工作状态。观察阶段不做无依据的推断，也不把未确认的结果当作结论。

六、规则排错：从单条规则入手

排错时按单条规则定位：先确认这条规则是否被匹配，再确认匹配后执行的动作是否符合预期。分流、重定向、拦截三类动作要分开验证，避免把路由问题误判为拦截问题。涉及 HTTP 引擎和 JavaScript 的部分，则要确认脚本处理的是请求还是响应，以及处理结果是否被后续规则覆盖。

排错过程中保持配置可回溯：每次只改一处，改完再观察。官方文档 https://stash.wiki/ 是判断机制和用法的主要依据，遇到不确定的行为先对照文档，而不是凭猜测添加规则。

七、跨设备复用边界：同一份配置，不同环境

同一份 YAML 可用于 macOS、iOS、Android，这是 Stash 的便利之处，但复用有边界。Mac 上基于 Network Extension 的接管方式与其他平台的环境并不完全相同，配置中依赖具体运行环境的部分应保持克制。共用配置应聚焦规则和逻辑本身，把与单一平台强绑定的内容隔离出去。

复用时先在小范围验证，再推广到其他设备。配置在不同设备上表现不一致时，回到共用部分检查是否有隐含的平台假设，而不是在各设备上分别打补丁。

八、注意事项

- 系统版本以 macOS 12.4+ 为底线，芯片类型支持 Apple 芯片和 Intel，但仍需查看安装包与系统。

- 安装包以 https://releases.stash.ws/Stash-latest.dmg 所在 Release 页显示的构建为准，下载走多来源查看，最终回到官方发布。

- Network Extension 授权是接管流量的前提，授权异常时先处理系统层面问题。

- 分流、重定向、拦截和 HTTP 引擎的行为都以官方文档 https://stash.wiki/ 为准，不自行推断未确认的菜单、版本或结果。

- YAML 配置按用途分区整理，保持可移植，导入前完成结构与内容检查。

- 排错从单条规则入手，每次只改一处，保持配置可回溯。

以上内容不构成官方说明，仅为基于已确认事实的配置思路整理。

Stash for Mac 使用教程