CFW 停更后的迁移范围

Clash for Windows，简称 CFW，是管理配置、节点和系统代理的桌面客户端，不等于 Clash 内核本身。CFW 已停止维护，常见的末期版本是 0.20.39。旧安装仍能启动，不代表它会继续获得系统兼容性修复，也不代表新订阅使用的协议和字段都能被旧内核识别。

迁移不必一次重写全部配置。先搬订阅和规则，再恢复系统代理，最后处理 TUN、DNS 与自动启动，容易判断问题来自哪一步。已有的订阅服务通常不需要因为换客户端而重新购买；需要确认的是服务商是否提供目标内核可读取的配置。

先区分三层设置

  • 订阅内容：节点、策略组、规则和部分 DNS 配置，通常由远端订阅生成。
  • 本地修改：手动添加的规则、订阅预处理、脚本与覆写，需要单独整理。
  • 客户端设置：系统代理开关、服务安装、开机启动、界面偏好，不能靠复制一份 YAML 全部恢复。

备份订阅地址、自定义规则与本地配置

记录当前正在使用的配置

  1. 在旧 CFW 的 Profiles 页面确认当前选中的配置，记下它的名称、订阅来源和最后一次更新是否成功。
  2. 查看 General 页面，记录实际代理端口、当前模式，以及 System Proxy、TUN Mode 的开关状态。常见 HTTP 代理端口是 7890，但应以本机显示为准。
  3. 找到实际配置目录并复制到本地备份文件夹。Windows 常见位置为 %USERPROFILE%\.config\clash，便携版或自定义目录可能不同，不要只凭默认路径判断。
  4. 将自己编辑过的 YAML、规则文件、订阅预处理配置和脚本另存一份；记录哪些是手动修改，哪些由订阅更新生成。

配置目录可能同时包含客户端设置、订阅缓存和内核运行时文件。完整备份有助于回查，但不建议把整个目录直接覆盖到新客户端中：不同项目的配置索引、数据库和文件命名并不一致。

订阅地址与配置快照都要留

订阅地址用于后续更新，当前 YAML 则用于核对节点与规则。只有配置快照、没有原始订阅地址时，导入后可能暂时能连接，却无法继续取得服务商的节点变更。反过来，只保存订阅地址，也可能遗漏本地规则与分流习惯。

订阅 URL 中的令牌常出现在查询参数或路径里。向他人求助时只展示错误信息和必要字段，不要贴完整链接。如果完整链接已经公开，先到服务商后台重置订阅令牌，再更新新客户端。

替代客户端选择：先看平台，再看内核

选择替代品时，重点核对项目近期发布记录、系统架构与内核类型。安装包版本与内核版本是两回事；判断某个字段是否可用，应查看实际运行的内核版本，而不是只看客户端界面的版本号。

使用环境可考察客户端迁移检查重点
Windows 桌面Clash Verge Rev、Clash Nyanpasu确认维护状态、mihomo 内核版本和服务模式权限。
macOS 桌面Clash Verge Rev、ClashX Meta区分 Apple Silicon 与 Intel，重新授权网络接管功能。
Linux 桌面Clash Verge Rev按发行版选择 DEB 或 RPM，并核对桌面代理设置。
仅需后台内核mihomo自行管理配置路径、服务启动和控制器访问权限。

上述名称是筛选入口，不是对未来维护状态的保证。安装前到下载页核对当前提供的平台与项目来源；需要比较管理方式时，可查看客户端横向评测。不要把名称相近的旧 CFW 重打包版本当作原项目恢复更新。

如果原来依赖 CFW 的 Parsers 或脚本处理订阅，还要确认目标客户端是否提供对应的覆写机制。能够导入 Clash YAML，不等于支持 CFW 的界面设置或全部预处理语法。

订阅与规则迁移：先恢复最小可用连接

第一轮只导入订阅，不开启 TUN

  1. 在旧客户端关闭 System Proxy 和 TUN Mode，再退出旧客户端；同时关闭其开机启动。
  2. 安装新客户端，在订阅或配置管理页面导入原订阅 URL。不同版本菜单名称可能不同，以页面中的“导入”“订阅”入口为准。
  3. 等待更新完成，确认节点数量与策略组基本符合预期，再将该配置设为当前配置。
  4. 切换到规则模式，手动选一个已知可用节点，仅开启系统代理，用浏览器测试连接。

导入失败时先看日志：返回 401 或 403 通常需要检查授权或服务商限制；返回网页而不是 YAML，则要检查复制的是否为订阅入口。提示字段或协议不支持时，应核对内核与订阅格式，不要先删除所有规则试运气。

