导入前:区分订阅地址、配置文件与节点列表

Clash 订阅导入的关键不是链接名称,而是链接返回的内容。以 https:// 开头只能说明它是一个网页资源地址,不能证明它返回 Clash 配置;以 .yaml 结尾也不能保证内部结构正确。先在服务提供方的订阅页面选择适配当前客户端内核的输出格式,再复制完整地址。

拿到的内容识别依据合适的入口
远程 Clash 配置地址返回含代理、策略组和规则的 YAML配置页中的 URL 或远程配置导入
本地配置文件设备上保存的 .yaml 或 .yml 文件文件导入或本地配置入口
协议节点列表多行 ss://、vmess:// 等链接,或它们的 Base64 编码支持节点解析的入口,或先转换为配置
代理提供者文件通常只有顶层 proxies: 列表主配置的 proxy-providers,并由策略组引用

客户端负责配置管理与界面操作,内核负责解析配置、处理规则和建立连接。使用 mihomo 内核的客户端可以识别相应的新协议与字段,但旧版原版 Clash 未必支持同一份配置。因此,格式正确与内核兼容是两个独立条件。

桌面端 URL 导入:创建远程配置并启用

以 Clash Verge Rev 一类桌面客户端为例,操作顺序是「配置」→「新建」→选择远程类型→填写订阅 URL→保存,然后选中该配置。界面文字会随版本调整:有些版本把 URL 输入框直接放在配置页顶部,按钮显示为「导入」,本质上仍是创建一个远程配置条目。

  1. 复制订阅地址。在提供方页面选择 Clash 或适配 mihomo 的订阅格式。使用页面的复制按钮,避免手动选取时漏掉末尾参数;不要复制登录页地址或账单页面地址。
  2. 填写远程配置。打开配置页,将完整地址粘贴到 URL 字段,名称填写便于辨认的短名。除非提供方明确要求,否则先保留请求头、用户代理和更新间隔的默认值。
  3. 执行首次下载。点击保存或导入,等待配置条目出现。若提示解析错误,应检查返回格式,而不是反复启用系统代理。
  4. 选中并加载配置。确认条目显示为当前使用状态。仅把条目添加到列表,不一定意味着内核已经切换到它。
  5. 检查策略组。进入代理页面,确认策略组与可选节点存在,再按需要启用系统代理。先用规则模式验证,不必同时开启 TUN。

粘贴链接时容易忽略的细节

  • 去掉链接前后的空格、引号和换行,但不要随意删除 ? 后的查询参数。
  • 从 HTML 源码复制到的 & 是转义形式;应优先返回原页面使用复制按钮取得实际 URL。
  • 不要自行把 HTTPS 改成 HTTP。证书错误应先检查设备时间、网络环境与服务端证书。
  • 部分服务根据 User-Agent 返回不同内容。只有确认提供方要求后,才调整客户端的订阅请求 User-Agent。

手机端导入:URL、剪贴板与二维码

Android 客户端常在「配置」页提供加号入口,再选择 URL、文件或二维码。以支持 mihomo 的移动客户端为例,应先添加配置并设为当前配置,再启动连接。首次启动出现的系统 VPN 授权,用于建立本地接管通道;它与订阅下载是两个步骤,不能用授权成功来判断订阅是否可用。

  1. 在订阅页面复制适配当前客户端的 URL,切回客户端配置列表。
  2. 打开新增配置入口,选择 URL 导入并粘贴地址;若使用扫码,先确认二维码里是订阅 URL,而不是单条节点链接。
  3. 保存后等待下载完成,检查配置名称、代理组和错误提示。
  4. 设为当前配置,再开启连接并确认系统授权;随后打开一个已知可访问的网站验证。

iOS 客户端的格式支持与导入方式由具体应用决定,不能把 Android 的菜单路径直接照搬。若应用只接受自己的订阅格式,应在提供方页面选择对应格式;只有明确支持 Clash YAML 的入口,才适合导入本文所说的完整配置。

本地 YAML 导入:文件结构与缩进检查

本地文件适合离线保存配置、迁移已有配置或排查订阅下载问题。在客户端选择「配置」→文件导入,找到实际保存的 .yaml 或 .yml 文件,导入后选中启用。把网页另存为文件可能得到 HTML,即使改了扩展名也不会变成 YAML。

下面是一份只用于检查配置加载的直连示例,包含明确的本地监听端口和兜底规则,不包含代理节点。它可以帮助区分“客户端能否加载 YAML”和“远程订阅能否正常提供代理”这两类问题。

mixed-port: 7890
allow-lan: false
mode: rule
log-level: info

proxies: []
proxy-groups: []

rules:
  - MATCH,DIRECT
  • mixed-port: 7890 表示该示例在本机同一端口提供 HTTP 与 SOCKS 代理入口;若端口已被占用,需要修改端口或停止占用程序。
  • allow-lan: false 不开放局域网访问。初次验证无需改成 true。
  • MATCH,DIRECT 让所有匹配到兜底规则的连接直连,所以这个示例不会带来远程代理能力。
  • YAML 缩进使用空格,不用 Tab。节点名称含冒号加空格等特殊内容时,应正确加引号。

