客户端观察

Mihomo、Clash Meta 和旧内核的 YAML 能否沿用

读旧教程前先分清项目名称、界面应用和运行内核。配置是否兼容,要由具体内核的字段支持、解析结果和实际规则表现共同判断,不能根据文件名作结论。

  • Mihomo
  • Clash Meta
  • 配置兼容
  • 内核
章节索引

名称关系适合用来理解文档沿革,不能替代当前运行信息。先找到处理流量的内核,再把它与图形界面和候选配置对应,才能解释为什么相似的 YAML 在不同环境中出现不同结果。

先理解 Meta 名称与 Mihomo 的沿革

Clash Meta 后来采用 Mihomo 这一名称。早期由 Dreamacro 发起的 Clash 内核,在旧文档中常被称为 Original Clash。阅读时应把项目沿革与具体版本区分,避免把旧名和新名误解成必须同时安装的组件。

Verge Rev、FlClash 等界面应用负责配置管理与系统接管,它们调用的内核需要另外确认。应用或文件名称中含有 Clash,并不能说明底层一定使用早期内核。

文档名词所对应的对象

文档用语指代对象阅读时关注的方面
Original Clash早期实现及其配置结构用来对应旧程序和历史设置
Clash Meta扩展项目在早期采用的名称对照旧日志与配置说明中的称呼
Mihomo后续沿用的项目名称根据明确版本查阅字段及实现
管理内核的图形应用组织配置并提供桌面或移动操作入口界面支持的平台及它真正调用的程序

用运行信息对应界面版本和内核版本

同份配置在不同设备上行为不同时,先记录当前加载文件和实际内核。界面的关于、内核信息或启动日志可以提供线索;命令行应查询运行实例对应的可执行文件,避免查到路径中的另一份程序。

分别查询所用内核的命令示意
mihomo -v

# 如果机器上运行的是旧名称的二进制,也应先看它自己的版本
clash -v

留下能够对应实际环境的信息

  • 界面应用的名称及发行版本
  • 日志中显示的内核项目名
  • 内核完整版本与调用位置
  • 系统平台及处理器类型
  • 错误发生时生效的配置路径

相似 YAML 仍需逐项验证字段与行为

proxies、proxy-groups、rules 等基础结构可以帮助理解配置延续关系。协议、解析、虚拟接口、嗅探及运行时扩展则要结合所用内核检查,不能因顶层结构熟悉就整份照搬。

无法识别的内容可能触发 unknown field 或 unsupported proxy type,也可能被忽略。除了看是否报错,还需要查看最终运行行为是否符合原用途。

迁向新内核同样要验证旧脚本和界面生成字段。解析通过以后,继续核对策略引用、DNS 与规则命中,再决定配置是否具备实际兼容性。

从功能层逐项查看迁移差异

配置部分早期内核中要核对Mihomo 中要核对检查方法
协议及其传输选项原版本识别哪些类型与参数目标版本对所需类型的支持范围遇到不支持类型时先查能力要求,保留原字段供对照
DNS开源与 Premium 分支的设置范围目标版本的 Fake-IP、上游及解析参数用基本解析配置验证后,再恢复过滤与上游修改
TUN旧分支及界面是否包含接管功能实际版本的实现、集成方式和授权要求基础代理可用后,再验证虚拟接口和后台服务
规则类型及外部规则内容原核心能够识别的匹配语法所用版本文档列明的规则扩展查看 behavior、引用名称及合并后的运行内容
界面附加的私有设置Mixin、Parsers 或旧脚本生成了哪些内容新应用通过哪些覆写入口生成对应设置按目的重新建立,而非复制整段界面私有配置

字段无法识别时 从哪里查?

先检查字段是否属于当前版本,以及层级是否放对。

按实际内核的文档确认语法和支持范围,保留原错误便于对照。

提示类型不支持 该怎么 办?

核对协议及传输要求是否超出了当前内核的实现。

选择满足兼容要求的配置或受支持内核,再重新检查相同内容。

找不到策略引用 怎样 定位?

从规则和策略组中查找不存在的名称,留意覆写后的引用变化。

检查最终合并结果,原始文件正确也不能代替运行配置核对。

加载成功但命中结果发生变化

分别检查 DNS、规则次序及界面生成的覆写。

用同一目标的连接记录比对匹配规则与实际出站。

按维护要求与 遗留用途选择运行环境

建立新环境时,应查明项目维护来源、系统兼容要求和所含内核。名称变化本身不代表性能提升,是否适用仍取决于配置需要的能力和可恢复的安装方式。

冻结的离线环境可能有保留早期内核的理由,但仍需记录来源、版本和恢复办法。遗留控制接口应维持适当隔离,避免因沿用旧配置而直接暴露到公网。

路由器插件环境
除了管理页面,还要核对插件、核心架构和存储条件。
容器或后台服务环境
先确定目标版本,并在独立目录检查候选配置,再安排实际实例的变更。
继续使用冻结的配置
保留隔离和恢复入口,新配置应先检查是否超出旧核心支持范围。

用备份、 独立检查和业务请求完成迁移

从原配置到新环境的处理步骤

  1. 记录可恢复的原环境

    保存内核信息及旧文件,并选择可以重复验证的访问目标。

  2. 识别界面专用内容

    把窗口、缓存和后台服务设置与代理内核配置分开处理。

  3. 在独立位置检查候选文件

    使用准备运行的二进制检查配置,从最先出现的解析或引用错误处理,避免通过整段删除掩盖不兼容。

  4. 保持相同出站条件比较

    先检查常用站点与内部域名;不读取系统代理的程序,留到接管功能配置后单独验证。

  5. 再恢 复解 析与接管 扩展

    每轮只调整一层,结合连接记录、规则匹配和退出恢复判断结果。

下方命令展示配置检查参数的组合方式。可执行文件、候选文件和工作目录都应替换为实际绝对路径;工作目录使用独立副本,并备齐候选文件依赖的数据。

-t 表示检查后结束,-d 选择工作目录,-f 选择配置文件。初始化可能写入目录或获取依赖,所以应避免指向正在使用的位置;解析成功以后仍需验证连接与规则效果。

独立目录中的配置检查示意,先替换路径与文件
mihomo -t -d '/absolute/path/to/test-data' -f '/absolute/path/to/candidate.yaml'

完成迁移需要检查关键访问是否按预期分流、内部域名和局域网是否仍可用,以及停用接管后网络是否恢复。确认这些结果并保留恢复入口后,再清理旧程序与服务。

出处与说明