iOS 上手 Clash 类客户端:App Store 获取方式与配置文件导入

先确认：支持 Clash 配置不等于使用 mihomo 内核

iPhone 上的代理客户端需要分别确认三个条件：能否在当前 App Store 地区获取、能否读取手头的配置格式、能否支持节点使用的协议。应用名称带有 Clash，或者介绍写着“支持 Clash 订阅”，都不能单独证明它完整支持 mihomo 的配置字段。

Clash YAML 是配置格式，mihomo 是代理内核，iOS 客户端则负责配置管理、节点选择和系统网络扩展。部分客户端导入 YAML 后会转换为自己的内部配置，另一些只提取节点，不导入原有规则与 DNS 设置。因此，“导入成功”与“按原配置运行”需要分开验证。

完整配置：通常包含 proxies、proxy-groups 和 rules，还可能包含 DNS、规则集与节点提供器。
节点订阅：主要提供服务器信息；导入后仍需由客户端或另一份配置提供策略组和分流规则。
客户端专用格式：必须按应用说明导入，不能仅将扩展名改成 .yaml。

App Store 获取：核对地区、开发者和系统要求

从下载入口定位商店页面

打开本站下载中心，选择 iOS 平台，查看当前列出的客户端及获取说明。
进入对应 App Store 页面，核对应用名称、开发者、版本记录和“兼容性”中的最低 iOS 要求。
阅读介绍中的配置格式说明，重点找 Clash YAML、远程订阅、文件导入，以及所需协议是否受支持。
确认价格与购买条件后安装。安装结束先打开一次，检查是否存在配置管理和连接入口，再准备导入。

搜索结果可能同时出现名称相近的应用。不要只凭图标判断，也不要把搜索广告的位置当作兼容性证明。商店页面上的开发者信息和应用自身文档更适合用来核对来源。

商店不可用时先检查账户地区

App Store 可用范围主要与购买项目所用 Apple 账户的国家或地区有关，不是打开代理后就会自动切换。可在「设置」→「你的姓名」→「媒体与购买项目」→「查看账户」→「国家/地区」核对；不同 iOS 版本的文字可能略有变化。更改地区通常涉及余额、现有订阅和付款方式，先阅读 Apple 的要求，不要为了安装单个应用直接修改。

出现“此 App 在你所在的国家或地区尚未提供”时，优先选择当前地区能获取且明确支持配置格式的客户端。不要使用陌生人分享的 Apple 账户，也不要为安装代理工具接受来源不明的企业证书或设备管理要求。

订阅链接导入：保存、更新、选中配置

远程订阅适合需要定期更新节点的场景。先从服务提供方取得专用于 Clash 的订阅地址；同一个账户可能同时提供 Clash、通用节点和其他客户端格式，不能凭链接外观判断响应内容。

复制原始地址：使用提供方的复制按钮，避免复制网页标题、前后空格或聊天软件附加的标点。
新增远程配置：进入客户端的配置管理页，寻找“添加”“从 URL 导入”或“远程配置”等入口。各应用菜单不同，这些是功能名称，不是所有客户端通用的固定路径。
执行首次下载：填写便于识别的名称并保存，手动更新一次，等待下载与解析结束。
检查导入结果：确认节点或策略组已出现；若应用显示规则数量，再检查规则是否一并载入。
设为当前配置：部分应用允许保存多份配置，但同一时刻只启用其中一份。保存完成后还要选中刚导入的项目。

更新失败时先看错误类别：401 或 403 常与访问授权或服务端限制有关；404 需要核对地址是否有效；解析错误则要检查返回内容和客户端支持范围。浏览器能打开地址不代表返回的是 YAML，也可能是登录页或错误提示。

文件与二维码导入：先辨认内容，再选择入口

通过“文件”App 导入 YAML

本地文件适合迁移现有配置，或在订阅下载暂时不可用时使用。先将 .yaml 或 .yml 文件保存到“文件”App 的“我的 iPhone”或 iCloud 云盘，再通过客户端的“从文件导入”选择它。若应用提供共享扩展，也可以在“文件”App 中长按文件，选择“共享”，再交给对应客户端。

文件应为 UTF-8 纯文本，不能是富文本文档、网页存档或重命名后的 PDF。
YAML 缩进使用空格，避免编辑器将缩进替换为 Tab；引号和冒号也要保留原格式。
检查配置中的外部资源地址。主文件在本地，不代表 proxy-providers 或 rule-providers 已经离线可用。
导入通常会生成应用内副本。修改“文件”App 中的原文件后，可能需要重新导入，不能假设客户端会自动同步。

下面只是用于辨认结构的片段，不是可直接连接的完整配置：它引用了名为“手动选择”的策略组，实际配置还需要提供对应策略组及可用节点。

mode: rule
rules:
  - DOMAIN-SUFFIX,apple.com,DIRECT
  - MATCH,手动选择

