平台教程 预计阅读 10 分钟

iPhone 使用 Clash 规则:App Store 获取兼容客户端与导入配置

说明 iOS 端兼容 Clash 配置的客户端如何从 App Store 获取,以及通过链接、文件和扫码三种方式导入订阅,附 VPN 权限授予与后台保活设置。

兼容范围:Clash 规则不等于通用 iOS 配置

iPhone 上使用 Clash 规则,关键是客户端是否支持对应的配置格式,而不是 App 名称里是否包含 Clash。Windows 的安装包不能在 iOS 上运行;iOS 客户端也不一定使用桌面端的 Clash 或 mihomo 内核。即使都能读取 YAML,支持的字段、协议和规则集格式仍可能不同。

本文以支持 Clash 风格配置的 Stash 为操作示例。实际购买前,应在 App Store 产品页与客户端文档中确认系统要求、配置兼容范围和价格。商店可用性会随 Apple 账户地区及产品上架情况变化,不能把搜索结果缺失直接判断为设备故障。

已有材料 导入前检查 处理方式
完整 Clash YAML 包含代理、策略组及规则,字段受到目标客户端支持 选择配置文件或配置 URL 导入
节点订阅或单条节点链接 可能只有服务器信息,没有策略组与分流规则 使用客户端支持的节点导入入口,另行配置规则
mihomo 专用配置 检查专用字段、协议及规则集编码 向提供方获取明确适配目标 iOS 客户端的配置
其他客户端配置 例如 Surge 配置或产品专用订阅 不要仅修改扩展名;选择对应格式或可信的适配方案

App Store 获取:先核对产品,再安装

商店与系统要求

  1. 打开 App Store,在「搜索」中输入产品名,例如 Stash。
  2. 进入产品详情,核对开发者、产品说明、更新记录,以及「兼容性」中的最低 iOS 要求。不要只依据相似图标或搜索广告判断。
  3. 查看当前账户显示的价格与购买条件,确认后再下载。客户端购买费用与订阅服务费用是两项独立内容。
  4. 打开客户端,先查看配置导入入口,再准备订阅链接或本地文件。首次启动不必立即开启连接。

若搜索不到产品,先在 App Store 右上角头像中确认当前「媒体与购买项目」使用的 Apple 账户。商店地区由购买账户等条件决定,不是把「设置」→「通用」→「语言与地区」改成其他地区就能切换。

需要调整账户地区时,应按 Apple 的正式流程处理余额、订阅和付款方式限制。不要使用来源不明的共享账户,也不要把他人账户登录到设备的 iCloud。企业证书安装、描述文件分发与 App Store 下载属于不同渠道,不能混为同一安装流程。

安装前的三项记录

  • 客户端版本:记录 App 内「设置」或「关于」显示的版本,报错时可用于确认字段支持情况。
  • 系统版本:在「设置」→「通用」→「关于本机」查看 iOS 版本。
  • 配置来源:记录订阅面板中标注的目标客户端。若提供方分别列出 Clash、Stash、Surge,应优先选明确适配当前产品的入口。

链接导入:保留订阅地址与更新能力

远程配置适合需要定期更新节点或规则的场景。以下路径按 Stash 常见界面说明:进入配置列表,点击右上角「+」,选择「从 URL 下载」一类入口。不同版本的按钮可能显示为「下载配置」;应选择接收远程配置 URL 的功能,而不是手动添加单个代理。

  1. 在服务方的账户面板复制适配当前客户端的订阅链接。确认复制的是完整 URL,不是登录页地址、购买页地址或一段展示文字。
  2. 粘贴后检查开头、结尾是否完整,有没有多余空格、换行或聊天软件附带的标点。不要为了“整理链接”删除查询参数。
  3. 下载完成后,为配置命名,例如「日常配置」,再在配置列表中选中该项。
  4. 打开配置内容或摘要,确认代理、策略组和规则已加载。若只有一组节点,需进一步核对是否拿到了节点订阅而非完整配置。
  5. 在配置详情中检查更新来源与更新入口。先手动更新一次,再根据客户端实际提供的选项设置更新周期。

订阅更新与规则集更新不一定是同一个过程。配置文件可能通过 proxy-providers 引用代理集合,通过 rule-providers 引用规则集合;主配置下载成功后,这些远程资源仍可能分别下载失败。排查时要看日志中的具体资源地址与错误,而不是只看首页是否出现配置名称。

文件与扫码导入:区分静态副本和远程来源

从「文件」App 导入 YAML

本地文件适合迁移现有配置或在网络下载失败时检查语法。先将 .yaml 或 .yml 文件保存到「文件」App 的「下载项」、iCloud 云盘或「我的 iPhone」。文件扩展名只是识别线索,实际内容仍须是目标客户端支持的配置。

  1. 在客户端配置列表的「+」入口选择从文件导入;如果当前版本没有该入口,可在「文件」App 长按文件,使用「共享」查找目标客户端。
  2. 导入后选中该配置,查看是否出现 YAML 解析错误。缩进应使用空格,不要混入制表符。
  3. 检查文件引用的外部资源。桌面配置中的本地路径不会自动指向 iPhone 上的同名文件,相关内容需要重新导入或改为客户端支持的引用方式。
  4. 保留一份未修改的副本。对规则做本地调整前,确认远程更新是否会覆盖这些改动。

本地导入通常只是导入当时的静态副本,不会仅凭文件名自动关联原订阅。若需要持续更新,应通过远程配置入口重新添加来源。不要把手动下载的新文件误认为已有配置已经自动更新。

扫描订阅二维码

