Stash 苹果全生态代理客户端进阶实战指南：iOS、iPadOS、macOS 与 Apple TV 四端联动、Clash 规则无缝迁移、脚本重写与抓包解密全书

排名	机场品牌与核心特征	参考价格	独家优惠券	快速直达
#1	光速云总榜冠军 · 站长力荐企业级双向 IEPL 专线 · VLESS (2020老牌) 自研客户端 · 晚高峰0丢包 · AI/4K秒开	￥7.5/月起年付折算 59G/月	AMM8折复制	直达官网 → 评测
#2	飞猫云低门槛 · 性价比全国多入口 IEPL 专线 · Shadowsocks/VLESS 自研客户端开箱即用 · 适合日常学术/轻度追剧	￥7.0/月起年付折算 50G/月	flycat8888折复制	直达官网 → 评测
#3	微风网络极致便宜 · 平价平价 IEPL 专线中转 · 香港/日本/新加坡预算友好无套路 · 学生与上班族高性价比	￥7.0/月起年付折算 50G/月	flat8889折复制	直达官网 → 评测
#4	星岛梦老牌长效稳定企业级内网骨干直通 · 全协议全客户端成熟线路容灾体系 · 长期备用首选	￥8.0/月起年付折算 60G/月	nmw888特惠复制	直达官网 → 评测
#5	唯兔云15元档大流量 BGP多点接入 + 智能中继 · 60+多国节点 14.9元真实月付 · 100G大流量 · 追剧首选	￥14.9/月付真实月付 100G/月	weitu666立减复制	直达官网 → 评测
#6	宇宙云15元IEPL专线 VLESS 协议 + IEPL 专线通道兼顾专线低延迟与百吉流量 · 4K秒开	￥14.9/月付真实月付 100G/月	YUZHOU553立减复制	直达官网 → 评测

#1光速云总榜冠军 · 站长力荐

￥7.5/月起

线路：企业级双向 IEPL 专线 · VLESS (2020老牌)

优势：自研客户端 · 晚高峰0丢包 · AI/4K秒开

AMM8折复制

直达官网 → 评测

#2飞猫云低门槛 · 性价比

￥7.0/月起

线路：全国多入口 IEPL 专线 · Shadowsocks/VLESS

优势：自研客户端开箱即用 · 适合日常学术/轻度追剧

flycat8888折复制

直达官网 → 评测

#3微风网络极致便宜 · 平价

￥7.0/月起

线路：平价 IEPL 专线中转 · 香港/日本/新加坡

优势：预算友好无套路 · 学生与上班族高性价比

flat8889折复制

直达官网 → 评测

#4星岛梦老牌长效稳定

￥8.0/月起

线路：企业级内网骨干直通 · 全协议全客户端

优势：成熟线路容灾体系 · 长期备用首选

nmw888特惠复制

直达官网 → 评测

#5唯兔云15元档大流量

￥14.9/月付

线路：BGP多点接入 + 智能中继 · 60+多国节点

优势：14.9元真实月付 · 100G大流量 · 追剧首选

weitu666立减复制

直达官网 → 评测

#6宇宙云15元IEPL专线

￥14.9/月付

线路：VLESS 协议 + IEPL 专线通道

优势：兼顾专线低延迟与百吉流量 · 4K秒开

YUZHOU553立减复制

直达官网 → 评测

💡 选型速查建议：日常主力与大模型防封首选 光速云（2020老牌IEPL/VLESS）；预算极度敏感且轻度查资料首选 飞猫云 或 微风网络（折合7元/月）；月付党与大流量追剧首选 唯兔云（14.9元/100G）。

返回网站首页 | 返回客户端专题总览 | 查看 2026 稳定优质机场推荐

答案摘要块：核心结论与速查索引

核心选型与调优结论：Stash 是 Apple 苹果生态（iOS、iPadOS、macOS 以及 tvOS）中设计最精美、现代化程度最高且唯一能够 “100% 原生无缝兼容标准 Clash / Clash.Meta (Mihomo) 配置语法” 的旗舰级代理应用。相较于学习曲线陡峭且按设备单独高昂买断的 Surge，Stash 提供了近乎一致的高级策略组分流、MitM（中间人 HTTPS 解密）、URL 重写与 JavaScript 脚本执行能力，同时支持通过单一 Apple ID 授权实现 iPhone、iPad、Mac 与 Apple TV 四端完全买断覆盖。对于既习惯 Clash 强大的 proxy-providers / rule-providers 自动化规则集体系，又渴望在苹果全家桶上获得极致原生的流畅体验与 iCloud 跨端静默同步的用户而言，Stash 是目前综合体验最无可挑剔的黄金标准。

核心评估维度	Stash (Apple 全生态)	Surge (iOS / Mac)	Shadowrocket 小火箭	Loon (iOS / tvOS)
支持平台矩阵	iOS / iPadOS / macOS / tvOS (四端)	iOS / iPadOS / macOS (独立授权)	iOS / iPadOS / macOS (M系列) / tvOS	iOS / iPadOS / tvOS
规则配置体系	原生兼容标准 Clash YAML / Stash Stashing	Surge 独占 conf 专有格式	混杂自研规则 / 支持简易列表	独占 conf 格式 / 插件化生态
Apple TV 独立 App	极佳 (原生遥控器适配 + 旁路网关模式)	支持 (Ponte 远程网关体系)	支持 (简易遥控器界面)	支持 (轻量化遥控界面)
iCloud 多端同步	原生静默双向同步 (规则/节点/缓存)	仅限单一平台内同步	支持 iCloud 简易备份	支持 iCloud 插件配置同步
脚本执行能力	JavaScript (ES6) / 兼容 Surge 脚本	JavaScript (自研高并发微核心)	基础脚本支持	JavaScript 插件体系
内存与省电控制	极佳 (严格遵守 iOS 15MB 内存红线)	极致 (深度汇编调优)	良好 (轻微内存抖动)	优秀 (轻量级常驻)

mermaid

