Quantumult X Apple TV 设置:先分清单机代理与家庭网关
简答:Quantumult X 可以安装在支持 tvOS 17.0 或更高版本的 Apple TV 上。最稳妥的顺序是:先在 iPhone 或 iPad 验证配置,再通过 iCloud 同步到 Apple TV,启动 Tunnel 后看日志或出口 IP;全屋使用则另行配置共享、DHCP 与 DNS。
定义:Quantumult X Apple TV 设置,是指在 Apple TV 上安装 Quantumult X,完成配置同步、节点选择、Tunnel 授权,以及按需要设置代理共享或家庭网络参数。
先判断你要哪种模式:三种设置不能混为一谈
Quantumult X 的 Apple TV 版本可在 App Store 查看,当前页面显示 Apple TV 需要 tvOS 17.0 或更高版本;具体上架地区、价格、兼容性和购买状态,以你所在地区的 App Store 页面为准。Apple TV 第三代没有 App Store,无法下载新的第三方应用。可先打开 Apple TV 的 App Store 搜索 Quantumult X,再决定是否继续。参考:Quantumult X App Store 页面、Apple:在 Apple TV 4K 和 Apple TV HD 上下载应用
| 模式 | 影响范围 | 需要做什么 | 适合谁 |
|---|---|---|---|
| Apple TV 单机代理 | 主要影响 Apple TV 上的应用 | 安装应用、同步配置、选择策略、启动 Tunnel | 只想让电视端应用使用配置 |
| HTTP/SOCKS5 共享 | 同一局域网内的指定设备 | 打开网络共享,其他设备手动填写 Apple TV 地址和端口 | 只让某台设备或某个应用使用代理 |
| 家庭网关尝试 | 可能影响局域网内多台设备 | 固定 Apple TV 地址,调整测试设备的网关、DNS 或路由器 DHCP | 希望把 Apple TV 放进家庭网络路径 |
快速分流:只想电视自己用,按下面的“同步配置”和“启动 Tunnel”操作;其他设备手动填代理,直接看“网络共享”;想让多台设备经过 Apple TV,先阅读“家庭网关步骤”,不要直接把网上的 192.168.x.x 地址照抄进路由器。
本站为独立第三方使用指南,与 Quantumult X、Apple 及相关服务提供方无关联。
先在 iPhone 或 iPad 准备配置,再同步到 Apple TV
- 确认 Apple TV 已连接 Wi-Fi 或以太网,并登录可以下载应用的 Apple Account。Apple 的设置指南说明,Apple TV 需要宽带网络和 Apple Account;是否能使用以太网取决于具体型号。参考:Apple:设置 Apple TV 4K
- 在 iPhone 或 iPad 上先导入你的配置文件或订阅。配置地址、节点账号和协议参数应使用你实际获得的内容,不要直接复制文章中的示例地址。
- 在 iPhone 或 iPad 上更新一次节点,选择一个已知可用的策略,并观察连接日志是否出现实际请求和命中的策略。仅看到“已连接”不等于所有应用都已经按预期分流。
- 打开 iCloud 云盘。在 Quantumult X 中进入右下角风车图标,打开“其他设置”,进入“资源”,确认 iCloud 云盘已启用;公开使用说明显示,相关资源会存放在 iCloud 云盘中的 Quantumult X 文件夹,并可同步至 Apple TV。参考:Quantumult X 其他设置说明
- 在 iPhone 或 iPad 的 Quantumult X 资源目录中放入需要同步的配置文件、配置片段或其他依赖资源。配置名称、策略组和规则资源要保持完整,否则 Apple TV 端可能只有部分内容。
- 在 Apple TV 上安装 Quantumult X,登录与 iPhone 或 iPad 相同的 Apple Account,并等待 iCloud 资源出现。若没有出现,依次检查 Apple Account、iCloud 云盘、网络连接和资源文件夹,再退出并重新打开应用。
Apple TV 端的界面文字可能随应用版本和语言变化。通常可从 Quantumult X 的设置入口进入“其他设置”,再查看“资源”或“Apple TV”相关项目;如果菜单名称不同,以当前界面显示为准。不要把“Apple TV 已安装应用”误认为“配置已经同步”。
Apple TV 端启动 Tunnel:载入、更新、验证按这个顺序
- 打开 Quantumult X,进入设置或资源相关页面,查看从 iCloud 同步过来的配置。若看到多个配置,先选择你在 iPhone 或 iPad 上验证过的那一个。
- 执行一次节点或订阅更新,确认节点列表能够加载。若节点全部显示 X,先不要改 DNS 或路由器,回到 iPhone 或 iPad 更新同一订阅,判断是订阅本身失败还是 Apple TV 端网络问题。
- 选择策略或节点。规则模式需要配置中存在相应策略和规则;全部代理、全部直连等模式的名称可能随界面变化,应以当前界面为准。
- 打开 Tunnel 或 VPN 连接。首次连接如出现系统授权提示,按 tvOS 提示允许;如果没有提示,可退出应用、重启 Apple TV 后再次尝试。
- 用 Apple TV 上实际使用的应用验证。优先查看 Quantumult X 连接日志中是否出现请求、命中的策略和目标域名;也可以在代理开启和关闭时对比出口 IP。网页能打开,只能说明基础网络可用,不能证明所有应用都经过同一策略。
如果开启 Tunnel 后 Apple TV 完全无法联网,先切换到全部直连或关闭特殊 DNS 设置,确认普通网络恢复,再一次只打开一个功能。Apple 的网络排查建议也包括重启 Apple TV、路由器,并确认 Apple TV 与相关设备处于同一网络。参考:Apple:Apple TV 出现网络问题或无互联网
网络共享:让指定设备手动使用 Apple TV 的代理
网络共享和家庭网关不是一回事。网络共享是 Quantumult X 在 Apple TV 上提供 HTTP 或 SOCKS5 入口,其他设备手动填写地址和端口;它不会自动接管整个局域网。
- 确认 Apple TV 与需要使用代理的设备连接到同一个局域网,避免使用访客网络或开启了终端隔离的无线网络。
- 在 Quantumult X 中进入右下角风车图标→“其他设置”→“VPN”,找到“HTTP、SOCKS5 代理服务器”或“网络共享”相关项目。
- 按需要开启 HTTP 或 SOCKS5 代理服务器,进入详情查看 Quantumult X 显示的服务器 IP 和端口。端口以应用当前显示为准,常见端口可能为 7897 或 7890,但不能直接照抄。
- 在另一台设备的 Wi-Fi 或应用代理设置中填写 Apple TV 的局域网 IP 和对应端口。浏览器或系统代理通常使用 HTTP;支持独立代理类型的应用再选择 SOCKS5。
- 先只测试一台设备。查看 Quantumult X 的连接日志是否出现该设备的请求,再对比代理关闭和开启时的出口 IP。若没有日志,优先检查两台设备是否同一网段、端口是否填错、路由器是否开启客户端隔离。
公开使用说明对“网络共享”的描述是:开启 HTTP 或 SOCKS5 代理服务器后,可为同一网络下的其他设备提供代理服务,并在设置中查看 IP 与端口。参考:Quantumult X 其他设置说明
家庭代理网关:先做单设备实验,再考虑 DHCP
把 Apple TV 设为家庭网络中的代理节点,不等于 Apple TV 会自动变成全屋路由器。最稳妥的做法是先固定地址、只测试一台终端,确认日志和出口 IP 都符合预期后,再考虑让路由器 DHCP 下发新参数。不同路由器和终端对网关、DNS、IPv6 的处理不同,无法保证所有应用和协议都能通过这种方式工作。
| 位置 | 参数 | 填写原则 | 验证方法 |
|---|---|---|---|
| Apple TV 自身 | IP 地址 | 使用路由器 LAN 网段内未占用的地址,或先在路由器中做 DHCP 静态租约 | 重启后地址仍保持一致 |
| Apple TV 自身 | 子网掩码、默认网关、DNS | 先沿用路由器当前有效参数;不要把 Apple TV 自己的默认网关改成 Apple TV 地址 | Apple TV 能访问路由器和普通网络 |
| 测试终端或 DHCP | 默认网关 | 只有明确测试家庭网关链路时,才将测试终端的网关指向 Apple TV 的实际局域网 IP | 终端能访问 Apple TV,并在日志中出现请求 |
| 测试终端或 DHCP | DNS | 按你的 DNS 设计填写;若依赖 Quantumult X 处理 DNS,终端必须能把 DNS 请求交给对应设备 | 域名解析正常,且连接日志或抓取记录有结果 |
| 路由器 | IPv6 | 先保持原状做基线测试;IPv4 正常而部分连接异常时,再单独测试 IPv6 | 关闭或恢复 IPv6 后故障现象发生变化 |
可替换参数卡:
Apple TV IP:<APPLE_TV_IP>
路由器 LAN IP:<ROUTER_LAN_IP>
测试终端默认网关:先填 <ROUTER_LAN_IP>,再按实验改为 <APPLE_TV_IP>
测试终端 DNS:<按你的 DNS 方案填写>
共享代理端口:<以 Quantumult X 网络共享页面显示为准>- 在 Apple TV 上记录当前 IP、子网掩码、默认网关和 DNS,不要先改动。
- 在路由器中为 Apple TV 做静态租约,或在 Apple TV 的网络设置中使用同一网段内未占用的地址。
- 只选择一台测试终端,把它的默认网关或代理设置改为 Apple TV 的实际 IP;不要立即修改全屋 DHCP。
- 在测试终端访问普通网站和目标应用,同时查看 Quantumult X 日志是否出现该终端请求,并对比出口 IP。
- 测试失败时,立即恢复测试终端原来的网关和 DNS。若恢复后网络正常,问题通常位于网关链路、DNS、IPv6 或终端隔离,而不是简单的节点选择。
Apple 官方明确提醒,同一网络应避免同时存在多个 DHCP 服务器;DNS 地址错误会导致域名无法解析,多个设备启用 NAT 也可能造成双重 NAT 问题。家庭网关实验应保留原路由器 DHCP,只在确认方案后再调整。参考:Apple:Apple TV 出现网络问题或无互联网
DNS、Fake-IP 与家庭中枢:出现断流时这样定位
Quantumult X 的 Tunnel 设置中包含 DNS 劫持、分流优化、兼容性增强和始终开启等选项。公开说明指出,DNS 劫持主要用于处理部分不会按系统 DNS 请求的应用;兼容性增强可在设备与家庭中枢处于同一局域网、HomeKit 实况视频异常或 IPv6 相关功能异常时尝试切换。进入路径通常是右下角风车→“其他设置”→“VPN”,具体文字以当前界面为准。参考:Quantumult X 其他设置说明
- Fake-IP 或 DNS 映射后打不开网站:先恢复自动 DNS,确认普通解析恢复,再逐项检查 Quantumult X 的 DNS 设置、规则和终端是否使用了正确的 DNS。
- AirPlay 或家庭应用异常:确认 Apple TV、iPhone 和家庭中枢在同一局域网,暂时关闭特殊 DNS 或 Tunnel 选项;Apple 官方建议检查活动家庭中枢所在网络以及路由器的防火墙和隔离设置。参考:Apple:将 Apple TV 设置为家庭中枢、Apple:Apple TV 出现网络问题或无互联网
- IPv4 正常、部分连接断流:先不要同时改 DNS、DHCP 和策略,单独关闭或恢复 IPv6 做对比;若现象没有变化,再回到 Tunnel 和规则排查。
- Apple TV 是家庭中枢但不是代理网关:家庭中枢需要在“设置→AirPlay 与 Apple Home→房间”中完成加入;这项设置只代表 HomeKit 角色,不代表局域网设备会自动经过 Quantumult X。参考:Apple:将 Apple TV 设置为家庭中枢
故障速查:每次只改一个变量
| 现象 | 先查什么 | 处理顺序 |
|---|---|---|
| App Store 搜不到 Quantumult X | Apple TV 型号、App Store 地区、tvOS 兼容性 | 确认不是第三代 Apple TV,并以当前 App Store 页面显示为准。 |
| 配置没有同步 | Apple Account、iCloud 云盘、Quantumult X 资源目录 | 确认两端账号一致,再检查 iCloud 云盘和资源文件夹。 |
| 节点全部显示 X | 订阅地址、网络、配置格式和资源依赖 | 先在 iPhone 或 iPad 更新同一订阅,再判断 Apple TV 端是否能访问。 |
| Tunnel 开启后无网络 | 策略、DNS、授权、默认路由 | 切换全部直连或恢复自动 DNS,确认基础网络后再逐项开启。 |
| 共享代理没有日志 | 是否同一局域网、端口、客户端隔离 | 改用一台同网段测试设备,核对 Quantumult X 显示的 IP 和端口。 |
| 测试终端改网关后断网 | Apple TV 地址、子网掩码、DHCP、IPv6 | 恢复原网关和 DNS,再只测试代理共享,不要继续扩大 DHCP 修改范围。 |
| Apple TV 重启后未自动连接 | 始终开启设置、系统授权和应用状态 | 重新打开应用检查连接;不要把“始终开启”理解为系统一定会在每次开机后自动运行。 |
排查顺序建议固定为:普通网络→配置同步→节点更新→Tunnel→日志命中→共享代理→DHCP、DNS 和 IPv6。这样能避免把订阅问题误判成路由器问题。
FAQ:Quantumult X Apple TV 设置常见问题
Apple TV 一定要使用以太网吗?
不一定,Apple TV 可以使用 Wi-Fi 或以太网。若要长期放在家庭网络中做共享或网关实验,有线连接通常更容易保持地址和链路稳定,但具体型号是否具备以太网接口,以 Apple 的设备规格和当前网络设置为准。
只让 Apple TV 自己使用 Quantumult X,需要改路由器 DHCP 吗?
通常不需要。单机模式只需在 Apple TV 内完成配置同步、策略选择和 Tunnel 授权;只有让其他终端使用 Apple TV 的代理或网关时,才需要考虑共享、DHCP、DNS 或路由。
iPhone 能用,Apple TV 却显示节点不可用怎么办?
先核对两台设备是否使用同一 Apple Account、同一份配置和同一资源更新时间,再在 Apple TV 上重新更新节点。若两端网络不同,也要分别验证订阅地址是否能访问。
网络共享应该填写 HTTP 还是 SOCKS5?
系统 Wi-Fi 代理通常优先填写 HTTP;支持独立代理类型的应用可以填写 SOCKS5。具体端口必须以 Quantumult X“网络共享”页面显示为准,填写后要看连接日志是否出现请求。
把终端 DNS 改成 Apple TV 后,为什么反而打不开网站?
这通常说明终端没有得到可用的 DNS 响应,或 DNS 映射模式与终端路由不匹配。先恢复自动 DNS,再单独测试 Quantumult X 的 DNS 设置、DNS 劫持和 IPv6,不要同时修改 DHCP 与策略。
Apple TV 作为家庭中枢后,就会自动成为代理网关吗?
不会。家庭中枢是 HomeKit 的设备角色,代理网关则涉及 Tunnel、代理共享、DHCP、DNS 和路由路径。两者可以在同一台 Apple TV 上分别配置,但不能把家庭中枢状态当成代理已经生效。
常见问题
Apple TV 一定要使用以太网吗?
不一定,Apple TV 可以使用 Wi-Fi 或以太网。若要长期做共享或网关实验,有线连接通常更容易保持链路稳定,但是否支持以太网要以具体型号为准。
只让 Apple TV 自己使用 Quantumult X,需要改路由器 DHCP 吗?
通常不需要。单机模式只需完成配置同步、策略选择和 Tunnel 授权;让其他终端使用时才考虑共享、DHCP、DNS 或路由。
iPhone 能用,Apple TV 却显示节点不可用怎么办?
核对两台设备的 Apple Account、配置名称和资源更新时间,再重新更新节点;同时排除 Apple TV 与 iPhone 所在网络不同。
网络共享应该填写 HTTP 还是 SOCKS5?
系统 Wi-Fi 代理通常填写 HTTP,支持独立代理类型的应用可以填写 SOCKS5。端口以 Quantumult X 网络共享页面显示为准,并通过连接日志验证。
把终端 DNS 改成 Apple TV 后为什么打不开网站?
先恢复自动 DNS,再单独检查 Quantumult X 的 DNS 设置、DNS 劫持、映射模式和 IPv6,不要同时修改 DHCP 与策略。
Apple TV 作为家庭中枢后会自动成为代理网关吗?
不会。家庭中枢是 HomeKit 角色,代理网关涉及 Tunnel、共享、DHCP、DNS 和路由,两者不能直接等同。
相关阅读
参考资料
- Quantumult X App Store 页面
- Apple:在 Apple TV 4K 和 Apple TV HD 上下载应用
- Apple:设置 Apple TV 4K
- Quantumult X 其他设置说明(doc.repcz.link)
- Apple:Apple TV 出现网络问题或无互联网
- Apple:将 Apple TV 设置为家庭中枢