下载与安装

Stash for Mac 的最低系统版本要求是什么？

软件面向 macOS，明确要求 macOS 12.4 或更高版本。Mac 安装包同时支持 Apple 芯片和 Intel 处理器架构。

应该从哪里获取 Mac 版的官方安装包？

Mac 版安装包从官方 releases.stash.ws 地址直接下载。当前 Release 页显示的构建

Stash for Mac 的授权价格是多少？支持哪些授权类型？

官方页面列出个人版、家庭版和终身版授权，官方 Mac 页面标注价格为 P 并链接到 Mac 版价格页。官方页面明确标注 Mac 版与 iOS 版分开销售。

更换 Mac 设备后，授权如何迁移？

官方页面介绍了专门的授权管理页面。用户可登录该后台激活授权、查看并管理设备，并在更换硬件时进行转移授权。

订阅与连接

Stash 是如何接管整机网络流量的？

Stash 基于 Apple 的 Network Extension 框架接管 Mac 的整机网络流量。网络流量将根据预设的分流规则进行路由、重定向或拦截。

Mac 版的 YAML 配置文件能和手机端通用吗？

可以。官方页面明确说明同一份 YAML 配置可用于 macOS、iOS 与 Android 版本，多端之间可直接复用分流规则与策略。

软件支持对网络请求进行检查与修改吗？

支持。客户端内置 HTTP 引擎可捕获并修改请求与响应，并且官方页面说明可使用 JavaScript 处理网络请求。

安全与隐私

官方文档入口为 stash.wiki，Mac 安装包请通过官方 releases.stash.ws 地址获取。

Stash 项目是否开源？

根据 kexuezj 条目记录，该项目标为源码未公开。软件的运行机制与具体细节以官方发布和官方文档为准。

准备开始进行配置？

查阅快速上手教程，了解从下载安装、激活授权、载入 YAML 配置到启动分流接管的完整步骤。

前往快速上手教程

Stash for Mac 常见疑问

1. 从官网下载安装包失败怎么办？

先从官方下载页 https://stash.ws/zh/download 重新获取链接。若浏览器下载中断，可换用其他网络或下载工具重试。Mac 安装包直链为 https://releases.stash.ws/Stash-latest.dmg，当前版本以官方发布为准，不要相信第三方转存。还可以尝试在下载页重新点击获取，这本身就是官方提供的多来源获取方式。仍失败时，用官方文档 https://stash.wiki/ 查看安装要求，确认系统与安装条件是否满足。

2. 提示“配置文件无效”是什么原因？

Stash 使用 YAML 配置，格式错误、缩进不一致或字段拼写错误都会导致校验失败。同一 YAML 可用于 macOS、iOS、Android，因此可先在能正常导入的设备上验证，再复制到 Mac。建议对照官方文档 https://stash.wiki/ 检查配置结构，不要自行添加文档未说明的字段。若多台设备都导入失败，问题多半在配置本身，可逐项查看键名、缩进与取值类型。

3. Mac 版对系统有什么要求？

Stash for Mac 要求 macOS 12.4 或更高版本，同时支持 Apple 芯片和 Intel 架构。系统版本过低时，应用可能无法安装或运行异常。下载前可先在“关于本机”中确认系统版本与芯片类型，再前往官方下载页选择合适的安装包。若系统不满足要求，换下载来源或重试安装也无法绕过，应先升级系统或改用符合要求的设备。

4. 安装包如何区分 Apple 芯片与 Intel？

官方提供统一的 Mac 安装包，地址为 https://releases.stash.ws/Stash-latest.dmg，可在 Apple 芯片和 Intel 机型上使用。当前版本与兼容信息以官方发布为准，不要从非官方来源获取改包。下载前可先查看官方文档 https://stash.wiki/ 了解安装说明。用户不必在两种芯片之间自行挑选不同的下载地址，按官方入口获取即可，安装失败时优先排除网络与文件完整性问题。

5. 应该从哪些官方入口获取软件和文档？

下载页为 https://stash.ws/zh/download，Mac 直链为 https://releases.stash.ws/Stash-latest.dmg，官方文档在 https://stash.wiki/。建议通过官网引导进入下载，不要使用搜索引擎广告位或论坛转发的链接。若直链下载失败，回到下载页重新获取，属于多来源获取方式。文档与安装包都应以官方入口为准，第三方转存或改包无法保证与官方发布一致。

6. 同一份配置能否用于多台设备？

可以。Stash 的 YAML 配置可在 macOS、iOS、Android 上通用，便于在不同设备间保持一致。把同一配置文件分别导入各设备即可，但要注意各平台支持的字段可能受版本影响。遇到导入失败时，优先用官方文档 https://stash.wiki/ 查看配置写法。跨设备共用配置只说明文件可通用，并不代表各平台的授权也通用，购买与使用仍需按平台分别确认。

7. 如何用官方文档排查配置问题？

打开 https://stash.wiki/，按配置结构逐项查看键名、缩进与取值类型。可先简化配置，确认基础字段通过校验后再逐步加入规则。文档是判断字段是否受支持的主要依据，不要依据来源不明的片段修改配置。必要时可从官方下载页重新获取安装包，排除安装文件损坏。若简化后仍提示无效，说明问题可能出在基础结构，应回到文档查看整份配置的组织方式。

8. Mac 与 iOS 的授权是通用的吗？

不是。Stash 的 Mac 与 iOS 授权分开销售，购买其中一端的授权不能用于另一端。跨设备使用同一 YAML 配置不代表授权通用。购买前应确认所需平台，并以官方页面说明为准。若同时使用 Mac 与 iOS，需要分别确认各平台的授权情况，不能因为配置文件相同就认为一端授权可覆盖另一端。

9. Stash 在 Mac 上如何接管流量？

Stash 通过 Network Extension 接管系统流量，可按规则对流量进行路由、重定向或拦截。内置 HTTP 引擎可捕获和修改请求与响应，并可用 JavaScript 处理请求。具体配置方式请以官方文档 https://stash.wiki/ 为准，不要依据非官方教程推测功能。文档也是查看字段与功能边界的主要依据，遇到与文档不一致的说法时，应

Stash for Mac 常见问题