如果导入后提示策略不存在，先检查 rules 引用的名称是否与 proxy-groups 完全一致。将桌面配置搬到 iPhone 时，还要检查本地文件路径、监听端口和内核专属字段，不能只处理节点部分。

二维码可能只是一个节点

二维码是文本载体，不是一种统一的订阅格式。它可能包含 HTTPS 订阅地址，也可能包含 ss://、trojan:// 等单节点链接，或者应用专用的导入指令。导入后只有一个节点，往往是二维码本来就只编码了一个节点，不代表原有规则被导入。

从客户端内打开扫码功能；首次使用时，按需允许相机权限。
二维码在同一部手机上时，使用客户端支持的相册识别功能；没有该功能就向提供方索取原始文本链接。
识别后检查预览：是远程配置地址、节点信息，还是未知指令，再决定保存。
导入完成后检查配置列表与策略组，不要只看“扫描成功”的提示。

二维码图片也可能携带凭据，不要上传到公共识别服务。相机权限被拒绝时，可在系统设置中找到对应应用并检查权限；以 iOS 18 为例，应用设置通常位于「设置」→「App」→「应用名称」。

开启 VPN：授权系统隧道，再选择出口

配置准备好后，先在代理策略组中选择一个可用节点，再打开客户端的连接开关。首次连接通常会出现系统弹窗，询问是否允许添加 VPN 配置；确认是刚安装的客户端发起后，按提示允许并完成系统验证。这个授权让应用通过系统网络扩展处理流量，并不等于所有请求都必然走远端节点。

检查系统配置：在「设置」→「通用」→「VPN 与设备管理」→「VPN」查看对应项目及连接状态。这里只需管理 VPN，不需要额外安装设备管理描述文件。
确认代理模式：日常先选规则模式；客户端若提供全局模式，可在诊断时短暂使用，并指定实际出口节点。
确认策略组选择：规则命中的组如果选择了 DIRECT，请求仍会直连，即便系统显示 VPN 已连接。
测试后再调整：先使用默认设置完成一次连接，再考虑 DNS、按需连接或其他高级功能，避免同时修改多个变量。

桌面端常见的“系统代理”与“TUN”开关，不能直接套到 iOS。iOS 客户端通常使用 Network Extension 中的 Packet Tunnel 接管流量，是否显示“TUN”字样取决于应用设计。不要为了照搬桌面教程，在 Wi-Fi 的 HTTP 代理栏填入 127.0.0.1:7890：它指向 iPhone 自身，只有应用确实提供对应监听服务时才有意义。

连接验证与故障定位

用同一次请求核对规则和出口

打开一个平时需要代理访问的 HTTPS 页面，同时查看客户端提供的连接或日志面板。若面板显示命中规则、策略组和出口节点，就将这三项一起核对。只有域名出现而没有成功响应，仍可能是 DNS、握手或远端链路问题。若使用出口 IP 查询服务，也应确认该请求本身没有被规则分到直连。

延迟测试只反映指定测试目标在当时的响应情况。例如界面显示 120 ms，它不是下载速度，也不能保证视频或游戏使用的目标可达；这里的数值仅作读数示例，并非本站实测。实际验证应包含一次页面请求，并分别在 Wi-Fi 和蜂窝网络下测试。

现象	优先检查	下一步操作
订阅能保存，但没有节点	返回内容及导入类型	确认不是 HTML 登录页，并核对是否误将节点订阅导入为完整配置。
提示未知字段或不支持协议	客户端格式与内核兼容范围	取得适配该应用的订阅，不要直接删除报错字段后继续使用。
VPN 已连接，网页仍打不开	当前配置、节点及 DNS 日志	切换一个确认可用的节点，再用同一页面复测，观察是否出现解析错误。
仅部分网站走代理	规则命中与策略组选择	确认是否为预期分流；全局模式只用于对照诊断，不代替规则修正。
开启后很快被另一个连接替换	其他代理或本地 VPN 类应用	暂时关闭其他应用的连接及自动连接选项，再单独测试当前客户端。
只有蜂窝网络无法更新或连接	蜂窝数据权限及网络差异	在「设置」→「蜂窝网络」检查应用权限，并与 Wi-Fi 结果对照。

更新配置与保留记录

节点失效时先更新远程配置，再核对策略组是否仍选中有效节点。应用支持自动更新时，可以从每天一次开始，具体间隔以服务提供方要求为准；不必设置为每分钟拉取。更新规则集与更新节点订阅也可能是两个独立操作，应分别检查结果。

需要反馈问题时，记录 iOS 版本、客户端版本、配置类型、使用 Wi-Fi 还是蜂窝网络，以及错误发生的时间和操作步骤。分享日志前隐藏订阅地址、节点密码和令牌。按“获取应用 → 导入配置 → 选中配置 → VPN 授权 → 请求验证”的顺序逐项确认，比反复重装更容易找到故障位置。更完整的导入与排查步骤可继续查看入门指南，配置概念可查阅完整文档。