App Store 下载前:核对 Clash 配置兼容性

先确认客户端能导入手头的配置,再决定是否安装。支持某种代理协议、支持 Clash 订阅、支持整份 Clash YAML,是三个不同的条件。即使桌面上的 mihomo 能读取同一份文件,iOS 客户端也可能只读取节点,忽略规则和策略组,或不识别个别字段。

  1. 核对开发者和应用页面。从开发者发布的入口打开 App Store,或在 App Store 搜索产品名后核对开发者名称。相似的名称和图标不能证明是同一个客户端。
  2. 核对系统版本。在 iPhone 打开「设置」→「通用」→「关于本机」查看 iOS 版本,再对照 App Store 详情页「信息」中的「兼容性」。如果页面显示当前商店地区不可用,先确认开发者公布的上架范围;不要把不明安装链接当成 App Store 入口。
  3. 核对导入范围。手头只有订阅链接时,查找「远程配置」或「订阅」支持说明;手头是 YAML 文件时,查找本地文件导入说明。如果依赖自定义分流,再核对 proxy-groups、rules 和远程规则集是否受支持。

订阅链接导入:确认下载的是完整配置

优先选服务方明确标注为 Clash 或与当前客户端兼容的订阅地址。订阅链接在外观上通常就是一个 HTTPS 地址,不能凭扩展名判断内容;同一个服务也可能分别提供完整配置、节点列表和账户管理页面。

  1. 在服务方的订阅页面复制完整 URL,保留问号后面的参数。不要将个人订阅链接贴进公开聊天、截图或在线格式转换站点;链接可能包含能直接读取订阅的令牌。
  2. 打开客户端的配置管理页,选择新增远程配置或从 URL 导入,把链接粘贴到地址栏。用于辨认的配置名称可自定;它不改变订阅内容,也不是代理服务器地址。
  3. 保存并执行首次更新。确认客户端显示下载或解析成功,再查看配置是否生成了预期节点和策略组。如果原配置包含分流规则,还要确认导入的结果保留了规则,而不只是节点列表。
  4. 将新配置设为当前配置。保存、更新和启用是不同动作:列表里看到一条新记录,不代表正在运行的连接已经切换过去。

按返回结果判断失败发生在哪一步。若日志明确显示 HTTP 401 或 403,先核对订阅授权和服务方访问条件;若下载成功但提示解析失败,先确认提供的不是网页、登录响应或其他客户端专用的订阅格式。此前能用的配置可先保留,等新配置通过测试再删除。

本地 YAML 导入:用「文件」选择器打开

将完整文件存到 iOS「文件」中,再从客户端导入。可先在「文件」→「浏览」下找到「我的 iPhone」或「iCloud 云盘」中的文件;如果文件仍显示云端下载图标,先打开或下载,确认本机能够读取。若配置在压缩包里,先解压,再选择实际的 .yaml 或 .yml 文件。

  1. 在客户端配置管理页选择从文件导入,通过系统文件选择器打开该文件。如果客户端支持通过分享菜单接收配置,也可在「文件」中长按文件,点「共享」后选择客户端。
  2. 遇到带行号的解析错误,先查该行及上一行:缩进用空格,同级列表项对齐,以 - 开头的条目放在对应字段下。把文件重命名为 .yaml 不会把网页或节点文本转换成配置。
  3. 检查导入结果后设为当前配置。本地文件通常是一次导入的副本;除非客户端明确支持联动更新,否则更改「文件」里的原件后,需要重新导入,并确认当前配置已切到新版。

如果同一份文件在电脑可用、在 iPhone 无法加载,先区分 YAML 语法错误与客户端字段兼容问题。例如,配置引用了本地规则集时,单独导入主 YAML 不一定会带入外部规则文件;桌面上的绝对路径也不能直接用于 iPhone。优先获取面向该客户端的版本,不要为了消除报错直接删除整段规则。

用最小片段核对规则缩进

下面是 Clash 风格的顶层字段示例,只说明规则列表的写法和顺序,不包含代理节点,也不用于验证代理连通性。检查实际配置时,把具体匹配规则放在兜底规则之前;规则模式通常按顺序采用首条命中的规则。

mode: rule
rules:
  - DOMAIN,example.com,DIRECT
  - MATCH,DIRECT

首次连接:允许 iOS 添加 VPN 配置

先选中已导入的配置,再从客户端点连接。首次启动隧道时,iOS 通常会询问是否允许该客户端添加 VPN 配置。确认弹窗对应刚安装的客户端,点「允许」,并按系统要求完成身份验证。订阅和 YAML 是客户端读取的数据,VPN 配置是 iOS 用来启动隧道的系统设置;导入前者不会自动授予后者的权限。

  1. 在客户端查看连接状态。如果停在未连接或立即断开,先查启动日志,确认当前配置已加载、系统授权已完成。
  2. 在 iOS 18 可打开「设置」→「通用」→「VPN 与设备管理」→「VPN」核对状态。若界面名称不同,可在「设置」搜索「VPN」。应核对当前处于连接状态的是本次安装的客户端,而不是原先使用的其他 VPN。
  3. 如果首次点了「不允许」,返回客户端重新发起连接并查看系统提示。若设备受企业或学校管理且连接受限,联系设备管理员核对策略,不要自行移除管理描述文件。

连接后验证:分别检查规则和节点

VPN 显示已连接,只说明隧道启动,不表示远端节点、DNS 和分流规则都工作正常。先在同一 Wi-Fi 下验证,不要同时换节点、切模式和改 DNS,否则难以判断是哪一步恢复了访问。

  1. 核对模式和策略组。客户端提供规则模式时,确认当前使用规则模式,并查看应走代理的策略组是否选中了可用节点,而不是 DIRECT。如果当前处于全局模式,仅凭网页打开不能证明规则配对正确。
  2. 各测一条直连和代理请求。从自己的规则中挑一个预期直连域名和一个预期走代理的域名,发起新请求。若客户端有连接列表或日志,按域名核对匹配规则与实际出站。测速结果只代表探测请求的表现,不能代替目标域名的访问验证。
  3. 按症状做单项对照。仅个别域名失败,先看是否被更靠前的规则匹配;仅某个节点反复连接超时,保持模式和网络不变,在同一策略组换一个节点测试;多个域名都出现解析报错,则先排除当前 Wi-Fi 需要网页登录,再检查客户端的 DNS 配置是否兼容。
  4. 最后测试蜂窝网络。在 Wi-Fi 验证通过后,关闭 Wi-Fi、保留同一配置和节点,再请求相同域名。若只在蜂窝网络失败,先在「设置」→「蜂窝网络」查看客户端及用于测试的应用是否允许使用蜂窝数据,再对照日志区分解析失败和连接超时。

订阅更新后如果才出现故障,先核对更新是否成功、当前配置是否变化、原先选中的节点是否被移除或改名。需要求助时,记录 iOS 版本、客户端版本、导入方式和第一条相关报错;分享前删去订阅地址、令牌和配置中的账号信息。