核对安装来源与平台

本文覆盖 iPhone/iPad 和 Android 的 Clash Mi。请从 KaringX/clashmi 项目指向的官网及官方发行入口安装，商店可用范围与最低系统版本以当前条目为准。不要把 Karing、FlClash 或其他同名 Clash 应用的备份直接覆盖进来。

添加完整配置链接

先登录 Roxi 账户复制自己的第三方订阅链接。下文路径只替换原链接中的 /sub/ 部分一次，保留域名、个人标识及全部查询参数；不要把“个人标识”当真值，也不要把官网首页或登录页当订阅。已有对应格式的专用链接时直接使用。

使用 /sub/clash/个人标识 对应的完整 mihomo YAML。它包含节点、策略组和规则；Base64 节点列表不是这一步所需的完整配置。

  1. 进入“我的配置”，点击右上角添加按钮，选择“添加配置链接”，粘贴完整个人 URL 并保存。
  2. 返回配置列表确认更新结果，选择刚添加的配置；遇到 YAML/未知字段错误先查看报错位置和内核版本，不继续点连接碰运气。
  3. 回首页打开连接，阅读并完成系统 VPN 授权。进入可用的节点/策略组界面，固定一个与当前订阅对应的节点作为测试对象。

配置有了，为什么仍然不能访问

观察优先核对
配置条目存在但没有节点是否保存了登录页、错误页或纯节点列表
某些节点不出现或无法启动当前核心支持的协议、传输与配置字段
VPN 已开启但目标失败目标请求是否命中预期策略组，组内是否选成 DIRECT
前台正常，切换网络后异常固定同一节点分别测试 Wi-Fi 和蜂窝，记录每轮网络

面板与规则修改

官方手册提供“面板”入口及核心设置中的 secret。面板可以帮助观察策略组和请求，但面板能打开本身并不能证明出口可用。控制密钥只保留在自己的设备；自定义规则前先备份，更新远程配置后重新检查规则是否仍保留。

首次使用的验收清单

  1. 固定一个节点，访问实际需要的网站，同时在日志或连接列表核对目标、命中规则和最终出口。VPN 图标、端口监听和延迟数字都不能单独证明目标访问成功。
  2. 再访问一个平时可直连的网站，记录是否受影响；停止接管后重试，确认正常网络恢复。一次只改一项，记录客户端与核心版本、网络和错误发生时间。
  1. 手动更新一次订阅，再重开配置，确认本轮更新没有丢失可用节点。
  2. 在应用里正常断开，确认系统 VPN 状态与网页访问恢复。若另一 VPN 自动接管，先处理系统的始终开启设置，而不是删除全部网络设置。

只分享脱敏后的失败阶段、字段名和日志摘要。订阅 URL、二维码、节点认证信息和导出的配置都可能包含凭据，不要发送到公开群或公共转换网站。本文依据官方资料与项目接口整理，未进行真机连接实测。