Apple TV Stash 教程:从下载安装到导入配置
简答:先确认 Apple TV 已升级到 tvOS 17.0 或更高版本,再从 App Store 安装 Stash。打开后使用有效的 Subscription URL 下载配置,进入 Proxy 或 Policy 选择策略并启动;若启动后无网络,先关闭 VPN,重新下载配置并检查节点与规则。
定义:Apple TV Stash 教程,是指在 tvOS 上安装 Stash、导入订阅或配置、选择代理策略并验证 Apple TV 连接是否生效的操作指南。
三步速查:先让 Apple TV 自己完成分流
| 步骤 | 操作 | 成功标志 |
|---|---|---|
| 1. 检查环境 | 确认 Apple TV 使用 tvOS 17.0 或更高版本,并能正常打开 App Store | 能搜索到商品名为 Stash - Rule Based Proxy 的应用 |
| 2. 导入配置 | 打开 Stash,选择添加配置或从 URL 下载,粘贴 Subscription URL | 配置名称出现在列表中,且下载没有报错 |
| 3. 启动并选择策略 | 点击 Start,再进入 Proxy 或 Policy 选择节点或策略组 | VPN 状态显示已启动,目标应用可以重新联网 |
本文只讲“让 Apple TV 自己使用 Stash 分流”,不包含把 Apple TV 配置成局域网旁路由、网关或家庭网络共享代理的方案。需要局域网其他设备经过 Apple TV 时,应另行核对路由器、网关和客户端的官方说明。
安装前检查:系统、商品名称与下载渠道
Apple TV 端首先要满足系统条件。Stash 官方中文页面当前列出的要求是:Apple TV 使用 tvOS 17.0 或更高版本;iPhone、iPad 与 Apple TV 使用同一个 App Store 商品。官方列出的商品名称是 Stash - Rule Based Proxy,开发者为 Stash Networks Limited。可先打开 Stash 官方 iOS 与 tvOS 页面核对当前要求。
- 在 Apple TV 打开“设置”,进入“系统”或系统信息页面,确认 tvOS 版本。
- 打开 App Store,切换到搜索,输入
Stash。 - 核对商品名称和开发者,不要仅凭图标或相似名称安装其他应用。
- 确认 Apple TV 的 App Store 账号能够正常下载应用。
- 从 App Store 安装 Stash。官方下载页说明,iPhone、iPad 和 Apple TV 使用同一个 App Store listing。
Stash 官方说明 iOS 与 tvOS 通过 App Store 分发,Apple TV 端不应使用来源不明的 IPA 或修改版安装包。下载入口可通过 Stash 官方下载页再次核对。
配置链接怎么选:Subscription URL、YAML 与二维码
Apple TV 新手最容易把不同类型的配置混在一起。可以按下面的方式判断:
| 形式 | 它是什么 | Apple TV 新手怎么处理 |
|---|---|---|
| Subscription URL | 用于在线下载或更新配置的链接 | 优先使用;向配置提供方索取完整链接并复制粘贴到 Stash |
| profile/YAML | 包含规则、策略组和代理配置的文本或文件 | 先确认当前 tvOS 版本是否支持对应导入方式;不确定时不要把 YAML 文本直接当网址粘贴 |
| 二维码 | 把链接或配置编码成图片 | 本文不把扫码作为主路径;Apple TV 是否支持某种扫码导入,需以当前版本和提供方说明为准 |
Stash 官方介绍使用 YAML 保存可复用配置,并通过规则和策略组决定连接路径;但具体订阅格式、字段和更新方式取决于配置提供方。若你拿到的不是 URL,而是一段 YAML 文本,先确认它是否为完整配置文件,不要随意修改字段或缩进。
Apple TV 端导入 Subscription URL:照着做
- 先在手机、电脑或其他设备上复制完整的 Subscription URL。复制时从协议头开始,到链接末尾结束,不要带聊天软件自动添加的空格、引号或句号。
- 打开 Apple TV 上的 Stash,进入配置列表或当前配置页面。
- 点击添加按钮,选择从 URL 下载配置;不同版本的按钮文字可能略有不同。
- 把 Subscription URL 粘贴到输入框,确认后点击下载或保存。
- 等待配置完成。下载结束后,检查配置名称是否出现在列表中;如果仍显示空列表,先不要启动 VPN。
- 选择刚下载的配置作为当前配置,然后再进入 Proxy 或 Policy 页面。
如果 Apple TV 上不方便输入长链接,可以在手机或电脑上准备好链接,再通过系统支持的粘贴方式传入。配置下载完成并不等于已经连接成功,后面还要选择策略并启动。
启动 Stash、选择节点并验证连接
- 确认当前配置已经选中,点击 Stash 界面中的 Start 或启动按钮。
- 如果配置包含多个节点或策略组,进入 Proxy 或 Policy 页面,选择一个具体节点或策略组。
- 观察被选项目是否出现勾选、激活或高亮状态。仅仅看到节点名称,不代表它已经被当前策略使用。
- 打开 Apple TV 上的目标应用进行测试。建议先用一个普通网页或可正常联网的应用,不要一开始就同时测试多个应用。
- 如果配置提供出口 IP、DNS 或诊断页面,可在启用后检查结果;没有检测页面时,以目标应用能否正常加载作为初步结果。
Stash 官方将其定位为基于规则的网络工具,实际连接路径由配置中的规则和策略组决定。也就是说,启动 VPN 后某个应用仍然直连,可能是规则将该域名指定为 DIRECT,而不一定是节点失效。可先更换策略组,再查看日志或配置规则。
连接失败排查:按现象分流
| 现象 | 先检查 | 下一步 |
|---|---|---|
| App Store 搜不到 Stash | tvOS 是否达到 17.0;搜索词和商品名称是否正确;App Store 账号是否能正常下载 | 打开官方 iOS 与 tvOS 页面核对商品名称和系统要求;不要从未知渠道安装 IPA |
| 提示重复购买或无法恢复购买 | Apple TV 与原购买设备是否使用同一 App Store 账号 | 退出并重新登录购买账号,仍无法确认时联系官方支持;本文不判断具体收费或账号状态 |
| 配置下载失败 | 链接是否完整、是否过期、是否包含空格或引号 | 在其他设备检查链接能否打开;重新复制 Subscription URL,再回到 Stash 下载 |
| 启动后完全无网络 | 先停止 VPN,确认 Apple TV 自身网络正常 | 重新下载配置;再选择其他节点或策略组,最后查看日志定位 DNS、规则或节点错误 |
| 节点已选但某个应用打不开 | 是否真的选中了策略;规则是否把目标域名设为 DIRECT 或 REJECT | 切换策略组测试,并逐项查看日志;不要直接开启 MitM 或修改全部规则 |
| 只有部分内容无法加载 | 目标应用的域名是否被规则拆分到不同策略 | 先记录失败域名和日志结果,再调整对应规则;修改前保留原配置,便于回滚 |
排查时建议遵循“停止 VPN—恢复正常网络—重新下载配置—选择节点—再次启动—验证应用”的顺序。这样可以区分是 Apple TV 本地网络、配置文件、策略规则还是具体节点造成的问题。
tvOS 上不建议一开始开启的进阶功能
Stash 的规则、日志、覆写和 HTTPS 解密能力适合需要调试网络请求的用户,但它们不是 Apple TV 首次安装的必要步骤。Stash 官方说明,查看 HTTPS 内容需要额外配置并启用解密。
- 刚完成安装时,先只使用基础配置、策略选择和日志查看。
- 不要为了测试普通联网功能就开启 MitM、安装证书或导入陌生脚本。
- 如果启用进阶功能后出现应用打不开,先关闭相关功能并恢复原配置。
- 保留一份未修改的原始配置,调整规则前记录修改内容,方便回滚。
另外,Apple TV 的 tvOS 环境与 iPhone、iPad、macOS 并不完全相同。来自其他平台的规则字段、脚本或进程匹配条件不一定能直接复用;遇到兼容性问题时,应以当前版本文档和配置提供方说明为准,无法核实时标记为“未核实”。
完成标准:怎样判断 Apple TV Stash 已配置好
- App Store 安装的是正确商品,tvOS 版本满足要求。
- Stash 能显示已下载的配置,而不是只有空白配置列表。
- VPN 启动后,Proxy 或 Policy 页面能看到当前激活的节点或策略组。
- 至少一个目标应用能够正常联网。
- 切换节点或策略后,应用表现和日志结果能够发生对应变化。
- 关闭 VPN 后,Apple TV 可以恢复原有网络连接。
如果只能完成安装但无法完成配置下载,问题通常集中在 Subscription URL 或配置提供方;如果配置能下载但应用打不开,优先检查策略组、规则和节点,而不是反复重装应用。
相关阅读与下一步
如果你还没有准备好配置链接,可以先阅读设备配置指南,了解不同设备导入配置前需要准备什么;遇到跨平台连接异常时,可继续查看连接问题排查,按网络、DNS 和客户端状态分层定位。
常见问题
Apple TV 安装 Stash 需要什么系统?
官方页面当前列出的要求是 tvOS 17.0 或更高版本。若低于该版本,先升级系统,再到 App Store 搜索并核对商品名称。
Apple TV 上应该导入什么链接?
优先使用完整的 Subscription URL,用它下载配置。YAML 文件和二维码不是同一种东西;格式不确定时,不要把 YAML 文本直接粘贴到网址输入框。
为什么配置下载成功,Apple TV 还是打不开应用?
先确认 VPN 已启动,再进入 Proxy 或 Policy 选择实际节点或策略组。随后检查规则是否把目标域名设为直连或拦截,并查看日志。
Apple TV 可以直接使用 iPhone 的 Stash 配置吗?
可以尝试复用同一份配置或订阅链接,但 tvOS 与 iOS 的能力并不完全相同。涉及脚本、进程匹配或进阶字段时,应以当前版本支持情况为准。
启动 Stash 后 Apple TV 完全没有网络怎么办?
先停止 VPN,确认 Apple TV 原本的网络正常;然后重新下载配置、换一个节点或策略组,再启动测试。若仍失败,保留日志和配置名称,便于继续定位。
Apple TV Stash 教程是否包含旁路由设置?
不包含。本文只讲 Apple TV 自身使用 Stash 分流;让局域网其他设备通过 Apple TV 的网关或旁路由方案,需要单独核对路由器和网络拓扑。
相关阅读
参考资料
- Stash 官方:iOS 与 tvOS 页面(stash.ws)
- Stash 官方下载页(stash.ws)
- Stash 官方中文主页(stash.ws)