flowchart TD
    subgraph 苹果全生态终端矩阵 [Apple 硬件全家桶协同]
        iPhone[iPhone 移动端: 蜂窝网络自适应]
        iPad[iPadOS 平板端: 生产力协同]
        Mac[macOS 桌面工作站: 开发者透明代理]
        AppleTV[Apple TV 4K: 客厅大屏与家庭透明旁路网关]
    end

    subgraph iCloud 云端数据枢纽 [iCloud Drive 自动增量同步]
        SyncConfig[(Stash 全量配置: config.yaml / 覆写脚本 / CA 根证书)]
    end

    iPhone <-->|增量同步规则与节点池| SyncConfig
    iPad <-->|增量同步规则与节点池| SyncConfig
    Mac <-->|增量同步规则与节点池| SyncConfig
    AppleTV <-->|增量同步规则与节点池| SyncConfig

    subgraph 智能分流与出站引擎 [Stash 四端统一分流核心]
        SyncConfig --> EngineCore[Stash 规则决策树]
        EngineCore -->|国内直连| DirectOut[物理宽带直连 DIRECT]
        EngineCore -->|流媒体与 AI 工具| ProxyOut[BGP / IEPL 跨境专线 PROXY]
        EngineCore -->|隐私广告追踪| RejectOut[广告黑洞 REJECT]
    end

1. Stash 产品定位与 Apple 全生态架构深度剖析

在苹果封闭严密的操作系统生态中，开发一款系统级的网络代理工具面临着常人难以想象的严苛限制。苹果为了保障电池续航与系统安全，对后台进程的内存占用设立了绝对的“生死红线”——iOS 系统的 NetworkExtension (PacketTunnelProvider) 虚拟网卡扩展进程，其物理内存上限被严格限定在 15MB 左右。一旦后台解密或规则匹配导致内存瞬间突破阈值，操作系统内核会毫不留情地直接向进程发送 SIGKILL 信号将其强行击杀，用户端则表现为 VPN 突然莫名断开。

mermaid

flowchart LR
    subgraph iOS 系统底层沙盒矩阵 [iOS Kernel 沙盒边界]
        AppUI[Stash 主界面: SwiftUI 前台应用] -->|IPC 进程间通信| ExtEngine[NetworkExtension 扩展核心]
        ExtEngine -->|内存触顶限制: < 15MB| Watchdog{iOS 系统监控}
        Watchdog -->|超过 15MB 强行杀后台| SIGKILL[产生闪退 / 隧道崩溃断开]
    end

    subgraph 内存优化控制体系 [Stash 极致内控技术]
        ExtEngine --> M1[流式规则匹配: 零全量字典预载]
        ExtEngine --> M2[零拷贝 Packet-to-Stream 协议栈转换]
        ExtEngine --> M3[DNS 动态 LRU 环形缓存淘汰]
    end

1.1 为什么 Stash 被誉为“苹果平台体验最好的 Clash 衍生客户端”？

对于大量从 Windows 或 Android 平台迁移到 iPhone、Mac 的资深技术用户而言，重新学习一套完全私有的规则语法（如 Surge 的专有指令）往往伴随着高昂的时间成本。而传统的通用开源客户端在 iOS 上往往因为内存管理粗糙而频繁闪退。Stash 在二者之间取得了完美的平衡：

纯血 Swift 与 SwiftUI 打造的原生体验：Stash 彻底抛弃了 Webview 渲染方案，全量 UI 采用苹果官方的 SwiftUI 编写。界面响应速度行云流水，完美适配 iOS 的 Dynamic Island（灵动岛）实时上下行速率展示、锁屏快捷小组件（Widgets）以及控制中心一键切换开关；
原生 Clash YAML 规则的 100% 无缝复用：用户可以直接将各大优质机场下发的标准 Clash 订阅链接贴入 Stash，无需经过任何第三方转换后门或订阅转换 API。软件内置了高度兼容的 YAML 解析器，能够原生识别 Proxy Group、RULE-SET、IP-CIDR 等所有工业级配置语法。

1.2 四端买断机制与多设备生态闭环优势

在当今软件订阅制（按月/按年持续付费）泛滥的环境下，Stash 坚持了对用户极其友好的销售模式：用户在 App Store 一次性买断后，即可通过同一个 Apple ID 无限制下载并激活 iOS (iPhone)、iPadOS (iPad)、macOS (MacBook/iMac) 以及 tvOS (Apple TV) 四大平台的正版客户端。

配置的真正“零折腾”：在办公室 MacBook 上刚刚调优好的分流规则、去除特定视频广告的 JavaScript 脚本，通过 iCloud Drive 的静默通知机制，能在数十秒内自动同步至家中的 Apple TV 4K 与口袋里的 iPhone，彻底终结了在不同设备上重复拷贝配置文件的繁琐体力劳动。

2. Stash 与 Surge、Shadowrocket、Loon 顶级工具全景横评

为了帮助用户在苹果平台的四大当红代理神器中做出理性客观的决策，我们从底层架构、实测性能、易用性及高级功能维度展开了深度技术横评。

mermaid

graph TD
    UserReq[用户实际需求与预算画像] --> Decision{核心使用偏好}
    
    Decision -->|已有成熟 Clash 规则 / 全家桶生态 / 高性价比| Choice_Stash[首选 Stash: 四端买断 / 原生 Clash 兼容]
    Decision -->|预算极度充裕 / 专业网络工程师 / 深度协议调试| Choice_Surge[选用 Surge: 顶级协议栈 / 昂贵独立授权]
    Decision -->|极低成本 / 仅需手机上外网 / 协议杂食极客| Choice_Rocket[选用 Shadowrocket: 便宜好用 / 界面较粗糙]
    Decision -->|插件化狂热玩家 / 热衷节点脚本变体| Choice_Loon[选用 Loon: 插件生态活跃 / 专注移动端]

2.1 四大苹果代理客户端客观技术维度对比表

评估维度	Stash	Surge	Shadowrocket (小火箭)	Loon
App Store 授权模式	一次性买断（包含四端全家桶）	分平台高昂买断（年费订阅更新）	超低价单次买断（全端可用）	单次买断（iOS + tvOS）
配置语法规范	标准 Clash YAML 规范	专有 Surge Conf 规范	自定义混合格式 / 简易列表	专有 Conf 规范 / 插件封装
底层 TCP/IP 协议栈	自研轻量级高性能 tun2socks 栈	业界顶级自研原生 IP 转发栈	lwIP 移植定制协议栈	自研轻量网络协议栈
后台保活稳定性	极佳（严格压制在 12MB 以内）	极致（业内标杆，极低功耗）	良好（极偶尔大并发闪退）	优秀（内存回收机制敏捷）
Apple TV 独立 App	原生 TV 界面 + 客厅网关支持	强劲（需配合 Ponte 远程网关）	基础可用（遥控器交互一般）	优秀（针对 TV 界面专门优化）
HTTP(S) 抓包与调试	完整内置（支持 MitM/重写/脚本）	顶级抓包控制台与视听分析	基础抓包与重写支持	丰富插件体系与脚本集成
上手门槛	中等（支持一键托管订阅）	极高（需深厚网络协议知识）	极低（扫码即用，傻瓜化）	中等（插件配置需简单调试）

