Roxi确认是 Apple TV 设备，并准备手机
适用于能运行 tvOS 17 或更高版本的 Apple TV，以及一部可运行 Karing 的 iPhone 或 Android 手机。这里的 Apple TV 指硬件盒子，不是其他电视里的 Apple TV 视频 App。Apple TV 第三代没有 App Store，不能按本文安装。客户端不附带 Roxi 套餐。
- 在 Apple TV 的 App Store 搜索 Karing，核对官方下载安装链接对应的应用后选择“获取”或下载。当前系统要求与账户所在商店的可用性以官方页面为准。
- 在手机也安装官方 Karing。首次优先选稳定版，并记录两端版本；电视二维码需要移动端 Karing 配合。
- 将手机和电视接入可互访的家庭局域网。电视用网线也可以，关键是两端可以互相访问；访客 Wi-Fi 的设备隔离可能阻止配对。
先在手机导入自己的 Roxi 节点
先在手机或电脑登录自己的 Roxi 账户，复制第三方客户端订阅地址。下文 /sub/nodes/ 或 /sub/clash/ 只表示链接路径：需要转换时只替换原 /sub/ 部分一次，保留原域名、个人标识及全部查询参数；已有专用格式链接就直接使用。官网首页、账户登录地址和“个人标识”占位文字都不是订阅。
本教程用 /sub/nodes/个人标识 的节点订阅，让 Karing 自己管理分流。不要把 /sub/singbox/ 返回的完整配置当成必须原样下发给 tvOS 的配置。手机这一步成功后，再处理电视上传。
- 在手机 Karing 的设置中进入“添加配置”→“添加配置链接”，输入完整订阅地址并添加。
- 检查本轮更新结果和节点列表，确认有可用的实际节点；返回主屏，点服务器名称固定一条节点。
- 在手机验证这条节点和所需分流。手机连通用于确认配置基本可用，电视仍需独立验证。
手机扫电视二维码，再上传核心配置
- 打开 Apple TV 上的 Karing，让电视停留在显示二维码的页面。
- 在手机 Karing 使用扫描二维码入口，扫描电视屏幕；按提示进入 Apple TV 控制中心。若跳到浏览器或普通添加订阅页面，回到 Karing 重新使用其扫码入口。
- 在手机的 Apple TV 控制中心点击右上角“上传”，将当前核心配置发送到电视。确认上传完成后，电视端应出现“连接”按钮。
- 回到电视端开启连接，按系统提示确认 VPN 权限，再从手机的 Apple TV 控制中心查看电视 VPN 状态。
更新订阅或规则后，重新上传
官方 Apple TV 手册明确说明：从控制中心进入连接状态后新增的分流数据，修改的是当前移动设备。要让电视生效，必须重新上传核心配置。按“手机更新订阅 → 核对节点与分流 → 上传 → 电视确认加载并复测”的顺序操作，不把手机上显示的更新时间当成电视已经更新。
上传前保留手机上的可用配置备份。若新配置失败，回到原副本再上传；只有决定清空电视配置时才使用控制中心的删除功能。不要为更新节点先删除全部可用配置。
扫码、连接和投屏故障分开处理
| 现象 | 检查与下一步 |
|---|---|
| 扫码后一直连不上控制中心 | 确认手机能访问电视所在局域网；检查本地网络权限、访客隔离和其他 VPN 的接管影响，不需要在公网开放路由器端口 |
| 已扫码却没有“连接”按钮 | 确认执行了“上传”，并核对上传错误；配对和上传是两步 |
| 电视仍使用旧节点或旧规则 | 在手机完成本轮更新，再上传当前核心配置，重新核对电视端 |
| 开启后 AirPlay / 投屏消失 | 先停止电视 VPN 做对照；官方 FAQ 的对应方法是手机 Karing 1.2.20.2304+ 在 TUN→排除路由中启用“组播”，随后重新上传；仅在该现象出现时调整 |
| 节点测试有延迟，视频却不能播放 | 检查电视实际请求、路由和应用提示；连接成功不能保证账号权益、内容地区或所有流媒体可用 |
在电视完成验收，再设置自动连接
- 先在电视端确认本次配置已加载、节点非空，固定一条节点，保留默认规则做首次验证。
- 打开电视上实际使用的应用，分别检查页面加载、登录和播放；记录失败发生在哪一步。再查看电视端请求记录、命中规则和出口，不能拿手机日志替代电视证据。
- 同时检查常用直连应用和投屏；随后在电视客户端停止连接，再确认基础网络恢复。遥控器返回主页不等于停止 VPN。
记录这次测试的电视型号、tvOS、两端 Karing 版本、网络、所选节点和失败时间。首次流程跑通后再考虑自动连接；异常时先关电视端连接，避免反复改手机配置却没有同步到电视。
本文按官方资料与 Roxi 订阅接口整理，未做真机连接实测。求助时只提供系统与客户端版本、失败步骤和脱敏错误；订阅链接、配置、二维码可能包含访问凭据，不发送到公共群或公共剪贴板。