安装与首次选择

从 Karing 官方下载入口选择设备对应版本。官方快速入门覆盖 iOS、macOS、tvOS、Android 和 Windows；具体最低版本以下载页和商店为准。第一次可使用新手模式，后续再根据需要添加自己的分流。

添加节点订阅

先在 Roxi 网站登录自己的账户，打开订阅区域，复制“第三方客户端”订阅地址。不要复制官网首页、邀请链接或浏览器地址栏里的登录地址。客户端不附送节点；套餐、流量、到期时间和设备限制以账户页为准。

把原 /sub/个人标识 改为 /sub/nodes/个人标识，得到明确的 Base64 节点列表。它只包含节点，不附带这个客户端的完整分流配置。

下面的 /sub/... 仅表示原链接中的路径。保留账户提供的域名、个人标识和查询参数；只替换一次路径，不把示例占位符当作真实地址，也不要重复加成 /sub/clash/clash/。已有专用链接时直接使用。不要将订阅 URL 发给公共转换站。

  1. 点击添加配置入口，选择“添加配置链接”，把完整 URL 粘贴进去，填写备注并保存。
  2. 进入“我的配置”确认更新成功且有节点，然后在首页选择当前配置/可用服务器。
  3. 启动连接并完成系统所需授权；先用默认分流访问实际目标，再调整自定义规则。

为什么不直接照搬 Clash 的所有设置

Karing 官方说明支持多种导入格式，但同时由自己的分流体系管理多个订阅。节点能被识别不证明导入的每项 Clash 脚本、规则集与策略组都完全等价。本文选节点列表，让规则交给 Karing 管理；需要迁移复杂规则时，应逐项对照官方兼容列表和连接记录。

自动选点和电视同步

为定位问题先固定一个节点，再开启自动选择；自动切换会让两次请求的出口不同。Apple TV 按官方流程由已配置的手机 Karing 扫描电视端二维码同步，二维码只在自己的设备间使用。手机可用仍需在电视目标应用里单独验证。

怎样确认真正连通

  1. 确认这次更新成功、节点数大于零，并选中了刚导入的配置。更新失败时可能仍在使用旧缓存，不能只看列表里还有节点。
  2. 固定一个节点，访问实际要用的网站或应用，再查看连接或日志中的目标、规则与出口。延迟数字、VPN 图标和“已启动”都不能单独证明业务成功。
  3. 同时检查一个平时可直连的网站；随后断开连接，确认基础网络恢复。只在全局模式可用时回到规则排障，不把全局作为长期修复。

失败后按层排查，保留可恢复的配置

现象先核对下一步
下载失败或 401 / 403订阅地址、账户状态、设备限制和当前网络回账户复制新地址；看响应说明，不连续重复导入
解析失败 / 节点为零下载到的是 YAML、JSON、节点列表还是登录网页换成本文指定格式，保留错误字段名与客户端版本
能启动但目标打不开当前节点、规则、DNS 和请求日志换一条兼容节点做对照，勿删除 TLS 校验
停止后不能直连系统代理、其他 VPN、断线阻止设置先在客户端正常停止接管，再退出；恢复改动前设置

求助只提供系统与客户端/核心版本、失败阶段、发生时间和脱敏日志。升级前备份本地规则；订阅更新会替换远程内容，个性化设置尽量放在客户端支持的覆写或本地规则里。