iOS 版 Clash 客户端安装:App Store 获取与配置文件导入

安装前：确认客户端与配置格式

在 iPhone 上使用 Clash 配置，关键不是搜索到名称中带有 Clash 的应用，而是确认客户端接受哪种配置、使用什么内核，以及当前 App Store 地区是否提供下载。原 Clash 项目没有发布统一的官方 iOS 客户端；iOS 上的兼容应用由不同开发者提供，界面和功能范围各不相同。

“支持代理订阅”也不等于“支持完整 Clash YAML”。有的客户端只读取节点，有的能导入策略组与规则，还有的只接受自身格式。Mihomo 是常被称为 Clash Meta 的内核；面向 Mihomo 的配置可能包含旧 Clash 内核不支持的协议或字段。导入前应查看应用说明中的配置格式与内核信息。

• 已有完整 YAML：确认支持 proxies、proxy-groups、rules，并检查配置使用的协议是否受支持。
• 只有订阅链接：确认服务方提供的是 Clash、Mihomo 配置，还是仅含节点 URI 的订阅。
• 只有单条节点：ss:// 等节点 URI 不是完整 YAML，通常应进入“添加节点”或对应的 URI 导入入口。
• 准备跨设备使用：iPad 与 iPhone 的商店可用性、最低系统版本及购买记录需要分别核对。

App Store 获取：核对地区、系统与开发者

从下载页进入应用详情

1. 打开本站客户端下载页，选择 iOS 对应入口，再进入 App Store 应用详情。
2. 核对应用名称与开发者，阅读“兼容性”和版本说明。名称接近的应用可能采用完全不同的配置格式。
3. 点击“获取”或价格按钮，按系统要求完成 Apple 账户验证。是否收费、支持哪些设备，以当前商店页面为准。
4. 首次打开后，先查看“关于”或“设置”中的应用版本、内核信息，再决定导入哪一种配置。

如果提示“此 App 在你所在的国家或地区尚未提供”，通常是商店分发范围问题，不是订阅失效。App Store 的下载地区主要由用于购买项目的 Apple 账户国家或地区决定，修改“设置”→“通用”→“语言与地区”不会直接改变商店归属。

找不到应用或无法安装时

• 核对系统版本：在“设置”→“通用”→“关于本机”查看 iOS 或 iPadOS 版本，与商店最低要求比较。
• 检查购买账户：查看“设置”→“Apple 账户”→“媒体与购买项目”，确认当前使用的账户。较旧系统可能显示 Apple ID。
• 区分内核与应用：桌面端安装包不能在 iPhone 上直接运行；本地文件导入入口也不是应用安装入口。

切换账户地区可能涉及余额、订阅和付款方式，处理前应阅读 Apple 的账户变更说明。不要为了下载应用而安装来源不明的设备管理描述文件。

订阅链接导入：保存远程地址并拉取配置

远程配置适合需要定期更新节点与规则的情况。链接本身通常带有访问凭据，应视为密码保管。这里所说的“订阅更新”是重新下载配置内容，不是 App Store 的应用更新。

1. 从配置提供方复制完整链接，检查开头是否为 https://，末尾是否混入空格或换行。网址中的查询参数不要随意删除。
2. 在客户端寻找“配置”或“订阅”入口，选择新增远程配置、从 URL 导入等功能。
3. 填写便于识别的名称，例如“日常分流”，粘贴链接并执行下载。首次测试建议手动更新，确认成功后再设置自动更新。
4. 查看拉取结果与解析提示。成功保存后，将这份配置设为当前使用的配置；仅出现在列表中不代表已经启用。
5. 进入策略组检查节点数量及选择状态，再开启连接。使用规则模式时，确认策略组不是意外停留在 DIRECT。

如果客户端要求选择订阅类型，应按提供方标注选择。节点列表订阅不能自然补齐规则组；完整配置也未必适合放进“节点订阅”入口。导入后只有节点、没有原有规则时，先查导入类型，不要立即反复更换节点。

文件与剪贴板导入：区分配置正文和链接

通过“文件”App 导入 YAML

把配置保存到“文件”App 中的“在我的 iPhone 上”或 iCloud 云盘。回到客户端的配置页面，选择从文件导入，通过系统文件选择器打开 .yaml 或 .yml 文件。部分应用也提供“共享”菜单导入，是否出现目标应用取决于其支持的文件类型。

