iOS 代理客户端上手:App Store 获取方式与订阅配置导入步骤

先确认客户端与订阅格式，再处理商店地区

iPhone 上的正确顺序是：确认客户端支持的配置格式，查看 App Store 是否可获取，导入配置，最后授权 VPN 并验证连接。安装客户端不会自动获得节点；订阅地址通常由服务提供方单独提供，应用购买费用与节点服务费用也不是同一笔费用。

桌面端的 Clash 客户端、mihomo 内核与 iOS 代理应用不能直接画等号。iOS 应用通常利用系统的 Network Extension 扩展接管网络，具体协议、规则语法和配置管理由各自实现。名称里出现“代理”或“VPN”，并不代表它能完整读取 Clash YAML。

App Store 获取方式与地区检查

部分代理客户端只在特定国家或地区的 App Store 上架，因此搜索不到应用时，首先检查商店地区，而不是修改 iPhone 的语言、时区或“语言与地区”。App Store 的商品可见性主要跟随购买项目所使用的 Apple 账户地区，具体上架情况可能变化，应以当前商店详情页为准。

先核对名称、开发者与系统要求

1. 打开 App Store，搜索应用的完整名称，并核对开发者信息。不要仅凭相似图标或搜索排序判断。
2. 进入详情页，检查“兼容性”中的最低 iOS 要求。若当前系统不满足要求，切换地区也不会解决兼容性问题。
3. 确认价格、购买账户以及是否能在自己的设备上安装。购买前先核实订阅格式，避免应用装好后才发现配置不兼容。

查看或更改购买账户地区

以 iOS 18 常见界面为例，路径为「设置」→ 顶部姓名 →「媒体与购买项目」→「查看账户」→「国家/地区」。系统版本、账户状态不同，文字可能略有差异。这里的地区与「设置」→「通用」→「语言与地区」不是同一项。

• 修改现有账户地区：Apple 可能要求先用完账户余额、处理订阅和待完成订单，并提供新地区认可的付款方式。家庭共享也可能影响操作条件。
• 使用自己持有的其他地区账户：可以在“媒体与购买项目”中管理商店登录，不必为了下载应用退出整台设备的 iCloud。切换仍可能影响购买项目、媒体订阅与后续更新，应先阅读系统提示。
• 保留购买记录：应用的购买、重新下载与更新资格跟随购买账户。不要依赖陌生人提供的共享账户，也不要把自己的验证码交给代操作人员。

地区资料应按实际情况填写并符合 Apple 的使用条件。网页提供的安装包不能直接替代 App Store 正常安装；桌面端的 .exe、.dmg、Android 的 .apk 也不能用于 iPhone。TestFlight 是测试分发渠道，存在名额与构建有效期限制，不应当作长期可用的商店替代方案。

订阅链接导入：保留原地址，检查更新结果

订阅链接适合需要定期更新节点的情况。它通常包含访问令牌，任何获得完整地址的人都可能读取相应订阅内容。不要把地址发到公开聊天、截图或工单正文中；需要排查时，可只提供状态码、报错文字与已隐藏令牌的域名信息。

按“新增配置 → 下载 → 选中”完成导入

1. 从服务方账户页面复制对应客户端的 HTTPS 订阅地址。确认复制的是链接本身，而不是登录页地址、分享说明或带引号的一段文字。
2. 打开客户端的“配置”“订阅”或“配置文件”页面，选择“新增”“从 URL 下载”一类入口。应用之间入口名称不同，重点是找到远程配置导入，而非手动新增单个节点。
3. 粘贴完整地址，为配置起一个能区分来源的本地名称，例如“个人订阅”。如果 iOS 询问是否允许从其他应用粘贴，确认当前来源后再允许。
4. 执行下载或更新，检查是否出现节点、策略组或规则。仅保存了一个配置名称，不代表内容已经成功获取。
5. 将新配置设为当前使用项。部分客户端可以保存多份配置，但同一时刻只有选中的配置参与连接。

完整 Clash 风格配置常见字段包括 proxies、proxy-groups、rules，也可能通过 proxy-providers 引入节点。只返回编码节点列表的订阅不是完整 YAML；同样，返回一个 HTML 登录页面也不是可用订阅。出现解析错误时，先确认响应类型与应用支持范围，不要直接改动大量规则。

订阅更新会重新取得远程内容。是否覆盖本地规则、是否保留节点选择，取决于客户端实现。需要长期保留分流修改时，优先使用该应用支持的覆写、脚本或独立规则机制；不要把直接编辑远程配置后的结果当作永久保存。

文件与二维码导入：先区分内容类型

从“文件”应用导入配置

