章节索引
名称关系适合用来理解文档沿革,不能替代当前运行信息。先找到处理流量的内核,再把它与图形界面和候选配置对应,才能解释为什么相似的 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、规则次序及界面生成的覆写。
用同一目标的连接记录比对匹配规则与实际出站。
按维护要求与 遗留用途选择运行环境
建立新环境时,应查明项目维护来源、系统兼容要求和所含内核。名称变化本身不代表性能提升,是否适用仍取决于配置需要的能力和可恢复的安装方式。
冻结的离线环境可能有保留早期内核的理由,但仍需记录来源、版本和恢复办法。遗留控制接口应维持适当隔离,避免因沿用旧配置而直接暴露到公网。
- 路由器插件环境
- 除了管理页面,还要核对插件、核心架构和存储条件。
- 容器或后台服务环境
- 先确定目标版本,并在独立目录检查候选配置,再安排实际实例的变更。
- 继续使用冻结的配置
- 保留隔离和恢复入口,新配置应先检查是否超出旧核心支持范围。
用备份、 独立检查和业务请求完成迁移
从原配置到新环境的处理步骤
记录可恢复的原环境
保存内核信息及旧文件,并选择可以重复验证的访问目标。
识别界面专用内容
把窗口、缓存和后台服务设置与代理内核配置分开处理。
在独立位置检查候选文件
使用准备运行的二进制检查配置,从最先出现的解析或引用错误处理,避免通过整段删除掩盖不兼容。
保持相同出站条件比较
先检查常用站点与内部域名;不读取系统代理的程序,留到接管功能配置后单独验证。
再恢 复解 析与接管 扩展
每轮只调整一层,结合连接记录、规则匹配和退出恢复判断结果。
下方命令展示配置检查参数的组合方式。可执行文件、候选文件和工作目录都应替换为实际绝对路径;工作目录使用独立副本,并备齐候选文件依赖的数据。
-t 表示检查后结束,-d 选择工作目录,-f 选择配置文件。初始化可能写入目录或获取依赖,所以应避免指向正在使用的位置;解析成功以后仍需验证连接与规则效果。
mihomo -t -d '/absolute/path/to/test-data' -f '/absolute/path/to/candidate.yaml'完成迁移需要检查关键访问是否按预期分流、内部域名和局域网是否仍可用,以及停用接管后网络是否恢复。确认这些结果并保留恢复入口后,再清理旧程序与服务。