3. Clash 规则集无缝迁移与本地/远程订阅托管实操

很多用户之所以选择 Stash，是因为它能够直接兼容目前网络上最为成熟的 Clash 规则生态。以下为你展示如何在 Stash 中构建一份生产级高可用 YAML 配置。

mermaid

flowchart LR
    SubURL[机场远程订阅 URL] --> StashEngine[Stash 订阅加载引擎]
    
    subgraph 配置分层解析流程 [YAML 分层解析管道]
        StashEngine --> P1[解析 Proxies / Proxy Providers 节点池]
        StashEngine --> P2[解析 Proxy Groups 策略组矩阵]
        StashEngine --> P3[解析 Rule Providers 外部精细规则集]
        StashEngine --> P4[解析 Dns 模块与 Fake-IP 缓存映射]
    end

    P1 & P2 & P3 & P4 --> ActiveRuntime[生成内存运行态拓扑]

3.1 生产级标准 Clash YAML 配置文件实战范例

将以下配置保存为 stash-production.yaml 并导入 Stash 中，即可实现自动节点探活、流媒体精准分流与广告拦截：

yaml

# Stash 苹果全生态生产级配置规范
mixed-port: 7890
allow-lan: true
log-level: warning
mode: rule

# 苹果生态高性能 DNS 与 Fake-IP 调优配置
dns:
  enable: true
  listen: 127.0.0.1:53
  enhanced-mode: fake-ip
  fake-ip-range: 198.18.0.0/15
  fake-ip-filter:
    - "*.lan"
    - "*.local"
    - "*.apple.com"
    - "*.icloud.com"
    - "captive.apple.com"
  nameserver:
    - 223.5.5.5
    - 119.29.29.29
  fallback:
    - https://1.1.1.1/dns-query
    - https://8.8.8.8/dns-query

# 代理集外部动态拉取（支持高可用自动更新）
proxy-providers:
  AirportNode:
    type: http
    url: "https://api.your-sub-provider.com/link?token=YOUR_TOKEN"
    path: ./profiles/airport.yaml
    interval: 86400
    health-check:
      enable: true
      url: http://www.apple.com/library/test/success.html
      interval: 300

# 策略组设计：实现多业务精准分流
proxy-groups:
  - name: "🚀 节点选择"
    type: select
    proxies:
      - "♻️ 自动优选"
      - "🇭🇰 香港专线"
      - "🇯🇵 日本专线"
      - "🇺🇸 美国专线"
      - "DIRECT"

  - name: "♻️ 自动优选"
    type: url-test
    use:
      - AirportNode
    url: "http://www.google.com/generate_204"
    interval: 300
    tolerance: 50

  - name: "🤖 AI 国际服务"
    type: select
    proxies:
      - "🇺🇸 美国专线"
      - "🇯🇵 日本专线"
      - "🚀 节点选择"

  - name: "🎬 国际流媒体"
    type: select
    proxies:
      - "🇭🇰 香港专线"
      - "🇯🇵 日本专线"
      - "🚀 节点选择"

  - name: "🛑 广告拦截"
    type: select
    proxies:
      - "REJECT"
      - "DIRECT"

# 外部规则集分层引入
rule-providers:
  RejectRules:
    type: http
    behavior: domain
    url: "https://testingcf.jsdelivr.net/gh/Loyalsoldier/clash-rules@release/reject.txt"
    path: ./rules/reject.yaml
    interval: 86400

  OpenAIRules:
    type: http
    behavior: classical
    url: "https://testingcf.jsdelivr.net/gh/Loyalsoldier/clash-rules@release/proxy.txt"
    path: ./rules/openai.yaml
    interval: 86400

rules:
  - RULE-SET,RejectRules,🛑 广告拦截
  - DOMAIN-SUFFIX,openai.com,🤖 AI 国际服务
  - DOMAIN-SUFFIX,anthropic.com,🤖 AI 国际服务
  - DOMAIN-SUFFIX,netflix.com,🎬 国际流媒体
  - DOMAIN-SUFFIX,disneyplus.com,🎬 国际流媒体
  - GEOIP,lan,DIRECT,no-resolve
  - GEOIP,CN,DIRECT
  - MATCH,🚀 节点选择

4. Apple TV 独立客户端部署与客厅旁路网关模式实操

随着 2023 年 tvOS 17 正式开放 NetworkExtension 框架，Apple TV 从原先只能被动充当客户端的流媒体播放盒，一跃成为整个家庭客厅网络中最具威力的“微型静音高性能透明网关”。Stash 是首批登陆 Apple TV App Store 的标杆应用。

mermaid

flowchart TD
    subgraph 家庭物理网络入口 [家庭宽带出口]
        Modem[光猫调制解调器] --> MainRoute[主路由器: 192.168.1.1 (DHCP Server)]
    end

    subgraph 客厅智能设备矩阵 [家庭局域网设备接入]
        PS5[PlayStation 5 / Switch 游戏机] -->|网关指向 192.168.1.2| AppleTV[Apple TV 4K: 192.168.1.2 (运行 Stash)]
        SmartTV[客厅智能索尼电视 / 投影仪] -->|网关指向 192.168.1.2| AppleTV
        iPad_Family[家人 iPad / 智能家居中枢] -->|默认网关 192.168.1.1| MainRoute
    end

    subgraph Stash 网关透明转发流程 [Apple TV Stash 内核处理]
        AppleTV --> StashTun[Stash 旁路网关模式: Fake-IP 劫持]
        StashTun --> SmartRoute{智能分流判断}
        SmartRoute -->|国服游戏/本地投屏| MainRoute
        SmartRoute -->|Netflix / YouTube 4K| ExtBGP[海外优质专线出口]
    end

