Clash 订阅链接导入教程:URL 导入、本地 YAML 文件与常见订阅格式区别

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

Clash 订阅导入是否成功，取决于地址返回的内容是否符合当前内核的配置要求，而不是链接是否以 .yaml 结尾。一个带有访问令牌的 HTTPS 地址可以返回完整配置；一个名为 config.yaml 的下载链接，也可能实际返回登录页面或错误提示。

桌面客户端负责保存订阅、下载更新和切换配置；Clash 或 mihomo 内核负责解析配置、建立连接和执行规则。界面提示“下载成功”，只说明客户端取得了响应，不一定意味着内核已接受其中的全部字段。

订阅 URL：用于获取内容的远程地址。内容可能是完整 Clash YAML，也可能是其他格式的节点集合。
完整配置：通常含有 proxies 或 proxy-providers，并配套 proxy-groups、rules 等设置。
节点链接：例如以 ss://、vmess:// 或 trojan:// 开头的单条连接信息，通常不包含分流规则。

方式一：通过 URL 导入远程订阅

长期使用优先选择远程订阅。客户端保存地址后，可以重新获取节点和规则；本地文件则只是某一时刻的副本。服务方如果提供“Clash”“Clash Meta”或“mihomo”入口，应先核对当前客户端实际使用的内核，再复制对应地址。

在订阅页完成下载与激活

以下以 Clash Verge Rev 的常见界面命名说明。不同版本可能将“订阅”显示为“配置”，应按入口功能辨认，不要在节点选择页寻找订阅导入框。

打开客户端，进入左侧「订阅」页面，在顶部的订阅链接输入框粘贴完整 HTTPS 地址。
检查地址首尾是否带有空格、换行或聊天软件附加的标点，再点击「导入」。无需把链接改成以 .yaml 结尾。
等待订阅卡片生成。若出现错误，先读取下载或解析提示，不要连续重复添加同一地址。
点击对应订阅卡片，将其设为当前配置。部分客户端把此操作称为「使用」或「激活」。
进入「代理」页面，确认策略组可见，再选择实际节点。导入完成不代表系统代理已开启。

一些服务页面提供“一键导入”，实际通过自定义 URL 协议唤起客户端。这要求系统已注册对应协议处理程序。点击后没有反应时，改用手动复制订阅地址的方式，更容易分清是系统唤起失败，还是订阅本身无法下载。

更新选项需要逐项确认

在订阅卡片的菜单中打开「编辑」或订阅设置，检查更新间隔及下载时使用的代理选项。自动更新是客户端功能，不由顶层 rules 决定。若界面单位为分钟，360 表示 6 小时；若界面单位为秒，则应填写 21600。这是设置示例，不是所有客户端的默认值。

首次导入时尚未建立可用代理，强制让订阅下载走代理可能形成依赖循环。只有确认直连无法获取、且已有可用出口时，再尝试更新代理选项。顶层远程订阅的更新周期，也不能与 proxy-providers 内的 interval 混为一谈：后者是内核拉取提供器的间隔，单位为秒。

方式二：导入本地 YAML 配置文件

本地导入适合服务方直接提供配置文件、需要离线备份，或正在排查远程下载失败的情况。通过文件选择器导入后，客户端通常管理自己的配置副本；随后修改原始下载文件，不一定会同步到正在运行的配置。

把配置保存到可识别的位置，例如 Windows 的「下载」文件夹，并确认扩展名是 .yaml 或 .yml，而不是隐藏扩展名后的 .yaml.txt。
进入客户端「订阅」或「配置」页面，选择「导入本地文件」；支持拖放的版本也可将文件拖入该页面。
选择文件，保存后激活该配置。出现解析错误时，用文本编辑器查看报错行及其前一行。
打开策略组和日志，确认加载结果。若修改的是客户端外部文件，需要重新导入或使用客户端明确提供的重载功能。

YAML 格式正确，不等于配置适合代理连接

下面是一份用于理解结构的最小示例。它只包含直连出口，不提供代理节点，也不能替代服务方的订阅。mixed-port: 7890 是这里明确指定的 HTTP 与 SOCKS 共用端口，并非所有客户端的出厂值。

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

proxies: []

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

rules:
  - MATCH,手动选择

YAML 缩进使用空格，不使用 Tab。列表项以 - 开头，键与值之间需要正确的冒号和空格。即使普通 YAML 解析器认为语法有效，内核仍可能因为不存在的策略名称、不支持的协议字段或缺失的认证参数而拒绝加载。

方式三：从剪贴板导入配置或节点内容

剪贴板导入适合已经拿到完整配置文本，或客户端明确支持识别单条节点链接的情况。不同客户端的能力差异较大：“粘贴订阅地址”与“从剪贴板解析节点”是两种功能，不能只因为都使用复制粘贴就视为相同入口。

完整 YAML 文本：若客户端支持「新建本地配置」或配置编辑器，可以新建本地配置后粘贴、保存，再激活。
单条节点链接：只有在菜单明确提供「从剪贴板导入」且支持该协议时才使用。导入后还应检查它被加入哪个配置、哪个策略组。
多行节点列表：需要客户端的批量解析能力。若不支持，应先转换成兼容的配置，不要把节点列表直接粘进订阅 URL 输入框。

