导入前:区分订阅地址、配置文件与节点列表
Clash 订阅导入的关键不是链接名称,而是链接返回的内容。以 https:// 开头只能说明它是一个网页资源地址,不能证明它返回 Clash 配置;以 .yaml 结尾也不能保证内部结构正确。先在服务提供方的订阅页面选择适配当前客户端内核的输出格式,再复制完整地址。
| 拿到的内容 | 识别依据 | 合适的入口 |
|---|---|---|
| 远程 Clash 配置 | 地址返回含代理、策略组和规则的 YAML | 配置页中的 URL 或远程配置导入 |
| 本地配置文件 | 设备上保存的 .yaml 或 .yml 文件 | 文件导入或本地配置入口 |
| 协议节点列表 | 多行 ss://、vmess:// 等链接,或它们的 Base64 编码 | 支持节点解析的入口,或先转换为配置 |
| 代理提供者文件 | 通常只有顶层 proxies: 列表 | 主配置的 proxy-providers,并由策略组引用 |
客户端负责配置管理与界面操作,内核负责解析配置、处理规则和建立连接。使用 mihomo 内核的客户端可以识别相应的新协议与字段,但旧版原版 Clash 未必支持同一份配置。因此,格式正确与内核兼容是两个独立条件。
桌面端 URL 导入:创建远程配置并启用
以 Clash Verge Rev 一类桌面客户端为例,操作顺序是「配置」→「新建」→选择远程类型→填写订阅 URL→保存,然后选中该配置。界面文字会随版本调整:有些版本把 URL 输入框直接放在配置页顶部,按钮显示为「导入」,本质上仍是创建一个远程配置条目。
- 复制订阅地址。在提供方页面选择 Clash 或适配 mihomo 的订阅格式。使用页面的复制按钮,避免手动选取时漏掉末尾参数;不要复制登录页地址或账单页面地址。
- 填写远程配置。打开配置页,将完整地址粘贴到 URL 字段,名称填写便于辨认的短名。除非提供方明确要求,否则先保留请求头、用户代理和更新间隔的默认值。
- 执行首次下载。点击保存或导入,等待配置条目出现。若提示解析错误,应检查返回格式,而不是反复启用系统代理。
- 选中并加载配置。确认条目显示为当前使用状态。仅把条目添加到列表,不一定意味着内核已经切换到它。
- 检查策略组。进入代理页面,确认策略组与可选节点存在,再按需要启用系统代理。先用规则模式验证,不必同时开启 TUN。
粘贴链接时容易忽略的细节
- 去掉链接前后的空格、引号和换行,但不要随意删除
?后的查询参数。 - 从 HTML 源码复制到的
&是转义形式;应优先返回原页面使用复制按钮取得实际 URL。 - 不要自行把 HTTPS 改成 HTTP。证书错误应先检查设备时间、网络环境与服务端证书。
- 部分服务根据 User-Agent 返回不同内容。只有确认提供方要求后,才调整客户端的订阅请求 User-Agent。
手机端导入:URL、剪贴板与二维码
Android 客户端常在「配置」页提供加号入口,再选择 URL、文件或二维码。以支持 mihomo 的移动客户端为例,应先添加配置并设为当前配置,再启动连接。首次启动出现的系统 VPN 授权,用于建立本地接管通道;它与订阅下载是两个步骤,不能用授权成功来判断订阅是否可用。
- 在订阅页面复制适配当前客户端的 URL,切回客户端配置列表。
- 打开新增配置入口,选择 URL 导入并粘贴地址;若使用扫码,先确认二维码里是订阅 URL,而不是单条节点链接。
- 保存后等待下载完成,检查配置名称、代理组和错误提示。
- 设为当前配置,再开启连接并确认系统授权;随后打开一个已知可访问的网站验证。
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 被解析,也不等同于一份已经配置好策略组和规则的主配置。
格式转换的推荐顺序
- 先选原生输出。优先使用提供方直接生成的 Clash 或 mihomo 配置,减少转换环节。
- 再检查客户端能力。有些客户端支持节点链接导入并自动生成配置,有些只接受完整 YAML;以当前客户端说明为准。
- 最后考虑转换。确需转换时,使用受信任或自行部署的转换工具,同时确认节点协议、传输参数、策略组模板和规则来源。
转换工具可能接触原始订阅与全部节点凭据,不宜把私人订阅交给来源不明的公共转换页面。转换也无法让旧内核获得不存在的协议支持;若节点需要 mihomo 支持的能力,应先确认客户端实际运行的内核,而不是只修改输出文件的名称。
订阅导入失败:按下载、解析、连接分层排查
先看客户端日志中的错误阶段,再决定修改哪个设置。下载失败发生在获取内容时,解析失败发生在读取内容时;配置已经加载但网页打不开,才进入代理连接、规则和 DNS 的排查。三类问题混在一起处理,容易把原本有效的设置改乱。
| 现象或日志 | 优先判断 | 下一步操作 |
|---|---|---|
| HTTP 401 或 403 | 令牌失效、访问限制或鉴权要求 | 重新复制有效订阅;核对账户状态与提供方说明 |
| HTTP 404 | 地址路径错误或旧入口失效 | 从订阅页面重新获取地址,避免手动拼接 |
| HTTP 429 | 请求过于频繁 | 停止连续刷新,按服务端要求等待后再试 |
| 超时或域名解析失败 | 订阅域名当前不可达 | 检查本地 DNS、网络以及客户端更新请求所用的连接方式 |
| YAML 解析错误、返回 HTML | 下载到了登录页、错误页或其他格式 | 确认订阅输出格式,检查缩进与报错行附近内容 |
| 未知代理类型或不支持的字段 | 内核版本或协议能力不匹配 | 核对内核类型,选择兼容输出或更新合适的客户端 |
浏览器能打开,客户端为什么仍然失败?
浏览器可能携带登录 Cookie,而客户端通常独立请求订阅;浏览器还可能使用系统代理,客户端订阅更新则可能走直连或专门的下载设置。因此,浏览器显示账户页面并不代表客户端拿到了 YAML。若更新必须经过代理,先确认当前已加载的配置可用,再检查客户端的订阅更新代理选项,避免首次导入依赖尚不存在的连接。
配置已加载,但网页仍打不开
- 检查当前选中的配置是否就是新导入条目,以及策略组是否选中了可用节点。
- 核对代理模式:规则模式按规则匹配;直连模式不会通过节点;全局模式也不能修复节点本身不可达的问题。
- 核对系统代理端口与实际监听端口是否一致。例如实际监听为
7890,系统代理却仍指向旧的7897,应用便可能连接失败。 - 不遵循系统代理的应用需要另外判断接管方式,再考虑 TUN;不要把 TUN 开关当作订阅格式修复工具。
自动更新与本地覆写:保留可重复的配置流程
远程订阅更新通常会替换该条目的远程内容,直接编辑下载得到的 YAML,下一次刷新后可能丢失修改。需要固定 DNS、添加自定义规则或调整策略组时,优先使用客户端支持的覆写、合并配置或脚本机制,并确认执行顺序。不同客户端的覆写语法并不通用,不能把某一款客户端的脚本直接当作内核配置字段。
- 先手动更新一次。确认下载和解析正常,再配置周期更新。可以从 24 小时间隔开始,根据提供方说明调整,避免短时间反复请求。
- 分清更新对象。完整配置、代理 provider 和规则 provider 可能各自有更新周期;更新其中一个不代表其他资源都已刷新。
- 验证覆写结果。检查最终生效配置与日志,不只检查编辑窗口。自定义规则的位置会影响结果,兜底
MATCH之后的规则通常不会再被匹配。 - 保留恢复入口。保存一份已确认可用的配置副本,并记录原订阅来源;更新失败时先恢复可用配置,再定位原因。
完成导入后的最小检查是:远程下载成功、内核加载成功、策略组可选择、目标应用实际经过预期规则。需要进一步设置系统代理或 TUN,可继续阅读订阅导入与连接教程;字段与 DNS 配置见完整手册,更新失败的后续处理见订阅更新疑难解答。