Clash Meta 全面升级指南：从旧版 Core 迁移到 Mihomo 内核完整教程

为什么必须从旧版 Clash Core 升级到 Mihomo？

如果你还在使用 2022 年以前发布的原版 Clash Core（即 Dreamacro 维护的版本），那么这篇教程非常重要。原版 Clash 项目已于 2023 年 11 月宣布停止维护，官方 GitHub 仓库存档只读。这意味着你的客户端将不再获得任何安全补丁或新功能支持。

与此同时，代理协议生态正在快速演进。越来越多的机场服务商开始部署 VLESS + REALITY、Hysteria2、TUIC v5 等新一代协议——这些协议在旧版 Clash Core 中完全无法使用。如果你的节点清单里出现了大量"连接失败"或"协议不支持"的报错，十有八九是内核版本过低导致的。

Mihomo（原 Clash Meta）是目前社区最活跃的 Clash 内核分支，由 MetaCubeX 团队持续维护。它在完整保留旧版 Clash 配置语法的基础上，新增了对 REALITY 协议、Hysteria2、TUIC v5、Shadowsocks 2022 等协议的原生支持，同时修复了大量内存泄漏与连接稳定性问题。升级 Mihomo 内核是目前延续 Clash 使用体验的最佳选择。

升级前的准备工作

在动手升级之前，建议花 5 分钟做好以下准备，可以避免升级过程中出现数据丢失或配置失效的情况。

1. 备份现有配置文件

Clash 的配置文件通常命名为 config.yaml，默认存放在以下目录：

• Windows：%USERPROFILE%\.config\clash\ 或客户端数据目录下的 profiles\ 文件夹
• macOS：~/.config/clash/
• Linux：~/.config/clash/

将整个 clash 配置文件夹复制到桌面备用。这是最重要的一步，哪怕升级失败，你也可以随时回退到旧版配置继续使用。

2. 确认你的客户端类型

Mihomo 内核本身是一个命令行程序，普通用户通常不会直接使用它，而是通过以下带 GUI 的客户端间接调用：

如果你使用的是 Clash Verge Rev 或 FlClash，恭喜你——这些客户端已经默认使用 Mihomo 内核，你只需保持客户端更新到最新版本即可，无需手动替换内核文件。

如果你使用的是旧版 Clash for Windows 或 ClashX，则需要按照下面的步骤手动操作。

Windows 平台：替换 Mihomo 内核

Windows 用户替换内核的操作相对简单，主要分为三步：下载新内核、替换文件、重启客户端。

第一步：下载 Mihomo 内核

前往 Mihomo GitHub Releases 页面，在最新版本的 Assets 中找到适合 Windows 的文件：

• 64 位 Intel/AMD 处理器（绝大多数用户）：选择 mihomo-windows-amd64.zip
• ARM 架构处理器（Surface Pro X 等）：选择 mihomo-windows-arm64.zip

下载后解压，得到 mihomo-windows-amd64.exe 文件。

第二步：替换内核文件

不同客户端的内核文件位置不同：

• Clash for Windows：找到安装目录下的 resources\static\files\win\x64\，将其中的 clash-win64.exe 替换为刚下载的 mihomo-windows-amd64.exe，并将文件重命名为 clash-win64.exe

第三步：重启并验证

替换完成后，重新启动客户端，在设置页面或关于页面中查看内核版本信息。如果显示 Mihomo 或 Meta 字样，说明替换成功。你也可以在客户端的日志面板中看到 Mihomo 的启动日志。

macOS 平台：迁移到新客户端

macOS 用户的推荐路径是直接切换到已内置 Mihomo 内核的新客户端（如 Clash Verge Rev），而不是在旧版 ClashX 中手动替换内核——因为 ClashX 项目同样已停止更新，即使替换了内核，其 GUI 层面也会存在各种兼容问题。

第一步：记录或导出订阅链接

在 ClashX 的配置管理界面，找到你的订阅链接（通常以 https:// 开头的一串 URL）并复制保存。如果你使用的是本地 YAML 配置文件，则直接备份该文件。

第二步：安装新客户端

访问本站下载页面，选择适合你 Mac 的版本：

• Apple Silicon（M1/M2/M3/M4 芯片）：下载 ARM64（Apple Silicon）版本
• Intel 芯片 Mac：下载 x64 版本

安装完成后，首次启动时 macOS 可能弹出安全提示，在「系统设置 → 隐私与安全性」中点击「仍要打开」即可。

第三步：导入订阅链接

在新客户端的「订阅」或「配置」界面，粘贴之前保存的订阅链接，点击「导入」或「更新」，等待节点列表加载完成，即可切换节点使用。

配置文件迁移注意事项

Mihomo 内核在语法上与旧版 Clash Core 高度兼容，大多数现有配置文件无需修改即可直接使用。但有几个常见字段存在差异，升级后可能导致配置加载失败：

主要配置差异对照

Mihomo 内核基础配置示例

以下是一个兼容 Mihomo 的最小化配置文件示例，可作为迁移参考：

YAMLmixed-port: 7890
allow-lan: false
mode: rule
log-level: info
ipv6: true

external-controller: '127.0.0.1:9090'
secret: ''

