教程

从 ClashX 迁移到 ClashFX 完整指南

为什么迁移到 ClashFX

如果你当前在使用 ClashX 或 ClashX Pro,迁移到 ClashFX 可以获得以下好处:

更现代的内核

ClashFX 基于 mihomo 内核(原 Clash.Meta),支持更多新协议和新特性。ClashX 使用的 Clash Premium 内核已于 2023 年停止更新,这意味着:

  • 新协议支持:VLESS、Hysteria2、TUIC 等 mihomo 支持而 Clash Premium 不支持的协议
  • Bug 修复:mihomo 持续维护,修复安全漏洞和性能问题
  • 新特性:更强大的规则匹配、更好的 DNS 处理

免费的增强模式

在 ClashX 中,TUN 增强模式需要购买 ClashX Pro(付费版本)。在 ClashFX 中,增强模式对所有用户免费开放

内置配置编辑器

ClashX 没有内置编辑器,修改配置需要切换到 VS Code 或其他文本编辑器。ClashFX 内置了语法高亮 YAML 编辑器,Pro 用户还可以使用可视化编辑模式。

持续活跃的开发

ClashFX 有活跃的开发团队,持续推出新功能和修复。ClashX 的维护已基本停止。

迁移前的准备

记录当前配置

在迁移之前,建议记录以下信息:

  1. 当前使用的配置文件名称
  2. 远程订阅链接(如果有)
  3. 自定义的代理规则
  4. 增强模式的 DNS 设置

备份配置目录

两者共用相同的配置目录。为安全起见,先备份:

cp -r ~/.config/clash/ ~/.config/clash.backup/

迁移步骤

第一步:关闭 ClashX

在迁移前,先完全关闭 ClashX,避免两个应用同时运行产生冲突:

  1. 点击菜单栏 ClashX 图标
  2. 选择 退出 ClashX
  3. 确认菜单栏图标已消失

第二步:安装 ClashFX

前往 下载页面 获取最新版本的 ClashFX,按照 安装教程 完成安装。

第三步:配置文件自动识别

ClashFX 和 ClashX 使用相同的配置目录 ~/.config/clash/。安装完成后启动 ClashFX,它会自动识别目录中已有的配置文件。

你可以在 ClashFX 菜单 → 配置 中看到之前 ClashX 使用的所有配置文件。

第四步:重新导入远程订阅(推荐)

虽然配置文件可以直接复用,但建议重新导入远程订阅以确保配置最新且兼容:

  1. 在 ClashFX 中打开 配置 → 远程配置管理
  2. 点击 添加,粘贴你的订阅链接
  3. 等待下载完成
  4. 配置 菜单中切换到新下载的配置

这样可以确保配置使用了 mihomo 内核的最新格式。

第五步:验证功能

迁移完成后,逐一检查:

  1. 节点连接 — 选择一个节点,测试是否能正常上网
  2. 规则分流 — 访问国内网站(直连)和国外网站(代理),确认分流正确
  3. 增强模式 — 开启增强模式,确认 TUN 正常工作
  4. 节点延迟 — 进行延迟测试,确认节点可用

第六步:卸载 ClashX(可选)

确认 ClashFX 一切正常后,可以卸载 ClashX:

  1. 将 ClashX 从 Applications 文件夹删除
  2. 清理相关系统扩展(如果安装了 ClashX Pro 的系统扩展)

功能映射对照

ClashX 功能ClashFX 对应
系统代理设置为系统代理(相同)
代理模式切换代理模式切换(相同)
增强模式(Pro 专属)增强模式(免费
yacd Dashboardyacd Dashboard(相同)
配置文件切换配置文件切换(相同)
远程配置管理远程配置管理(增强版)
无内置编辑器内置 YAML 编辑器
无可视化编辑可视化编辑器(Pro)
无面板模式原生面板模式(Pro)
无流量图表实时流量图表(Pro)

可能遇到的问题

配置解析错误

mihomo 和 Clash Premium 在某些高级配置项上存在差异。如果遇到解析错误:

  1. 查看 ClashFX 的错误提示,定位到具体的配置行
  2. 参考 mihomo 文档 修改不兼容的字段
  3. 或者直接重新导入远程订阅获取兼容的配置

系统扩展冲突

如果之前安装了 ClashX Pro 的系统扩展,可能需要在「系统设置 → 隐私与安全性」中移除旧扩展后,再安装 ClashFX 的扩展。

AppleScript 变更

如果你使用了 AppleScript 全局快捷键,需要将应用名称从 ClashX 改为 ClashFX

-- 旧的
tell application "ClashX" to toggleProxy

-- 新的
tell application "ClashFX" to toggleProxy

更详细的对比

想了解 ClashFX 和 ClashX 在功能和性能上的详细对比,请查看 ClashFX vs ClashX 完整对比

下一步

开始使用 ClashFX

免费下载,升级 Pro 获得更流畅的工作流。

常见问题

大部分情况可以。ClashFX 基于 mihomo 内核,兼容 Clash 配置格式。部分高级特性可能有差异,建议导入后检查一下。

可以,但不建议同时运行。两者都会设置系统代理,同时运行可能冲突。建议迁移完成后卸载 ClashX。