订阅导入前:确认链接、格式与内核

Clash 订阅链接是获取远程配置的地址,不等于单个代理节点。客户端请求这个地址,将响应保存为一份配置档案,再把最终配置交给内核运行。导入成功只说明配置获取与解析通过;是否有可用节点、规则是否指向正确策略组,还需要分别检查。

Clash Nyanpasu 是桌面配置管理客户端,具体协议支持取决于所选内核及其版本。Clash Meta 的后续项目名为 mihomo;面向 mihomo 输出的配置可能包含旧版 Clash 不认识的字段。订阅服务提供多个入口时,先选择与当前内核对应的 Clash 或 mihomo 格式,而不是直接复制通用节点列表。

  • 地址来源:从订阅服务账户页复制完整 HTTPS 链接,不复制浏览器中的账户管理页面地址。
  • 输出类型:确认标注为 Clash YAML、Clash Meta 或 mihomo,并核对服务方的格式说明。
  • 访问凭据:保留查询参数。链接里的令牌通常承担身份认证作用,截断参数可能导致请求被拒绝。
  • 当前配置:记下原有配置名称和正在使用的策略组,避免导入后失去回退依据。

Clash Nyanpasu 订阅链接导入步骤

以下按“远程配置”流程说明。不同发行版本的按钮可能标为“新建”“导入”或使用加号图标,核心步骤相同:在配置管理页创建远程记录,填入 URL,下载后选中该配置。不要把订阅链接填入系统代理地址或外部控制器地址。

  1. 打开配置页。进入客户端侧栏的「配置」页面,找到新建或导入入口。若同时提供“本地”和“远程”类型,选择远程配置。
  2. 填写可区分的名称。例如“日常订阅-主线路”。名称只用于本地管理,不会改变服务端返回的节点内容。
  3. 粘贴完整 URL。检查开头是否为 https://,结尾是否多出空格、换行、中文引号。链接中的 & 和 = 属于查询参数分隔符,不要手动删除。
  4. 执行导入并等待结果。观察是否出现下载失败、认证失败或 YAML 解析错误。出现错误时先保留原配置,不要连续创建多份相同记录。
  5. 选中新配置。在配置列表中将新记录设为当前使用项。仅保存远程记录,并不一定会切换正在运行的配置。
  6. 检查代理与规则。打开代理页面,确认节点或策略组已经出现;再查看日志,确认内核没有报告缺失策略组、未知代理类型等错误。

导入后先做一次最小验证

先保持规则模式,选中一个实际代理节点,访问需要验证的目标站点,再在连接记录中查看命中的规则与出站链路。节点延迟测试成功,只代表测试地址的连接结果,不代表所有网站均可访问。若配置里只有 DIRECT,说明当前并没有可供选择的代理节点,不能把“配置已激活”当作代理可用的证明。

系统代理与 TUN 是流量接入方式,不负责把订阅转换成节点。首次排查可先使用系统代理,避免同时改动 DNS、TUN 和路由。浏览器能否使用代理,还取决于其代理设置;不会读取系统代理的程序,需要单独配置或使用适合的接入方式。

Clash YAML、Base64 与单节点链接的区别

文件名后缀和链接外观都不足以判断订阅格式。一个没有 .yaml 后缀的 URL 也可能返回 Clash 配置;一个以 .yaml 结尾的地址也可能返回登录页面。判断对象应是服务器实际返回的正文,以及它是否符合目标内核的配置结构。

内容类型常见特征导入处理
完整 Clash YAML包含 proxies 或 proxy-providers,并组织策略组与规则核对内核兼容性后作为远程配置导入
Base64 节点列表正文为编码文本,解码后通常是多行节点 URI先转换成目标内核支持的 YAML 配置
单节点 URI以 ss://、vmess://、trojan:// 等协议开头由支持该协议的导入工具处理,再加入配置
代理提供者 YAML常见顶层为 proxies:,仅列出节点通常作为 proxy-providers 的数据源使用
HTML 或 JSON 错误响应登录提示、过期提示、错误码或网页标签修复地址或账户状态,不按配置导入

YAML 能解析,不等于配置能运行

YAML 是数据表达格式,不能仅凭“有冒号、有缩进”确认内容可用。下面是一份用于说明层级关系的最小配置:监听端口为 7890,策略组只包含直连,不提供代理能力。实际订阅还需要节点定义,或需要由代理提供者加载节点。

mixed-port: 7890
mode: rule
log-level: info

proxies: []

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

rules:
  - MATCH,手动选择

proxy-groups 中的成员必须能解析到已定义的节点、其他有效策略组或内置出站。上例中的 MATCH,手动选择 引用策略组名称,名称必须完全一致。使用代理提供者时,还需要检查组内的 use 是否引用了实际存在的提供者名称。完整字段说明可查阅YAML 配置手册。

Base64 解码不等于配置转换

Base64 只是编码方式,不提供规则、策略组或 DNS 设置,也不是加密。将其解码后,得到的可能仍然是若干节点 URI。真正的转换还需要解析协议参数、映射目标内核字段、生成策略组并添加规则。把原文件改名为 config.yaml,不会完成这些步骤。