配置文件适合离线传递、备份恢复或排查问题。先把文件存到「文件」应用的“我的 iPhone”或 iCloud 云盘，再在客户端中选择“从文件导入”；也可在文件的分享菜单中选择目标客户端，前提是该应用注册了相应文件类型。

1. 确认文件实际内容。.yaml 与 .yml 常用于 Clash 风格配置；改后缀不会自动转换格式。
2. 导入后查看配置检查结果，留意缩进、字段类型和不支持的协议。YAML 缩进使用空格，不能用 Tab 随意替代。
3. 选中该文件配置，检查策略组是否有可选节点。文件中引用的远程节点提供器或规则提供器，仍然需要联网下载。
4. 保存原文件备份。静态文件通常不会像远程订阅一样自动取得新节点，除非其内容本身包含受支持的远程引用。

扫码导入订阅或单个节点

二维码只是文字的承载方式，不是一种统一配置格式。扫码结果可能是 HTTPS 订阅链接，也可能是单节点 URI，或客户端专用的导入指令。客户端必须支持里面的内容，扫描成功才有意义。

• 扫描另一块屏幕：从客户端内的扫码入口打开相机，按 iOS 提示授予相机权限，再核对导入预览。
• 二维码在本机相册：若客户端支持“从相册识别”，可选取截图；如果不支持，回到服务方页面复制订阅链接更直接。
• 系统相机识别：系统可能只把结果当作普通网址打开，不能据此判断客户端已经导入成功。

导入后要看新增的是“一个节点”还是“一份订阅”。单节点二维码通常不会同时附带完整分流规则，也不必然支持后续自动更新。含有节点密码或订阅令牌的二维码与原链接同样敏感，分享截图前应将二维码整体遮挡。

VPN 授权与首次连接验证

导入成功后，先选配置和节点，再点击连接。首次启动隧道时，iOS 通常会提示应用希望添加 VPN 配置。确认提示中的应用就是刚安装的客户端，再选择允许，并根据系统要求输入设备密码或完成验证。

这项授权允许客户端创建系统网络隧道，并不等同于安装企业管理描述文件、根证书或 MDM 管理。普通订阅导入通常不需要这些额外操作；如果来源不明的教程要求安装证书或管理描述文件，应先停止并核实用途。

用三项检查确认连接，而不是只看 VPN 图标

1. 检查模式与策略组：首次验证可使用规则模式，在实际被规则引用的手动选择组中选定一个节点。若组中选择的是 DIRECT，命中的流量仍会直连。
2. 确认隧道状态：查看客户端是否显示已连接，也可在 iOS 18 的「设置」→「通用」→「VPN 与设备管理」→「VPN」检查状态。菜单会随系统版本变化。
3. 核对真实请求：打开一个按当前规则应走代理的网页，同时查看客户端的连接记录或日志，确认目标域名、命中策略与出站节点。再用出口 IP 查询辅助判断，不要仅凭状态栏图标下结论。

规则可能把某些 IP 查询网站分流为直连，所以“查询结果没变化”并不总是连接失败。需要隔离变量时，可短暂使用应用提供的全局代理模式，并确认全局策略选的是目标节点；测试完成后恢复原来的规则模式。不要同时修改 DNS、节点与规则，否则很难判断哪一项起作用。

桌面客户端所说的“TUN 模式”和 iOS 的系统隧道在使用体验上都可能接管应用流量，但配置开关与底层限制并不相同。不要因为桌面配置含有 tun 字段，就认定 iOS 应用会按完全相同的方式处理它。

导入失败、连接超时与更新异常的排查顺序

按单一变量复测

建议先关闭连接，确认普通网络能够访问服务方页面，再执行一次订阅更新。随后选定一个节点连接，记录出错时间和客户端给出的错误类型。如果 Wi-Fi 失败而蜂窝网络成功，优先排查当前路由器、DNS 或局域网限制；如果两种网络均失败，再检查节点状态和配置兼容性。

iOS 上另一个 VPN、按需连接规则或网络过滤扩展可能影响测试。排查时先断开其他 VPN，并检查其是否会自动重新连接。若重启后客户端又自动接管流量，检查客户端内的“按需连接”设置，以及系统 VPN 配置对应的开关，而不是反复删除订阅。

延迟测试有数值只说明测试目标在当时可达，不代表所有网站、流媒体或 UDP 应用都可用。首次连接的最低验收标准应是：配置能更新、当前策略选对、预期走代理的请求在日志中有对应记录、目标服务能正常访问。遇到协议或规则字段问题，可对照本站的 YAML 手册，但最终仍以所用 iOS 客户端的支持范围为准。