· 平台上手 · 预计阅读 8 分钟
iPhone 安装 Clash 类客户端:App Store 地区账号与订阅导入步骤
介绍 iOS 端可用客户端在 App Store 的获取条件、外区账号注意事项,以及通过链接、文件、扫码三种方式导入配置后的首次连接检查。
App Store 搜不到客户端:先核对商店地区和兼容性
先从开发者发布页打开 App Store 商品页,再核对开发者名称、最低 iOS 版本和配置格式。搜索结果里有 Clash 字样,仅凭名称无法判断它是否使用 mihomo 内核,也无法判断它能否读取现有的 Clash YAML。
- 商店地区:商品页提示当地不可用时,先确认当前「媒体与购买项目」账号所属的国家或地区。项目是否上架取决于商店目录;修改系统语言或切换网络不会改变账号的商店地区。
- 最低版本:在商品页的「信息」→「兼容性」查看要求,再到「设置」→「通用」→「关于本机」核对 iOS 版本。例如商品要求 iOS 17.0,而设备是 iOS 16.7,切换商店地区也不能满足版本要求。
- 订阅格式:手头是完整 Clash YAML,就找明确说明支持该格式的应用。若应用只接受自己的配置格式,先向订阅提供方确认有没有对应入口,再决定是否购买。能导入单条节点链接,不代表能读取整份分流配置。
Apple 账号地区:查看购买账号,再决定是否变更
常见查看路径是「设置」→「你的姓名」→「媒体与购买项目」→「查看账户」→「国家或地区」。菜单文字可能随系统版本变化。这里检查的是购买项目账号,不是「通用」里的「语言与地区」。
变更现有账号地区前要查什么
先检查账户余额、订阅、家庭共享状态和目标地区的付款要求。Apple 可能要求先用完余额、取消妨碍变更的订阅并等当前周期结束,或处理家庭共享限制。目标地区也可能要求有效的付款方式和账单地址。变更前应核对常用应用是否仍可下载,不能把改区当成随时可撤销的开关。
已有其他地区的自用账号怎么办
若已持有符合当地条件的自用账号,且需要用它获取应用,先确认能接收该账号的双重认证验证码。只需切换购买账号时,在「媒体与购买项目」中操作,不要从 Apple 账号设置页底部退出整个 iCloud。应用的购买记录仍属于获取时的账号,日后更新或重新下载可能需要该账号。避免使用共享账号,也不要向他人交付密码或验证码。
订阅导入:链接、YAML 文件和二维码怎么选
先确认来源,再确认内容。HTTP 或 HTTPS 链接可能指向可更新订阅,也可能只是登录页;二维码可能封装订阅地址,也可能只有一个节点。完整 Clash 配置常见顶层字段有 proxies、proxy-providers、proxy-groups 和 rules,具体组合视配置而定。若依赖远程提供器,还要确认客户端支持对应字段并能获取远程内容。
- 订阅链接:在订阅提供方页面选与客户端兼容的输出格式,复制完整 URL。从应用的「配置」或「订阅」页进入添加界面,选 URL 导入,保存后手动刷新一次,再把新配置设为当前使用。若更新返回 401 或 403,先查令牌是否失效、地址有无复制完整,以及所选订阅入口是否适用;若返回 200 仍解析失败,检查内容是否实际为 HTML 登录页或其他格式。
- 本地文件:把可信的
.yaml或.yml存进「文件」App,然后从客户端的文件导入入口选择。若客户端提供分享扩展,也可在「文件」中长按文件,选「共享」后交给对应应用。保留原件,修改副本。遇到解析错误先看日志标出的行号及上一行,检查缩进、冒号和列表层级;把网页或文本改成 YAML 扩展名不会转换内容。通常需要重新导入新文件才能更新本地快照。 - 二维码:将可信的二维码显示在另一台设备上,从客户端的扫码入口导入。同一台 iPhone 上的截图,需要客户端支持从相册识别;没有该入口就回到提供方页面复制链接。扫码后若只新增一个节点,不能据此认定策略组和规则也已导入。相机打不开时,可在「设置」→「隐私与安全性」→「相机」检查权限。
首次连接:检查系统 VPN、当前配置和规则命中
- 确认当前配置。导入后打开配置详情,检查预期的节点和策略组是否出现。策略组如果依赖远程提供器,先刷新并查看拉取结果。在手动选择组中指定一个节点,避免一边排查一边自动切换出口。
- 允许添加 VPN 配置。启动使用系统 VPN 的客户端时,iOS 可能要求允许添加 VPN 配置并验证身份。只批准刚刚主动发起的请求。之后可到「设置」→「通用」→「VPN 与设备管理」→「VPN」查看状态。公司或学校管理的设备若限制配置添加,应联系管理员。
- 使用规则模式核对两种出口。找一个配置明确设为
DIRECT的域名,再找一个明确交给代理策略组的域名,各发起一次请求。若客户端提供连接日志,记录域名、命中规则、策略组和最终出口。只看到网页打开或状态栏出现 VPN 标记,都不足以证明指定请求经过了代理。 - 切换网络重复一次。先在 Wi‑Fi 上测试,再切换蜂窝网络,用同一个节点和同一个测试域名重试。单一网络失败时,先核对 Wi‑Fi 是否需要门户登录、蜂窝数据是否允许使用,以及失败发生在域名解析还是连接阶段,再考虑更换配置。
iOS 客户端显示的 VPN 连接通常依赖系统的 Network Extension。即便应用支持 Clash 配置,也不意味着桌面版的 tun、mixed-port 或 external-controller 字段会原样生效。是否支持接管特定流量、开放本地端口或使用自定义 DNS,要看应用与其内核的实现。
配置已导入但打不开网页:按失败阶段定位
| 现象 | 优先核对 |
|---|---|
| 导入成功,策略组却是空的 | 查看 proxy-providers 是否拉取成功,确认客户端支持提供器格式。若扫描的是单节点二维码,重新索取完整配置。 |
| VPN 已连接,请求却走直连 | 检查当前是否处于直连模式,或规则模式下请求是否先命中了一条直连规则。再看代理策略组当前选择的是否就是 DIRECT。 |
| 直连正常,代理请求超时 | 在同一网络下切换一个已知可用的节点。若日志给出解析错误,查节点域名的 DNS;若有连接超时或证书错误,分别核对服务器地址、端口或系统日期时间。 |
| 开启 VPN 后直连和代理都失败 | 先断开,确认基础网络可用;再检查是否有其他 VPN 或 DNS 配置影响测试。一次只改一项,记录改前改后的结果,避免同时更换订阅、节点和 DNS。 |
例如,若日志显示测试域名最终命中 MATCH,DIRECT,说明该请求落到了直连兜底;此时先查预期规则是否存在、顺序是否正确,或规则集是否加载成功。若日志已显示请求进入预期代理组,却在连接节点时超时,才把排查重点移到节点和当前网络。这样可以把分流错误与节点不可达分开。