入门指南 预计阅读 12 分钟

Clash 订阅链接导入教程:URL、Base64 与 YAML 格式区别

介绍在各平台客户端中导入订阅链接的入口与步骤,并对比完整 YAML 配置、Base64 节点列表与单节点链接三种常见格式的差异与转换思路。

先分清链接与返回内容

导入 Clash 订阅,先确认两件事:手里拿到的是下载地址,还是节点本身;下载地址返回的是完整配置,还是只有节点列表。很多“链接能打开,客户端却导入失败”的问题,就出在这里。

URL 是地址,YAML 和 Base64 描述的是内容格式或编码方式,三者不是同一层概念。一个以 https:// 开头的订阅 URL,既可能返回 Clash YAML,也可能返回 Base64 编码的节点列表,还可能返回账户登录页。仅看后缀、链接长度或网页是否能访问,都不能判断兼容性。

拿到的内容 识别线索 适合的入口
完整 YAML 配置 通常含有 proxies、proxy-groups、rules 等字段,也可能通过 provider 引用节点 远程配置导入,或本地配置文件导入
Base64 节点列表 解码后通常是多行 ss://、vmess://、trojan:// 等链接 支持该格式的导入工具,或可信的本地转换流程
单节点链接 以具体协议前缀开头,通常描述一个连接 明确支持该协议的节点导入或节点编辑入口

完整 YAML 与节点列表的区别

完整配置不只是节点集合

一份可直接使用的 Clash 配置,除了连接参数,还需要决定流量如何进入内核、规则指向哪个策略组,以及没有命中规则时使用哪个出口。常见字段包括 mixed-port、mode、proxy-groups、rules 和 dns。不同内核支持的字段不完全相同,配置中出现某个字段,并不代表所有客户端都能识别。

下面是用于认识字段的 YAML 片段,不是带代理节点的订阅。7890 是示例监听端口,不能据此认定本机客户端也在使用这个端口;MATCH,DIRECT 则会让走到这条规则的请求直连。

mixed-port: 7890
mode: rule
log-level: info
rules:
  - MATCH,DIRECT

导入时要保留原文件的层级和空格缩进,不要把网页中展示的富文本直接当作配置。YAML 缩进应使用空格而不是 Tab。解析器报出的行号是排查起点,真正的错误也可能在上一行,例如漏掉引号、冒号后没有正确分隔,或列表项缩进错位。

同为 YAML,也可能只是 provider 文件

有些地址返回的内容只有顶层 proxies: 和节点列表。这通常用于 proxy-providers,不等于包含策略组与分流规则的完整配置。主配置需要声明 provider,并通过策略组的 use 引用它;把它当成完整配置导入,可能虽然能解析,却没有预期的策略组和分流行为。

因此,服务提供方如果同时给出“Clash 配置”和“节点提供者”两个入口,新手应先选择前者。只有准备自己维护主配置时,才需要接入后者。字段含义可以对照本站的配置字段文档,不要仅凭文件扩展名判断用途。

各平台怎样导入订阅 URL

下面按常见客户端界面说明。菜单翻译可能随版本调整,遇到名称不一致时,优先找“订阅”“配置”或 Profiles 页面,而不是连接列表里的节点搜索框。首次导入前,先保留当前能用的配置,不要把旧配置删掉再试。

Windows 与 macOS:以 Clash Verge Rev 为例

  1. 在服务提供方的订阅页面选择 Clash 或明确标注适配 mihomo 的格式,复制完整的 HTTPS 订阅地址,而不是账户后台的网页地址。
  2. 打开 Clash Verge Rev 的「订阅」页面,在订阅链接输入框粘贴地址,点击「导入」。如果当前界面提供「新建」入口,可选择远程类型后填写名称与 URL。
  3. 等待远程配置下载完成,再选中该配置。仅把条目加入列表,不一定意味着它已经成为正在使用的配置。
  4. 打开「代理」页面,确认出现预期的策略组,再选择组内出口。需要按规则分流时,将运行模式设为「规则」。
  5. 按实际需求启用系统代理或 TUN,并检查连接记录。首次验证不建议同时更改 DNS、规则和 TUN 参数,否则很难判断是哪一步生效。

Linux 上使用同一客户端时,订阅导入逻辑相同;差别主要在系统代理与 TUN 的权限、服务安装方式。订阅下载成功与系统流量是否进入代理,是两个独立结果。

Android:区分配置导入与 VPN 启动

旧版 Clash for Android 常见路径是「配置」→「+」→「从 URL 导入」,随后填写名称与 URL 并保存。返回配置列表后,需要选择刚导入的配置,再回到主界面启动;系统首次出现 VPN 授权提示时,确认授权才能接管相应流量。该项目已停止维护,较新的协议与配置字段应先核对兼容性。

使用 FlClash 等仍在维护的客户端时,可以从「配置」页面寻找新增或 URL 导入入口,流程同样是“添加地址 → 下载 → 选中配置 → 启动”。不要把 Android 的 VPN 图标当作订阅已正确加载的证明:它只能说明 VPN 服务处于运行状态。

iOS:先确认客户端接受什么格式

