Clash Meta 全面升级指南：从旧版 Core 迁移到 Mihomo 内核一应俱全操作说明

为什么必须从旧版 Clash Core 升级到 Mihomo？ 内在逻辑与实践

如果你还在上手上手上手使用 2022 年以前发布的原版 Clash Core（即 Dreamacro 维护的版本），那么这篇操作说明特别不可忽视。原版 Clash 项目已于 2023 年 11 月宣布停止维护，官方 GitHub 仓库存档只读。这意味着你的客户端将不再获得每一种安全补丁或新功能能跑。

Mihomo（原 Clash Meta）是目前社区最活跃的 Clash 内核分支，由 MetaCubeX 团队持续维护。它在一应俱全保留旧版 Clash 配置语法的基础上，新增了对 REALITY 协议、Hysteria2、TUIC v5、Shadowsocks 2022 等协议的原生能跑，同时修复了成规模内存泄漏与连接经得起折腾性要留意之处。升级 Mihomo 内核是目前延续 Clash 上手上手上手使用实际感受的最佳拿定。

与此同时，代理协议生态正在很快演进。越来越多的机场服务商开始搭建 VLESS + REALITY、Hysteria2、TUIC v5 等新一代协议——这些协议在旧版 Clash Core 中完全无法上手上手上手使用。如果你的节点清单里出现了成规模"连接弹出错漏"或"协议不能跑"的弹出错漏，十有八九是内核版本过低导致的。

升级前的准备工作 技术拆解

在动手升级之前，更推荐花 5 分钟做好以下准备，完全能避免升级过程中出现数据丢失或配置失效的实际表现。

1. 备份现有配置文件（内在逻辑）

Clash 的配置文件按常规命名为 config.yaml，初始存放在以下目录：

将通盘 clash 配置文件夹复制到桌面备用。这是最不可忽视的一次到位，哪怕升级弹出错误，你也完全能随时回退到旧版配置继续上手上手使用。

从机制上看：Windows：%USERPROFILE%\.config\clash\ 或客户端数据目录下的 profiles\ 文件夹；macOS：~/.config/clash/；Linux：~/.config/clash/。

2. 确认你的客户端类型（机制）

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

如果你上手上手使用的是旧版 Clash for Windows 或 ClashX，则免不了要按照下面的一路走下来逐项操作。

如果你上手上手使用的是 Clash Verge Rev 或 FlClash，恭喜你——这些客户端已经初始上手上手使用 Mihomo 内核，你只需保持客户端重新拉取到最新版本即可，无需逐项替换内核文件。

Windows 平台：替换 Mihomo 内核 结构解析

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

第一次到位：下载 Mihomo 内核（实现）

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

更严格地说：下载后解压，得到 mihomo-windows-amd64.exe 文件。

64 位 Intel/AMD 处理器（绝多半数用户）：拿定 mihomo-windows-amd64.zip；ARM 架构处理器（Surface Pro X 等）：拿定 mihomo-windows-arm64.zip。

第二步：替换内核文件（不起眼却关键的地方）

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

• 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 的版本：

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

换个层面：Apple Silicon（M1/M2/M3/M4 芯片）：下载 ARM64（Apple Silicon）版本；Intel 芯片 Mac：下载 x64 版本。

第三步：导进订阅链接（不起眼却关键的地方）

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

配置文件迁移注意事项 内在逻辑与实践

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 都全面超越了旧版内核。

在拿定新客户端时，更推荐在前考虑那些将 Mihomo 内核深度集成、并提供打磨已久成熟完善 GUI 人机人机界面的产品——它们本身本身按常规在人机人机界面设计、订阅管理、TUN 模式开关等用户最频繁操作的环节上做了成规模优化，用起来要比原生命令行工具不费事得多。

如果在迁移过程中遇到了下文没有覆盖到的要留意之处，欢迎开本站的操作说明页面查看更详尽说明的配置指南，或者一上来尝试上手上手使用我们推荐的客户端——它已经帮你预置了多半数合理的初始配置，即使是第一次上手上手使用 Clash 的用户也能很快上手。

先厘清一件事：如果你的当前客户端用起来还算顺手，完全能考虑只替换内核文件；如果客户端本身也已经停止重新拉取（如旧版 Clash for Windows），那么一上来迁移到新一代客户端是更彻底的摆平方案，也省去了后续维护的费功夫。