先区分客户端、配置格式与服务端协议

在 iPhone 上使用 Clash 订阅，首先需要选择能够读取对应配置的 iOS 客户端。Clash 配置通常使用 YAML，包含节点、策略组、规则与 DNS 设置；客户端负责导入、展示和启动网络扩展。两者不是同一层，也不能仅凭应用名称里有“Clash”就判断兼容性。

Clash Meta 现称 mihomo，是内核项目。桌面端使用 mihomo，不代表 iOS 客户端也使用相同内核，更不代表订阅里的全部字段都能原样执行。协议名称相同，也仍可能存在传输参数、TLS 选项或规则扩展的差异。

客户端或配置类型导入前需要确认不能直接推断的事项
Stash支持 Clash 风格配置，按当前版本文档检查扩展字段与协议支持不能假定完整兼容所有 mihomo 专用字段
Shadowrocket使用其支持的节点订阅或专用配置格式不能把完整 Clash YAML 当作等价配置直接使用
sing-box 类客户端确认客户端要求的 JSON 结构与内核版本Clash YAML 不能只修改文件扩展名就变成 sing-box 配置

本文以支持 Clash 风格配置的客户端为主线。Stash 是可供核对的实例，并非原 Clash 项目的官方 iOS 发行版。其他应用也应分别核对开发者、格式支持和当前商店页面，不把站点品牌或相似名称当成项目授权关系。

App Store 获取渠道与账号地区要求

先检查商店页面，再判断地区限制

应用是否能搜索到，取决于 Apple 账户的商店地区、开发者上架范围、设备兼容性与当前分发状态。设备的语言、时区，以及「设置」中的设备地区，不等同于 App Store 账户地区。切换网络出口也不会自动改变商店归属。

  1. 从开发者官方网站的 App Store 入口进入商品页，核对应用名称、开发者名称、最低 iOS 要求与价格。
  2. 若提示“所在国家或地区尚不提供”，先确认当前「媒体与购买项目」使用的账户，而不是反复修改手机语言。
  3. 若提示系统版本不支持，检查「设置」→「通用」→「关于本机」中的 iOS 版本；地区调整不能解决系统兼容问题。
  4. 购买前确认这是一次性付费、订阅项目还是其他收费方式，以当时的商品页为准。应用费用与节点服务费用是两项独立支出。

地区变更与账户安全

以 iOS 18 的菜单为参照，账户地区可在「设置」→顶部 Apple 账户→「媒体与购买项目」→「查看账户」→「国家/地区」查看。不同系统版本的名称可能略有变化。正式变更前，需要按 Apple 提示处理账户余额、现有订阅、家庭共享与付款方式。

App Store 可用性会变化，本文不承诺某个地区长期上架。TestFlight 属于测试分发，存在名额和构建有效期限制，也不应被视作永久下载渠道。需要安装入口时，可先查看本站下载中心中的平台说明，再核对开发者提供的正式渠道。

导入前准备：确认订阅返回的是完整配置

“订阅链接”不是统一格式。有的返回完整 YAML，有的只有节点列表，有的返回编码后的节点 URI，还有的根据请求参数或客户端标识返回不同内容。浏览器能打开链接，只说明请求得到响应，不说明响应适合当前客户端。

  • 完整 Clash 配置：通常可以看到 proxies 或 proxy-providers，以及 proxy-groups、rules 等字段。
  • 节点提供器：可能只有 proxies 列表，需要主配置中的 proxy-providers 引用；不一定能直接作为完整配置启动。
  • 网页响应：出现登录页、套餐页面或 HTML，通常表示拿到了页面地址、鉴权失败，或者服务端要求先登录。
  • 其他客户端专用格式：应向服务提供方获取对应客户端入口，不要仅凭文件后缀判断内容。

订阅地址中的查询参数常包含访问凭据。复制时应保留完整参数，避免漏掉末尾字符；分享截图时应遮住整个地址。不要把有效订阅提交给不受信任的在线转换服务。需要转换时，优先使用服务提供方的适配入口或可自行控制的转换工具。

如果订阅已经在电脑端使用，先记录三个信息：当前选择的策略组、实际节点名称、订阅提供方声明的格式。iPhone 导入后就能逐项比对，而不是只看节点数量是否相同。

订阅导入流程：下载、选中与更新分别确认

不同客户端版本的按钮名称可能不同，但导入流程应包含“添加远程配置、下载、设为当前配置”三个动作。以 Stash 这类客户端为例，从配置列表添加 URL 来源；若当前版本提供扫码或文件导入，也要确认导入对象究竟是远程链接还是本地副本。

  1. 进入配置管理。打开客户端的配置列表，选择新增配置或从 URL 下载入口。不要把订阅填到 HTTP 代理地址、DNS 地址或节点服务器地址栏。
  2. 粘贴原始订阅。检查是否包含空格、换行、中文标点或聊天软件追加的说明文字。使用方便识别的名称，例如“日常规则”。
  3. 执行下载。等到客户端完成解析。若出现错误，保留状态码和字段位置，不要只记录“导入失败”。
  4. 选中当前配置。下载成功后回到配置列表，确认该配置已被选用；有多个配置时，新增成功不一定意味着立即切换。
  5. 检查策略组。打开代理或策略页面，确认主策略组有可选节点，规则引用的组名也存在。
  6. 确认更新来源。检查是否保留了远程 URL，以及自动更新开关或手动更新入口。本地文件通常不会自动从原订阅获取变化。