4.1 如何在 Apple TV 上启用 Stash 旁路网关模式（Gateway Mode）？

将 Apple TV 打造成全屋客厅网关无需刷机或破坏原有网络结构：

静态 IP 绑定：在主路由器管理后台中，将 Apple TV 4K 的局域网 MAC 地址绑定为固定 IP（例如 192.168.1.2）；
在 Apple TV 上开启网关特性：打开 tvOS 上的 Stash 客户端，进入“更多设置” -> “入站与局域网”，勾选 “允许局域网连接” 并开启 “透明旁路网关模式”；
定向接管特定智能设备：对于客厅里的 PlayStation 5 游戏机、Switch 或其他智能电视，无需全屋改动网络。只需进入这些设备的网络设置，将连接方式改为“手动”，将其 IPv4 网关与主 DNS 地址均修改为 Apple TV 的 IP (192.168.1.2)，子网掩码保持 255.255.255.0。
验证客厅全域加速与 HDR/4K 流媒体播放：接管后，PS5 下载海外联机补丁的握手延迟瞬间降低，电视内置的 Netflix 与 YouTube 客户端可秒级开启 4K 60FPS Dolby Vision（杜比视界）画质，且整体网络稳定运行数月不发热、不死机。

4.2 tvOS 17+ 客厅网关实测数据、多用户切换与家庭自动化

将 Apple TV 4K（搭载 A15 仿生芯片）作为家庭客厅的主力旁路网关，在实测中展现出了远超传统 x86 软路由（如常见工控机 N5105 或 J4125）的能效比与稳定性：

千兆双向线速转发与极致能效比实测：在千兆光纤入户的家庭局域网中，通过有线网口连接的 Apple TV 4K 运行 Stash 旁路网关模式，内网测速双向吞吐能够稳稳跑满 940Mbps 的物理线速上限，大并发 UDP 数据包转发时的 CPU 总体占用率仅在 3% 至 6% 之间游弋，机身外壳温度常态化维持在 34℃ 温凉状态。相较于整机功耗常年 15W 至 25W 的 x86 工控小主机，Apple TV 4K 全速转发时的整机功耗仅为 4W 至 6W，全年运行无风扇噪音、无灰尘堆积隐患。
Apple 遥控器与 tvOS 控制中心快捷唤醒：在 tvOS 界面长按遥控器上的 TV 键，可在屏幕右侧呼出系统级控制中心。Stash 提供了定制化的 tvOS 浮窗卡片，无需退出正在全屏播放的电影，即可使用遥控器直接在香港、日本、美国专线之间一键无缝切流，或者快速查看当前的上下行实时码率与节点健康状态。
HomeKit 智能家居与观影场景自动化联动：利用苹果生态的“快捷指令”与 HomeKit 自动化，可以构建极致智能的家庭影院场景：当检测到客厅吸顶灯调暗且索尼电视或激光投影仪开机时，系统自动向 Apple TV 上的 Stash 本地 API 发起请求，将出站流媒体策略组强制锁定为低延迟新加坡原生节点，并自动激活 4K 缓存预取，实现真正的“坐下即看、丝滑无感”。

5. 高阶生产力：MitM 解密、URL 重写与 JavaScript 脚本实战

Stash 不仅仅是一个网络流量转发器，更是一个功能完备的移动端网络调试分析套件。通过启用 MitM（Man-in-the-Middle）中间人解密技术，Stash 可以窥探并重写应用层的 HTTPS 请求与响应报文。

mermaid

sequenceDiagram
    autonumber
    participant App as 手机 App (客户端)
    participant Stash as Stash MitM 解密引擎 (本地 CA)
    participant TargetServer as 远程目标 HTTPS 服务器

    App->>Stash: 发起 HTTPS TLS 握手 (目标: api.target.com)
    Stash->>App: 下发由 Stash 本地根证书动态签发的伪证书
    Note over App,Stash: 本地信任 Stash 根证书，握手成功完成
    App->>Stash: 发送加密应用层 HTTP 数据明文 (包含广告/参数)
    
    Stash->>Stash: 触发 Script / Rewrite 规则: 执行正则替换或 JS 脚本剥离广告参数
    
    Stash->>TargetServer: 与真实服务器建立标准合法 TLS 隧道
    Stash->>TargetServer: 转发清洗后的精简数据包
    TargetServer-->>Stash: 返回业务数据 (包含广告 JSON)
    Stash->>Stash: 运行 Response Script 脚本: 过滤广告节点
    Stash-->>App: 将无广告的纯净数据返回给手机界面渲染

5.1 生成与完全信任本地 MitM 根证书的关键四步

许多新手在配置 MitM 规则后发现所有 HTTPS 网站均无法访问，99% 的原因是没有在 iOS 系统深处开启“根证书完全信任”：

生成并安装证书：在 Stash 中进入“设置” -> “MitM” -> 点击“生成新 CA 证书”，随后点击“安装证书到系统”。系统会自动调出 Safari 弹窗并下载描述文件；
激活系统描述文件：打开 iPhone 系统“设置” -> 顶部出现“已下载描述文件” -> 点击进入并点击右上角“安装”；
【最为关键的致命盲区】完全信任根证书：安装完毕后，必须手动打开 iPhone“设置” -> “通用” -> “关于本机” -> 滑动至最底端点击“证书信任设置” -> 在“针对根证书启用完全信任”列表中，找到刚刚安装的 Stash CA，手动拨动开关至开启状态；
通配符域名解密列表配置：在 Stash 的配置文件中，指定需要 MitM 解密的域名清单，切记必须将各大银行金融、政府公信系统以及苹果核心系统服务加入排他绕过名单：

yaml

# MitM 与 URL 重写配置示范
mitm:
  enable: true
  ca-p12: stash_root_ca.p12
  passphrase: "your_secure_password"
  hostname:
    - "*.zhihu.com"
    - "*.weibo.cn"
    - "-*.apple.com"
    - "-*.icloud.com"
    - "-*.crashlytics.com"

# 正则表达式 URL 重写规则
url-rewrite:
  - ^https?://api\.example\.com/ad/fetch - reject
  - ^https?://www.google.cn https://www.google.com 302

5.2 JavaScript 定时任务 (Cron) 自动化执行与告警推送实战

