Tutorial
Stash 新手完整使用教程
Stash 不是账号登录型客户端，它先读取一份 profile/YAML 配置，再用 Outbound、Policy 和系统代理能力决定流量走法。新手入口按 iOS / iPadOS 端、macOS 端和 tvOS 端分开走，也把 Stash 深度档案里的配置入口、Mac 系统代理、Apple TV 使用场景和 tvOS 边界讲清楚。配图只在能说明当前步骤时使用：官方截图讲界面，站内示意图讲流程，不拿无关产品图凑数。
先跑通
只用这 6 步跑通
先照这 6 步做。iPhone / iPad 能跑通以后，再看 Mac 系统代理、Apple TV 和高级 profile。
01
装对 Stash
先核对 Stash 覆盖 Apple 设备，iOS / tvOS 走 App Store，Mac 看官网入口。
02
复制 profile
机场后台找 Stash、Clash Premium、Clash 或 Mihomo profile/YAML 链接。
03
URL 导入
进 Settings / Config File / Configs，用 Download from URL 粘贴 profile。
04
选中配置
下载完成后确认当前 profile 被选中，别停在空配置或旧配置。
05
回首页启动
回 Home 点 START，第一次弹系统 VPN 权限时允许。
06
检测出口
先用 Rule 模式和主 Policy 跑通，再用 IP 检测看出口、DNS 和服务连通性。
准备工作
一台可以安装 Stash 的 iPhone、iPad、Mac 或 Apple TV；iOS / tvOS 走 App Store，macOS 看 Stash 官方网站下载入口。
机场后台提供的 Stash、Clash Premium、Clash 或 Mihomo profile/YAML 配置链接。
如果机场后台同时给 Lite profile 和 Normal profile，新手先用 Lite profile 跑通规则分流，Normal profile 留给排错或全局测试。
打开 52.mk IP 检测页，最后用出口 IP、DNS 和服务连通性核对结果。
操作步骤
按顺序操作，出问题时回到当前步骤的检查点，不要同时改多个地方。
Step 1
先认清 Stash 读什么
Stash 的入口不是账号密码，而是一份 Stash / Clash 格式配置。配置里包含节点、规则、策略组和部分功能开关。
1.1
确认你装的是 Stash
Stash 官方展示的是 Apple 端网络工具：iPhone、iPad、Mac 和 Apple TV 都有对应入口。下载前先核对名称、开发者和平台，不要把同名理财 App、第三方安装包或教程站按钮当成客户端本体。
点哪里
点哪里：按这一步找到 Mac、iPhone、iPad，先完成当前动作，不要顺手改其他开关。
成功标志
成功标志：界面里能看到 Mac、iPhone、iPad，并且可以继续下一步。
卡住先查
卡住先查：如果 App Store 搜不到，先检查 Apple ID 地区和设备兼容性；macOS 端优先从 Stash 官方网站进入下载或购买。
如果 App Store 搜不到，先检查 Apple ID 地区和设备兼容性；macOS 端优先从 Stash 官方网站进入下载或购买。
官方平台图
本图看哪里
1.2
分清 profile，不要复制错链接
机场后台给的 Stash、Clash Premium、Clash 或 Mihomo 链接，本质上都是让 Stash 下载一份 profile/YAML。Lite profile 通常更适合新手日常规则分流，Normal profile 信息更完整，适合排错、全局测试或需要完整配置的人。
点哪里
点哪里：按这一步找到 Configs、Default profile、Download from URL，先完成当前动作，不要顺手改其他开关。
成功标志
成功标志：界面里能看到 Configs、Default profile、Download from URL，并且可以继续下一步。
卡住先查
卡住先查：真正要复制的是 profile URL 或配置二维码，不是机场首页、登录页、邀请页、付款页，也不是单个节点说明。
真正要复制的是 profile URL 或配置二维码，不是机场首页、登录页、邀请页、付款页，也不是单个节点说明。
官方截图：Configs
本图看哪里
Step 2
iOS / iPadOS 端：导入 profile
iPhone 和 iPad 的路径基本一致：先把远程配置导入 Configs / Config File，再回 Home 点 START。
2.1
Settings -> Config File -> Download from URL
打开 Stash，进入 Settings 里的 Config File；有些版本界面会直接显示 Configs。选择 Download from URL，把 profile 链接粘进去，点 Download。下载完成后确认这份配置被选中。
点哪里
点哪里：按这一步找到 Settings、Config File、Configs，先完成当前动作，不要顺手改其他开关。
成功标志
成功标志：界面里能看到 Settings、Config File、Configs，并且可以继续下一步。
卡住先查
卡住先查：官方 Quick Start 也把这条路写成：进入配置列表，选择 Download from URL，输入订阅地址，下载后确认配置被选中。
官方 Quick Start 也把这条路写成：进入配置列表，选择 Download from URL，输入订阅地址，下载后确认配置被选中。
官方截图：Download from URL
本图看哪里
2.2
也可以 Download from QRcode
如果机场后台给的是二维码，在 Configs / Config File 里选择 Download from QRcode，然后扫描后台二维码。导入后同样要确认当前配置被勾选，再回 Home。
点哪里
点哪里：按这一步找到 Download from QRcode、Profile selected、Configs，先完成当前动作，不要顺手改其他开关。
成功标志
成功标志：界面里能看到 Download from QRcode、Profile selected、Configs，并且可以继续下一步。
卡住先查
卡住先查：扫完没有出现 profile，通常是二维码不是 Stash/Clash 配置，或者当前网络访问不了订阅域名。
扫完没有出现 profile，通常是二维码不是 Stash/Clash 配置，或者当前网络访问不了订阅域名。
官方截图：Download from QRcode
本图看哪里
Step 3
iOS / iPadOS 端：启动和分流
START 负责启动代理层；Outbound 和 Policy 决定流量到底直连、全局还是按规则走。
3.1
回到 Home 点 START
配置选中后回到 Stash Home，点击 START。第一次启动会弹系统 VPN 权限，允许后 Stash 才会开始接管设备流量。
点哪里
点哪里：按这一步找到 Home、START、Outbound，先完成当前动作，不要顺手改其他开关。
成功标志
成功标志：界面里能看到 Home、START、Outbound，并且可以继续下一步。
卡住先查
卡住先查：只导入 profile 但没点 START，浏览器和 App 仍会按原网络直连。
只导入 profile 但没点 START，浏览器和 App 仍会按原网络直连。
官方截图：Home 和 START
本图看哪里
3.2
看 Outbound 和 Policy
Outbound 常见是 Rule / Global / Direct：Rule 按规则分流，Global 全部走代理，Direct 全部直连。Policy 里会看到 Proxy / Automatic / Sequential / Auto / Load-Balance 等策略组，新手日常先用 Rule + Lite profile，需要排错时再短暂切 Global 对比。
点哪里
点哪里：按这一步找到 Outbound、Rule / Global / Direct、Policy，先完成当前动作，不要顺手改其他开关。
成功标志
成功标志：界面里能看到 Outbound、Rule / Global / Direct、Policy，并且可以继续下一步。
卡住先查
卡住先查：如果 Outbound 选了 Direct，即使节点看起来正常，实际访问也可能全部直连。
如果 Outbound 选了 Direct，即使节点看起来正常，实际访问也可能全部直连。
官方产品图：Outbound / Policy
本图看哪里
Step 4
更新和验证
订阅会变、节点会换。Stash 里要会更新配置，也要用真实出口结果判断是否跑通。
4.1
Update Now 和 Auto Update
iOS / iPadOS 端进入 Config File 或 Configs，长按当前 profile 执行 Update Now；也可以在 More Settings 设置 CONFIG FILE update interval 和 Auto Update。Mac 端同样先回 Config File 检查当前配置，再更新。
点哪里
点哪里：按这一步找到 Config File、Configs、Update Now，先完成当前动作，不要顺手改其他开关。
成功标志
成功标志：界面里能看到 Config File、Configs、Update Now，并且可以继续下一步。
卡住先查
卡住先查：机场后台换节点以后，客户端没更新就看不到新节点；更新失败时先看订阅是否过期、链接是否还能访问、当前配置是否选中。
机场后台换节点以后，客户端没更新就看不到新节点；更新失败时先看订阅是否过期、链接是否还能访问、当前配置是否选中。
站内示意图：更新 profile
本图看哪里
图源：52.mk 站内示意图
4.2
Connection test + 52.mk IP 检测
Stash 里的 Connection test 只能看节点响应和延迟，不能代表流媒体、AI 服务和出口地区都没问题。最后打开 52.mk IP 检测，看出口 IP、DNS、共享人数、Netflix、TikTok、ChatGPT、Claude Code 等结果。
点哪里
点哪里：按这一步找到 Connection test、出口 IP、DNS，先完成当前动作，不要顺手改其他开关。
成功标志
成功标志：界面里能看到 Connection test、出口 IP、DNS，并且可以继续下一步。
卡住先查
卡住先查：延迟有数值只是第一步；出口地区、DNS 和目标服务连通性符合预期，才算这条线路真的可用。
延迟有数值只是第一步；出口地区、DNS 和目标服务连通性符合预期，才算这条线路真的可用。
站内示意图：从延迟到真实出口
本图看哪里
图源：52.mk 站内示意图
Step 5
macOS 端：桌面使用路径
Stash Mac 不是 iOS 版的简单放大。官方文档说明它支持 Intel 和 Apple Silicon，并提供进程级规则、网关模式等桌面能力。
5.1
打开 Dashboard，先看配置是否进来
macOS 端打开后先看 Dashboard：左侧会有 Dashboard、Connections、Proxies、Rules、Config File、Settings 等入口。导入 profile 后，先确认 Dashboard 能看到 Outbound、Statistics、Network 等信息。
点哪里
点哪里：按这一步找到 Dashboard、Config File、Proxies，先完成当前动作，不要顺手改其他开关。
成功标志
成功标志：界面里能看到 Dashboard、Config File、Proxies，并且可以继续下一步。
卡住先查
卡住先查：如果 Dashboard 还是空的，先回 Config File 检查 profile 是否选中，别急着改 Rules 或 Override。
如果 Dashboard 还是空的，先回 Config File 检查 profile 是否选中，别急着改 Rules 或 Override。
官方截图：Mac Dashboard
本图看哪里
5.2
Set as System Proxy / Enable Enhanced Mode
Mac 端常见有两层开关：Set as System Proxy 让系统代理走 Stash；Enable Enhanced Mode 用来处理更完整的透明代理/增强模式场景。新手先开 System Proxy 跑通浏览器，再按需要测试 Enhanced Mode。
点哪里
点哪里：按这一步找到 Set as System Proxy、Enable Enhanced Mode、Rule Mode，先完成当前动作，不要顺手改其他开关。
成功标志
成功标志：界面里能看到 Set as System Proxy、Enable Enhanced Mode、Rule Mode，并且可以继续下一步。
卡住先查
卡住先查：如果只在 Stash 里看到节点，但 Safari、Chrome 仍然直连，先看 System Proxy 是否真的打开；不要同时开多个代理软件抢系统代理。
如果只在 Stash 里看到节点，但 Safari、Chrome 仍然直连，先看 System Proxy 是否真的打开；不要同时开多个代理软件抢系统代理。
官方产品图：Mac 顶部开关
本图看哪里
Step 6
tvOS 端：Apple TV 使用场景
Stash 的 App Store 条目包含 Apple TV，但 tvOS 的能力边界和 Mac 不一样。先确认 tvOS 17.0，再决定只是给电视 App 分流，还是要研究网关模式。
6.1
配置入口：iOS & tvOS App Store
Stash 官方下载页把 iPhone、iPad 和 Apple TV 放在同一个 iOS & tvOS App Store 入口，并说明 same listing covers 当前 iOS 和 tvOS builds。App Store 兼容信息里，Apple TV 需要 tvOS 17.0 或更高版本；如果电视端搜不到，先查系统版本、Apple ID 地区和 App Store 入口。
点哪里
点哪里：按这一步找到 Apple TV 4K、iOS & tvOS App Store、tvOS 17.0，先完成当前动作，不要顺手改其他开关。
成功标志
成功标志：界面里能看到 Apple TV 4K、iOS & tvOS App Store、tvOS 17.0，并且可以继续下一步。
卡住先查
卡住先查：Apple TV 能安装不等于所有 Mac 玩法都能照搬。tvOS 端先用同一份 Profile / Config 跑通电视自己的 App，再考虑复杂分流。
Apple TV 能安装不等于所有 Mac 玩法都能照搬。tvOS 端先用同一份 Profile / Config 跑通电视自己的 App，再考虑复杂分流。
官方平台图：Apple TV 4K
本图看哪里
6.2
tvOS 边界：Thread-enabled Apple TV 和网关模式
Apple TV 上的 Stash 更适合客厅场景：给 Apple TV 自己的 Netflix、YouTube、Disney+、TikTok 等应用做规则分流，或者在特定设备上尝试给局域网设备提供代理。官方 Wiki 写到 Stash iOS、tvOS、Mac 都支持给局域网设备提供代理；tvOS 和 Mac 支持 HTTP proxy、SOCKS proxy、transparent proxy / gateway mode，但透明代理只支持 Thread-enabled Apple TV。另一个常见边界是规则类型：iOS / tvOS 不支持 PROCESS-NAME 和 PROCESS-PATH，进程规则不要照搬 Mac 配置。
点哪里
点哪里：按这一步找到 Thread-enabled Apple TV、网关模式、HTTP proxy，先完成当前动作，不要顺手改其他开关。
成功标志
成功标志：界面里能看到 Thread-enabled Apple TV、网关模式、HTTP proxy，并且可以继续下一步。
卡住先查
卡住先查：只想看 Apple TV 流媒体，就先别碰网关模式；要做透明代理，先确认 Apple TV 型号、Thread 支持、网关/DNS 指向和局域网拓扑。
只想看 Apple TV 流媒体，就先别碰网关模式；要做透明代理，先确认 Apple TV 型号、Thread 支持、网关/DNS 指向和局域网拓扑。
站内示意图：tvOS 网关模式
本图看哪里
图源：52.mk 站内示意图
排错清单
Stash 连不上时先查什么
现象
配置下载成功，但 Home 里没法 Start
先查
先看 Config File 列表里当前 profile 是否被选中，再看文件格式是不是 Stash 能识别的 YAML。
处理
重新勾选正确 profile；仍不行就换 Clash Premium / Mihomo 入口重新下载。
现象
只有 Direct，所有流量都像没走代理
先查
检查 Outbound 是否被切到 Direct，或当前 Rule profile 里没有命中目标站点规则。
处理
日常切回 Rule；排错时短暂切 Global 对比出口是否变化。
现象
节点列表或 Policy 是空的
先查
大概率复制了登录页、订阅面板地址，或者机场给的 profile 不兼容 Stash。
处理
回后台复制 Stash / Clash / Mihomo 的 profile URL，不要复制浏览器地址栏。
现象
更新后节点消失
先查
确认订阅没过期，profile URL 还能访问，且没有误切到另一份空配置。
处理
Config File 长按 profile 执行 Update Now；仍失败就回后台重新生成订阅。
现象
Apple TV 上找不到或装不上 Stash
先查
先看 Apple TV 是否满足 tvOS 17.0，App Store 地区是否能看到 Stash，同一个 iOS & tvOS App Store 条目是否对你的设备开放。
处理
升级 tvOS、切回可用的 Apple ID 地区重新搜索；不要转去安装来路不明的 tvOS 包。
现象
tvOS 网关模式开了，但局域网设备没变化
先查
确认是不是 Thread-enabled Apple TV，再看客户端设备的网关和 DNS 有没有指向 Apple TV。
处理
只代理 Apple TV 自己的 App 时不需要网关模式；真要做透明代理，按官方 LAN / Gateway Mode 文档逐项核对网络设置。
现象
把 Mac 的 PROCESS 规则放到 tvOS 后不生效
先查
Stash 官方规则说明里，iOS / tvOS 不支持 PROCESS-NAME 和 PROCESS-PATH，这类规则会被忽略。
处理
tvOS 端改用 DOMAIN、DOMAIN-SUFFIX、RULE-SET、GEOIP 等规则思路，不要依赖进程名分流。
现象
Connection test 有延迟，但 App 还是打不开
先查
延迟只说明节点有响应，不代表 Outbound、Policy、DNS 和目标服务都符合要求。
处理
用 52.mk IP 检测核对出口地区、DNS、共享人数和目标服务连通性，再换节点交叉测试。
善意提醒
订阅链接要当密码保管，里面可能包含你的套餐身份和节点权限。
客户端只是工具，不承诺线路质量；线路稳定性要看机场本身。
下载软件和导入订阅是两件事。软件装好以后，还需要有效订阅或节点。
模块、覆写、TUN 和自定义路由属于进阶玩法，基础访问没跑通前先不要叠加。
遵守所在地法律和服务条款，本站教程只做软件使用和网络诊断说明。