按错误类型处理，而不是连续重试

  • 401 或 403：优先检查凭据、链接有效性和服务端访问限制，不要先改 DNS。
  • 404：核对完整路径，确认旧订阅是否已被替换。
  • YAML 解析报错：查看缩进、重复键及具体报错行；也可能是服务器返回了 HTML 而非 YAML。
  • 下载超时：检查基础网络与订阅域名是否可达。若客户端支持通过现有代理更新，可在已有可用连接时尝试该方式。

VPN 配置授权：iOS 网络扩展如何接管流量

首次启动连接时，iOS 通常会询问是否允许添加 VPN 配置。确认应用来源后，按系统提示允许，并使用设备密码或系统验证完成授权。这里的 VPN 是系统网络扩展入口，不表示订阅中的每个节点都采用传统 VPN 协议，也不表示所有流量都必然经过远端节点。

以 iOS 18 为参照，可在「设置」→「通用」→「VPN 与设备管理」→「VPN」查看配置与连接状态。若列表里已有公司 VPN、其他代理客户端或安全软件，先停止另一条个人 VPN 连接再测试。受管理设备的限制需要由设备管理员确认。

与桌面系统代理、TUN 的区别

桌面系统代理通常要求应用遵循 HTTP 或 SOCKS 代理设置；iOS 这类客户端常通过 Network Extension 的 Packet Tunnel 接入系统网络。它与桌面 TUN 都涉及网络层接管，但授权、路由能力、排除流量和生命周期受各自操作系统约束，不能直接照抄 Windows 的服务模式步骤。

  • 不必先修改 Wi-Fi HTTP 代理。使用客户端的 VPN 网络扩展时，Wi-Fi 详情中的手动代理不是常规必需步骤。
  • 端口不等于 VPN 授权。桌面配置中的 mixed-port: 7890 是本地监听端口示例，不是 iPhone 的系统授权参数。
  • 保持局域网暴露范围可控。除非确实需要让其他设备连接，不要为了手机自身联网而开启允许局域网访问。
  • 图标不是完整验证。系统显示 VPN 已连接，只能证明隧道状态，仍需确认规则、节点与目标请求。

规则模式切换：确认策略组与最终出口

首次使用建议先选择规则模式。规则模式按顺序匹配目标并执行策略；全局模式将通常受其控制的流量交给全局策略；直连模式则用于直接连接。具体覆盖范围还受客户端路由设置与系统约束影响。不要把“全局”理解成对设备所有系统通信的绝对保证。

下面是用于检查顺序的规则片段，不是可独立导入的完整配置。其中“代理选择”必须对应现有配置中的策略组名称；若实际组名不同，需要按真实名称修改。

mode: rule
rules:
  - DOMAIN-SUFFIX,apple.com,DIRECT
  - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
  - MATCH,代理选择

这段配置表示：匹配 apple.com 及其子域名时直连；目标地址属于指定局域网网段时直连；其他请求交给“代理选择”。它仅演示规则结构，不是面向所有用户的推荐分流方案。特别是域名后缀规则不会覆盖一个公司的全部业务域名。

用同一个请求完成三项核对

  1. 策略组选择：在客户端的代理页面找到规则引用的组，明确选择一个节点。自动选择组则需要查看当前实际选中的成员。
  2. 延迟测试：运行客户端提供的测试。结果为 120 ms 时，只能说明该测试目标与测试方法下的耗时；这是读数示例，并非本文实测，也不能替代带宽与业务可用性测试。
  3. 连接记录：打开一个预期走代理的网站，随后查看客户端的连接或请求记录，核对目标域名、命中规则、策略链与实际节点。

若出口地址仍与本地运营商一致，先确认这次查询是否命中了直连规则。出口检测站本身也可能被规则直连。应把检测结果与同一时间的连接记录对应，而不是看到一个 IP 地址就认定整台手机的代理失效。

iPhone 常见问题：DNS、更新失败与网络切换

节点能测延迟，网页却打不开

先比较具体业务请求与延迟测试的目标是否相同，再检查 DNS 和规则。节点握手成功不代表目标网站可访问。如果日志出现域名解析失败，应确认客户端是否接受配置中的 DNS 字段，以及是否有客户端级 DNS 设置覆盖它。使用 Fake-IP 时，也需要客户端自身支持对应模式，不能仅添加 enhanced-mode: fake-ip 就假定生效。

桌面配置正常，iOS 提示不支持字段

保留报错字段名，查当前客户端版本的配置文档。mihomo 专用扩展、规则提供器行为和传输选项可能存在差异。不要为消除报错而删除整段规则或 DNS 配置；先使用订阅提供方的 iOS 适配输出，再确认关键策略是否仍然保留。

Wi-Fi 可用，蜂窝网络失败

先在关闭代理时确认蜂窝数据能正常联网，再确认「设置」→「蜂窝网络」中客户端具备所需的数据访问权限。切换 Wi-Fi 与蜂窝网络后，观察隧道是否重连、节点是否重新握手。部分网络路径对 UDP 的处理不同，使用 Hysteria2 等基于 QUIC 的协议时，应特别核对 UDP 可达性，不要直接归因于账号地区。

订阅更新后，原有选择消失

订阅可能修改了节点名称、策略组名称或组结构。先检查本次更新结果，再重新选择成员。若应用支持策略选择持久化，也只能在其匹配规则有效时恢复选择；服务端已经删除的节点无法靠本地保留设置继续使用。

需要停止或清理配置

先在客户端停止连接，检查是否开启按需连接或自动连接，避免系统立即重连。需要移除时，再到系统 VPN 列表删除对应配置。准备反馈问题时，记录客户端版本、iOS 版本、网络类型、错误时间与相关日志，遮住订阅凭据、节点密码和私人域名。更多排查入口见常见问题。