除了针对 HTTP 报文的被动拦截，Stash 还原生支持遵循标准 Unix 5 段 Cron 语法的定时执行脚本机制。用户无需依赖外部云服务器，即可在 iPhone 或 Apple TV 上常态化运行健康检测与自动化运维任务：

Cron 定时脚本配置语法：在配置文件中通过 script: 模块声明定时任务，指定触发周期与本地或远程脚本路径：

yaml

# Stash Cron 定时任务配置范例
script:
  - name: node_health_monitor
    type: cron
    cron: "0 8 * * *"
    script-path: "./scripts/health_check.js"
    timeout: 30

多节点自动巡检与 Bark 手机告警推送脚本：以下 JavaScript 脚本可每日自动探测核心专线节点的存活状态。一旦发现连续丢包或延迟突增，立即向用户的 iPhone 发起 Bark 系统级 APNs 推送通知：

javascript

// Stash 节点探活与 Bark 告警自动化脚本 (health_check.js)
const checkUrl = "http://www.google.com/generate_204";
const barkServer = "https://api.day.app/YOUR_BARK_KEY/";

$httpClient.get({ url: checkUrl, timeout: 5000 }, (error, response, data) => {
  if (error || response.status !== 204) {
    const notifyBody = encodeURIComponent("警告: Stash 核心跨境链路发生异常或阻断，请检查当前节点状态！");
    $httpClient.get(`${barkServer}Stash网络告警/${notifyBody}?group=Stash`, () => {
      $done();
    });
  } else {
    console.log("[Stash Health] 核心专线网络巡检正常，时延稳定。");
    $done();
  }
});

6. 耗电量调优与 iOS 后台常驻机制深度优化

对于每天需要全天候开启代理的用户而言，电池续航往往是最关心的现实痛点。很多用户误以为屏幕“电池”用量统计中 Stash 占比高达 30% 就是客户端在疯狂耗电，这实际上是 iOS 系统计算逻辑造成的统计假象。

mermaid

flowchart TD
    subgraph iOS 统计机制 [电池用量统计归因假象]
        Safari[Safari 浏览器消耗 500MB 流量]
        TikTok[TikTok 刷短视频消耗 2GB 流量]
        Safari & TikTok -->|全部流量流经本地网卡接口| StashEngine[Stash 虚拟网卡接口]
        StashEngine -->|数据加密发包| Radio[基带天线射频电路耗电]
        Radio --> BatteryStat[iOS 系统将射频能耗全量归罪于 Stash]
    end

6.1 拆解 iOS 电池统计假象与真实功耗

因为在开启 VPN 扩展后，手机上所有应用的数据包都需要先路由到 Stash 的虚拟网络接口，再由 Stash 调用底层 socket 写入物理蜂窝或 Wi-Fi 射频天线。iOS 系统在计算电量归属时，会将所有流经该虚拟网卡所产生的 CPU 运算与无线射频功耗，一股脑全算在 Stash 头上。

验证方法：即使你完全不打开 Stash 界面，只用 Safari 狂刷超清视频，电池统计中 Stash 的耗电占比依然会飙升。实际上，Stash 本身在纯流式转发时对 CPU 的占用通常不足 1.5%，真正的耗电大户依然是屏幕高刷渲染与射频发射功率。

6.2 降低 Stash 真实能耗的三大高阶调优手段

若想进一步将 iPhone 在全天候挂机下的能耗降至冰点，建议实施以下三项配置：

彻底关闭实时连接日志记录：在“设置” -> “日志设置”中，将日志级别设置为 silent (静默) 或 warning。关闭日志能够避免高并发数据包到达时频繁触发磁盘 I/O 写入与控制台内存分配；
启用高效的 Fake-IP DNS 模式：相较于传统的 Redir-Host 模式（客户端每次请求都必须等待本地或远程 DNS 往返解析完成后才建立连接），Fake-IP 模式实现了真正的零耗时即时应答，极大缩减了手机蜂窝基带芯片在高功率发射状态（DCH / FACH 态）下的停留时长；
精简精细化规则集数量：避免在配置中同时订阅七八个包含数十万条无用域名的巨型黑名单列表。单条规则匹配的时间复杂度随着列表膨胀而上升，将规则集聚焦在 Loyalsoldier 等经过高度优化的精炼规则集上，可使单包匹配判定时间从微秒级缩短至纳秒级。

7. 跨端协同：macOS 与 Apple TV 全场景无感热备

在现代数字游民与居家办公场景中，多设备间无缝流转是提升生产力的核心。Stash 针对 macOS 桌面端和 tvOS 客厅端做了极其精细的深度集成。

mermaid

flowchart LR
    subgraph 桌面与客厅流转 [Stash 跨端控制矩阵]
        MacApp[macOS Stash: 开启系统全局接管与助手模式]
        iPhoneApp[iPhone Stash: 充当遥控终端]
        AppleTVApp[Apple TV Stash: 常驻客厅提供千兆网关]
    end

    iPhoneApp -.->|同一局域网 HTTP API 远程控制| AppleTVApp
    iPhoneApp -.->|iCloud 配置文件修改推送| MacApp

7.1 macOS 端 Stash 的高级系统助手模式（Helper Mode）

在 Mac 设备上运行 Stash 时，相较于普通代理工具，Stash 提供了更底层、更清爽的接管方式：

无须频繁修改系统网络位置设置：点击“安装特权辅助工具（Privileged Helper Tool）”，Stash 可以直接接管 macOS 底层路由表，实现无缝的全局 TUN 模式，即使是在终端中运行没有配置代理环境变量的 Docker 镜像拉取、brew update 或 cargo build，都能实现全透明的网络提速；
原生 Apple Silicon (M1/M2/M3/M4) 架构指令集优化：Stash 针对 ARM64 架构进行了深度的汇编级编译优化，内存常驻占用仅为 30MB 左右，无论是 MacBook Air 还是 Mac Studio 都能享受到无感知、无风扇噪音的宁静体验。

7.2 macOS 菜单栏快捷控制与 iOS 快捷指令 (Shortcuts) 自动化网络切换

为了达成在各种物理网络环境下的无缝自适应流转，结合苹果原生“快捷指令（Apple Shortcuts）”能够构建高度智能的自动化网络编排工作流：

