导入前:先确认链接内容与客户端内核

打开客户端的「订阅」或「配置」页,再决定使用 URL、剪贴板还是本地文件。三种方式只是把配置送进客户端的入口;能否正常使用,取决于返回内容的格式、内核支持的协议,以及配置是否已经启用。拿到服务商提供的链接后,优先选择标注为「Clash」「Clash Meta」或「mihomo」的订阅。

  • 远程 URL:适合长期使用。客户端保存来源地址,后续可以手动更新或按间隔更新。
  • 剪贴板:适合从浏览器复制后快速导入。先区分复制的是链接、整份 YAML,还是单个节点 URI。
  • 本地文件:适合接收配置文件、离线检查或保留快照。普通本地配置通常不会跟随原订阅地址更新。

本文以采用 mihomo 内核的桌面客户端为操作背景,Clash Verge Rev 的入口通常位于「订阅」页。其他客户端可能将同类入口命名为「配置」「Profiles」或「远程配置」,按钮名称随版本变化。macOS、Windows 与 Android 的导入原理相同,但系统代理与 VPN 授权属于后续步骤,不需要在粘贴链接之前同时打开。

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

粘贴地址、下载配置、选中启用

  1. 在服务商的订阅页面选择适用于当前内核的格式,再复制订阅地址。应复制链接本身,而不是账户后台网页的地址。
  2. 打开客户端「订阅」页。如果页面上有「订阅链接」输入框,直接粘贴;如果使用新建窗口,则进入「新建」,选择「远程」类型后填写 URL。
  3. 检查开头和结尾是否多出空格、换行或中文标点。保留原始查询参数,不要随意删除问号后的内容。
  4. 点击「导入」或保存远程配置,等待配置卡片出现。成功后应能看到配置名称或更新时间,而不是只有一个空白输入框。
  5. 选中刚导入的配置,再到「代理」页查看策略组。导入成功和启用成功是两件事,列表里存在配置卡片,并不代表内核已经切换到它。

首次下载通常需要当前网络能访问订阅服务器。如果客户端下载设置提供「直连」「系统代理」或其他请求方式,应根据实际网络选择。现有代理已经失效时,强制通过该代理下载订阅可能形成循环:更新需要代理,而代理又等待更新。可先尝试直连更新,或换用能访问订阅服务器的网络。

导入后先看日志,再测试网页

查看日志是否出现配置解析错误,再检查策略组是否有可选节点。运行模式先选择「规则」,在需要接管浏览器流量时开启系统代理。普通 HTTP 代理入口不能覆盖所有应用的 UDP 流量;是否开启 TUN,应在基本连接验证完成后单独决定。

如果配置指定了 mixed-port: 7890,HTTP 与 SOCKS 客户端可以连接同一个本地端口,但图形客户端可能使用自己的端口设置覆盖它。以设置页实际显示的监听地址与端口为准,不能仅凭网上示例就认定本机一定是 127.0.0.1:7890。

方式二:从剪贴板导入链接或配置文本

先查看剪贴板里是什么,再使用对应入口。macOS 上复制与粘贴分别是 ⌘C、⌘V,Windows 上为 Ctrl+C、Ctrl+V。快捷键只负责传递文本,不会把节点链接自动转换成完整的 Clash 配置。

复制的内容建议入口检查重点
https:// 开头的订阅地址远程订阅 URL 输入框是否保留完整令牌与参数
含 proxies: 等字段的 YAML 文本本地配置编辑器或文本导入缩进是否完整,是否混入说明文字
ss://、vmess:// 等节点 URI客户端明确提供的节点导入功能是否支持协议及节点转换
一长段 Base64 文本先确认来源与编码内容不能直接假定为完整 YAML
  1. 如果复制的是 URL,回到「订阅」页粘贴并导入,之后仍按远程订阅管理。
  2. 如果复制的是完整 YAML,进入本地配置的新建或编辑入口。客户端没有文本入口时,用纯文本编辑器保存为 .yaml 文件,再按本地文件方式导入。
  3. 如果只有单个节点 URI,先确认客户端是否支持该协议的节点导入。完整配置通常还需要策略组与规则,节点参数不能替代这些部分。

从聊天工具复制代码时,不要把代码围栏、行号和“点击复制”等界面文字一并粘入。YAML 使用空格缩进,Tab 制表符容易导致解析失败。文本编辑器中的智能引号、富文本格式也可能改变原始内容,保存时选择 UTF-8 纯文本。

方式三:导入本地 YAML 文件

在「订阅」或「配置」页寻找「导入文件」,选择磁盘上的 .yaml 或 .yml 文件;部分客户端也支持拖入文件。导入后选中该配置,再检查日志与策略组。文件选择器支持哪些扩展名,以客户端界面提示为准。

先识别文件内容,再判断能否使用

文件名叫 config.yaml 只能说明命名意图,内容仍可能是下载失败后的 HTML 页面。用文本编辑器打开,如果开头是 <!doctype html>、登录提示或 JSON 错误消息,就应回到下载来源处理认证与访问问题,而不是继续修改 YAML 缩进。

下面是一份用于辨认配置结构的最小直连示例。它没有代理节点,只适合观察字段和解析行为;拿它替换订阅配置不会获得代理连接。

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

