确认电视系统和安装包是否匹配

适用于 Android TV / Google TV 以及具备相应 Android 能力的电视盒子。Karing 当前要求 Android 8 或更高版本，官方 Android TV 下载入口标注 armeabi-v7a。先查看设备“关于”中的系统版本；具体型号还必须支持该架构和 Android VPN 功能。不要只凭芯片宣传“64 位”就决定安装包。

三星 Tizen、LG webOS 等其他电视系统不能直接安装 Android APK；屏幕里有 Apple TV 视频 App 也不代表它运行 tvOS。运营商定制盒子可能限制安装或裁剪 VPN 模块，版本号满足要求并不保证能运行。

从官方 TV 入口下载并安装

  1. 在手机或电脑打开 Karing 官方下载页，找到 Android TV 栏，选择稳定版下载；不要把 Android 手机包或来历不明的“TV 专版”当成官方电视入口。
  2. 把 APK 通过设备支持的方式传到电视。例如有 USB 和文件管理器的电视，可将 APK 放入 U 盘后在电视打开；没有 USB 时使用厂商支持的本地传文件或下载方式。文件传输方式取决于型号，不要求安装某个指定第三方工具。
  3. 打开 APK。若系统要求授权“安装未知应用”，只给本次使用的文件管理器或下载工具开启该来源权限，返回继续安装；完成后可撤回该权限。
  4. 安装后从应用列表或系统应用设置打开 Karing。若提示解析包失败、架构不兼容或签名冲突，核对系统、完整下载和官方包来源；升级失败时先备份，避免直接卸载丢失配置。

在电视输入订阅，避免长链接输错

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

本文使用 /sub/nodes/个人标识 的节点订阅。订阅地址需要完整输入，尤其要保留大小写、查询参数和符号。可用电视支持的外接键盘或已配对的官方遥控输入功能辅助输入；没有剪贴板功能时，直接在配置链接输入框逐段核对。不要用公开在线剪贴板中转个人链接。

  1. 打开电视 Karing 的设置，进入“添加配置”→“添加配置链接”，输入完整地址并添加。布局可能随版本变化，按功能名称查找。
  2. 检查本轮更新是否成功、配置名称和节点是否非空。HTTP 401/403、超时与“成功但没有节点”分别记录，不把旧节点仍可见当成更新成功。
  3. 返回主屏，选择一个明确节点。先保留默认分流，确认基础连接后再按需调整应用范围。

遥控器点不到按钮时怎么处理

Karing 官方 FAQ 对 Android TV 主屏焦点无法切换的建议是：在设置启用“跟随屏幕旋转”。如果遥控器连设置都无法进入，可先连接设备支持的鼠标或键盘，再调整该选项；没有相关选项时核对安装包和版本，不反复删除订阅。

授权 VPN，并在电视应用里验证

  1. 在 Karing 开启连接，确认系统弹出的 VPN 连接请求；若设置里提供 TUN 开关，首次接管电视应用流量时应启用相应 VPN/TUN 模式。
  2. 如果系统没有弹出授权，先看错误。官方 FAQ 列出的 ConfirmDialog / com.android.vpndialogs 缺失可能表示系统裁剪了 VPN 模块；记录型号并向设备厂商核对支持情况，重新粘贴订阅不会修复系统组件。
  3. 保持客户端运行，切到目标电视应用，核对实际访问与电视端连接记录。只启动本地代理端口并不能保证其他电视应用会使用它。
  1. 先在电视端确认本次配置已加载、节点非空，固定一条节点，保留默认规则做首次验证。
  2. 打开电视上实际使用的应用，分别检查页面加载、登录和播放；记录失败发生在哪一步。再查看电视端请求记录、命中规则和出口，不能拿手机日志替代电视证据。
  3. 同时检查常用直连应用和投屏；随后在电视客户端停止连接，再确认基础网络恢复。遥控器返回主页不等于停止 VPN。

更新订阅和待机恢复

后续在这台电视的“我的配置”里找到刚添加的远程订阅，执行更新并核对本轮结果。手机更新同一账号的配置不会自动证明电视同步完成。官方手册注明本地文件导入无法更新，长期使用应保留远程 URL 配置。

现象下一步
无法安装 APK核对 Android 版本、包架构、来源权限与签名；系统限制按厂商说明处理
订阅下载失败确认没有把登录页当订阅；核对网址、账户状态及电视当前网络
节点存在，但启动报 VPN 组件错误核查系统 VPN 支持，保留具体错误，不继续重复导入
切到后台或待机后掉线检查厂商后台限制；先做一次待机唤醒复测，确认稳定后再考虑自动启动或始终开启
停止后其他应用仍无网络核对系统是否启用了始终开启及无 VPN 时阻止连接，恢复自己修改前的设置

将应用更新与订阅更新分开：前者升级 Karing，后者获取节点。升级应用前备份配置并保留来源；订阅更新失败时保留上次可用配置，先查下载或解析原因。

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