把本地规则放到稳定的覆写层

规则通常自上而下匹配，前面的匹配结果优先。以下三条仅展示顺序：先处理指定域名，再处理内网地址，最后使用兜底规则。DIRECT 是内置直连策略；如改成策略组名称，该名称必须已经存在于配置中。

rules:
  - DOMAIN-SUFFIX,example.com,DIRECT
  - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
  - MATCH,DIRECT

不要把这段示例作为完整订阅覆盖导入，也不要直接在原有 rules 下再复制一个同名顶层字段。实际迁移时，应使用目标客户端提供的规则合并或覆写功能，将自己的规则插入合适位置，同时保留订阅原来的兜底策略。

旧配置迁到 mihomo 的兼容性检查

Clash.Meta 后续以 mihomo 名称发展，许多基础 Clash YAML 字段可以继续使用，但旧客户端专有功能不能按同名设置直接照搬。迁移时优先保留 proxies、proxy-groups、rules 等核心结构，再逐项核对扩展能力。

  • 旧脚本与预处理：不要假设 CFW Parsers、JavaScript 处理流程或旧内核的脚本模式能在目标客户端原样执行；先确认功能归属，再按目标实现改写。
  • 规则文件路径：rule-providers 中的相对路径会受到新配置目录影响。复制本地规则文件后，核对路径与读取权限。
  • 策略组引用：规则引用的组名必须准确，空格与大小写也要核对。组名不存在会导致配置加载失败或规则无法按预期工作。
  • 控制器权限：external-controller 如无远程管理需求，应限制在回环地址；不要照搬监听所有网卡且缺少访问密钥的旧设置。
  • DNS 配置：先保存原始行为基线，再调整 fake-ip、上游解析器和域名策略。一次换内核又改解析方案，会增加定位难度。

如果使用独立 mihomo 内核，可通过 mihomo -t -f config.yaml 检查指定配置能否通过校验；运行时要使用实际文件路径。图形客户端则优先查看配置检查结果和内核日志。检查通过只能说明配置可加载，不等于订阅地址、规则源和所有节点都能正常联网。

系统代理、TUN 与端口冲突排查

浏览器可用，其他程序不可用

系统代理主要作用于遵循系统代理设置的应用，不保证所有程序都会使用它。先确认目标程序是否有独立代理选项；确实需要接管不遵循系统代理的流量时，再按新客户端的说明启用 TUN，并完成服务或管理员权限配置。

旧 CFW 的服务安装状态不会自动转移到新客户端。新客户端提示权限不足时，应使用它自己的服务安装入口，不要直接搬旧服务文件，也不要让两个代理客户端同时创建虚拟网卡与路由。

端口占用或退出后无法联网

若新客户端日志显示 address already in use，先确认旧进程是否仍在后台运行。Windows 可以在终端执行以下命令，查看监听 7890 的进程编号，再到任务管理器核对程序名称。

netstat -ano | findstr :7890

不要在未识别进程用途时直接结束任务。也可以为新客户端选择一个未占用的端口，但浏览器扩展、终端环境变量和其他手动代理设置必须同步修改。特别留意 HTTP_PROXY、HTTPS_PROXY 和 ALL_PROXY 是否仍指向旧端口。

若客户端退出后浏览器仍尝试连接本地代理，在 Windows 11 打开「设置」→「网络和 Internet」→「代理」，检查“使用代理服务器”。仅在确认没有组织策略或其他软件需要该设置时关闭它。TUN 停用后仍有连接异常，则继续检查其他 VPN、虚拟网卡和 DNS 设置。

迁移验收与旧客户端回退

迁移完成不以“延迟数字出现”为唯一标准。延迟测试只覆盖特定请求，不能证明所有流量都按规则走向正确出口。建议用下面的清单完成一轮实际验收，再决定是否卸载旧客户端。

  1. 订阅更新：手动更新成功，节点与自定义规则没有意外丢失。
  2. 规则命中：分别访问一个应直连和一个应走代理的目标，在连接记录中核对匹配规则与实际策略。
  3. 日常应用：测试浏览器、终端和一个常用桌面应用，避免只测浏览器。
  4. 局域网访问：确认路由器管理页、打印机或 NAS 仍能按原计划访问。
  5. 重启与恢复：重启电脑并测试一次睡眠唤醒，确认开机启动、服务权限和代理状态正确。

遇到订阅更新或节点连接问题，可继续查看订阅更新排查与延迟测试说明。迁移的关键是分开处理订阅、规则和网络接管，每完成一层就验证一层，而不是把旧目录全部覆盖过去。