本地文件导入后,客户端可能保存一份副本;继续编辑原文件不一定会同步到已导入的条目。普通本地配置也不会自动重新下载远程完整配置,但其中独立声明的远程 provider 仍可能按其设置更新。需要持续同步完整订阅时,应使用远程 URL 条目。

Base64 节点列表与完整配置的差异

Base64 是编码方式,不是代理协议,也不是加密。一段 Base64 文本解码后可能只是多行节点链接,通常没有 Clash 所需的策略组和分流规则。直接将它作为完整 YAML 导入,常见结果是解析失败,或者只有节点信息而缺少可用的选择与路由结构。

完整配置与 provider 文件不能互换

完整配置可以用 proxies 直接声明节点,也可以用 proxy-providers 引入外部节点资源;策略组通过 proxies 或 use 引用它们,再由规则决定连接去向。单独一份顶层为 proxies: 的文件即使能作为 provider 被解析,也不等同于一份已经配置好策略组和规则的主配置。

格式转换的推荐顺序

  1. 先选原生输出。优先使用提供方直接生成的 Clash 或 mihomo 配置,减少转换环节。
  2. 再检查客户端能力。有些客户端支持节点链接导入并自动生成配置,有些只接受完整 YAML;以当前客户端说明为准。
  3. 最后考虑转换。确需转换时,使用受信任或自行部署的转换工具,同时确认节点协议、传输参数、策略组模板和规则来源。

转换工具可能接触原始订阅与全部节点凭据,不宜把私人订阅交给来源不明的公共转换页面。转换也无法让旧内核获得不存在的协议支持;若节点需要 mihomo 支持的能力,应先确认客户端实际运行的内核,而不是只修改输出文件的名称。

订阅导入失败:按下载、解析、连接分层排查

先看客户端日志中的错误阶段,再决定修改哪个设置。下载失败发生在获取内容时,解析失败发生在读取内容时;配置已经加载但网页打不开,才进入代理连接、规则和 DNS 的排查。三类问题混在一起处理,容易把原本有效的设置改乱。

现象或日志优先判断下一步操作
HTTP 401 或 403令牌失效、访问限制或鉴权要求重新复制有效订阅;核对账户状态与提供方说明
HTTP 404地址路径错误或旧入口失效从订阅页面重新获取地址,避免手动拼接
HTTP 429请求过于频繁停止连续刷新,按服务端要求等待后再试
超时或域名解析失败订阅域名当前不可达检查本地 DNS、网络以及客户端更新请求所用的连接方式
YAML 解析错误、返回 HTML下载到了登录页、错误页或其他格式确认订阅输出格式,检查缩进与报错行附近内容
未知代理类型或不支持的字段内核版本或协议能力不匹配核对内核类型,选择兼容输出或更新合适的客户端

浏览器能打开,客户端为什么仍然失败?

浏览器可能携带登录 Cookie,而客户端通常独立请求订阅;浏览器还可能使用系统代理,客户端订阅更新则可能走直连或专门的下载设置。因此,浏览器显示账户页面并不代表客户端拿到了 YAML。若更新必须经过代理,先确认当前已加载的配置可用,再检查客户端的订阅更新代理选项,避免首次导入依赖尚不存在的连接。

配置已加载,但网页仍打不开

  • 检查当前选中的配置是否就是新导入条目,以及策略组是否选中了可用节点。
  • 核对代理模式:规则模式按规则匹配;直连模式不会通过节点;全局模式也不能修复节点本身不可达的问题。
  • 核对系统代理端口与实际监听端口是否一致。例如实际监听为 7890,系统代理却仍指向旧的 7897,应用便可能连接失败。
  • 不遵循系统代理的应用需要另外判断接管方式,再考虑 TUN;不要把 TUN 开关当作订阅格式修复工具。

自动更新与本地覆写:保留可重复的配置流程

远程订阅更新通常会替换该条目的远程内容,直接编辑下载得到的 YAML,下一次刷新后可能丢失修改。需要固定 DNS、添加自定义规则或调整策略组时,优先使用客户端支持的覆写、合并配置或脚本机制,并确认执行顺序。不同客户端的覆写语法并不通用,不能把某一款客户端的脚本直接当作内核配置字段。

  1. 先手动更新一次。确认下载和解析正常,再配置周期更新。可以从 24 小时间隔开始,根据提供方说明调整,避免短时间反复请求。
  2. 分清更新对象。完整配置、代理 provider 和规则 provider 可能各自有更新周期;更新其中一个不代表其他资源都已刷新。
  3. 验证覆写结果。检查最终生效配置与日志,不只检查编辑窗口。自定义规则的位置会影响结果,兜底 MATCH 之后的规则通常不会再被匹配。
  4. 保留恢复入口。保存一份已确认可用的配置副本,并记录原订阅来源;更新失败时先恢复可用配置,再定位原因。

完成导入后的最小检查是:远程下载成功、内核加载成功、策略组可选择、目标应用实际经过预期规则。需要进一步设置系统代理或 TUN,可继续阅读订阅导入与连接教程;字段与 DNS 配置见完整手册,更新失败的后续处理见订阅更新疑难解答。