开源 mihomo 内核 · 全平台客户端

ClashX官网 · Clash 客户端
下载与安装配置

下载Clash 查看教程

按平台完成安装，逐项设置订阅导入、规则分流与系统代理。

代码开源YAML 配置中文安装指引

基于开源 Clash 生态

  • mihomo
  • Clash Verge Rev
  • ClashX Meta
  • FlClash
  • Clash Meta for Android

规则分流与
订阅管理

先区分配置来源、出站规则与流量入口。客户端界面负责操作，内核负责执行；不同客户端的菜单名称可能不同，配置思路可以相互参照。

配置可读

YAML 保留明确的键名与层级，便于逐项定位设置。

连接可追踪

结合规则命中与运行日志核对实际出站路径。

config.yaml / 按顺序匹配规则
mode: rule
rules:
  - DOMAIN-SUFFIX,apple.com,DIRECT
  - GEOIP,CN,DIRECT
  - MATCH,PROXY

规则分流按从上到下的顺序检查连接，首条命中的规则决定出站策略。示例先让指定域名直连，再按目标地址所属地区判断，最后由 MATCH 接住其余连接。PROXY 不是内置的万能出口，必须对应配置中已有的节点或策略组。导入订阅后先选规则模式，再打开连接记录，核对命中规则与实际出口。遇到单个网站异常，优先检查规则顺序、域名识别和 DNS 结果，不要直接把整份配置改成全局模式。

平台与安装入口

Clash 客户端下载

查看全部客户端 →

先确认操作系统与处理器架构，再选择对应客户端。安装包能够启动，只代表应用已安装；要建立可用连接，还需要有效配置、可用的出站节点以及正确的流量入口。下载页集中列出各平台的可选客户端、安装要求和归档状态，首次使用不必同时安装多个客户端。

Windows

优先查看 Clash Plus，也可对照 Clash Verge Rev、FlClash 等客户端。安装前确认系统架构，首次启动核对混合端口是否被其他程序占用。系统代理适合作为第一步验证；需要 TUN 时，再按客户端提示安装服务或授予相应权限。

浏览器可用但某个应用不通，先确认该应用是否读取系统代理。商店应用的回环访问问题与节点故障不同，应结合 UWP 回环说明单独处理。

前往下载 Windows 客户端→

macOS

在“关于本机”确认 Apple Silicon 或 Intel，再选择对应安装包。将应用放入“应用程序”后启动，按需完成代理辅助服务或网络相关授权。不同客户端请求的权限不同，不应预先假定每款应用都需要系统扩展。

遇到授权弹窗，核对应用名称、来源与实际操作。拒绝后需要恢复时，从系统设置中的隐私与安全性及相关网络设置检查，不要反复重装来代替权限排查。

前往下载 macOS 客户端→

Android

可从 Clash Plus、Clash Meta for Android、FlClash 等客户端中选择。先查看设备架构与安装要求，导入订阅后选中配置，再确认系统 VPN 连接请求。该授权用于建立本机流量入口，不等同于订阅服务已经可用。

锁屏后断连时，检查电池优化、后台运行限制与其他 VPN 的占用情况。不同厂商系统的设置入口有差异，建议一次调整一项，再观察连接是否恢复。

前往下载 Android 客户端→

iOS

下载页提供 Clash Plus 的 App Store 入口，并列出官网 clashplus.io。安装后先核对订阅格式是否受支持，再完成导入、节点选择与系统 VPN 配置授权。连接图标出现后，仍应使用实际访问测试确认规则和出口。

从无线网络切换到蜂窝网络后，若连接异常，先核对应用的网络访问权限与配置状态。客户端提供的是连接管理能力，订阅内容、节点有效期和服务范围由配置来源决定。

前往下载 iOS 客户端→

Linux

桌面用户可查看 Clash Verge Rev 与 FlClash，并按发行版选择适用的包格式。桌面环境的系统代理、终端代理环境变量与 TUN 是不同入口，浏览器能够连接，并不意味着命令行工具已采用相同设置。

服务器或路由器用户可进一步阅读 mihomo 内核说明。部署时分别检查监听地址、文件权限、服务管理与防火墙，不要把仅供本机使用的控制接口直接暴露到公共网络。

前往下载 Linux 客户端→

首次连接顺序

Clash 快速上手

查看完整教程 →

按“配置能加载、节点能连接、应用能访问”的顺序验证，可以把问题限制在具体一层。首次配置先保留默认端口与规则模式，不急于修改 DNS、添加大量规则或同时启用多个接管方式。下面三步适合作为安装后的核对清单，完整教程提供每一步的操作说明。

01 / CONFIG

导入并选中订阅