本地导入通常是复制一份配置到客户端，并不自动跟随原文件更新。修改云盘里的原文件后，应在客户端重新导入或使用其提供的编辑功能。使用远程链接创建的配置，则可能在下一次更新时覆盖本地改动；需要长期保留的规则应放到客户端支持的覆写或合并机制中。

剪贴板中应该放什么

• 完整 YAML 文本：使用“从剪贴板导入配置”，复制时保留缩进，不要把 Markdown 的三反引号一起复制。
• HTTPS 链接：使用远程配置入口，避免把网址当作 YAML 正文解析。
• 节点 URI：进入节点导入入口，之后仍需要规则与策略组才能组成所需的分流方案。

iOS 可能询问是否允许从其他应用粘贴；这与 VPN 授权是两项独立权限。若曾拒绝，先尝试长按输入框手动粘贴；对于提供该选项的系统版本，可在应用设置中检查“从其他 App 粘贴”的权限。以 iOS 18 为例，应用设置入口位于“设置”→“App”→对应客户端。

用最小配置检查 YAML 解析

下面的配置只用于验证导入和规则解析，所有连接均直连，不包含代理节点。若客户端要求额外字段，应以该应用的配置文档为准；不要把这段示例当成可连接远程代理的订阅。

mode: rule
log-level: info
rules:
  - DOMAIN-SUFFIX,example.com,DIRECT
  - MATCH,DIRECT

YAML 缩进使用空格，不使用 Tab。rules 是列表，每行规则前的短横线属于语法。配置里的策略组名称必须与规则引用完全一致；例如规则指向“代理选择”，配置中就应存在同名策略组。末尾的 MATCH 接住前面未匹配的连接，通常放在最后。

首次启用 VPN：系统提示与连接验证

配置准备好后，点击客户端的连接开关。采用 Network Extension 的客户端首次建立隧道时，iOS 通常会弹出“想添加 VPN 配置”的系统确认窗口。核对申请者是刚安装的客户端，再点击“允许”，并按系统要求通过设备密码或身份验证。

这是允许应用创建 VPN 配置，不等于安装根证书，也不等于把设备交给组织管理。正常的代理隧道连接不需要为此开启 HTTPS 解密。如果随后出现安装证书、加入设备管理等步骤，应先确认具体用途与来源。

1. 打开“设置”→“通用”→“VPN 与设备管理”→“VPN”，检查客户端对应的配置与连接状态；不同系统版本的层级可能略有区别。
2. 回到客户端，确认当前配置与规则模式。暂停其他同类代理或 VPN 应用，减少重复建隧道造成的干扰。
3. 打开 Safari 发起一次新请求，在客户端连接记录中查找目标域名、命中的规则、策略组及最终节点。
4. 分别测试应直连与应代理的目标。VPN 状态为已连接，只说明隧道建立，不能单独证明节点、DNS 和规则都正确。

兼容客户端通常通过系统隧道接口接管流量，但具体覆盖范围受应用实现与系统策略影响。不要直接照搬桌面端的 tun、auto-route 或路由权限设置；iOS 客户端可能忽略这些字段，也可能要求在自身界面里设置。规则模式决定已接管连接如何分流，并不意味着所有连接都必须经过代理节点。

导入失败与连接异常：按提示定位

排查时一次只修改一类设置：先解决配置拉取，再解决解析，随后验证隧道与节点，最后检查规则和 DNS。若下载超时，先在断开隧道的状态下测试；如果配置地址只能通过代理访问，则需要已有可用连接来完成更新，不能指望尚未成功导入的配置提供连接。

反馈问题时提供客户端版本、系统版本、错误时间以及去除敏感信息的日志。订阅令牌、节点密码和完整配置不要直接公开。截图应保留错误文本与配置类型，遮住账户和凭据即可。

日常更新与换机：保留可恢复的信息

• 记录更新来源：区分远程订阅与本地文件，保存来源说明，避免误把旧文件当成最新订阅。
• 更新前备份：保留自定义规则、策略组选择和必要的覆写设置；远程更新可能替换整份配置。
• 换机后重新验证：即使应用数据已迁移，也应检查配置是否仍可拉取，并按系统提示重新授予 VPN 权限。
• 删除前先断开：停用连接后再移除客户端。若有遗留配置，可在系统的 VPN 页面核对并删除对应条目。

完成安装后，最有价值的检查是沿着同一条链路确认结果：来源可信的应用、格式匹配的配置、成功的系统授权，以及能够解释去向的连接日志。这样遇到更新失败或单个应用无法联网时，就能定位到具体环节，而不是反复重装。