基于 Wi-Fi SSID 物理感知的自动化条件切换：在 iOS 系统的“快捷指令” App 中创建一条“个人自动化”规则：
- 触发条件：当 iPhone 连接至特定的公司办公 Wi-Fi（例如 Company-Internal-5G）时；
- 执行操作：调用 Stash 快捷指令动作 Set Outbound Mode，自动将全局出站模式切换为 Direct（直连），或者暂停代理隧道，避免与企业内网认证防火墙或 802.1X 动态端口安全认证产生冲突；
- 离场恢复：当断开公司 Wi-Fi 离开园区时，自动化触发器自动执行 Start Stash，无缝拉起 TUN 隧道并锁定为 Rule（规则分流） 模式，确保离开办公网后核心通信与敏感数据始终受到加密隧道保护。
macOS 菜单栏轻量化弹窗与全局快捷键映射：在 Mac 桌面端，Stash 常驻于系统右上角菜单栏。用户不仅可以通过点击菜单栏图标直观监控当前的瞬时上行/下行速率曲线，还可以通过系统“键盘快捷键”设置将“切换模式（Rule / Global / Direct）”映射为全局组合键（例如 Option + Command + P），在编写代码或开启全屏远程桌面时实现纯键盘流盲操。

8. 三大真实苹果生态全场景落地实战案例

案例一：外企中层管理者的全套 Apple 全家桶自动化静默分流与家庭影院无缝解锁

用户背景与痛点：某外企大中华区业务主管何先生是资深的“苹果全家桶”拥趸，日常标配 iPhone 16 Pro、iPad Pro、M3 MacBook Pro 以及客厅中的 Apple TV 4K。此前，何先生在不同设备上分别安装了不同的代理工具，配置语法割裂，每逢机场更新节点，必须在四台设备上依次手动修改，苦不堪言。更痛苦的是，周末在客厅使用 Apple TV 播放 Netflix 4K 原生剧集时，经常因为路由分流误判被识别为中转机房 IP 而遭遇奈飞代理拦截警告。
解决方案与实施步骤：
1. 在 iPhone 上一次性买断 Stash，利用同一个美区 Apple ID 将软件直接静默推送到 iPad、MacBook 与 Apple TV 4K 四台设备上。
2. 编写一份高标准的生产级 Clash YAML 配置，利用 proxy-providers 订阅优质专线机场，并通过 iCloud Drive 存放统一的配置文件，所有设备统一指向该 iCloud 配置文件。
3. 在 Apple TV 上开启 Stash 旁路网关模式，固定内网 IP 192.168.1.10，将客厅索尼电视与家庭音响中枢网关指向 Apple TV。
4. 针对流媒体配置专用的原生新加坡/日本独立解锁策略组，开启 url-test 自动健康测试。
治理效果与收益：何先生达成了苹果全生态“一次配置、终生全端静默协同”的极简状态。无论是在外移动办公，还是周末客厅家庭影院，Netflix 与 Disney+ 均能瞬间点亮 4K Dolby Vision 与 Dolby Atmos 声轨；且节点出现网络抖动时，Stash 能在 300 毫秒内原地自愈切换，彻底告别了家庭影院卡顿的尴尬。

案例二：移动端前端与逆向开发者的 iOS 抓包调试、接口 Mock 与 HTTPS 解密

用户背景与痛点：某移动互联网大厂 iOS 资深前端研发工程师陈工在开发公司跨国业务 App 时，需要频繁在 iPhone 真机上排查第三方 SDK 发起的网络请求，或者在服务端未就绪时进行接口 Mock 联调。此前使用的 Charles 或 Fiddler 抓包工具必须将手机和电脑连入同一个 Wi-Fi 并手动配置 HTTP 代理，一旦离开工位或切换到蜂窝 5G 网络，调试环境立刻失效。
解决方案与实施步骤：
1. 在 iPhone 上启动 Stash，生成独有的本地 MitM 根证书，并在 iOS 系统中配置完全信任该证书。
2. 利用 Stash 内置的 JavaScript 脚本引擎功能，编写定制化的本地拦截脚本，对指定的海外 API 接口实现响应报文的实时注入与动态 Mock：

javascript

// Stash 接口动态 Mock 与字段注入示例脚本
const url = $request.url;
if (url.includes("/api/v1/user/profile")) {
  let body = JSON.parse($response.body);
  body.data.is_vip = true;
  body.data.region_code = "US";
  body.data.debug_mode = 1;
  $done({ body: JSON.stringify(body) });
} else {
  $done({});
}

在 Stash 界面中启用“网络请求嗅探与记录仪”，直接在手机端以原生高刷界面查看每一个 HTTP/HTTPS 事务的 Headers、Payload 以及详细 TLS 握手耗时。

治理效果与收益：陈工彻底摆脱了笨重电脑调试软件的束缚。无论是在会议室、通勤地铁还是真机测试现场，掏出 iPhone 即可就地展开毫秒级精度的接口拦截与参数 Mock，接口排错周期缩短了 70% 以上，成为团队内部公认的移动开发效率利器。

案例三：高频跨国商旅精英的多地区海外漫游自适应快速切换

用户背景与痛点：跨国贸易合伙人林先生每月都需要在东京、新加坡、旧金山与欧洲之间频繁飞行。由于跨越多个国家，当地的物理网络环境与运营商网络制式千差万别。此前使用的简易客户端在手机由飞行模式降落连入当地机场 Wi-Fi 后，常常因为节点死锁或 DNS 路由缓存残留，导致整机断网，无法及时接收重要的海外业务邮件与航班提醒。
解决方案与实施步骤：
1. 在 Stash 中配置 fallback（故障转移）策略组，将全球不同核心金融枢纽的优质专线节点按优先级依次排列。
2. 启用 Stash 的“网络切换自动健康探测”机制，设置当系统网络接口发生物理变动（例如由蜂窝网络断开切换为国际漫游 Wi-Fi）时，立即对核心测速源发起并发探活。
3. 配置智能 DNS 优先级规则，将海外漫游状态下的权威解析强制交由 Cloudflare 1.1.1.1 递归处理，避免当地机场公共 Wi-Fi 的广告欺骗劫持。
治理效果与收益：林先生在降落国际机场打开手机的一瞬间，Stash 仅耗时 200 毫秒即自动识别当地网络状态，并静默锁定到当前地理位置最优的专线出站节点。无论是海外即时通讯、视频会议还是云端邮件同步均未发生过哪怕一次断流，为商业谈判赢得了最可靠的信息保障。