二维码是信息载体,不是独立的配置格式。它可能编码一个 HTTPS 订阅地址,也可能是一条节点 URI。先在客户端的添加配置或扫描入口识别;若界面支持从相册读取,也可以选择已保存的二维码图片。

  • 首次扫描时按提示授予相机权限;之后可在「设置」→「隐私与安全性」→「相机」调整。
  • 识别为远程配置 URL 时,继续核对来源与下载结果,步骤与链接导入相同。
  • 识别为单条节点时,确认它进入的是节点列表,不能期待同时出现完整分流规则。
  • 使用系统相机扫描时,系统可能只显示网址或跳转提示,不保证把内容直接交给代理客户端。

如果二维码来自同一部 iPhone 的屏幕,优先使用客户端的相册识别功能,或直接复制原始订阅链接。不要为了扫码把包含令牌的截图上传到公共识别服务。

VPN 授权与首次连接检查

配置选中后,再打开客户端的连接开关。首次连接通常会出现系统提示,要求允许添加 VPN 配置;确认产品名称后点击「允许」,并按系统要求完成设备密码或生物识别验证。这是授权客户端创建网络隧道,不是安装订阅服务方的证书。

配置状态可在「设置」→「通用」→「VPN 与设备管理」→「VPN」查看。设备受组织管理时,相关权限可能被管理策略限制,应联系管理员确认,不能依靠重复导入绕过限制。

按四步验证分流

  1. 选择规则模式:在客户端的出站或模式设置中选择「规则」。全局模式主要用于临时对比,不适合作为规则是否生效的验证依据。
  2. 检查策略组:打开配置中实际存在的代理策略组,选择一个可用节点,或使用配置已定义的自动选择组。
  3. 测试两类请求:分别访问一个预期直连的网站和一个预期经代理的网站,并在请求记录中查看命中的规则、策略与出站。
  4. 复测应用:浏览器可用后,再测试目标 App。已有长连接可能继续使用旧路径,必要时关闭并重新打开该 App。

桌面端常见的 mixed-port: 7890 表示本地代理监听端口,不是 iPhone 启动 VPN 隧道的必要条件。不要把 Wi-Fi 的「配置代理」手动填成 127.0.0.1:7890 来代替客户端连接开关;该地址只指向手机自身,且不保证存在对应监听服务。

iOS 客户端通常通过系统 Network Extension 建立隧道,不能照搬桌面 mihomo 的「安装服务」或 TUN 网卡操作。桌面配置里的 tun、路由与 DNS 参数,也不能假定在 iOS 上逐项等效。

后台运行:锁屏、切网与按需连接

iOS 隧道由网络扩展承担,界面 App 不需要一直停留在前台。「后台 App 刷新」与隧道能否持续运行不是同一开关。不能承诺开启刷新后绝不掉线,也不应通过反复强制退出客户端来“保活”。

建议的测试顺序

  • 锁屏测试:先确认前台访问正常,再锁屏约 2 分钟,解锁后检查 VPN 状态与新请求记录。这个时长是排查步骤,不是续航或稳定性实测结论。
  • 切网测试:从 Wi-Fi 切换到蜂窝网络,观察是否恢复连接。若仅在蜂窝网络失败,在「设置」→「蜂窝网络」中检查客户端的数据使用权限。
  • 按需连接:若客户端提供「按需连接」,按其说明设置网络条件。它决定何时触发连接,不负责修复失效节点或错误配置。
  • 低电量模式:出现仅在低电量时发生的异常,可暂时关闭低电量模式作对照,但不要将其当成所有断连问题的统一原因。

远程配置更新可能依赖客户端调度、前台运行或系统允许的后台机会。即使设置了更新间隔,也不要理解为 iOS 会在每个时间点精确唤醒 App。长时间未打开客户端时,重新使用前先手动检查配置更新时间。

其他 VPN、DNS 过滤工具和安全类网络扩展可能影响路由或解析。排查时先停用另一项服务,只保留一个待测隧道;不要直接删除工作或学校下发的管理配置。

常见错误:按下载、解析、连接分层排查

现象或日志 优先检查 下一步操作
下载返回 401、403 或 404 令牌、访问限制、链接是否已被重置 回到账户面板重新复制链接,核对订阅状态;状态码本身不能证明唯一原因
返回内容以 HTML 开头 是否误用登录页,或被验证页面拦截 获取真正的配置端点,不要把网页另存为 YAML 导入
YAML 解析失败 报错行附近的缩进、冒号、引号及文件完整性 恢复原始副本,使用本地编辑器逐项检查,不向公开工具上传含凭据的文件
未知字段或不支持的协议 配置是否面向 mihomo 或其他产品 获取目标客户端专用配置,不要直接删除字段后假定行为不变
VPN 已连接但网站打不开 节点可用性、策略组选项、DNS 与规则命中 先换一个已知可用节点,再根据请求记录区分解析失败与连接超时
主配置成功,规则集加载失败 远程规则地址、格式及下载路径 查看具体资源日志,确认客户端支持其编码;二进制规则集并非跨客户端通用

延迟测试有响应,不等于所有业务连接都可用。测速可能使用特定 URL,也可能不覆盖目标网站的 DNS、UDP 或规则路径。反过来,测试超时也可能是探测地址不可达,不能仅凭一个数字判定订阅整体失效。

向提供方或客户端维护者反馈时,提交客户端版本、iOS 版本、导入方式、错误时间和脱敏日志。保留字段名称与错误行号,移除订阅令牌、密码、私钥和个人账户信息。按“配置能否下载 → 能否解析 → 隧道能否启动 → 请求命中何种出站”的顺序定位,通常比反复重装更有效。

下载Clash