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:// |
需要客户端明确支持解析,或先转换为目标内核支持的配置 |
导入前先准备订阅地址与兼容内核
- 确认客户端内核。在「关于」或「设置」中的内核信息处查看是否使用 mihomo。图形客户端版本与内核版本不是同一个版本号,反馈兼容问题时应分别记录。
- 从服务管理页面复制专用入口。选择标注为 Clash、Clash Meta 或 mihomo 的地址,不要复制套餐页面、登录页面或浏览器当前地址栏。
- 保留查询参数。地址中从
?开始的 token 或格式参数可能参与鉴权与内容选择,不能只保留域名和路径。 - 清理复制附带的字符。移除首尾空格、换行和中文引号。不要随意修改地址内部的百分号编码、大小写或参数顺序。
订阅地址通常没有 .yaml 后缀。服务器可以根据路径、查询参数或请求头决定返回格式,因此不能通过文件名判断兼容性。浏览器能打开管理后台,也不代表客户端请求订阅接口时拥有相同的登录状态。
如果地址已经泄露,应到服务管理页面重置订阅令牌,再替换客户端中的旧地址。仅删除聊天记录或本地配置无法撤销已经被复制的凭据。
在客户端中粘贴 URL 并启用配置
不同客户端的按钮名称会变化,但流程可以拆成“新建远程配置、下载内容、选中配置、选择策略”四步。下面以常见的「配置」页面为操作入口;若界面使用「订阅」或「Profiles」,应进入对应的远程配置列表,而不是节点粘贴框。
首次导入的操作顺序
- 打开「配置」,在订阅地址输入框粘贴完整 URL;若没有直接输入框,选择「新建」并将类型设为「远程」。
- 将名称设为易区分的名称,例如“日常订阅”,点击「导入」或「保存」。等待下载完成,不要连续重复提交。
- 确认配置卡片出现更新时间。点击该卡片或使用「使用此配置」,使其成为当前活动配置;仅下载到列表不一定会自动启用。
- 进入「代理」页面,检查是否出现代理组以及节点列表。选择目标节点,先运行一次延迟测试,再尝试实际访问。
- 按实际需要开启系统代理。只有需要接管不遵循系统代理的流量时,再单独配置 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。两种单位不能混用。
- 先手动执行一次「更新」,确认订阅地址仍有效,更新时间有变化。
- 设置合理周期,例如每 6 小时;如果服务方有限流要求,以其要求为准。
- 检查是否支持「启动时更新」或失败重试。客户端关闭时通常不会继续执行其内部定时任务,休眠期间也可能推迟。
- 更新后检查当前节点选择、代理组与规则。节点更名或移除后,原先选中的项可能无法继续保留。
不要在远程订阅下载得到的 YAML 中长期直接修改规则。下一次更新可能覆盖这些编辑。客户端若提供覆写、合并或脚本功能,应把自定义内容放到对应位置,并确认其在更新后仍参与生成生效配置。各客户端的合并顺序不同,不能仅凭编辑器里存在一段规则就认定它已经生效。
订阅无法导入时,按错误类型处理
| 提示或现象 | 优先检查 | 处理步骤 |
|---|---|---|
| HTTP 401 或 403 | 令牌失效、访问权限、服务侧限制 | 从管理页面重新复制地址;确认账号状态,必要时联系服务方核实拒绝原因 |
| HTTP 429 | 更新请求过于频繁 | 停止连续重试,按服务方限制等待,并延长自动更新周期 |
| HTTP 200,但解析失败 | 响应可能是 HTML 登录页、JSON 错误或节点列表 | 本地查看响应开头,确认取得的是目标格式,而不是只看状态码 |
| YAML 行号错误 | 缩进、制表符、冒号或截断内容 | 对照错误行及其前一行;使用空格缩进,重新下载原始文件作比较 |
| 不支持的代理类型或字段 | 配置目标与本地内核不匹配 | 确认内核版本,换用匹配入口或升级到支持该功能的客户端与内核 |
| 下载超时或 TLS 错误 | DNS、网络路径、系统时间与证书信任 | 先校准系统时间,再检查连接日志与网络;不要通过关闭证书验证长期绕过问题 |
格式不兼容时的处理顺序
先回到服务页面寻找正确的格式入口,其次检查客户端是否提供明确标注的节点列表导入功能,最后才考虑转换。转换工具只能处理其实现支持的协议与字段;源数据缺失的传输参数、TLS 设置或规则不会凭空补齐。
优先采用服务方提供的转换功能或本地运行的可信工具。把带 token 的 URL 提交给公共转换服务,等同于把读取订阅的权限交给该服务。转换后的结果还应检查代理类型、传输设置、代理组和规则,不能以“能够保存文件”作为兼容性结论。
导入完成后的三项验证
- 验证更新链路。手动更新一次,记录成功时间;若失败,保留旧配置并先处理订阅请求错误,避免在仍可用时反复删除重建。
- 验证策略链路。选择明确的代理组与节点,打开一个目标网站,在连接日志中核对命中的规则、策略与连接结果。延迟测试有数值不代表所有网站都可访问。
- 验证流量入口。确认目标应用是否遵循系统代理;需要时再配置 TUN。检查出口信息时结合日志判断,不能只用一条直连规则命中的请求推断整个配置失效。
完成这三项后,再安排定时更新与个性化规则。把订阅获取、配置解析、节点连通和系统流量接入分开检查,可以减少“导入成功却不能上网”这类问题的定位范围。完整的接入与端口说明可继续查阅使用指南,规则调整则参照自定义规则说明。