9. 权威排错与高频常见问题解答 (FAQ)

Q1: Stash 与 Clash Verge Rev、Surge 相比，核心优势到底在哪里？

Stash 的核心优势在于 “专为 Apple 全家桶量身定制的极致原生体验与 Clash 规则的高度亲和力”。Clash Verge Rev 是桌面端（Windows/Mac）的利器，但在 iOS 和 tvOS 上并无官方移动端；而 Surge 尽管技术实力极强，但其高昂的按设备买断费用与独特的专有配置语法让很多普通用户望而却步。Stash 允许你仅凭一次买断即可全量覆盖 iPhone、iPad、Mac 与 Apple TV，同时可以直接读取标准的 Clash YAML 语法，兼顾了成本、易用性与极致体验。

Q2: 为什么导入 Clash 订阅后，部分节点显示“不支持的协议类型”？

这通常是因为你的订阅中包含了较新或较为冷门的协议变种（如某些非标的 TUIC v5 自定义变体，或使用了未公开的私有加密流控）。建议在 Stash 设置中检查当前核心版本是否已更新至最新，或者在机场后台将订阅导出格式选择为标准的“Clash.Meta (Mihomo)”通用格式。

Q3: 为什么开启 Stash 后，Apple Music、iCloud 同步或隔空投送 (AirDrop) 出现异常？

这是由于配置中的规则未对 Apple 私有服务进行妥善直连保护导致的。解决方案是在配置文件的 rules 最前部加入针对苹果本地服务与局域网广播的豁免规则：

yaml

rules:
  - DOMAIN-SUFFIX,push.apple.com,DIRECT
  - DOMAIN-SUFFIX,icloud.com,DIRECT
  - DOMAIN-SUFFIX,ls.apple.com,DIRECT
  - GEOIP,lan,DIRECT,no-resolve

确保系统底层局域网发现协议（如 mDNS/Bonjour）不被劫持到虚拟网卡上。

Q4: 开启 MitM HTTPS 解密后，银行 App 提示“网络环境不安全”并强制退出？

这是因为现代大型银行金融类 App 和部分政务类应用（例如招商银行、工商银行、个人所得税等）在代码中严格部署了 SSL Pinning（证书公钥绑定） 技术。它们在与服务器握手时，会硬编码比对服务端证书的公钥指纹。当遇到 Stash 的自建根证书时，系统会判定存在中间人网络窃听风险并主动断开连接。解决方案是在 Stash 的 MitM 域名列表中，绝对不要配置这些银行机构的域名，或者在 MitM 设置面板中直接将它们加入 Skip List（跳过名单）。

Q5: 为什么 Apple TV 上的 Stash 在长时间待机后会自动断开？

Apple TV 在进入休眠待机状态时，tvOS 内核会对后台网络活动进行极端激进的休眠省电冻结。解决办法是：打开 Apple TV 系统“设置” -> “隔空播放与 HomeKit” -> 确保将 Apple TV 设置为“家庭中枢（Home Hub）”，这样操作系统会维持 tvOS 底层微内核的常态化唤醒；同时在 Stash 的 tvOS 端高级设置中，勾选开启 “常驻后台旁路模式 (Keep-Alive Daemon)”。

Q6: Stash 如何实现类似 Surge 的去开屏广告和网页净化？

Stash 完全支持基于 JavaScript 的脚本引擎与 URL Rewrite 重写。你可以在 Stash 中订阅社区成熟的去广告规则集（例如墨鱼规则或野比去广告脚本）。通过 MitM 解密应用层流量，配合正则匹配将广告请求重定向为 reject，即可在客户端呈现完全纯净无广告的界面体验。

Q7: Stash 能够像网易 UU 等专业加速器那样加速 Switch 或 PS5 主机游戏联机吗？

Stash 可以加速主机游戏，但其专长在于 “游戏更新包下载提速、任天堂 Eshop 商店与 PSN 联机商城的极速加载”。对于高精度的 P2P 对战类网游（如《任天堂全明星大乱斗》、《喷射战士》或外服《FIFA》），由于这些游戏严苛依赖 NAT 穿透类型（要求 NAT Type A），普通代理协议的 UDP 转发难以稳定保障全锥形 NAT。对于电竞联机对战，依然建议使用网易 UU 等具备物理链路优化与专用 NAT 穿透驱动的游戏加速器。

Q8: 如何通过 iCloud 彻底清空或重置 Stash 的云端错误配置？

打开 iPhone 系统“设置” -> 点击顶部的个人“Apple ID 头像” -> 进入“iCloud” -> 点击“管理账户储存空间” -> 在应用列表中找到 Stash -> 点击“从 iCloud 中删除数据”。随后在手机本地卸载并重新安装 Stash，即可彻底清除由错误脚本引发的云端死锁，恢复出厂默认状态。

10. 跨专题矩阵导航与推荐资源索引

在苹果全生态上掌握了 Stash 的高阶分流与客厅网关配置后，建议联动阅读本站客户端矩阵与高品质专线指南，构建全方位的极速数字网络体验：

全平台客户端深度配置指南：
- 苹果 iOS 入门必备神器：👉 Shadowrocket 小火箭 iOS 深度配置全书
- Windows/macOS 现代主力：👉 Clash Verge Rev 跨平台深度配置全书
- 通用下一代解耦协议核心：👉 Sing-box 跨平台全协议核心指南与 TUN 实战
- 苹果生态跨设备协同全景：👉 Apple 苹果生态跨设备代理协同终极指南
- Windows 极客多核心神器：👉 v2rayN Windows 经典客户端深度配置与多内核调优全书
高端稳定机场与优质专线推荐：
- 2026 年度综合性能梯队榜单：👉 2026 稳定优质机场综合评测梯队
- 跨境全专线超低延迟推荐：👉 高端稳定专线机场选型指南
- 高性价比平民首选方案：👉 高性价比平民机场横向对比
网络故障排查与深度调优：
- 深入排查系统级 DNS 污染：👉 DNS 污染排查与防泄漏高阶实战
- 游戏双开与驱动冲突排障：👉 网易 UU 加速器海外服能看网页吗？双开与分流实操
- 节点超时排错与网络修复：👉 节点大面积超时排错完全手册