订阅转换:先选原生格式,再考虑转换工具

如果服务端已经提供 Clash 或 mihomo 入口,优先使用该入口。它能减少字段映射和模板差异带来的问题。只有拿到通用节点订阅、且当前客户端无法直接作为配置使用时,再考虑转换流程。

  1. 确认源格式。区分完整配置、节点列表和提供者文件。节点列表没有路由规则,不能假定转换后会保留原有分流策略。
  2. 选择目标内核。目标填写或选择 mihomo 时,应确保正在运行的也是兼容内核。转换器不能让旧内核自动获得新协议支持。
  3. 选择受控的转换方式。优先考虑本地运行或自行管理的转换服务。远程转换服务会接触源订阅地址及返回的节点凭据。
  4. 检查转换产物。核对节点数量、协议类型、TLS 参数、策略组名称和最终 MATCH 规则,再导入为单独的测试配置。

更新间隔与手动修改:区分两层订阅

远程配置更新与代理提供者更新是两套机制。前者由客户端重新下载整份配置,后者由内核按照 proxy-providers 设置刷新节点文件。两者可能指向不同 URL,更新时间也不必一致。

客户端远程配置更新

在「配置」页面打开目标记录的编辑入口,查找更新间隔或自动更新选项。不同版本的输入单位可能是分钟,也可能以其他方式展示,应以字段旁的单位为准。例如,界面单位是分钟时,360 表示 6 小时;单位是秒时,6 小时对应 21600。不要直接照抄数值而忽略单位。

对于变化不频繁的订阅,可以先按 6 小时安排更新;节点临时失效或服务方通知变更时再手动刷新。服务方若规定请求频率,应遵循其限制。客户端关闭、设备睡眠或网络离线时,不能把自动更新理解为严格按墙上时钟执行的定时任务。

内核代理提供者更新

在 mihomo 配置中,HTTP 类型代理提供者的 interval 使用秒。下面片段表示每 3600 秒刷新一次提供者文件,URL 为格式演示地址,不能直接用于实际订阅。该片段需要并入完整配置,并由策略组通过 use 引用。

proxy-providers:
  remote-nodes:
    type: http
    url: "https://example.net/clash-provider.yaml"
    path: ./providers/remote-nodes.yaml
    interval: 3600

在下载得到的远程配置文件里直接改规则,下次更新时可能被覆盖。需要保留个人规则、端口或 DNS 调整时,应使用当前版本支持的覆写或合并机制,并检查最终生成配置。不要假定本地编辑会回写订阅服务,也不要把原订阅和个人调整混成难以恢复的一份文件。

订阅导入失败的排查顺序

按“请求是否成功 → 返回格式是否正确 → 内核是否兼容 → 流量是否接入”逐层检查。每次只改一项,并记录错误发生在下载阶段还是内核启动阶段。两类错误的处理方向不同。

现象优先检查下一步
HTTP 401 或 403令牌、账户权限、服务端访问策略从账户页重新复制链接,核对服务方提示
HTTP 404地址路径是否完整、旧入口是否失效使用当前有效入口,不手动猜接口路径
HTTP 429更新请求是否过于频繁停止连续重试,按服务端限制延后更新
超时或域名解析失败当前网络、DNS、下载请求所走路径确认订阅域名可达,再检查更新代理设置
YAML 解析错误响应是否为网页、缩进是否损坏核对响应正文,选择正确格式入口
未知代理类型或字段错误内核版本和输出目标切换匹配的内核或使用兼容配置
已导入但没有流量配置激活状态、策略组、系统代理查看连接记录与实际出站,不反复重新导入

浏览器能打开链接,客户端为什么仍然失败

浏览器与客户端不一定使用同一路径。浏览器可能携带登录 Cookie,或正在通过已有代理访问;客户端的订阅下载请求则可能直连,也可能使用不同的请求头。部分服务还会根据 User-Agent 返回不同格式。因此,浏览器显示了一段内容,并不能证明客户端收到的是同一份 YAML。

如果订阅域名必须经代理访问,先保留一份可用配置,再检查当前版本是否提供订阅更新的代理选项。不要为了下载新订阅先删除唯一可用的旧配置。日志分享前应遮盖完整 URL,尤其是请求路径和查询参数中的访问凭据。

导入完成后的检查清单

  • 当前使用的配置名称正确,最后一次更新结果可确认。
  • 节点和策略组已经加载,规则引用的名称没有缺失。
  • 更新间隔的数值与单位一致,没有把分钟当成秒。
  • 连接记录能显示预期规则和出站,应用流量确实进入内核。
  • 个人调整通过可持续的覆写方式保存,旧配置仍可用于回退。

订阅导入的核心是让“链接返回内容、配置结构、运行内核”三者一致。先解决格式与认证,再检查规则和流量接入,能避免把网络问题误判成 YAML 问题。初次使用时,可配合快速上手教程完成系统代理与基础连接验证;遇到 Profile、策略组等术语时,可查阅术语手册。