iOS 客户端并不共享统一的 Clash 导入菜单。应先查看客户端说明,确认它接收完整 Clash YAML、节点订阅,还是仅接收单节点 URI,再使用对应的“添加订阅”或“导入配置”入口。不要因为两个应用都支持同一种代理协议,就认为它们也支持同一种配置文件。

若订阅页面提供“打开客户端”按钮,唤起应用后仍应核对导入名称与目标地址。系统分享面板里出现某个应用,也不代表该应用能够解析当前内容。需要更换客户端时,可以先在客户端下载页确认平台与内核类型。

Base64 和单节点怎样处理

Base64 解码不会生成分流规则

Base64 是编码,不是加密。节点列表经过编码后看起来像一长串字符,但解码后通常仍然只是多行节点 URI,不会自动补出 proxy-groups、rules 或 DNS 设置。有的列表会省略末尾填充字符,或采用 URL 安全变体,因此简单的在线解码器也可能报告错误。

最省事的路径,是先回到服务提供方页面选择 Clash 或 mihomo 对应的订阅格式。只有没有原生格式时,再考虑转换。不要通过给 URL 随意追加 format=clash 来碰运气;格式参数由服务端定义,不存在所有订阅站都通用的写法。

单节点能导入,不等于能持续更新

ss://、vmess://、trojan:// 等链接通常包含服务器、端口、认证与传输参数。导入它们时,客户端必须同时支持对应协议及 URI 的参数表达方式。某些新协议需要 mihomo 等内核支持,旧 Clash 内核不能只靠修改协议名称获得兼容能力。

手动导入的节点一般是一次性快照。服务端以后更换端口、认证信息或传输参数,原节点不会因为“曾经来自订阅页面”就自动更新。需要自动维护时,应保存远程订阅条目,并使用客户端提供的更新机制。

转换前后要核对哪些字段

  • 协议与认证:确认节点类型、服务器端口、密码或 UUID 没有丢失。不要只看节点名称相同就判定转换成功。
  • TLS 参数:核对 SNI、ALPN 与证书验证设置。不要为了让转换结果“能连”而直接关闭证书验证。
  • 传输参数:WebSocket 路径、请求头以及 gRPC 的服务名称都可能影响握手;遗漏一项就可能连接失败。
  • 配置结构:转换工具生成的策略组与规则应能够互相引用。规则指向不存在的组名,即使节点有效,整份配置也可能无法加载。

导入失败按返回结果排查

先区分“请求没有成功”和“请求成功但内容不对”。前者查网络、地址和证书;后者查格式与内核兼容性。不要在下载失败时反复修改 YAML 缩进,也不要在解析失败时只切换节点。

现象 常见原因 下一步
HTTP 401 或 403 令牌失效、权限限制或访问被拦截 重新复制订阅地址,核对账户状态与服务说明
HTTP 404 或 410 地址错误、旧接口移除或资源失效 从服务提供方后台重新获取入口
HTTP 429 短时间更新过于频繁 停止连续重试,按服务端提示等待后再更新
状态为 200,但提示解析失败 返回 HTML、JSON 错误信息或不兼容的节点列表 查看响应开头,确认是否真的是预期配置
unknown proxy type 等类型错误 当前内核不支持节点协议,或转换结果错误 核对内核类型和节点参数,不要只升级界面程序
导入成功但没有预期策略组 配置未激活,或拿到了仅含节点的文件 检查当前选中项以及完整配置结构

浏览器打开成功,不代表客户端也能下载

浏览器可能带有登录 Cookie,而订阅下载器没有;服务端也可能根据 User-Agent 返回不同内容。因此应以客户端实际取得的响应为准。如果日志出现证书过期或证书链错误,先检查设备时间、系统证书与服务端证书状态,不要把跳过证书验证当作常规修复。

请求超时则要检查订阅域名能否解析,以及客户端更新订阅时使用直连还是已有代理。若必须借助代理才能下载,可以在保留可用旧配置的前提下,使用客户端提供的代理下载选项。没有可用配置时,不要选择一个依赖“新订阅下载后才存在”的出口,这会形成循环依赖。

导入后再做四项确认

  1. 确认当前配置。核对选中条目、最近更新时间和加载日志,避免“新订阅已下载,旧配置仍在运行”。如果更新报错,先保留旧副本,确认新配置有效后再替换。
  2. 确认策略组引用。在「代理」页面检查组内是否有预期节点,规则模式下查看连接命中的规则与出口。全局模式测试通过,并不能证明分流规则正确。
  3. 确认流量入口。系统代理主要作用于遵循系统代理设置的应用,其他程序未必会使用;TUN 的接管范围又受路由和排除项影响。订阅本身不会自动使所有应用都走代理。
  4. 确认更新设置。完整远程配置的刷新通常由客户端管理;proxy-providers 的 interval 则以秒为单位,例如 3600 表示一小时。两者不是同一个开关,具体间隔还应遵守服务提供方的要求。

最后记住一个顺序:先确认响应格式,再完成导入和激活,随后验证策略组,最后检查系统代理或 TUN。把这几层拆开,遇到问题时就能知道该查地址、配置还是流量入口,而不是每次都从重装客户端开始。

下载客户端