入门指南 预计阅读 10 分钟

Clash 订阅链接导入步骤详解:YAML 配置与 Base64 订阅格式区别

从复制订阅地址到在客户端完成更新,逐步说明导入流程,并对比 Clash YAML、Base64 节点列表等常见订阅格式的兼容差异与更新间隔设置。

导入前先分清:订阅地址、配置文件与节点链接

Clash 订阅导入失败,常见原因不是网络断了,而是把不同类型的内容放进了同一个入口。订阅地址是用于获取内容的 URL;YAML 是配置内容的组织格式;Base64 则是一种编码方式。这三者不在同一层,不能用“链接看起来差不多”判断兼容性。

  • 远程订阅地址:通常以 https:// 开头,客户端访问后获得配置或节点列表。地址中可能带有账户令牌,应按凭据保管。
  • 本地配置文件:常见扩展名为 .yaml 或 .yml,通过“导入文件”或本地配置入口加载。只导入本地副本,一般不会自动获取原服务商的后续更新。
  • 单个节点分享链接:例如以 ss://、vmess:// 或 trojan:// 开头的内容。部分客户端提供单独的解析功能,但这不代表 Clash 内核能把它直接当作完整 YAML 配置读取。

开始操作前,记录客户端名称及“关于”页面中的内核名称。Clash、Clash Meta(现称 mihomo)与其他代理内核支持的协议和字段并不完全一致。服务商提供“Clash”“Clash Meta”“通用订阅”等多个按钮时,应先选择与当前内核对应的格式,再复制地址。

YAML 配置与 Base64 订阅格式的具体区别

完整 Clash YAML 配置通常会描述节点、代理组和规则,分别对应 proxies、proxy-groups、rules 等字段;也可能通过 proxy-providers 引用外部节点资源。Base64 节点订阅常见做法则是把多行分享链接整体编码,它通常不包含完整的 Clash 分流规则和代理组结构。

内容类型识别线索适合的入口
完整 Clash YAML存在节点或 provider 定义,并配置代理组、规则等远程配置或本地配置导入
Base64 节点列表常为长串字符,解码后出现多行协议分享链接明确支持该格式的客户端解析或可信转换流程
节点 provider YAML通常只有顶层 proxies: 和节点条目配置内的 proxy-providers
登录页或错误页出现 HTML 标签、登录提示或 JSON 错误消息不能作为代理配置导入

完整配置与 provider 文件不能混用

只有 proxies: 的文件可以是合法的节点资源,却不一定是可直接使用的完整配置。把它当完整配置加载后,即使解析通过,也可能没有预期的代理组和规则。反过来,把完整配置交给仅接受节点资源的入口,也可能触发格式错误。应看入口要求,不能只看文件扩展名。

下面是用于辨认结构的最小本地配置示意,不包含代理节点,所有连接都直连。它展示 YAML 的层级关系,不是可替代服务商订阅的联网方案。

mixed-port: 7890
mode: rule
log-level: info

proxy-groups:
  - name: 手动选择
    type: select
    proxies:
      - DIRECT

rules:
  - MATCH,手动选择

Base64 解码不等于转换成 Clash 配置

Base64 解码只还原原始文本,不会自动生成代理组、DNS 设置或路由规则。真正的格式转换还需要解析节点字段,并生成目标内核接受的配置。即使转换成功,目标内核若不支持某种协议或参数,节点仍然不能使用。优先向服务商索取原生 Clash 或 mihomo 格式,可以减少中间转换带来的字段丢失。

Clash 订阅链接导入:从复制地址到启用配置

各客户端按钮名称会随版本变化。以下按“订阅”或“配置”页面中的远程导入流程说明;遇到只接收文件的入口,应返回上一级寻找 URL 输入框,不要把链接保存成文本文件后冒充 YAML。

  1. 复制对应格式的地址。在服务商后台选择 Clash 或 Clash Meta/mihomo 入口。复制的是订阅地址,不是后台首页、付款页面或文档地址;检查首尾是否混入空格、换行和中文标点。
  2. 进入远程配置入口。打开客户端的“订阅”或“配置”页面。如果有直接的 URL 输入框,粘贴后选择“导入”;若界面通过“新建”添加,则选择远程类型,填写 URL 后保存。不要选成本地文件类型。
  3. 等待下载与解析完成。观察是否生成配置卡片,是否显示更新时间,以及通知区域有无 YAML 解析错误。仅出现一张卡片不等于已完成下载,仍要检查其状态。
  4. 选中并启用新配置。多个配置可以同时保存在列表,但实际生效的是当前选中的配置。导入后检查选中标识,再到代理页面查看是否出现预期的节点与代理组。
  5. 使用规则模式并选择出口。先将运行模式设为“规则”,在订阅定义的选择组里选一个节点。部分订阅默认选中 DIRECT,此时流量直连不代表节点失效。
  6. 验证应用流量。在系统代理场景下开启客户端的“系统代理”,再测试遵循系统代理的浏览器。若使用 TUN 接管流量,应单独确认 TUN 权限和路由状态;订阅导入本身不会保证 TUN 已启用。

