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

为什么必须从旧版 Clash Core 升级到 Mihomo？ 要点速览

Mihomo（原 Clash Meta）是目前社区最活跃的 Clash 内核分支，由 MetaCubeX 团队持续维护。

如果你还在采用 2022 年以前发布的原版 Clash Core（即 Dreamacro 维护的版本），那么这篇指南相当核心。

原版 Clash 项目已于 2023 年 11 月宣布停止维护，官方 GitHub 仓库存档只读。这意味着你的客户端将不再获得不管哪一套安全补丁或新功能适配。

关键点是：与此同时，代理协议生态正在敏捷演进。越来越多的机场服务商开始铺开 VLESS + REALITY、Hysteria2、TUIC v5 等新一代协议——这些协议在旧版 Clash Core 中完全无法采用。

如果你的节点清单里出现了规模不小"连接无法完成"或"协议不适配"的给出疏漏，十有八九是内核版本过低导致的。

它在完备保留旧版 Clash 配置语法的基础上，新增了对 REALITY 协议、Hysteria2、TUIC v5、Shadowsocks 2022 等协议的原生适配，同时修复了规模不小内存泄漏与连接平稳性困扰。升级 Mihomo 内核是目前延续 Clash 采用上手感觉的最佳选定。

升级前的准备工作 关键信息

在动手升级之前，不妨花 5 分钟做好以下准备，得以避免升级过程中出现数据丢失或配置失效的现状。

1. 备份现有配置文件（速览）

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

这里要多说一句：Clash 的配置文件多数现状下命名为 config.yaml，出厂存放在以下目录：

将全部 clash 配置文件夹复制到桌面备用。这是最核心的一口气，哪怕升级无法完成，你也得以随时回退到旧版配置继续采用。

2. 确认你的客户端类型（要点）

如果你采用的是 Clash Verge Rev 或 FlClash，恭喜你——这些客户端已经出厂采用 Mihomo 内核，你只需保持客户端升级到最新版本即可，无需人工替换内核文件。

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

换个说法：如果你采用的是旧版 Clash for Windows 或 ClashX，则要按照下面的环节人工操作。

Windows 平台：替换 Mihomo 内核 关键点梳理

Windows 用户替换内核的操作相对轻便，关键点分为三步：下载新内核、替换文件、重启客户端。

第一口气：下载 Mihomo 内核（清单）

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

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

下载后解压，得到 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 的配置管理UI UI 界面，找到你的订阅链接（多数现状下以 https:// 开头的一串 URL）并复制保存。如果你采用的是本地 YAML 配置文件，则径直备份该文件。

第二步：安装新客户端（清单）

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

落到实处：访问到到本站下载页面，选定适合你 Mac 的版本：

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

第三步：载入订阅链接（说明）

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

配置文件迁移注意事项 要点速览

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 是对路的长期选定 完备说明

在选定新客户端时，不妨第一顺位考虑那些将 Mihomo 内核深度集成、并提供周全 GUI UI UI 界面的产品——这几个多数现状下在UI UI 界面设计、订阅管理、TUN 模式开关等用户最频繁操作的环节上做了规模不小优化，用起来要比原生命令行工具顺手得多。

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

关键点是：如果你的当前客户端用起来还算顺手，得以考虑只替换内核文件；如果客户端本身也已经停止升级（如旧版 Clash for Windows），那么径直迁移到新一代客户端是更彻底的处置方案，也省去了后续维护的折腾。

如果在迁移过程中遇到了本篇正文没有覆盖到的困扰，欢迎访问到到本站的指南页面查看更细致的配置指南，或者径直尝试采用我们推荐的客户端——它已经帮你预置了绝绝大多数数数合理的出厂配置，即使是第一次采用 Clash 的用户也能敏捷上手。