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

演示在客户端中粘贴订阅地址并设置自动更新,对比完整 YAML 配置与 Base64 节点列表的差别,以及格式不兼容时的处理办法。

URL 是获取地址,YAML 与 Base64 是内容格式

Clash 订阅导入失败时,先区分“地址能否访问”和“返回内容能否解析”。URL 是远程资源的地址;YAML 是配置表达方式;Base64 是编码方式。三者不在同一层,不能简单分成三种互斥的订阅类型。一个 HTTPS 订阅地址可以返回完整 YAML,也可以返回经过 Base64 编码的节点列表,还可能返回登录页面。

对使用 mihomo 内核的客户端,优先选择服务提供方标明的 Clash Meta 或 mihomo 订阅入口。名称只表示目标兼容范围,实际仍要看返回字段与本地内核是否支持。客户端能保存一个 URL,并不代表它能理解该地址的响应内容。

收到的内容 通常包含什么 导入位置与限制
订阅 URL 协议、服务器地址、路径及身份令牌 粘贴到远程配置入口,由客户端请求实际内容
完整 YAML 配置 节点或节点提供器、代理组、规则及可选 DNS 设置 可作为配置文件加载,但仍需检查字段与策略引用
节点提供器 YAML 常见为顶层 proxies: 节点列表 通常由 proxy-providers 引用,不等同于完整主配置
Base64 节点列表 编码后的多行节点 URI,例如 ss://、vmess:// 需要客户端明确支持解析,或先转换为目标内核支持的配置

导入前先准备订阅地址与兼容内核

  1. 确认客户端内核。在「关于」或「设置」中的内核信息处查看是否使用 mihomo。图形客户端版本与内核版本不是同一个版本号,反馈兼容问题时应分别记录。
  2. 从服务管理页面复制专用入口。选择标注为 Clash、Clash Meta 或 mihomo 的地址,不要复制套餐页面、登录页面或浏览器当前地址栏。
  3. 保留查询参数。地址中从 ? 开始的 token 或格式参数可能参与鉴权与内容选择,不能只保留域名和路径。
  4. 清理复制附带的字符。移除首尾空格、换行和中文引号。不要随意修改地址内部的百分号编码、大小写或参数顺序。

订阅地址通常没有 .yaml 后缀。服务器可以根据路径、查询参数或请求头决定返回格式,因此不能通过文件名判断兼容性。浏览器能打开管理后台,也不代表客户端请求订阅接口时拥有相同的登录状态。

如果地址已经泄露,应到服务管理页面重置订阅令牌,再替换客户端中的旧地址。仅删除聊天记录或本地配置无法撤销已经被复制的凭据。

在客户端中粘贴 URL 并启用配置

不同客户端的按钮名称会变化,但流程可以拆成“新建远程配置、下载内容、选中配置、选择策略”四步。下面以常见的「配置」页面为操作入口;若界面使用「订阅」或「Profiles」,应进入对应的远程配置列表,而不是节点粘贴框。

首次导入的操作顺序

  1. 打开「配置」,在订阅地址输入框粘贴完整 URL;若没有直接输入框,选择「新建」并将类型设为「远程」。
  2. 将名称设为易区分的名称,例如“日常订阅”,点击「导入」或「保存」。等待下载完成,不要连续重复提交。
  3. 确认配置卡片出现更新时间。点击该卡片或使用「使用此配置」,使其成为当前活动配置;仅下载到列表不一定会自动启用。
  4. 进入「代理」页面,检查是否出现代理组以及节点列表。选择目标节点,先运行一次延迟测试,再尝试实际访问。
  5. 按实际需要开启系统代理。只有需要接管不遵循系统代理的流量时,再单独配置 TUN 模式及其权限。

“导入成功”“配置已启用”和“流量经过代理”是三个检查点。导入成功只说明文件已取得并通过相应处理,不能证明节点可连接。系统代理或 TUN 模式负责流量接入,规则与代理组负责后续分流;开启 TUN 也不会修复错误的订阅格式。

导入后检查哪些字段

  • proxies 或 proxy-providers:是否有节点来源,名称是否正常显示。
  • proxy-groups:规则引用的策略组是否存在,组内是否有可选项。
  • rules:是否包含预期的分流规则,末尾是否有处理剩余流量的策略。
  • 本地监听端口:以客户端当前显示为准,不要直接套用其他教程中的 7890。

完整 YAML 配置与节点列表如何区分

YAML 描述的是结构,不保证内容完整。只有 proxies: 的文件可能是供主配置引用的节点资源,也可能需要客户端补充代理组与规则。它不一定语法错误,但直接作为主配置使用时,可能没有所需的代理选择入口或分流行为。

下面是一份可以说明层级关系的最小配置。它只提供直连策略,没有远程节点,适合对照字段,不应当被当作可用的代理订阅。

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

proxies: []

