Stash Mac 教程：从下载安装到完成首次连接
简答：很多人卡在下载错同名软件、Helper 反复弹窗或配置导入后无法连接。先确认 macOS 12.4 及以上，再从 stash.ws 官方页面下载安装，完成辅助工具权限、配置导入和策略组选择，最后分别测试浏览器与终端。
定义：Stash Mac 是运行在 macOS 上、通过 Apple Network Extension 管理整台 Mac 连接的规则式网络工具。
3 分钟速查：先确认这 4 项
本文页面名称为 Stash Mac 教程，对应软件信息以 stash.ws 官方 Mac 页面为准，本站仅提供操作说明，不是官方站点。其他同名的媒体整理软件、密码管理工具与本文无关；辨认时应以官方域名 stash.ws 和页面中的 macOS 版本说明为准。核对日期：2026-10-24。
| 项目 | 查看位置 | 通过标准 |
|---|---|---|
| macOS 版本 | 苹果菜单—关于本机 | macOS 12.4 或更高版本 |
| 芯片类型 | 关于本机—芯片或处理器 | Apple 芯片与 Intel 均支持 |
| 软件来源 | stash.ws 下载页面 | 从官方页面获取当前 macOS 安装包 |
| 首次连接条件 | 配置页面与主界面 | 配置列表有条目、能看到更新时间，并已选为当前配置 |
官方页面列明 Stash Mac 要求 macOS 12.4 及以上，同时支持 Apple 芯片与 Intel；下载页面提供 macOS 直接下载入口。查看官方运行要求 查看官方下载页
下载安装 Stash Mac：按官方入口操作
- 打开 Stash 官方下载页，进入 macOS 下载入口。页面说明该版本同时适配 Apple 芯片与 Intel，不需要按芯片另选安装包。
- 下载完成后，按安装包中的官方提示完成安装，并从“应用程序”启动 Stash。若系统提示无法确认开发者，先关闭安装流程，重新核对下载页面与文件来源，不要运行来历不明的副本。
- 首次启动时，Stash 可能要求输入 Mac 登录密码，以安装用于管理系统级网络设置的辅助工具。只在应用确认来自 stash.ws 时输入密码。
- 完成辅助工具安装后，回到 Stash 主界面，先确认应用处于运行状态，再开始导入配置。不要同时启动多个会修改系统网络设置的工具，以免排查时无法区分影响来源。
官方 Mac 页面说明，Stash 通过 Apple Network Extension 处理整台 Mac 的连接，因此设置影响范围可能不只限于浏览器，也可能涉及终端和桌面应用。查看官方功能说明
macOS 12、13、15 的后台权限入口对照
辅助工具需要管理员权限；如果安装后反复弹窗，先检查后台运行权限。macOS 的菜单名称会随版本变化，以下路径以当前系统显示为准。
| 系统版本 | 入口参考 | 重点检查项 |
|---|---|---|
| macOS 12 | 系统偏好设置—用户与群组—登录项 | 检查 Stash 是否在登录项中，必要时重新启动应用 |
| macOS 13 | 系统设置—通用—登录项 | 在“允许在后台”中开启 Stash 或 Stash Networks Limited |
| macOS 15 及更新版本 | 系统设置—通用—登录项与扩展 | 检查“应用后台活动”以及相关网络扩展状态 |
Stash 的 Helper 文档明确提到，macOS 13 的后台权限设置不正确，可能导致辅助工具无法工作；Apple 当前文档也将后台活动开关放在“系统设置—通用—登录项与扩展”。查看 Stash Helper 官方排查文档 查看 Apple 后台活动说明
如果系统界面与表格不同，不要按旧路径反复寻找，直接在“系统设置”顶部搜索“登录项”或“后台活动”，再确认 Stash 相关项目是否允许运行。
导入配置并完成第一次连接测试
- 向管理员或服务提供方获取配置获取地址。确认来源可信、用途明确，不要把包含账号信息的地址转发到公开群组。
- 打开 Stash，进入设置页面，选择“Configuration File”或中文界面中对应的“配置文件”入口。
- 在配置列表中选择“Download from URL”或“从地址下载”，粘贴配置获取地址并点击下载。官方快速开始文档给出的流程就是先进入配置文件，再从地址下载。
- 下载完成后，配置列表应出现新的条目。检查名称、更新时间和文件状态；若没有新增条目，先确认地址完整，再检查当前网络是否能打开该地址。
- 点击刚导入的配置，使其成为当前配置。回到主界面后，选择一个策略组中的明确线路条目，先不要修改大量规则。
- 点击主界面的启动或启用按钮，先用浏览器打开一个常用页面测试，再测试目标办公系统。每次只改一个设置，并记录修改前后的结果。
Stash 官方文档说明，应用需要配置文件来定义连接方式和网络规则，远程配置可以从服务提供方地址获取；Mac 页面还说明同一份 YAML 配置可在多个支持设备间复用。查看官方快速开始文档 查看官方配置说明
导入成功的表现：配置列表中出现可识别条目，能看到更新时间；当前配置被选中；主界面可以启动；策略组中能看到可选择的线路条目。缺少其中一项时，先不要判断为网络故障。
规则、统一设置与直连：第一次该怎么选
| 模式或设置 | 适合场景 | 排查时的用法 |
|---|---|---|
| 规则模式 | 日常办公，希望不同域名、地址或应用按配置处理 | 长期使用前优先选择，实际效果取决于配置中的规则 |
| 统一策略 | 临时确认某个策略组是否能建立连接 | 只用于短时间测试，确认后恢复常用规则 |
| 直连 | 本地服务、公司内网或不需要特殊线路的地址 | 用于判断问题是否只出现在特定线路或规则 |
| 增强模式 | 需要让更多桌面应用遵循统一连接设置 | 影响范围更大，排查时一次只开启或关闭一个选项 |
浏览器测试成功后，再测试终端、邮件客户端或办公软件。如果只有一个应用异常，先检查该应用自己的网络连接设置、DNS 设置或安全策略，不要立即更换整份配置。Stash 官方页面说明，Network Extension 会让规则作用于整台 Mac 的应用连接；因此增强模式或相关系统级设置变化后，应重新观察受影响的应用范围。查看官方 macOS 功能说明
Helper 反复弹窗：从权限到重装的顺序
- 退出 Stash 并重新打开，确认输入的是 Mac 登录密码，而不是其他账号密码。
- 按照上方版本表检查后台运行权限，macOS 13 及更新版本重点查看“系统设置—通用—登录项与扩展”。
- 暂时检查清理软件或安全软件是否阻止、删除了 Stash 相关文件。Stash 官方文档提示，这类软件可能导致 Helper 无法运行或应用反复要求激活。
- 重启 Mac，再从 Stash 内重新执行辅助工具安装。
- 如果仍然失败，再按照官方文档提供的终端命令清理旧 Helper 并重新加载服务。命令涉及系统目录和管理员权限，执行前应确认应用来源、逐字核对路径，并保留必要数据。
sudo rm -rf /Library/PrivilegedHelperTools/ws.stash.app.mac.daemon.helper
sudo /bin/launchctl load -w /Library/LaunchDaemons/ws.stash.app.mac.daemon.helper.plist
完成命令后重启 Mac，再打开 Stash 重新安装辅助工具。如果终端提示服务已经加载或操作正在进行，官方文档说明可忽略该提示；仍无法解决时，应联系官方支持。查看命令来源与完整步骤
关闭 Stash 后仍无法联网：检查系统网络设置残留
如果关闭 Stash 后，浏览器和桌面应用仍无法连接，可能是系统网络设置仍保留了手动设置或扩展状态。以下步骤用于恢复检查，不代表每台 Mac 都会出现残留。
- 先关闭 Stash，等待 10 秒，再重新打开浏览器测试。
- 如果问题仍在，进入“系统设置—网络”，选择当前使用的 Wi-Fi 或有线网络，打开“详细信息”。macOS 旧版本可能显示为“系统偏好设置—网络—高级”。
- 检查代理、DNS、过滤器或手动地址等项目是否是你此前为 Stash 或其他软件设置的内容。不了解用途的项目不要直接删除，先截图记录原值。
- 如果确认某项是临时测试留下的设置，恢复为自动或系统默认状态，点击“好”或“应用”，然后断开并重新连接当前网络。
- 重新打开 Stash，只启用一项功能测试。若关闭 Stash 后恢复正常，说明问题更可能与当前配置、辅助工具或系统网络设置有关；若仍不通，则回到本地网络、DNS 和应用自身设置排查。
Apple 的网络设置入口会因 macOS 版本变化，具体名称以当前系统为准。涉及公司设备、管理策略或证书的设置，先咨询管理员，不要自行删除组织配置。
浏览器能用但终端或桌面应用不通
- 确认 Stash 主界面仍处于启用状态，并确认当前配置没有自动切回默认配置。
- 检查目标应用是否使用独立的网络连接设置、独立 DNS、证书校验或登录安全策略。应用内设置可能覆盖 macOS 的系统网络设置。
- 在终端执行解析测试：
nslookup example.com。如果解析失败，优先检查 DNS 和当前网络。 - 再执行 HTTPS 测试：
curl -I https://example.com。如果浏览器正常但命令失败，说明两者可能采用了不同的连接路径。 - 若应用支持填写本地连接端口，必须使用配置提供方明确给出的地址和端口，不要自行猜测。
- 关闭 Stash 后重复执行同样测试，再重新开启并测试。通过“关闭、开启”两种状态对比，判断问题是否由当前配置、Helper 或系统网络设置引起。
如果问题集中在办公系统，可继续阅读站内的访问海外业务系统很慢的排查指南；如果还不确定线路如何选择，可查看网络加速线路选择方法。
安装完成后的自查清单
- macOS 已确认达到 12.4 或更高版本。
- 已核对 Apple 芯片或 Intel 类型，并从 stash.ws 获取安装包。
- 已完成辅助工具安装，后台运行权限处于开启状态。
- 配置获取地址来自可信来源，配置列表出现条目并显示更新时间。
- 当前配置已选中，策略组中能看到可选择的线路条目。
- 已先测试浏览器，再测试终端和目标办公应用。
- 关闭 Stash 后也做过一次对照测试。
- 遇到问题时一次只修改一个设置，并记录修改前后的表现。
- 涉及管理员密码、证书或系统级网络设置时，先确认来源与用途。
截至 2026-10-24，官方 Mac 页面列出的运行要求仍为 macOS 12.4 及以上，并支持 Apple 芯片与 Intel。下载入口、界面名称和权限路径可能随软件或 macOS 更新变化，遇到差异时以当前官方页面和系统提示为准。查看当前官方 Mac 页面
常见问题
Stash Mac 和 iOS 版需要分别购买吗？
需要。官方 Mac 页面说明，Mac 版授权与 iOS 版是分开销售的；iOS App Store 的购买不会自动解锁独立的 Mac 应用。具体授权方式以官方页面为准。
Apple 芯片和 Intel Mac 要下载不同版本吗？
通常不需要。官方 Mac 页面和下载页都说明，当前 Mac 版同时支持 Apple 芯片与 Intel，按 macOS 下载入口获取即可。
macOS 低于 12.4 可以安装 Stash Mac 吗？
官方运行要求是 macOS 12.4 或更高版本。低于该版本时，不建议强行安装，应先查看当前官方兼容说明或升级系统。
Helper 一直要求重复安装怎么办？
先检查后台运行权限，再退出并重启 Stash；如果仍失败，按照官方 Helper 文档清理旧服务、重启电脑并重新安装。终端命令涉及系统目录，执行前要核对来源和路径。
配置导入后没有线路条目怎么办？
先确认配置列表出现条目并有更新时间，再刷新配置并检查配置获取地址是否有效。如果配置内容为空、已过期或格式不兼容，需要向提供方重新获取有效配置。
为什么浏览器能用，终端却无法连接？
浏览器和终端可能采用不同的连接设置。可先用 nslookup 测试解析，再用 curl 测试 HTTPS，并检查目标应用是否使用独立的网络连接设置。
关闭 Stash 后仍然无法联网怎么办？
进入“系统设置—网络—当前网络—详细信息”，检查此前留下的 DNS、代理或其他手动设置。先记录原值，再恢复确认过的临时设置；公司设备应先咨询管理员。
增强模式应该一直开启吗？
不一定。它可能扩大统一连接设置的影响范围。建议先在需要测试更多桌面应用时开启，排查完成后根据实际使用场景决定是否保留。