如果当前版本没有文本导入入口，先把完整 YAML 保存为 UTF-8 编码的本地文件，再按本地文件流程导入。不要将 YAML 转成一整行，也不要手动删除缩进。单条节点能被识别，也不意味着客户端会自动生成符合预期的 DNS、规则和策略组。

订阅格式区别：Clash YAML、Base64 与提供器文件

“订阅”描述的是获取和更新方式，不是唯一的文件格式。判断兼容性时，应同时看内容结构、协议类型与内核支持范围。扩展名和网页上的按钮名称只能作为线索。

内容类型	常见特征	导入前的判断
完整 Clash YAML	包含节点或提供器，以及策略组、规则等配置项	通常可作为配置导入；仍需核对内核支持的字段和协议
Base64 节点列表	外层是一段编码文本，解码后常见多行节点 URI	通常不能直接作为完整 Clash 配置加载，需要客户端识别或转换
单条节点 URI	以 ss、vmess、trojan 等协议名称开头	依赖客户端的协议导入功能，不含完整规则体系
代理提供器 YAML	常见顶层为 `proxies:`，内容主要是节点列表	通常由 `proxy-providers` 引用，不应直接当作完整配置
其他客户端配置	可能是 JSON 或另一套字段结构	不能通过改扩展名获得兼容性，需检查转换工具是否支持源格式

Base64 是编码，不是协议兼容层

将 Base64 解码，只能还原被编码的文本。它不会自动把节点 URI 变成 Clash 的 YAML 字段，也不会补齐规则、DNS 与策略组。部分节点 URI 的某一部分也使用 Base64；不能仅凭看到一长串字符就认定整个响应是 Base64 订阅。

Clash 与 mihomo 的兼容范围并不完全相同

mihomo 延续并扩展了 Clash Meta 的能力。面向 mihomo 生成的配置可能包含旧版 Clash 不支持的协议或参数。因此，服务方提供多个目标格式时，应按客户端当前内核选择。某个节点缺少内核支持时，仅修改配置中的协议名称并不能使其可用。

格式不兼容时：先选原生输出，再考虑转换

最直接的处理顺序是：先检查服务方是否提供目标格式，再检查客户端内核，最后才进行转换。转换工具处理的是配置表达方式，不能改变远端服务器提供的协议能力，也不能恢复原始数据中缺失的认证信息。

优先原生订阅：在服务方页面选择与当前内核对应的 Clash 或 mihomo 输出，重新复制完整地址。
确认源内容：区分节点 URI、Base64 列表、完整 YAML 和提供器文件。不要将网页 HTML 当作订阅交给转换工具。
选择可信转换环境：优先使用服务方提供的转换入口，或在自己控制的本地环境运行转换工具。远程转换服务可能接触订阅令牌及节点凭据。
明确目标与模板：确认输出是完整配置还是节点提供器，并检查生成的策略组名称、规则出口和 DNS 设置。
导入后逐项验证：先确认配置能加载，再确认节点与策略组完整，最后测试实际连接。不要只看转换页面是否提示成功。

转换后的配置可能丢失源格式独有字段，或使用模板中的规则替换原规则。尤其要检查 UDP、TLS、传输层及证书相关参数是否被保留。遇到证书报错时，应检查设备时间、服务器名称和服务方说明，不要把关闭证书验证作为通用转换步骤。

导入报错与生效检查：按下载、解析、路由顺序排查

下载失败与内容错误分开处理

HTTP 401 或 403：检查订阅令牌是否失效、复制是否完整，以及服务方是否设置访问限制；不要只反复调整本地代理端口。
请求超时：检查网络连通性、订阅域名解析与更新代理选项。浏览器能打开服务方首页，不代表订阅接口一定可达。
响应开头为 HTML：可能取到了登录页、验证页面或错误页。HTTP 200 也可能返回这些内容，需检查实际响应而不是只看状态码。
提示找不到代理或策略：检查 proxy-groups 中引用的名称，以及规则末尾的出口名称是否真实存在，大小写和空格也应一致。
不支持的代理类型或字段：核对实际内核与订阅目标格式。更换界面主题、重命名文件都不会修复内核兼容问题。

配置已激活，还要检查应用是否经过客户端

在客户端确认当前配置名称正确，并确认使用规则模式，而不是误切到直连模式。
打开需要使用的策略组，选择可用节点。延迟测试成功只代表测试请求得到响应，不保证所有网站和协议都可用。
对于遵循系统代理设置的桌面应用，开启客户端的「系统代理」。如果手动设置代理，应核对实际监听地址与端口；配置为 mixed-port: 7890 时，本机可使用 127.0.0.1:7890。
在浏览器发起一次新请求，同时查看「连接」或「日志」，核对目标域名、匹配规则与最终出口。必要时关闭旧连接后重试。

不遵循系统代理的应用可能需要 TUN 模式接管流量，但这属于导入之后的路由配置。TUN 能否工作还受服务权限、路由和 DNS 设置影响；它不会修复错误的订阅格式，也不会给空配置增加节点。