proxy-groups:
  - name: 出口选择
    type: select
    proxies:
      - DIRECT

rules:
  - MATCH,出口选择

mixed-port: 7890 表示 HTTP 与 SOCKS 共用本地入口;mode: rule 表示按规则分流;最后一条规则把剩余连接交给“出口选择”。这里组名必须与规则中的名称一致。实际客户端可能通过运行时设置覆盖端口和模式,因此还应检查最终生效配置。

如果远程资源用于 proxy-providers,主配置需要定义提供器,并让代理组通过 use 引用它。提供器更新与整份 Profile 更新是不同层级的操作。不要把完整主配置地址随意填入节点提供器字段,也不要假设任意 Base64 列表都能被当前内核直接作为提供器读取。

Base64 解码后仍不是完整配置

常见的 Base64 订阅解码后是多行节点 URI。每行描述一个节点的协议、服务器、端口与认证参数,但通常不包含 rules、DNS 和代理组。解码只是恢复文本,并没有自动生成 Clash 所需的配置结构。

另一个易混点是 vmess:// 节点 URI 自身也可能包含 Base64 编码内容。这与“整份订阅被 Base64 编码”不是同一层。把整段文本反复解码,不能代替按订阅格式解析。更稳妥的处理是重新获取服务方提供的 mihomo 专用入口。

设置自动更新,保留自定义规则

首次导入并验证可用后,再开启自动更新。在配置卡片的「编辑」或「设置」中查找「自动更新」「更新间隔」等选项。若字段单位是分钟,填 360 表示每 6 小时更新;若明确要求秒,同一周期应填 21600。两种单位不能混用。

  1. 先手动执行一次「更新」,确认订阅地址仍有效,更新时间有变化。
  2. 设置合理周期,例如每 6 小时;如果服务方有限流要求,以其要求为准。
  3. 检查是否支持「启动时更新」或失败重试。客户端关闭时通常不会继续执行其内部定时任务,休眠期间也可能推迟。
  4. 更新后检查当前节点选择、代理组与规则。节点更名或移除后,原先选中的项可能无法继续保留。

不要在远程订阅下载得到的 YAML 中长期直接修改规则。下一次更新可能覆盖这些编辑。客户端若提供覆写、合并或脚本功能,应把自定义内容放到对应位置,并确认其在更新后仍参与生成生效配置。各客户端的合并顺序不同,不能仅凭编辑器里存在一段规则就认定它已经生效。

订阅无法导入时,按错误类型处理

提示或现象 优先检查 处理步骤
HTTP 401 或 403 令牌失效、访问权限、服务侧限制 从管理页面重新复制地址;确认账号状态,必要时联系服务方核实拒绝原因
HTTP 429 更新请求过于频繁 停止连续重试,按服务方限制等待,并延长自动更新周期
HTTP 200,但解析失败 响应可能是 HTML 登录页、JSON 错误或节点列表 本地查看响应开头,确认取得的是目标格式,而不是只看状态码
YAML 行号错误 缩进、制表符、冒号或截断内容 对照错误行及其前一行;使用空格缩进,重新下载原始文件作比较
不支持的代理类型或字段 配置目标与本地内核不匹配 确认内核版本,换用匹配入口或升级到支持该功能的客户端与内核
下载超时或 TLS 错误 DNS、网络路径、系统时间与证书信任 先校准系统时间,再检查连接日志与网络;不要通过关闭证书验证长期绕过问题

格式不兼容时的处理顺序

先回到服务页面寻找正确的格式入口,其次检查客户端是否提供明确标注的节点列表导入功能,最后才考虑转换。转换工具只能处理其实现支持的协议与字段;源数据缺失的传输参数、TLS 设置或规则不会凭空补齐。

优先采用服务方提供的转换功能或本地运行的可信工具。把带 token 的 URL 提交给公共转换服务,等同于把读取订阅的权限交给该服务。转换后的结果还应检查代理类型、传输设置、代理组和规则,不能以“能够保存文件”作为兼容性结论。

导入完成后的三项验证

  1. 验证更新链路。手动更新一次,记录成功时间;若失败,保留旧配置并先处理订阅请求错误,避免在仍可用时反复删除重建。
  2. 验证策略链路。选择明确的代理组与节点,打开一个目标网站,在连接日志中核对命中的规则、策略与连接结果。延迟测试有数值不代表所有网站都可访问。
  3. 验证流量入口。确认目标应用是否遵循系统代理;需要时再配置 TUN。检查出口信息时结合日志判断,不能只用一条直连规则命中的请求推断整个配置失效。

完成这三项后,再安排定时更新与个性化规则。把订阅获取、配置解析、节点连通和系统流量接入分开检查,可以减少“导入成功却不能上网”这类问题的定位范围。完整的接入与端口说明可继续查阅使用指南,规则调整则参照自定义规则说明。

Clash最新版下载