Apple TV Quantumult X 配置教程：从安装到连接排查
简答：Apple TV 配置 Quantumult X，最短路径是：在 App Store 安装适用于 tvOS 的 Quantumult X，用 iPhone 键盘输入订阅或配置地址，更新节点后选择策略并开启 Tunnel。若节点为空、Tunnel 无法启动或应用无法连接，应先区分地址失效、配置格式不兼容、系统授权和 DNS/IPv6 等问题。
定义：Apple TV Quantumult X 配置，是指在 tvOS 设备上安装 Quantumult X，并导入节点或完整配置文件后完成策略选择、Tunnel 授权与连接复测。
先看一分钟速查：你需要准备什么
本文是 CreamData 的第三方使用指南，不代表 Quantumult X 或 Apple TV 官方。Apple TV 上的 Quantumult X 是否能安装，首先取决于设备是否支持 App Store、Apple 账户所在地区是否能看到该应用，以及当前设备是否满足应用页面列出的 tvOS 要求。Apple 官方说明，Apple TV 4K 和 Apple TV HD 可以从 App Store 下载应用；第三代 Apple TV 无法安装新应用。Apple 官方下载 Apple TV 应用说明
| 检查项 | 判定方法 | 不满足时怎么处理 |
|---|---|---|
| Apple TV 型号 | 确认设备不是第三代 Apple TV | 第三代设备不能通过 App Store 安装新应用 |
| Quantumult X 可见性 | 打开 App Store 搜索应用名称 | 看不到时，先检查账户地区、系统更新和应用兼容性 |
| tvOS 要求 | 以 App Store 当前页面的兼容性信息为准 | 页面显示的要求高于设备系统时，不能按本文继续安装 |
| 订阅或配置地址 | 准备可访问的 HTTPS 地址或完整配置文件 | 不要把登录密码、短期令牌或私人链接公开给他人 |
| iPhone 或 iPad | 用于在 Apple TV 文本框中输入长地址 | 也可以使用 Siri Remote，但长链接更容易输错 |
App Store 页面目前明确列出 Apple TV 支持，并显示需要 tvOS 17.0 或更高版本；版本号、价格和地区可见性会随商店页面变化，安装前应以当前页面为准。App Store 中的 Quantumult X 页面
最短可执行步骤：安装并导入配置
- 安装应用：在 Apple TV 主屏幕打开 App Store，搜索 Quantumult X，进入应用详情页并选择获取或购买。若显示“打开”，说明应用已经安装；若完全搜不到，不要从不明来源下载所谓安装包，先回到上面的兼容性检查。Apple 官方给出的安装入口是 App Store。Apple 官方安装应用步骤
- 准备输入方式：在 Apple TV 打开 Quantumult X，进入需要填写 URL、订阅地址或配置内容的输入框。此时，如果附近的 iPhone 或 iPad 满足同一 Apple 账户、蓝牙和 Wi-Fi 等条件，设备通常会收到 Apple TV 键盘通知。点击通知即可在手机上输入，内容会同步到电视端。Apple 官方：使用 iPhone 或 iPad 作为 Apple TV 键盘
- 输入地址：优先粘贴由订阅服务或配置维护者提供的原始地址，不要自行修改协议头、参数或编码。输入完成后，逐字符检查开头的协议、域名、路径和末尾参数，再确认保存。地址涉及账户权限时，不要截图或发布到公开群组。
- 判断导入类型：如果导入后只出现节点列表，说明更接近“节点订阅”；如果同时出现规则、策略组、DNS 或重写等内容，才属于完整配置。两者不能混为一谈：节点订阅通常只提供服务器信息，完整配置还会决定分流和解析行为。
- 更新内容：在 Quantumult X 中找到已添加的订阅或配置，执行更新操作。更新结束后记录三个结果：是否提示成功、节点数量是否变化、配置页面是否出现错误信息。不要只看“更新完成”，还要确认节点列表确实出现。
- 选择策略：先选择一个明确可用的节点或策略组，不要一开始就叠加大量规则、重写和 DNS 修改。首次验证的目标只有两个：Tunnel 能启动，以及目标应用能完成一次可重复的网络请求。
- 首次授权 Tunnel：在 Quantumult X 中开启 Tunnel 或 VPN 相关开关。系统出现网络扩展或 VPN 授权提示时，按屏幕提示确认。若没有弹窗，先关闭应用后重新打开，再检查开关状态和系统设置中是否存在对应的 VPN 配置。
- 完成复测：先打开一个普通网页或应用页面，再关闭 Tunnel 重试一次，记录两次现象。只有在“关闭时失败、开启后成功”且重复结果一致时，才能说明该次配置对目标请求产生了影响；仅凭出口 IP 变化，不能证明所有应用流量都经过同一规则。
订阅导入、完整配置和 iCloud 同步怎么选
| 方式 | 适合场景 | 优点 | 注意事项 |
|---|---|---|---|
| 直接输入节点订阅 | 只想先验证节点和基础连接 | 步骤短，出错范围较小 | 规则、DNS 和策略组可能需要另外设置 |
| 导入完整配置文件 | 已有维护好的规则与策略 | 节点、分流和部分网络参数可以一起载入 | 字段可能因 Quantumult X 版本或配置来源不同而不兼容 |
| iPhone/iPad 先配置，再同步到 Apple TV | 电视端输入困难，且已有移动端配置 | 手机端编辑长文本更方便 | 需要确认设备、账户和应用版本的同步条件 |
App Store 的版本历史曾列出通过 iCloud 将配置共享到 tvOS 设备的能力，但具体菜单名称和当前可用状态应以你设备上的实际界面为准。不要把“手机端能正常使用”直接等同于“电视端一定兼容”，尤其要重新核对节点协议、规则字段和 tvOS 支持情况。App Store 中的 Quantumult X 版本历史与设备支持信息
如果只是输入长链接，优先使用 Apple TV 的系统键盘通知；如果是编辑多段配置，优先在 iPhone 或 iPad 端整理并保存，再尝试同步。Apple 官方也提供 Siri Remote 输入方式，但长地址用遥控器逐字符输入时更容易发生大小写、符号或末尾参数错误。Apple 官方：在 Apple TV 上输入文字
连接失败时按现象分流
- 节点列表为空：先重新打开订阅地址，确认手机或电脑浏览器能访问该地址；再检查是否把分享页、登录页或失效链接误当成订阅地址。若浏览器返回 HTML 页面而不是配置内容，说明地址类型可能不对。记录返回结果和更新时间，不要反复点击更新来代替核验。
- 更新报错或节点数量为零：检查地址是否被截断、参数是否缺失、订阅是否过期，以及配置格式是否为当前应用能识别的格式。若只有完整配置导入失败，可以先备份原配置，再用最小节点订阅测试，以区分“地址问题”和“配置字段问题”。
- Tunnel 无法启动：先确认系统授权提示是否被取消，再关闭其他可能占用 VPN 或网络扩展的应用，重启 Quantumult X 后重新授权。若仍失败，记录 Apple TV 型号、tvOS 版本、Quantumult X 页面显示的兼容性要求和错误文字，避免只描述“连不上”。
- Tunnel 已开但应用打不开：先把策略切换为一个明确节点，暂时不要同时修改 DNS、IPv6 和规则。随后分别测试域名解析、网页请求和目标应用。应用可能使用独立网络栈、区域限制、证书校验或自身代理设置，因此不能仅凭浏览器成功就判断流媒体或其他应用一定成功。
- 域名解析失败或表现反复：记录失败域名、发生时间、当前策略和 DNS 设置。不要直接把 DNS 劫持、IPv6 或节点问题混为一谈；可以先恢复默认 DNS，关闭复杂规则后复测，再一次只改一个变量。
- HomeKit 或局域网设备异常：如果开启后本地设备发现、家庭中枢或局域网访问出现问题，先暂时关闭 Tunnel 做对照。若关闭后恢复，优先检查局域网地址、排除路由和分流规则；没有实测证据时，不要直接断言某个字段一定能解决。
配置完成后的复测与回滚清单
- 保存基线：记录 Apple TV 型号、tvOS 版本、Quantumult X 当前页面显示版本、配置更新时间、所选节点和 Tunnel 状态。
- 单变量复测：每次只改变一个项目，例如只切换节点、只关闭规则、只恢复默认 DNS。每次测试至少记录“成功、失败、超时或解析失败”之一。
- 分应用验证：分别测试普通网页、需要登录的应用和局域网功能。不要把一个应用的结果推广到全部流量。
- 回滚：先关闭 Tunnel，再删除或停用刚导入的配置，恢复之前备份的配置。若问题发生在更新后，可以先回到原配置验证；不要在未备份时批量替换字段。
一个可复现的结论应至少包含：设备与系统版本、配置来源类型、节点或策略名称、开关状态、测试时间、具体失败表现和回滚结果。这样后续无论是更换节点、调整 DNS，还是检查网络线路，都能判断问题究竟发生在哪一层。
常见问题 FAQ
Apple TV 上搜不到 Quantumult X，应该怎么办？
先确认设备是否属于可从 App Store 安装应用的 Apple TV 机型，再检查 Apple 账户地区、系统版本和 App Store 当前兼容性信息。当前页面显示的 tvOS 要求高于设备系统时，应先升级系统或更换兼容设备；不要使用未核实的安装包。
一定要用 iPhone 才能在 Apple TV 上输入订阅吗？
不是。Apple TV 可以使用 Siri Remote 的屏幕键盘输入，但长订阅地址容易出错。若有符合条件的 iPhone 或 iPad，Apple 官方支持在 Apple TV 出现文本框时通过设备键盘输入，通常更适合长链接。
只导入节点订阅后能不能直接使用？
可以先用它验证节点是否能更新和连接，但节点订阅不一定包含完整规则、策略组或 DNS 设置。若目标是分流或特定应用排查，应确认导入内容是否包含相应配置，并逐项复测。
节点更新成功但列表仍然为空，问题在哪里？
优先检查订阅地址是否为真实配置内容、是否需要登录、是否已过期，以及地址是否在输入时被截断。记录更新提示和节点数量；如果浏览器打开的是网页说明页而不是配置文本，通常需要重新获取正确的订阅地址。
Tunnel 开启后，是否代表 Apple TV 所有流量都已代理？
不能直接这样判断。应用自身网络行为、规则匹配、DNS、IPv6、局域网排除项和系统限制都可能影响结果。应结合日志、域名解析、目标应用实际请求和关闭 Tunnel 后的对照测试判断。
配置出错后如何恢复？
先关闭 Tunnel，保留原配置备份，再停用或删除刚导入的配置，恢复上一份可用配置。每次只改一个变量，并记录修改前后的结果，避免连续修改导致无法定位原因。
常见问题
Apple TV 上搜不到 Quantumult X，应该怎么办？
先确认设备是否支持 App Store 安装应用，再核对账户地区、系统版本和 App Store 当前兼容性。若设备系统低于应用要求，应先升级或更换兼容设备，不要使用未核实安装包。
一定要用 iPhone 才能输入订阅吗？
不是。Apple TV 可以使用 Siri Remote 输入；如果有符合条件的 iPhone 或 iPad，也可以在 Apple TV 出现文本框时使用手机键盘输入长地址。
只导入节点订阅后能不能直接使用？
可以先验证节点更新和基础连接，但节点订阅不一定包含规则、策略组或 DNS 设置。需要分流时，应确认配置内容并单独复测。
节点更新成功但列表为空怎么办？
检查地址是否为真实配置内容、是否需要登录、是否已过期，以及输入时是否被截断。浏览器如果打开的是网页说明页而不是配置文本，应重新获取订阅地址。
Tunnel 开启后是否代表所有流量都已代理？
不能直接判断。还要核对规则、DNS、IPv6、应用网络行为和局域网排除项，并用日志、域名解析和关闭 Tunnel 的对照测试复核。