先分清订阅地址、配置文件与节点列表
拿到订阅后,先确认提供方是否有“Clash”或“Clash Meta / mihomo”专用入口,再打开客户端的配置页面。不要把浏览器后台地址、单个节点链接和订阅地址混在一起。三者看起来都是文本,但客户端处理它们的方式不同。
URL 是获取内容的地址,YAML 是配置的组织格式,Base64 是文本编码方式。三者不是同一层级的选项:一个 HTTPS 订阅地址,返回的内容既可能是 YAML,也可能是 Base64 编码的节点列表。导入失败时,应检查实际返回内容,而不是只看链接是否以 https:// 开头。
| 拿到的内容 | 识别方式 | 处理入口 |
|---|---|---|
| 远程订阅 URL | 提供方标明适配 Clash 或 mihomo 的 HTTPS 地址 | 配置 → 新建远程配置 → 粘贴 URL |
| 完整 YAML 配置 | 含策略组、规则,以及节点或节点提供器 | 配置 → 导入本地文件 |
| Base64 节点列表 | 解码后通常是多行协议链接 | 使用支持该格式的导入器,或先转换为配置 |
| 单个节点链接 | 以 ss://、vmess://、trojan:// 等协议前缀开头 | 使用客户端明确提供的节点导入功能 |
URL 导入:保存远程配置,再选为当前配置
复制正确的客户端订阅入口
- 登录订阅提供方的管理页面,找到“订阅”或“导出配置”,选择 Clash 或 mihomo 对应格式。若仅提供通用订阅,先确认客户端是否支持转换。
- 使用页面的复制按钮,取得完整 URL。避免从聊天软件复制时混入句号、换行、引号,尤其不要漏掉
?后面的访问参数。 - 打开客户端配置列表,选择“新建”“添加”或加号,切换到远程 URL 类型。给配置起一个可辨认的名称,例如“日常订阅”。
- 粘贴地址并保存,等待首次获取完成。若有错误详情,先记录状态码或解析错误,不要连续重复添加同一个地址。
- 在配置列表中选中刚添加的项目,确认它成为当前配置;进入代理页面,检查是否出现策略组,再选择可用节点。
“下载完成”只代表客户端拿到了配置,不等于系统流量已经进入代理。完成导入后,还要按实际用途开启系统代理,或在需要接管更多应用流量时设置 TUN。首次验证建议先使用一种接管方式,确认链路正常后再增加功能,避免把导入问题与路由问题混在一起。
设置更新间隔,区分两种刷新
如果客户端提供自动更新,可先设为每 24 小时更新一次;有些界面用小时,有些用分钟,此时应填 1440 分钟。这只是起步建议,最终以提供方的请求频率限制为准。短时间内反复刷新可能触发限流。
还要区分“更新整个远程配置”和“更新配置里的 proxy-providers”。前者由客户端配置管理功能负责,后者由内核按提供器的 interval 设置获取节点。提供器中的 interval: 86400 表示 86400 秒,并不会自动让客户端每隔一天重新下载整个主配置。
本地 YAML 导入:先确认它是不是完整配置
已有 .yaml 或 .yml 文件时,在配置页面选择文件导入,再从文件选择器打开它。导入前用纯文本编辑器检查内容:如果开头是 <!DOCTYPE html>、登录页面或错误提示,说明保存到的是网页,而不是配置。把扩展名改成 YAML 不会改变文件内容。
检查配置的三个组成部分
- 节点来源:
proxies定义内联节点,或通过proxy-providers引入节点集合。节点提供器文件通常只有节点列表,不能直接等同于完整主配置。 - 选择策略:
proxy-groups组织手动选择、自动测速等策略。规则引用的策略名称必须能在配置中找到。 - 路由规则:
rules决定连接走向;规则模式按顺序匹配,先匹配的规则优先。规则指向不存在的组名时,配置可能无法加载。
下面是一份仅用于理解结构的最小示例。它不包含远程节点,所有连接最终直连,不能用来验证远程代理是否可用。7890 是示例混合端口,并不是每个客户端的固定默认值;实际使用以客户端显示的监听端口为准。
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
proxies: []
proxy-groups:
- name: 手动选择
type: select
proxies:
- DIRECT
rules:
- MATCH,手动选择
YAML 对缩进敏感。使用空格,不使用 Tab;同一层级保持一致缩进。不要在文本编辑器里批量替换所有冒号,也不要让文档软件把普通引号改成弯引号。带特殊字符的名称或密码应按 YAML 语法正确加引号。
保留原文件与回退配置
部分客户端会复制文件到自己的配置目录,另一些支持引用外部路径。导入后修改原文件,不一定会更新当前配置,需要重新导入或触发重载。建议保留一份能正常工作的配置,修改 DNS、规则或节点前先复制副本。
本地文件通常不会像远程订阅一样自动更新整个配置;但其中引用的远程提供器仍可能联网更新。反过来,直接编辑远程订阅下载得到的文件,也可能在下次刷新时被覆盖。需要长期保留自定义规则时,优先使用客户端支持的覆写、合并或补丁功能。
Base64 格式:解码得到节点,不等于得到 Clash 配置
常见通用订阅会把多行节点链接编码成一段 Base64 文本。解码之后,内容可能是若干条 ss://、vmess:// 或 trojan:// 链接,而不是带有规则和策略组的 YAML。Base64 只是编码,任何拿到原文的人都可能还原其中的信息。
以字符串 c3M6Ly8= 为例,它解码后只是 ss://,这能说明编码关系,但不是可连接的节点。真实订阅还包含服务器、端口和认证参数;部分协议链接内部还会再使用编码,不能靠一次解码就完成全部协议解析。
按顺序选择转换方式
- 先找提供方的 Clash 导出。使用面向目标客户端的专用输出,通常能同时拿到节点、分组与规则,减少手工补全。
- 再看客户端的导入能力。只有明确支持通用订阅或节点链接的导入器,才适合直接粘贴 Base64 内容。不能因为客户端使用 mihomo 内核,就假定它的图形界面支持任意订阅格式。
- 确需转换时在可信环境处理。优先使用本地工具或提供方指定服务。转换后检查节点数量、协议字段、策略组引用和最终规则,再在客户端启用。
转换器不是把编码文字换一个扩展名。它需要解析节点协议,再按 Clash / mihomo 的字段组织节点,并补上主配置所需的策略与规则。目标内核不支持的协议或参数,不能靠转换自动获得支持;应核对客户端“关于”页面里的实际内核与版本,再对照该内核支持的配置语法。
导入失败:按网络、内容、配置语法逐层排查
先看客户端日志或导入错误详情,再决定下一步。网络请求失败、返回内容不对、配置语法错误是三类问题,处理方式不同。浏览器能打开后台,也不代表客户端能取得订阅;后台可能依赖登录 Cookie,而订阅接口应使用自己的访问凭据。
| 错误或现象 | 优先检查 | 下一步 |
|---|---|---|
| HTTP 401 / 403 | 访问令牌、权限、订阅有效期或服务端拦截 | 回提供方后台重新复制,核对套餐状态与请求限制 |
| HTTP 429 | 请求频率过高 | 停止连续刷新,按服务端要求等待并调大更新间隔 |
| timeout / DNS 查询失败 | 订阅域名解析、网络可达性与更新请求所走路径 | 检查网络;仅在已有可用节点时尝试经代理更新 |
| certificate / TLS 错误 | 系统日期、证书链或网络拦截 | 校准系统时间,核实服务端证书,不以关闭验证作为常规修复 |
| YAML 解析失败 | 返回了网页、Base64 列表,或缩进有误 | 在本机查看文件开头,重新选择 Clash 格式入口 |
| 加载后没有预期策略组 | 导入了提供器文件,或新配置尚未选中 | 核对配置类型,切换当前配置并查看内核日志 |
“经代理更新”适用于已经有可用代理、但订阅服务器直连不可达的情形。如果当前没有任何可用配置,打开这个选项可能形成依赖:需要先更新才能得到节点,却又需要节点才能更新。此时应使用提供方给出的可达入口,或在可信网络中取得配置后本地导入。
导入后验证:配置、节点、流量入口分别确认
- 确认配置启用。检查当前配置名称、最近更新时间与加载日志。配置列表里出现一个项目,并不代表内核正在使用它。
- 确认策略选择。进入代理页面,打开规则实际指向的策略组,选择一个节点。延迟测试通过只说明特定测试请求成功,不代表所有网站都能访问。
- 确认流量入口。使用系统代理时,核对客户端监听端口与系统设置是否一致。例如客户端显示混合端口为
7890,应用应连接对应的127.0.0.1:7890,不能照抄另一台机器的端口。 - 确认规则命中。打开目标网页后查看连接记录,检查域名、命中规则、策略组与实际出口。记录中完全没有请求时,优先查应用是否使用了代理入口,而不是反复更换订阅。
遇到需要 TUN 才能接管的应用,再按客户端要求授予权限并设置路由与 DNS。TUN 是流量接管方式,不是订阅格式转换器;DNS 劫持也不会把 Base64 节点列表变成完整配置。把配置获取、内核加载、流量接管三步分开验证,才能准确找到故障所在。
日常维护时,保留一个可回退的配置、记录更新周期,并在订阅变更后检查策略组名称。若提供方重命名了组,自定义规则与覆写可能仍在引用旧名称。先核对引用关系,再调整规则,能避免“订阅更新成功,但配置加载失败”的反复排查。