本地监听端口与订阅地址是两回事。示例中的 7890 是混合代理监听端口,不是订阅服务器端口。如果日志出现 address already in use,应检查本机是否有另一个代理进程占用了同一端口,而不是反复重置订阅令牌。

订阅更新间隔:区分客户端更新与 provider 更新

远程配置更新通常由客户端外壳负责:定时重新下载整个配置,然后按客户端逻辑重新加载。配置内的 proxy-providers 则由支持该功能的内核更新节点资源。这是两套计时机制,不能把某个界面里的“更新间隔”直接等同于 YAML 中的 interval。

客户端远程配置更新

  • 初次导入后:先手动更新一次,确认地址可用、解析正常,再启用自动更新。
  • 日常使用:可从每 24 小时一次开始,具体遵守服务商建议。节点调整频繁时可考虑每 6 小时一次,但不应无故设置为每分钟拉取。
  • 注意输入单位:24 小时等于 1440 分钟,也等于 86400 秒。界面若要求分钟,填入 86400 就不是一天。
  • 留意运行条件:部分客户端仅在应用运行时执行定时任务;设备休眠、断网或后台限制都可能推迟更新,应以最近一次成功更新时间为准。

mihomo 节点 provider 更新

mihomo HTTP 类型的节点 provider 使用 interval 设置资源更新周期,单位是秒。例如一天对应 interval: 86400。它更新的是该 provider 指向的节点资源,不会替你刷新外层配置中的全部规则。health-check 下的间隔则用于节点可用性检测,同样不等于订阅更新间隔。

如果订阅里根本没有 proxy-providers,不要为了“开启自动更新”随意插入这一块。直接使用客户端远程配置的定时更新功能即可。使用多层引用时,则需要分别检查外层配置和各 provider 的最后更新时间。

订阅导入失败排查:HTTP、YAML 与内核兼容

一次只处理一个层级。先看请求是否拿到正确内容,再看内容能否被当前内核解析,最后检查节点是否可连接。下面的错误信息比“导入不了”更能缩小范围。

现象或错误优先检查下一步
HTTP 401 或 403令牌失效、权限限制、账户状态或访问策略从后台重新复制地址,检查服务商通知
HTTP 404地址截断、路径变化或订阅入口已撤销重新获取完整 URL,不手工猜测接口路径
HTTP 429请求过于频繁,触发限流停止连续点击,按服务端提示等待后重试
超时或 DNS 解析失败订阅域名解析及当前网络到服务器的连通性检查网络、系统时间及客户端日志
YAML 解析错误返回 HTML、Base64 文本或缩进损坏核对订阅格式和报错行附近内容
不支持的代理类型内核不支持节点协议,或配置格式选错确认内核能力,重新选择兼容订阅入口

浏览器能打开,不代表客户端拿到相同内容

浏览器可能携带登录 Cookie,而客户端请求通常没有;部分服务端也会按 User-Agent 返回不同内容。HTTP 200 只说明请求成功得到响应,不代表响应就是 Clash 配置。若正文开头是 <!DOCTYPE html>,应先处理登录跳转、访问验证或地址错误,不能靠修改 YAML 缩进解决。

YAML 错误先看原文,不先改规则

YAML 的层级使用空格缩进,不能用制表符替代。复制到聊天软件后,英文冒号可能变成中文冒号,缩进也可能丢失。若远程订阅原文就有语法错误,应向提供方反馈脱敏后的错误行;不要通过删除整段配置来换取“能启动”,否则容易丢掉规则或 DNS 设置。

订阅正常但网页打不开

先查看客户端连接记录。如果没有目标请求,检查系统代理或 TUN 接管;如果有请求,查看命中的规则、代理组和实际出口。节点延迟测试成功只说明特定探测请求可用,不能证明所有域名、UDP 流量或应用都能正常连接。订阅下载成功、节点可用、应用走代理,是三个独立检查项。

格式转换与更新后的收尾检查

只有在服务商无法提供目标格式、客户端又不支持原始格式时,再考虑订阅转换。转换器可能接触完整订阅地址和节点凭据,优先选择可在本地运行、来源明确的工具。不要为了测试一条地址,把凭据提交到多个不熟悉的转换站点。

  1. 确认目标内核:明确输出是传统 Clash 兼容配置还是 mihomo 配置,检查目标协议是否受支持。转换只能调整表示方式,不能给旧内核补上新协议实现。
  2. 确认规则来源:转换可能替换代理组和分流规则。核对默认出口、最终 MATCH 去向及是否保留原本需要的直连规则。
  3. 确认后续更新路径:导入一次转换后的本地文件,通常只获得一个静态快照。需要持续更新时,应明确由谁定时获取源订阅、执行转换并重新加载配置。
  4. 检查更新结果:手动更新后确认成功时间变化、节点数量合理、当前配置仍被选中;然后测试一个应直连的目标和一个应走代理的目标,在连接记录中核对出口。

需要核对运行模式、DNS 或 TUN 的具体参数,可继续查看技术参考;只想按步骤完成首次使用,则从入门教程开始。先把订阅格式与配置选择确认好,再处理网络接管,排查路径会短得多。

下载Clash按平台选择客户端