dns:
  enable: true
  ipv6: false
  enhanced-mode: fake-ip
  fake-ip-range: '198.18.0.1/16'
  nameserver:
    - 'https://doh.pub/dns-query'
    - 'https://dns.alidns.com/dns-query'
  fallback:
    - 'https://cloudflare-dns.com/dns-query'
    - 'tls://dns.google'
  fallback-filter:
    geoip: true
    geoip-code: CN

tun:
  enable: false
  stack: system
  dns-hijack:
    - 'any:53'
  auto-route: true
  auto-detect-interface: true

proxies: []

proxy-groups:
  - name: "节点选择"
    type: select
    proxies:
      - "自动选择"
      - DIRECT

  - name: "自动选择"
    type: url-test
    proxies: []
    url: 'http://www.gstatic.com/generate_204'
    interval: 300

rules:
  - GEOIP,CN,DIRECT
  - MATCH,节点选择

升级后常见问题与解决方案

即使按照上述步骤操作，升级后也可能遇到一些问题。以下是用户反馈最集中的几类问题及其解决方法：

问题 1：Dashboard 面板无法访问（ERR_CONNECTION_REFUSED）

这是升级后最常见的问题之一。原因通常是 external-controller 配置的监听地址从 0.0.0.0:9090 改成了 127.0.0.1:9090，或者监听端口被防火墙拦截。

解决方法：打开配置文件，确认 external-controller 字段的值，然后在浏览器中访问对应地址（如 http://127.0.0.1:9090/ui）。如果你使用的是带 GUI 的客户端，通常在设置中有"打开 Dashboard"按钮，直接点击即可。

问题 2：节点全部显示超时或连接失败

这类问题有多种可能的原因：

• 订阅未更新：部分机场在服务端升级了节点协议后，旧订阅链接中的节点配置信息已过期。在客户端手动触发一次"更新订阅"操作，重新获取最新的节点列表。
• DNS 解析失败：Mihomo 默认开启了 fake-ip 模式，如果你的 DNS 配置不正确，可能导致节点域名无法解析。检查 dns.nameserver 配置，建议使用国内外各一个 DNS 服务器。
• 系统代理未设置：Mihomo 内核本身不会自动设置系统代理，需要通过 GUI 客户端或手动设置系统代理指向 127.0.0.1:7890。

问题 3：TUN 模式无法启动

Mihomo 的 TUN 模式需要管理员权限才能创建虚拟网卡。在 Windows 上，需要以管理员身份启动客户端，或者启用客户端的"服务模式"；在 macOS 上，需要在系统设置中允许客户端安装系统扩展。

问题 4：规则配置加载报错

Mihomo 对规则语法要求更严格，部分旧版 Clash Core 中可以使用的非标准规则写法在 Mihomo 中会报错。最常见的问题包括：

• RULE-SET 规则需要配合 rule-providers 使用，单独写 RULE-SET,xxx,DIRECT 而不定义对应的 provider 会报错
• 规则集文件需要是有效的 YAML 或 MRS 格式，Mihomo 不支持部分非标准的规则集格式
• 代理组名称中不得包含特殊字符，建议只使用中文、字母和数字

升级后验证与性能优化

完成升级后，建议通过以下几步验证升级效果，并做一些基础的性能优化配置：

验证步骤

1. 在 Dashboard 的「代理」页面，确认节点列表正常显示，对常用节点执行延迟测试（Ping），确认能够返回延迟数值
2. 在浏览器中打开一个国外网站（如 Google），确认页面可以正常加载
3. 在 Dashboard 的「日志」页面查看实时日志，确认没有持续出现 ERROR 或 FATAL 级别的错误信息
4. 如果你使用了 REALITY 或 Hysteria2 协议的节点，确认这些节点的延迟测试能够返回正常数值（旧版内核无法识别这类节点，会直接显示超时）

性能优化建议

升级到 Mihomo 后，可以通过以下配置进一步提升代理体验：

• 开启 TCP 并发连接：在配置文件中添加 tcp-concurrent: true，可以在多个 IP 中同时建立连接，选择最快的那个
• 启用 geodata 自动更新：Mihomo 支持自动更新 GeoIP 和 GeoSite 数据文件，可以让规则分流更精准
• 使用 profile 节点缓存：开启 profile.store-selected: true，客户端重启后会自动记住上次选择的节点，无需每次手动切换

总结：升级 Mihomo 是正确的长期选择

旧版 Clash Core 的停止维护是一个明确的信号——代理工具的生态已经进入了以 Mihomo 为核心的新阶段。无论是协议支持的完整性、长期的安全更新保障，还是对现代代理配置语法的兼容性，Mihomo 都全面超越了旧版内核。

如果你的当前客户端用起来还算顺手，可以考虑只替换内核文件；如果客户端本身也已经停止更新（如旧版 Clash for Windows），那么直接迁移到新一代客户端是更彻底的解决方案，也省去了后续维护的麻烦。

在选择新客户端时，建议优先考虑那些将 Mihomo 内核深度集成、并提供完善 GUI 界面的产品——它们通常在界面设计、订阅管理、TUN 模式开关等用户最频繁操作的环节上做了大量优化，用起来要比原生命令行工具方便得多。

如果在迁移过程中遇到了本文没有覆盖到的问题，欢迎访问本站的教程页面查看更详细的配置指南，或者直接尝试使用我们推荐的客户端——它已经帮你预置了大多数合理的默认配置，即使是第一次使用 Clash 的用户也能快速上手。