导入前先分清:订阅地址、配置文件与节点链接
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。
- 复制对应格式的地址。在服务商后台选择 Clash 或 Clash Meta/mihomo 入口。复制的是订阅地址,不是后台首页、付款页面或文档地址;检查首尾是否混入空格、换行和中文标点。
- 进入远程配置入口。打开客户端的“订阅”或“配置”页面。如果有直接的 URL 输入框,粘贴后选择“导入”;若界面通过“新建”添加,则选择远程类型,填写 URL 后保存。不要选成本地文件类型。
- 等待下载与解析完成。观察是否生成配置卡片,是否显示更新时间,以及通知区域有无 YAML 解析错误。仅出现一张卡片不等于已完成下载,仍要检查其状态。
- 选中并启用新配置。多个配置可以同时保存在列表,但实际生效的是当前选中的配置。导入后检查选中标识,再到代理页面查看是否出现预期的节点与代理组。
- 使用规则模式并选择出口。先将运行模式设为“规则”,在订阅定义的选择组里选一个节点。部分订阅默认选中
DIRECT,此时流量直连不代表节点失效。 - 验证应用流量。在系统代理场景下开启客户端的“系统代理”,再测试遵循系统代理的浏览器。若使用 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 流量或应用都能正常连接。订阅下载成功、节点可用、应用走代理,是三个独立检查项。
格式转换与更新后的收尾检查
只有在服务商无法提供目标格式、客户端又不支持原始格式时,再考虑订阅转换。转换器可能接触完整订阅地址和节点凭据,优先选择可在本地运行、来源明确的工具。不要为了测试一条地址,把凭据提交到多个不熟悉的转换站点。
- 确认目标内核:明确输出是传统 Clash 兼容配置还是 mihomo 配置,检查目标协议是否受支持。转换只能调整表示方式,不能给旧内核补上新协议实现。
- 确认规则来源:转换可能替换代理组和分流规则。核对默认出口、最终
MATCH去向及是否保留原本需要的直连规则。 - 确认后续更新路径:导入一次转换后的本地文件,通常只获得一个静态快照。需要持续更新时,应明确由谁定时获取源订阅、执行转换并重新加载配置。
- 检查更新结果:手动更新后确认成功时间变化、节点数量合理、当前配置仍被选中;然后测试一个应直连的目标和一个应走代理的目标,在连接记录中核对出口。
需要核对运行模式、DNS 或 TUN 的具体参数,可继续查看技术参考;只想按步骤完成首次使用,则从入门教程开始。先把订阅格式与配置选择确认好,再处理网络接管,排查路径会短得多。