Stash 苹果全生态代理客户端进阶实战指南：iOS、iPadOS、macOS 与 Apple TV 四端联动、Clash 规则无缝迁移、脚本重写与抓包解密全书 ​

答案摘要块：核心结论与速查索引 ​

1. Stash 产品定位与 Apple 全生态架构深度剖析 ​

1.1 为什么 Stash 被誉为“苹果平台体验最好的 Clash 衍生客户端”？ ​

1.2 四端买断机制与多设备生态闭环优势 ​

2. Stash 与 Surge、Shadowrocket、Loon 顶级工具全景横评 ​

2.1 四大苹果代理客户端客观技术维度对比表 ​

3. Clash 规则集无缝迁移与本地/远程订阅托管实操 ​

3.1 生产级标准 Clash YAML 配置文件实战范例 ​

4. Apple TV 独立客户端部署与客厅旁路网关模式实操 ​

4.1 如何在 Apple TV 上启用 Stash 旁路网关模式（Gateway Mode）？ ​

4.2 tvOS 17+ 客厅网关实测数据、多用户切换与家庭自动化 ​

5. 高阶生产力：MitM 解密、URL 重写与 JavaScript 脚本实战 ​

5.1 生成与完全信任本地 MitM 根证书的关键四步 ​

5.2 JavaScript 定时任务 (Cron) 自动化执行与告警推送实战 ​

6. 耗电量调优与 iOS 后台常驻机制深度优化 ​

6.1 拆解 iOS 电池统计假象与真实功耗 ​

6.2 降低 Stash 真实能耗的三大高阶调优手段 ​

7. 跨端协同：macOS 与 Apple TV 全场景无感热备 ​

7.1 macOS 端 Stash 的高级系统助手模式（Helper Mode） ​

7.2 macOS 菜单栏快捷控制与 iOS 快捷指令 (Shortcuts) 自动化网络切换 ​

8. 三大真实苹果生态全场景落地实战案例 ​

案例一：外企中层管理者的全套 Apple 全家桶自动化静默分流与家庭影院无缝解锁 ​

案例二：移动端前端与逆向开发者的 iOS 抓包调试、接口 Mock 与 HTTPS 解密 ​

案例三：高频跨国商旅精英的多地区海外漫游自适应快速切换 ​

9. 权威排错与高频常见问题解答 (FAQ) ​

Q1: Stash 与 Clash Verge Rev、Surge 相比，核心优势到底在哪里？ ​

Q2: 为什么导入 Clash 订阅后，部分节点显示“不支持的协议类型”？ ​

Q3: 为什么开启 Stash 后，Apple Music、iCloud 同步或隔空投送 (AirDrop) 出现异常？ ​

Q4: 开启 MitM HTTPS 解密后，银行 App 提示“网络环境不安全”并强制退出？ ​

Q5: 为什么 Apple TV 上的 Stash 在长时间待机后会自动断开？ ​

Q6: Stash 如何实现类似 Surge 的去开屏广告和网页净化？ ​

Q7: Stash 能够像网易 UU 等专业加速器那样加速 Switch 或 PS5 主机游戏联机吗？ ​

Q8: 如何通过 iCloud 彻底清空或重置 Stash 的云端错误配置？ ​

10. 跨专题矩阵导航与推荐资源索引 ​

Stash 苹果全生态代理客户端进阶实战指南：iOS、iPadOS、macOS 与 Apple TV 四端联动、Clash 规则无缝迁移、脚本重写与抓包解密全书

答案摘要块：核心结论与速查索引

1. Stash 产品定位与 Apple 全生态架构深度剖析

1.1 为什么 Stash 被誉为“苹果平台体验最好的 Clash 衍生客户端”？

1.2 四端买断机制与多设备生态闭环优势

2. Stash 与 Surge、Shadowrocket、Loon 顶级工具全景横评

2.1 四大苹果代理客户端客观技术维度对比表

3. Clash 规则集无缝迁移与本地/远程订阅托管实操

3.1 生产级标准 Clash YAML 配置文件实战范例

4. Apple TV 独立客户端部署与客厅旁路网关模式实操

4.1 如何在 Apple TV 上启用 Stash 旁路网关模式（Gateway Mode）？

4.2 tvOS 17+ 客厅网关实测数据、多用户切换与家庭自动化

5. 高阶生产力：MitM 解密、URL 重写与 JavaScript 脚本实战

5.1 生成与完全信任本地 MitM 根证书的关键四步

5.2 JavaScript 定时任务 (Cron) 自动化执行与告警推送实战

6. 耗电量调优与 iOS 后台常驻机制深度优化

6.1 拆解 iOS 电池统计假象与真实功耗

6.2 降低 Stash 真实能耗的三大高阶调优手段

7. 跨端协同：macOS 与 Apple TV 全场景无感热备

7.1 macOS 端 Stash 的高级系统助手模式（Helper Mode）

7.2 macOS 菜单栏快捷控制与 iOS 快捷指令 (Shortcuts) 自动化网络切换

8. 三大真实苹果生态全场景落地实战案例

案例一：外企中层管理者的全套 Apple 全家桶自动化静默分流与家庭影院无缝解锁

案例二：移动端前端与逆向开发者的 iOS 抓包调试、接口 Mock 与 HTTPS 解密

案例三：高频跨国商旅精英的多地区海外漫游自适应快速切换

9. 权威排错与高频常见问题解答 (FAQ)

Q1: Stash 与 Clash Verge Rev、Surge 相比，核心优势到底在哪里？

Q2: 为什么导入 Clash 订阅后，部分节点显示“不支持的协议类型”？

Q3: 为什么开启 Stash 后，Apple Music、iCloud 同步或隔空投送 (AirDrop) 出现异常？

Q4: 开启 MitM HTTPS 解密后，银行 App 提示“网络环境不安全”并强制退出？

Q5: 为什么 Apple TV 上的 Stash 在长时间待机后会自动断开？

Q6: Stash 如何实现类似 Surge 的去开屏广告和网页净化？

Q7: Stash 能够像网易 UU 等专业加速器那样加速 Switch 或 PS5 主机游戏联机吗？

Q8: 如何通过 iCloud 彻底清空或重置 Stash 的云端错误配置？

10. 跨专题矩阵导航与推荐资源索引