先确认平台与配置来源

本文使用 Stash 官方文档对应的 Apple 客户端；iOS、macOS 和 tvOS 的安装入口与授权以官方产品页为准。不要按旧文章寻找所谓“Stash Android 版”。安装前确认自己的系统满足当前发行要求。

下载并选中配置

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

使用账户页的 Clash Meta / mihomo 链接；手动处理时将原 /sub/个人标识 改为 /sub/clash/个人标识，得到完整 mihomo YAML 配置。

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

  1. 在 Stash 设置中进入“配置文件”，选择“从 URL 下载”，粘贴 Clash 配置链接后下载。
  2. 确认下载的配置已被选中，再返回首页启动；首次连接按系统提示授权。
  3. 进入策略组选择节点，先保持规则模式；看日志是否报告某个配置字段、代理类型或规则提供者不兼容。

MRS 并非一律不支持

截至本次核对，Stash 官方规则文档明确列出 domain 与 ipcidr 的 MRS 支持。Roxi 的 Clash 配置正使用这两类 MRS，因此不能仅凭后缀就判断必然不能用。但旧 Stash 版本、其他 mihomo 专用选项和具体传输仍需逐项核对；文档支持不等于已在你的设备上验证整份配置。

  1. 若报规则格式错误，记录 Stash 版本、provider 名称与 behavior/format，对照当前官方说明。
  2. 需要兼容旧版本时，在自己的配置副本中按官方支持的 YAML/text 格式改写规则资源，并同步更新 URL、format 和引用；只改扩展名不是转换。优先使用提供方已经适配的配置。
  3. 节点存在但握手失败时检查该节点完整的协议、TLS 和传输组合，不以“支持 VLESS”推断支持所有 VLESS 传输。

怎样确认真正连通

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

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

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

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