rules:
  - MATCH,DIRECT
  • mixed-port 是本地 HTTP 与 SOCKS 共用监听端口;端口被占用时需要调整配置或客户端设置。
  • allow-lan: false 限制局域网访问。确有共享需求时再检查监听地址、防火墙与认证设置。
  • MATCH,DIRECT 将剩余流量直连,不代表已选择某个代理节点。

本地文件是快照,远程资源可能仍需联网

普通本地配置没有订阅 URL 的自动更新关系。服务商修改节点密码或服务器地址后,需要重新导入,或者手动维护本地配置。不过,文件内部如果声明了远程 proxy-providers 或 rule-providers,这些资源仍可能单独联网更新;“从本地文件导入”不等于运行过程完全离线。

需要长期保留的分流修改,优先放在客户端提供的覆写、合并或脚本机制中。直接编辑远程订阅下载后的正文,下一次更新可能被覆盖。应用覆写后还应检查最终生效配置,确认策略组名称与规则引用仍然对应。

格式对比:Clash YAML、Base64 与节点 URI

订阅 URL 是获取内容的地址,YAML 和 Base64 描述的是内容结构或编码方式。即使两个地址都以 HTTPS 开头,返回的也可能完全不同。排查“订阅能打开但导入失败”时,先看返回正文,而不是只看文件后缀。

格式常见内容导入注意
完整 Clash YAML节点、策略组、规则等配置字段内核必须支持其中的协议与字段
节点提供者 YAML以 proxies: 为主的节点列表通常通过 proxy-providers 接入主配置
Base64 订阅常见为编码后的多行节点 URI依赖客户端转换能力,不能只改扩展名
单个节点 URI一个服务器的协议与连接参数通常还需生成策略组与分流规则

Base64 是编码,不是加密,也不是一种统一的代理配置规范。解码后可能得到多行节点链接,也可能得到其他文本;能否使用取决于具体内容与客户端支持。将文件名从 .txt 改成 .yaml 不会完成格式转换。

Clash Meta(现称 mihomo)支持的协议和字段范围,与历史 Clash 内核并不完全相同。遇到不支持的节点类型,应先确认当前运行的内核,再向订阅来源选择相应格式。若服务商同时提供 Clash 与 mihomo 入口,使用 mihomo 内核时优先选择其明确标注的兼容入口。

自动更新间隔:客户端订阅与 provider 分别设置

在远程订阅卡片的菜单中打开「编辑」或更新设置,查找「更新间隔」。先看输入框旁的单位:如果单位是分钟,填 360 表示每 6 小时;如果单位是秒,则应填 21600。这两个值是同一时长,不能不看单位就照抄。

  1. 先执行一次手动更新,确认当前 URL 可访问且解析正常。
  2. 按服务商建议设置周期。没有特别要求时,可先采用 6 小时,再根据节点变更频率调整。
  3. 观察卡片上的更新时间与更新日志,确认任务确实执行,而不是只保存了间隔数值。
  4. 电脑休眠或客户端退出期间,图形客户端的定时任务通常不会持续运行。唤醒后是否立即补更取决于实现,必要时手动更新一次。

mihomo 配置中的 HTTP 类型 proxy-providers、rule-providers 使用各自的 interval 字段,单位为秒。例如 interval: 21600 表示 6 小时。它们更新的是节点集合或规则集合,不等于刷新客户端保存的整份远程订阅;节点健康检查的 health-check.interval 又是另一项周期。

不要假定所有客户端都用 0 表示关闭自动更新。关闭方式、允许的最小间隔和重试策略以界面说明为准。订阅流量与到期时间通常来自服务端返回的信息,并非每个来源都会提供;缺少这类显示不直接说明配置无效。

常见错误:按请求、解析、启用顺序排查

下载失败:先看 HTTP 状态与网络

  • 401 或 403:检查令牌是否失效、订阅是否到期,以及服务端是否限制访问。403 也可能来自访问策略,不能只凭状态码认定原因。
  • 404:核对路径是否复制完整,服务商是否更换了订阅入口。
  • 超时或证书错误:检查网络、系统时间与请求路径。不要通过长期关闭证书验证来掩盖问题。

解析失败:看错误行附近的原始内容

出现 YAML 错误时,检查缩进、冒号后的空格和是否混入 HTML。出现未知代理类型或字段错误时,核对内核兼容性。服务端可能根据请求的 User-Agent 返回不同格式,浏览器打开正常不一定等于客户端拿到相同内容,应结合客户端下载日志判断。

配置有效但连接失败:检查生效配置与接管方式

确认选中了新配置、策略组指向实际可用节点,随后检查系统代理或 TUN 是否按预期接管流量。导入订阅、解析配置、连接节点与 DNS 解析是不同环节;一个节点的延迟测试结果不能代表所有网站都可访问。使用连接面板查看目标域名、匹配规则和出站策略,比反复重新导入更容易缩小范围。

建议保留一份已知可用的配置,更新前后分别记录配置名称、更新时间和错误文字。需要求助时提供客户端名称、内核类型、导入入口与已脱敏日志即可,完整订阅地址和节点密码不应随问题描述一起公开。