从 ClashX 迁移到 ClashFX：备份、导入与回退

发布于 2026-03-01 · 最后更新 2026-10-23

先了解产品与配置目录

当前开发重点已转向 ClashFX。ClashX 旧站继续保留历史下载、教程和故障排查资料，后续维护安排以公告为准。

ClashFX 1.1.11 使用 ~/.config/clashfx 作为默认配置目录；标准 ClashX 的默认目录是 ~/.config/clash。两者不是共用目录。1.1.11 只会在首次启动时、且 ~/.config/clashfx 尚不存在的情况下，整体复制旧的 ~/.config/clash 目录。只要新目录已经存在（即使为空），自动复制就会跳过。

复制配置文件不等于迁移应用内所有数据。远程订阅清单保存在应用偏好中，不会随目录复制；迁移后需要在 ClashFX 中重新登记订阅。配置格式、路径和运行行为也不保证完全兼容，导入后请逐项验证。

增强模式 (TUN)、远程订阅和 YAML 编辑器等 ClashFX 当前核心功能可免费使用。ClashFX Pro 正在筹备，尚未开放购买或激活；最终功能与价格待公布，迁移不需要 Pro。

迁移步骤

1. 记录信息并备份

先记下 ClashX 当前选中的配置名称，并妥善保存需要重新登记的订阅 URL。订阅 URL 可能包含账户凭据，不要公开分享。

停止修改配置后，在终端复制两个默认目录（如果存在）到带时间戳的备份目录。备份完成后确认终端没有报错，并保留打印出的备份路径：

(
  set -e
  task_stamp="$(date +%Y%m%d-%H%M%S)"
  task_backup_dir="$HOME/.config/clashfx-migration-backup-$task_stamp"
  mkdir -p "$HOME/.config"
  mkdir "$task_backup_dir"
  if [ -d "$HOME/.config/clash" ]; then
    cp -a "$HOME/.config/clash" "$task_backup_dir/"
  fi
  if [ -d "$HOME/.config/clashfx" ]; then
    cp -a "$HOME/.config/clashfx" "$task_backup_dir/"
  fi
  printf 'Backup: %s\n' "$task_backup_dir"
)

若旧客户端使用自定义配置目录，也要单独备份实际目录。备份命令报错或副本不完整时，先停止迁移并处理备份问题。

2. 退出 ClashX

确认备份完成后，完全退出 ClashX，并确认菜单栏图标消失。迁移期间不要让 ClashX 与 ClashFX 同时接管系统代理或 TUN。

3. 安装并首次启动 ClashFX

从下载页面获取 ClashFX 并完成安装。首次打开 1.1.11 时，如果 ~/.config/clashfx 不存在，程序会将 ~/.config/clash 整体复制到新目录；旧目录会保留。

如果 ~/.config/clashfx 已存在，自动复制会跳过。不要清空或删除这个目录来触发复制；先备份其中已有内容，再通过 ClashFX 的配置菜单导入所需 YAML 文件。若旧配置依赖同目录规则集或其他文件，请保留这些依赖并检查 YAML 中引用的路径。

4. 导入配置并重新登记订阅

在 ClashFX 的配置菜单中检查可用配置并选择要使用的 YAML。若自动复制没有发生，可从备份中选择需要的配置文件导入；不要假设所有配置、偏好或外部依赖都已自动迁移。

应用内的远程订阅清单不会随配置目录复制。打开远程配置管理，使用之前安全保存的订阅 URL 重新添加，并手动确认更新成功。详见导入订阅指南。

5. 验证配置与网络

先检查配置是否成功加载、当前选中的配置是否正确，再逐项验证：

• 节点和代理组是否存在，手动选择节点后能否连接。
• 规则和规则集是否加载，常用直连与代理目标是否符合预期。
• DNS、端口及 YAML 中引用的相对路径是否有效。
• 普通系统代理工作正常后，再按需启用 TUN，并检查系统授权与实际流量。

如果出现解析错误或行为差异，查看 ClashFX 提示和日志，按需调整配置。重新导入订阅不会自动升级或转换配置语法。

6. 保留回退方式

在 ClashFX 稳定运行前，保留 ClashX 和上述备份。若需要回退：先在 ClashFX 关闭 TUN 和系统代理，完全退出 ClashFX，再启动 ClashX。不要同时运行两个客户端。

如果要从备份恢复文件，先将当前目录另存一份并比对内容；不要清空目录，也不要在未检查的情况下覆盖同名文件。确认旧客户端恢复正常后，再决定是否继续排查 ClashFX。

相关指南

• 安装 ClashFX
• 导入远程订阅
• 编辑 YAML 配置
• ClashFX 与 ClashX 对比