一、确认 iPhone 客户端与订阅格式
在 iPhone 上搜索“iOS 版 Clash”,实际需要选择能够处理相应订阅、代理协议和分流规则的客户端。Clash 是代理内核及配置生态中的名称,不能仅凭 App 名称里出现 Clash,就判断它能直接使用现有 YAML。桌面端安装包也不能作为 iOS 应用安装。
本文以从 App Store 获取、支持 Clash 风格 YAML 的客户端为操作对象,Stash 是可核对的选项之一。它有自己的实现与配置支持范围,不应当作桌面 Clash 或 Clash Meta(mihomo)的完全替代品。尤其是 mihomo 专用字段、脚本和部分协议参数,导入前需要查看客户端文档。
| 现有内容 | 应当确认 | 下一步 |
|---|---|---|
| Clash YAML 订阅 | 客户端是否支持其中的协议与字段 | 选择适配客户端的订阅入口 |
| 单个节点分享链接 | 客户端是否支持该链接协议 | 按节点导入,不当作完整规则配置 |
| 其他客户端专用订阅 | 服务端是否提供 Clash 或 Stash 输出 | 先切换输出格式,再复制链接 |
| 本地 YAML 文件 | 文件是否含节点、代理组及规则 | 通过文件导入,并自行管理后续更新 |
二、从 App Store 获取客户端
核对商店页面与系统要求
- 打开 iPhone 的 App Store,点底部“搜索”,输入准确的产品名,例如“Stash”。不要只按图标颜色或搜索排序选择应用。
- 进入应用详情页,查看开发者、功能说明及“兼容性”信息,确认支持当前设备与 iOS 版本。若有付费标价,先确认价格再通过系统购买流程安装。
- 安装结束后点“打开”。首次进入先查看配置入口,不必立即打开连接开关;空配置下开启 VPN 并不能产生可用节点。
如果搜索不到应用,先检查产品是否仍在当前商店上架,以及 Apple 账户的商店地区。以 iOS 18 的界面为例,可在“设置”→顶部 Apple 账户→“媒体与购买项目”→“查看账户”→“国家/地区”查看。菜单可能随系统版本调整,商店可售范围也可能变化。
更改商店地区可能涉及余额、订阅和付款方式,不是排查连接问题的必要步骤。不要使用来历不明的共享账户,也不要为安装客户端提供 Apple 账户密码给第三方网站。遇到要求通过企业证书安装、安装设备管理描述文件的页面,应先停止并核对来源。
需要比较系统适配与客户端入口时,可查看客户端下载页;iOS 应用是否可获取、具体售价及兼容系统,以 App Store 当前页面为准。
三、准备订阅链接并导入配置
先复制配置地址,不复制账户后台地址
在服务提供方的订阅管理页面,找到适用于目标客户端的导出选项。若同时提供通用节点订阅、Clash、Stash、mihomo 等入口,优先选择明确适配当前客户端的选项。复制的应是订阅地址,而不是登录页、订单页或浏览器当前地址。
- 完整保留链接中的查询参数,不要自行删除问号后面的内容;其中可能包含身份令牌或输出格式。
- 检查首尾是否带空格、换行、中文引号,尤其是经过聊天工具转发的长链接。
- 订阅地址通常具有账户访问能力,不要发到公开评论、截图或在线格式检查工具中。
在客户端添加并启用配置
- 打开客户端的配置管理页面。以 Stash 为例,从首页的配置入口进入配置列表,找到添加或下载远程配置的操作;不同版本可能将其标为“从 URL 下载”或类似名称,以实际界面为准。
- 将完整订阅地址粘贴到 URL 输入框。若可以填写名称,可用“主用订阅”等易辨认的名称,避免在名称中写入密码或令牌。
- 点下载或确认,等待配置出现在列表中。若出现错误提示,先记录错误类型,不要连续重复提交。
- 点选刚添加的配置,使其成为当前配置。返回首页或代理组页面,确认能看到代理组及节点,而不只是配置文件名。
- 展开默认代理组,选择一个有效节点。初次测试先使用手动选择组,便于确定实际出口;自动选择组还需要检查其测速地址及成员是否有效。
导入成功只说明客户端接受了配置,不代表每个节点均可连接。一个完整的 Clash 风格配置通常包含节点或节点提供者、代理组、规则等内容;如果配置依赖远程规则集或节点提供者,还需要确认这些资源也能成功下载。仅有代理组名称、组内没有节点时,暂时不要继续开启连接。
四、允许 VPN 配置并开启首次连接
iOS 客户端通常通过系统 Network Extension 建立隧道,接管配置范围内的流量。它不是照搬桌面端“系统代理端口”的方式:在 iPhone 上使用此类客户端,通常不需要到 Wi-Fi 设置中手工填写 127.0.0.1:7890。该地址与端口在桌面教程中常见,但并非 iOS 的通用安装步骤。
- 确认配置已选中,在客户端首页打开连接开关。
- 当系统显示客户端想要添加 VPN 配置的提示时,先核对发起请求的应用名称,再点“允许”。
- 按系统要求完成设备密码或生物识别验证。验证应发生在 iOS 系统界面,不是在网页表单中输入锁屏密码。
- 返回客户端,等待状态变为已连接。若刚才取消了授权,重新打开连接开关,再次完成授权。
- 需要检查系统记录时,进入“设置”→“通用”→“VPN 与设备管理”→“VPN”,查看对应配置与连接状态。不同 iOS 版本的显示位置可能略有差别。
系统 VPN 标记代表隧道状态,不代表远端节点已通过验证;带刘海或灵动岛的机型也未必始终在状态栏显示 VPN 字样,应结合控制中心、系统设置和客户端状态判断。普通个人使用场景下,另一款 VPN 应用正在连接时可能影响当前连接,首次测试先断开其他 VPN。
五、验证节点、规则与 DNS 是否正常
首次连接采用“一个节点、一个网络、一组测试”的方式,每次只改一个变量。不要一边换节点,一边更改 DNS 和规则,否则即使恢复也难以判断原因。下面的测试次数是排查步骤,不是对线路性能的实测结论。
- 确认工作模式:日常配置通常先使用 Rule(规则)模式。Direct(直连)模式不会按预期使用代理节点,Global(全局)模式则会改变分流结果,不能用它验证规则是否正确。
- 测试节点可达性:在代理组中对同一节点做 3 次延迟测试,观察是否持续超时。延迟测试通常访问特定测试地址,不等于视频下载速度,也不能证明所有网站都能访问。
- 测试实际网页:用 Safari 打开一个应直连的网站,再打开一个按现有规则应走代理的网站。每个页面刷新一次,同时到客户端连接记录或日志页查找对应域名。
- 核对命中结果:检查日志是否显示预期规则、代理组和出口。若页面能打开但命中 DIRECT,说明不能仅凭网页结果认定代理节点有效。
- 对比接入网络:保持同一个节点,分别在 Wi-Fi 与蜂窝网络测试。仅一侧失败时,优先排查接入网络、门户认证和服务端限制。
如果日志持续出现域名解析超时,再检查配置中的 DNS 设置及客户端对相关字段的支持。不要把多个教程中的 dns 段直接拼接:重复键、缩进错误和不支持的字段都可能造成新问题。Clash Meta(mihomo)配置中的特定 DNS 或 TUN 选项,也不保证能原样用于 iOS 客户端。
六、处理导入失败与连接后断网
| 看到的现象 | 优先检查 | 处理动作 |
|---|---|---|
| 下载返回 401 或 403 | 令牌、订阅权限或服务端访问限制 | 回服务后台确认状态,重新复制有效链接 |
| 下载返回 404 | 订阅路径是否失效或被截断 | 从服务方当前页面重新获取地址 |
| 提示 YAML 解析失败 | 返回内容是否为网页,格式是否适配 | 选择正确的订阅输出,保留报错行号 |
| 节点为空或提示协议不支持 | 节点资源下载及客户端协议支持 | 检查提供者更新结果,获取兼容配置 |
| VPN 已连接但网页打不开 | 所选节点、规则出口、DNS 与订阅状态 | 先换同组有效节点,再按日志定位 |
| 打开开关后立即断开 | 配置加载错误或其他 VPN 冲突 | 先查看日志,断开其他 VPN 后再试 |
解析错误中若出现 <html> 或登录页面标题,常见原因是地址返回了网页,而非客户端需要的订阅。节点空列表则还可能是套餐到期、流量耗尽,或远程节点提供者尚未更新成功,不能一概归为客户端故障。
需要恢复正常上网时,先在客户端关闭连接,再到系统 VPN 设置确认已断开。若配置启用了按需连接,还应在客户端或对应 VPN 配置中检查该选项,避免系统再次自动连接。不要一开始就执行“还原网络设置”,这会影响已保存的网络信息,却未必解决订阅格式问题。
七、订阅更新与日常配置维护
- 区分远程订阅与本地文件:通过 URL 添加的配置可以重新拉取;导入本地 YAML 不代表它会自动跟随服务端变化。
- 更新前保留可用配置:先导出或复制当前配置,再手动更新一次,核对节点数量、代理组选择和连接结果。
- 确认自动更新含义:客户端打开时更新、后台任务和节点提供者更新是不同机制。iOS 会调度后台任务,设置了间隔也不代表能按分钟精确执行。
- 分开保存个人修改:直接修改远程订阅内容可能在下次更新时被覆盖。需要自定义规则时,优先采用客户端明确支持的覆写或本地配置机制。
- 订阅泄露后及时重置:在服务后台重置订阅令牌后,记得同步修改客户端地址,旧地址失效属于预期结果。
完成上述步骤后,应当能明确回答三个问题:当前启用的是哪份配置、实际选中了哪个出口、访问请求命中了什么规则。后续出现连接异常时,从这三个位置开始检查,比重复安装应用更容易定位。更完整的配置顺序可继续阅读使用文档,规则与配置概念可查阅Clash 配置手册。