准备同一 iCloud 账户的 Apple 设备

本文覆盖 Apple TV 上的 Stash，并用 iPhone/iPad 辅助导入。官方产品页要求 tvOS 17 或更高版本，手机端要求 iOS 16 或更高版本；安装前再看当前商店兼容性。Stash 的 iOS/tvOS 属于同一 App Store 购买范围，具体价格和下载资格以自己的商店为准。

  1. 从 Stash 官方产品页进入 App Store，核对名称 Stash - Rule Based Proxy 和发布者 Stash Networks Limited。
  2. 在 Apple TV 的 App Store 下载对应应用；已购买时先核对购买账户，不因电视搜索不到就重复付款。Apple TV 第三代无法按本文安装。
  3. 准备自己的 iPhone/iPad，确保手机与 Apple TV 使用用于同步的同一 iCloud 账户，且 Stash 的 iCloud 功能可用。商店购买账户与 iCloud 同步账户的用途要分开核对。

在手机下载完整 Clash 配置

先在手机或电脑登录自己的 Roxi 账户，复制第三方客户端订阅地址。下文 /sub/nodes/ 或 /sub/clash/ 只表示链接路径：需要转换时只替换原 /sub/ 部分一次，保留原域名、个人标识及全部查询参数；已有专用格式链接就直接使用。官网首页、账户登录地址和“个人标识”占位文字都不是订阅。

选择 /sub/clash/个人标识 的完整 YAML 配置。Stash 需要配置文件来描述节点和网络策略；不要把 /sub/nodes/ 节点列表或 sing-box JSON 当成相同格式。首次先在手机完成下载与解析，避免把格式错误误判为电视同步故障。

  1. 在 iPhone/iPad 的 Stash 设置中进入“配置文件”，选择“从 URL 下载”，粘贴自己的完整 Clash 订阅链接后下载。
  2. 给配置使用容易辨认的名称，选中刚下载的文件；核对本轮下载结果和节点列表，不只看旧缓存。
  3. 在手机启动并验证基本配置。若报协议、规则提供者或字段错误，先处理手机这一步，再同步到电视。

通过 iCloud 同步，再在电视选用配置

Stash 官方说明支持通过 iCloud 同步配置文件、规则与订阅。本文采用这一方式，不把 iPhone 的“从 URL 下载”菜单位置照搬到 tvOS。同步入口及提示以两端实际版本为准。

  1. 检查手机 Stash 的 iCloud 同步状态，确保刚添加的配置已进入同步范围。保留原配置，先不要删除可用版本。
  2. 打开电视 Stash，查看同步状态与配置列表；确认出现同名配置，并核对节点或规则内容。只看到相同文件名还不足以证明内容已经更新。
  3. 在电视端选用这份配置，再启动连接并按系统提示确认授权。若当前版本要求重新加载配置，在完成同步后执行一次。
  4. 若列表仍为空，先排查两端 iCloud 账户、同步开关、网络和版本差异；不要连续重复导入生成多份配置，也不要未经核对改用测试版。

同步成功后，仍要核对规则与协议

Roxi Clash 配置使用的外部规则资源也需要能下载或有有效缓存。Stash 当前官方文档列出了 domain/ipcidr 的 MRS 支持，但这不能证明旧版本支持所有字段，也不能证明所有 mihomo 传输组合都兼容。遇到错误时记录 provider、behavior/format 和协议字段，再对照文档；只修改文件后缀不会转换格式。

手机与电视可能运行不同版本。若手机可用而电视解析失败，先比较版本、配置内容和依赖资源；若启动成功但目标请求走 DIRECT，则继续检查策略组和规则。首次导入无需为普通代理使用安装 MitM 证书或配置家庭网关。

更新、验证与恢复

  1. 先在电视端确认本次配置已加载、节点非空，固定一条节点，保留默认规则做首次验证。
  2. 打开电视上实际使用的应用，分别检查页面加载、登录和播放；记录失败发生在哪一步。再查看电视端请求记录、命中规则和出口，不能拿手机日志替代电视证据。
  3. 同时检查常用直连应用和投屏；随后在电视客户端停止连接，再确认基础网络恢复。遥控器返回主页不等于停止 VPN。
  1. 订阅到期或节点变化时，先确认手机获取了新的远程配置，再核对同步后的电视内容。远程资源更新、iCloud 同步和电视重新加载是不同环节。
  2. 若只更新了远程代理集或规则集，也要检查电视上的资源更新时间；不能只凭手机显示了新节点认定电视一致。
  3. 新配置有问题时，重新选用之前保存的可用副本并同步；退出前在电视内停止连接，若会自动重连，再检查该客户端的按需连接设置。
失败位置先检查
手机下载失败链接、账户状态、HTTP 错误、当前网络
手机已导入，电视没有iCloud 同步账户、开关与状态
电视显示配置但启动失败电视版本、协议字段、规则资源与日志
启动成功但目标应用异常电视请求命中规则、出口及应用自身错误；不要用手机测试替代

本文按官方资料与 Roxi 订阅接口整理，未做真机连接实测。求助时只提供系统与客户端版本、失败步骤和脱敏错误；订阅链接、配置、二维码可能包含访问凭据，不发送到公共群或公共剪贴板。