开源项目 · 全平台客户端持续更新

Clash 客户端
免费下载

按设备选择客户端,以同一份兼容配置管理订阅和规则分流,从安装到连接查阅中文文档。

代码开源跨端配置分步教程

选择设备平台

客户端下载入口

按系统选择 Clash 客户端

先确认操作系统,再选择处理器架构。桌面图形客户端、手机应用与独立内核的安装方式不同,下载页集中说明各自的适用设备和安装要求。

客户端提供配置管理与本地流量转发功能,远端代理能力取决于自行准备的服务与配置。安装应用并不等于已经具备可用节点。已有订阅时,先确认它支持目标客户端使用的配置格式;从旧客户端迁移时,保留原配置,并重新检查本机端口、权限和规则兼容性。

查看全部客户端 →

配置与连接

规则、模式与网络接管

界面是功能示意,不代表某一客户端的完整截图。各客户端菜单名称可能不同,先理解配置与流量的关系,再对应实际设置操作。

日常配置

规则分流

从上到下匹配
首条命中规则生效

rules:
  - DOMAIN-SUFFIX,google.com,Proxy
  - IP-CIDR,192.168.0.0/16,DIRECT
  - GEOIP,CN,DIRECT
  - MATCH,Proxy
默认策略Proxy

策略组名应与配置定义一致。

阅读完整系统教程 →从核心概念到配置维护,按章节逐步查阅。

配置复用的边界

mode: rule
proxy-groups:
  - name: Proxy
    type: select
    proxies:
      - DIRECT
rules:
  - GEOIP,CN,DIRECT
  - MATCH,Proxy

结构示例仅演示策略引用关系。实际代理出口需在自己的配置中定义。

跨端配置

同一份规则
分别设置设备权限

兼容同一配置格式的客户端,可以共享域名规则与策略组定义。复制配置后,不必在每台设备重新整理分流思路,但本机网络设置不能原样照搬:桌面端的监听端口、移动端的 VPN 授权、不同系统的开机启动方式,都属于设备自己的运行环境。

跨端迁移先核对内核支持,再导入配置。若配置包含本地规则文件、脚本或专属扩展字段,应确认目标客户端能否识别;仅复制订阅地址并不保证每个客户端都呈现完全相同的功能。保留一份可用配置,能让迁移和回退更清晰。

  1. 安装并导入订阅

    下载对应系统的客户端,打开配置管理,导入兼容订阅并选用。没有订阅时,先准备可用配置;安装包本身不会生成远端代理服务。

  2. 选择模式与出口

    选择规则模式,在代理页面确认策略组指向可用出口,再启用系统代理或平台所需的 VPN 连接。初次设置暂不叠加其他网络工具。

  3. 验证连接与分流

    访问常用网页,并在连接页查看命中规则。再测试本地服务与常用应用,确认代理请求和直连请求分别按预期处理。

快速上手 · 三个阶段

先连接成功
再调整高级设置

首次使用按“配置有效、出口可用、流量进入客户端”的顺序检查。导入成功只是完成第一步,仍需确认策略组已经选择出口,并且应用流量确实经过客户端。连接失败时先看错误信息,不要反复切换模式来替代排查。

每次只改一项设置,并保留改动前的状态。基础连接通过后,再尝试 TUN、自定义 DNS 或规则覆盖。这样能明确是哪一项变更影响网络,也能在更新订阅后更快恢复原来的使用环境。

查看完整教程 →

开源生态与维护

客户端界面与代理内核分工

理解软件来自哪里、配置交给谁执行,比只看应用名称更有用。本站整理下载入口和中文文档,不提供代理服务;实际功能以所选客户端及其内核支持为准。

从 Clash 到 mihomo

Clash 建立了以配置文件管理代理、策略组与规则的使用方式。原始项目与围绕它形成的客户端不是同一个维护主体;后续的 Clash Meta/mihomo 生态继续发展兼容配置及网络功能。因此,名称里带有 Clash,并不意味着它们来自同一团队,也不意味着都支持相同的协议与字段。

选择新客户端时,优先看当前维护状态、操作系统支持与内核兼容性。历史客户端适合了解迁移背景,但长期使用还应考虑系统更新带来的权限、网络栈和安装兼容变化。已有配置不必一次性重写,可以先导入仍在维护的客户端,再对照日志处理不被支持的字段。

界面负责管理,内核负责执行

图形客户端通常提供订阅管理、模式切换、系统代理和日志入口;内核则负责解析配置、匹配规则、发起代理连接与处理 DNS。某个菜单能否出现,既取决于界面的功能设计,也取决于随客户端提供的内核与权限机制。遇到教程和界面不同,先确认客户端名称,再找功能相近的入口。

本站下载页把图形客户端和独立 mihomo 内核分开列出。普通桌面与手机用户从图形界面开始更容易完成配置;服务器、路由器与自动化部署用户则需要自行管理配置路径、服务权限和启动方式。单独取得内核,并不等于已经具备图形界面的系统代理设置能力。

公开源码与问题追踪

开源仓库便于阅读实现、了解配置字段的用途,并查找已知问题。查看问题记录时,应比较复现条件是否一致:同一种现象可能来自订阅失效、目标站点限制或本机代理端口冲突,并非都属于程序缺陷。提交反馈前准备客户端名称、系统类型、操作步骤与经过脱敏的日志,能减少来回确认。

下面的命令用于获取 mihomo 源码,适合需要阅读实现或参与开发的用户。日常使用不需要先编译项目,直接到下载页选择客户端即可。仓库中的构建文档、配置说明和发布记录应结合阅读;源码可见提供了核查依据,但不替代对本机环境与配置内容的判断。

更新前保留可恢复的状态

客户端更新、内核更新和订阅更新是三件不同的事。应用更新可能调整界面及权限流程;内核更新可能影响字段支持与连接行为;订阅更新则可能替换代理组或规则。把这些变更分开处理,能避免出现异常时无法判断起因,也方便根据日志逐步回退。

更新前记录当前选用的配置、策略组选择和本地覆盖项,保留自己的规则文件。订阅内容通常由提供方维护,直接改写下载得到的文件可能在下次更新时被覆盖;需要长期保留的修改,应优先使用客户端支持的覆写或合并机制。新配置生效后,再验证网页、局域网和常用应用。

查看 mihomo 源码

需要本机已安装 Git。命令只获取仓库,不会安装或启动代理服务。

打开项目仓库 ↗
git clone https://github.com/MetaCubeX/mihomo.git

Linux 企鹅图标:Font Awesome,依 CC BY 4.0 使用。查看许可

配置笔记

近期教程与排查文章

基础连接完成后,再按实际遇到的问题补充配置知识。先建立可复现的对照条件,比同时更换节点、模式和 DNS 更容易得到明确结论。

查看全部文章 →

按现象选择排查方向

客户端已启动但网页打不开,先确认订阅是否仍有效,再检查监听端口和系统代理;只有某个应用异常,则比较它是否遵守系统代理、是否使用独立 DNS,以及是否被其他 VPN 接管。连接页中没有对应请求,通常应先核对流量入口,而不是急着修改末尾的规则。

需要从头建立完整流程时,阅读使用文档;已经能连接、准备理解策略组和规则顺序时,转到系统教程。排查过程中保留原始设置,每一步记录改动与现象,避免在网络恢复后仍留下不必要的全局代理或 DNS 覆写。