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 值测试（Ping），确认能够返回ping 值数值
2. 在浏览器中拉起一个国外网站（如 Google），确认页面自然自然可以正常加载
3. 在 Dashboard 的「日志」页面查看实时日志，确认没有持续出现 ERROR 或 FATAL 级别的误操作信息
4. 如果你拿它来用了 REALITY 或 Hysteria2 协议的节点，确认这些节点的ping 值测试能够返回正常数值（旧版内核无法识别这类节点，会就这么显示超时）

性能优化可以考虑（提示）

升级到 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 的用户也能迅速上手。