在订阅或配置入口添加完整 URL，也可选择已有的本地 YAML 文件。等待下载完成后，选中该配置并查看解析结果。列表里出现名称不代表加载成功，若有字段错误，先按日志中的行号处理。示例地址只用于说明结构，不能代替实际订阅。

02 / ROUTE

选择模式与出站

日常使用先选规则模式，在对应策略组中选择可用节点。策略组中的选择只影响引用它的规则，并不会覆盖全部流量。延迟测试用于检查某种探测条件下的连通性，不能直接视为下载速度；测试失败时还要结合实际访问与日志判断。

03 / VERIFY

启用入口并验证

桌面端先尝试系统代理，移动端按提示允许 VPN 配置。访问一个预期直连与一个预期代理的目标，同时查看连接记录里的规则命中和出口。若客户端没有任何新连接，优先排查流量入口；若已有记录再报错，则继续检查 DNS、节点与目标网络。

完成后保留一份可恢复配置。

远程订阅更新可能覆盖手工编辑的内容，自定义规则应使用客户端支持的覆写或合并机制。调整前记录原设置，出现异常时先退回已验证的状态，再逐项复现，而不是一次更改多个参数。

项目关系与源码查阅

Clash 生态与 mihomo 内核

Clash 是生态名称，不是同一个安装包

Clash 最初以规则驱动的代理内核及其配置方式形成用户基础，随后出现面向不同系统的图形客户端、内核分支和配置管理工具。今天搜索 Clash，可能看到多个名称相近但维护状态不同的项目。选择时应分别核对客户端、所用内核和配置格式，而不是仅凭图标或名称判断功能是否相同。

本页中的生态字标用于说明相关项目关系，不表示这些项目共同发布了一个安装包，也不代表第三方项目对本站作出认证。下载页将仍可选择的客户端与归档项目分别标注，便于在兼容旧配置与采用持续维护的工具之间作出判断。

界面管理与网络执行分开理解

mihomo 延续并扩展了 Clash 生态的配置与规则能力。图形客户端可以在其外层加入配置订阅、托盘菜单、连接查看和系统服务，但这些界面功能并不都属于内核。遇到问题时，订阅按钮失效可能是客户端管理层的问题，配置解析错误可能涉及内核字段，系统代理未生效则可能出在系统集成层。

开源仓库可以帮助确认项目说明、许可条款、配置文档与公开问题记录。mihomo 使用 GPL-3.0 许可，其他客户端应以各自仓库的许可为准。查看源码不要求立即自行编译；对普通使用者，更实用的做法是先阅读与当前问题相关的文档和发布说明。

MetaCubeX / mihomo · 源码入口

查阅公开实现与配置说明

需要研究规则、DNS 或内核行为时，可从项目仓库开始。以下命令仅克隆源码，不会安装图形客户端，也不会提供订阅或自动修改网络设置。

git clone https://github.com/MetaCubeX/mihomo.git
查看项目仓库 ↗

Linux 企鹅图形来源：Font Awesome Tux，采用 CC BY 4.0 许可；本站以内联矢量展示。

更新前看影响范围

客户端更新、内核更新、订阅更新与规则数据更新是不同动作。更新订阅会改变配置来源的内容，更新内核可能影响字段支持和运行行为，规则数据则服务于地区或分类匹配。遇到更新后的异常，先记录刚才更新的是哪一层，再查看对应说明，避免把所有变化笼统归为“节点不可用”。

准备迁移客户端时，保存原配置与必要的本地覆写，并确认新客户端支持相同的规则和协议。归档项目仍能启动，不意味着能够适配后续系统变化；是否继续使用，应结合实际需求、维护状态和已知问题判断。

日志只保留排查所需信息

普通使用保留适度日志级别即可。需要定位问题时，记录失败发生的时间、目标类型、命中规则与报错，再短时间提高日志详细程度。公开求助前去掉订阅地址、节点密码、访问令牌和其他私人信息，仅提供能够复现问题的最小配置片段。

一次完整排查应区分本地监听、DNS 解析、规则选择和远端连接。先检查是否有流量进入内核，再确认规则是否选到预期出口，最后检查节点和目标服务。按层定位比反复更换客户端更容易得到可复现结论，详细示例可在使用文档与常见问题中查阅。

按问题查阅

Clash 使用心得

查看全部文章 →

完成首次连接后，再按实际问题深入阅读。安装阶段重点看端口、模式与系统入口；应用兼容问题重点看 DNS 和网络接管方式；订阅导入失败则先确认输入格式。每次只处理一个可验证的问题，保留调整前后的差异，方便判断是哪项设置产生了影响。

连接失败：先查端口监听与系统代理，再按错误信息定位。查看常见问题 →

概念不清：先区分节点、策略组、规则与 DNS，再修改配置。查阅术语表 →

跨平台迁移：对照系统授权与流量入口，不直接照搬旧设备的开关状态。查阅使用文档 →