---
url: /migration.md
description: >-
  Clash for Windows 已停止维护，本文介绍如何将订阅与配置迁移到基于 mihomo 内核的 Clash Light
  客户端，附完整迁移步骤与常见问题。
---

# 迁移指南

Clash for Windows 已于 2023 年停止维护，原仓库删除，不会再有安全更新和 Bug 修复。如果你仍在使用它，建议尽早迁移到仍在活跃维护的客户端。本站推荐唯一替代方案：[Clash Light](https://clashlight.org/)。

## 为什么选择 Clash Light

* **同为 mihomo（Clash Meta）内核**：与 Clash for Windows 后期版本使用的内核一脉相承，订阅和配置格式完全兼容
* **支持 Windows 和 macOS 双平台**，桌面端即开即用
* **系统代理自动清理**：停止或退出时同步清理系统代理状态，减少残留问题
* **本地持久化**：订阅、节点选择、端口配置都保存在本机，不需要账号或云同步

前往 [Clash Light 官方下载](https://clashlight.org/download.html)获取安装包。

## 迁移步骤

### 1. 备份订阅地址

在 Clash for Windows 中打开左侧 `配置` 选项卡，找到当前使用的配置文件，记下其对应的远程订阅 URL。如果当初使用的是本地文件导入，请把该 YAML 文件备份一份。

### 2. 安装 Clash Light

下载对应平台的安装包并完成安装。Windows 首次运行如遇安全提示选择"保留"即可。

### 3. 导入订阅

在 Clash Light 中新增订阅，粘贴第 1 步备份的订阅 URL 即可。节点列表、代理组和分流规则会自动加载——**订阅链接是通用的**，不需要向机场重新购买或申请新链接。

### 4. 开启系统代理并验证

选择一个节点，开启系统代理，打开任意网页验证连通性。确认无误后即可卸载 Clash for Windows。

## 界面对照：原来点这里，现在点那里

已经熟悉 Clash for Windows 菜单的人，切换到新客户端最先卡住的是「功能在哪」。下表按你原来的操作习惯排列：

| Clash for Windows 的位置          | Clash Light 里的对应位置           | 说明                                            |
| --------------------------------- | ---------------------------------- | ----------------------------------------------- |
| 左侧 `配置` → 顶部地址栏与 `下载` | 「订阅和节点」→ 添加订阅地址       | 粘贴 URL 后刷新节点列表                         |
| 左侧 `代理` → 节点组              | 「订阅和节点」→ 选择节点、测试延迟 | 分流仍按配置里的 `rules` 执行，不需要在界面重设 |
| 左侧 `主页` → `系统代理` 开关     | 「开始」页 → 启动 / 停止           | 启动时写入系统代理，停止时同步清理              |
| 左侧 `设置` → `端口`              | 「开始」页显示的本地端口           | 默认端口被占用时会自动改用可用端口              |
| 托盘图标颜色（金色 = 已生效）     | 「开始」页的核心状态与托盘区域     | 核心是否运行、代理是否写入，在这一页能直接看到  |

> 不同版本的界面文案可能略有差异，以应用内的实际标签为准。

## 能力对照

只对比 CFW 与 Clash Light 两列——本站不做客户端评测，也不引入第三方客户端做横向比较。

| 项目         | Clash for Windows（0.20.39，2023 停更） | Clash Light（维护中）           |
| ------------ | --------------------------------------- | ------------------------------- |
| 内核         | Clash 内核（可手动替换为 mihomo）       | mihomo                          |
| 维护状态     | 停止维护，仓库已删除                    | 活跃                            |
| 平台         | Windows                                 | Windows / macOS（arm64 与 x64） |
| 订阅格式     | Clash YAML                              | 兼容，可直接导入                |
| 系统代理清理 | 退出后易残留                            | 停止或退出时同步清理            |
| 更新方式     | 内置更新（已失效）                      | 应用内检查更新 + 手动覆盖安装   |
| 数据存储     | 本地                                    | 本地，无账号、无云同步          |

## 常见迁移问题

* **订阅链接导入失败？** 先在 Clash for Windows 中确认链接仍然有效；订阅格式是通用的，导入失败通常是链接复制不完整或网络问题，可参考[订阅导入排查](/faqs/5)。
* **旧的本地配置文件能直接用吗？** 基于规则（`rules`）和代理组（`proxy-groups`）的标准 YAML 配置可以直接导入，字段说明见 [代理组](/wiki/proxy-groups) 和 [规则](/wiki/rules)。
* **端口被占用？** Clash for Windows 卸载前请先关闭并退出托盘程序，否则 7890 等默认端口可能仍被占用，参见[系统代理打不开的排查](/faqs/6)。

## 迁移后

迁移完成后，本站的[使用教程](/tutorial)、[常见问题](/faq)和 [Wiki](/wiki/Shadowsocks) 中的协议与规则知识依然适用——它们讲解的是 Clash 系客户端的通用概念，不限于某一个客户端。