开源项目 · mihomo 内核客户端持续更新

Clash 客户端全平台下载

下载Clash 查看教程

按系统选择客户端，用 mihomo 内核处理代理连接，通过规则分流管理请求，配合中文文档完成配置。

  • 统一入站 HTTP 与 SOCKS 共用混合端口
  • 按需接管 系统代理与 TUN 分别设置
  • 配置可读 订阅、代理组与规则分层管理

MIHOMO 内核 · GPL-3.0 开源 · 规则分流

规则分流TUN 模式订阅管理
PLATFORMS 按系统选择安装包
Windows Android iOS macOS Linux
COREmihomo协议与规则引擎
LICENSEGPL-3.0内核代码开源
CONFIGURATIONYAML 配置入站 / 代理组 / 规则
PROTOCOLS / CORE

协议类型与内核支持先看兼容性，再做选择

协议名称描述连接方式，不代表固定速度。服务端参数、网络路径与客户端内核需要匹配；导入订阅后，先确认协议字段能被当前内核识别。

已有订阅

沿用服务端给出的协议与传输参数。客户端能解析配置，只是第一步；还要核对 TLS、传输层和代理组引用是否完整。

移动网络

关注网络切换后的恢复表现与后台限制。基于 QUIC 的协议依赖 UDP 可用性，不能仅凭协议名判断耗电或连接稳定性。

桌面与服务部署

桌面侧重界面操作与系统集成，服务器侧重服务管理与配置可维护性。查看协议与内核技术参考 →

01 / CLIENT SELECTION

Clash 全平台客户端按系统与处理器选择

图形界面负责订阅管理、代理切换和系统集成，内核负责解析规则与建立连接。先选适合设备的安装包，再确认配置所需的协议支持。

Windows

可选 Clash Plus、Clash Verge Rev、FlClash 等图形客户端。先在系统信息中确认处理器架构，安装后从系统代理开始验证；需要接管不读取系统代理的程序时，再按教程配置 TUN 服务。

前往下载 Windows 客户端→

macOS

按 Apple Silicon 或 Intel 选择对应构建。系统代理与网络扩展的授权位置不同，首次启动时按系统提示处理。更新客户端之前保留配置备份，不要用重装代替订阅或规则问题的定位。

前往下载 macOS 客户端→

Android

可选 Clash Plus、Clash Meta for Android、FlClash 与 Surfboard。确认设备架构和配置格式，首次连接需允许建立 VPN。若切换应用后连接中断，检查系统对客户端的后台运行与电池管理限制。

前往下载 Android 客户端→

iOS

通过 App Store 安装 Clash Plus，官网为 clashplus.io。导入配置后允许添加 VPN 配置，再选择代理组。应用界面与桌面端并不完全相同，排查时以连接状态、活动配置和规则命中为依据。

前往下载 iOS 客户端→

Linux

桌面环境可选择 Clash Verge Rev 或 FlClash，并按发行版选择软件包。无图形界面的主机可直接运行 mihomo，由服务管理器维持进程；同时核对配置目录权限、监听地址和服务日志。

前往下载 Linux 客户端→
02 / CONFIGURATION WORKBENCH

入站、规则与代理组从连接路径理解设置

一次请求依次经过本地入站、规则匹配和出站选择。按这条路径设置，比同时切换多个开关更容易确认结果。

规则分流
TUN 模式
混合端口 · 局域网共享
mixed-port: 7890
allow-lan: false
订阅更新
节点测速
外部控制
日志查看
配置覆写 · 规则顺序
DOMAIN-SUFFIX,github.com,PROXY
GEOIP,CN,DIRECT
MATCH,DIRECT
DNS 设置
代理组
多配置切换

规则按顺序匹配，代理组决定出口

规则模式不是把全部连接交给同一个节点。内核从上到下检查域名、地址或规则集，命中后把请求交给对应策略。策略可以是直连，也可以是一个代理组。调整配置时，把具体条件放在前面，兜底的 MATCH 放在最后，并确认规则引用的组名确实存在。与全局模式相比，规则模式能保留不同业务的连接路径；但结果取决于规则内容。遇到某个应用走错出口，先在连接列表查看命中的规则，再改动对应条件，而不是反复切换全部节点。

rules:
  - DOMAIN-SUFFIX,github.com,PROXY
  - GEOIP,CN,DIRECT
  - MATCH,DIRECT

测速结果与实际下载速度分开看

节点测速通常是在指定探测地址上测量连接响应，并不是持续下载测试。响应较快的节点，也可能受到带宽、服务器负载或目标站点限制。比较时保持同一网络、同一测试目标与相近时间，只更换一个变量。若浏览器正常而终端失败，应先确认终端是否读取代理环境变量，不要直接判断为节点故障。

日志用于定位阶段，不用于推断结论

先区分订阅下载失败、配置解析失败、域名解析失败与目标连接失败，再检查对应设置。临时提高日志详细程度可以辅助排查，但分享日志前应移除订阅链接、认证字段与个人地址。记录活动配置、模式与复现步骤，往往比反复重新安装更有帮助。

03 / FIRST CONNECTION

订阅导入与连接验证先完成一条可复现的连接

第一次配置先保留默认端口，只启用当前需要的网络模式。每完成一步都确认状态，再继续下一步。

STEP 01

导入并启用订阅

在客户端的订阅或配置页面添加订阅地址，下载成功后选中该配置。确认文件能被解析、代理组内有可选项，再进行下一步。订阅地址通常包含访问凭据，不应贴到公共讨论区；若导入时报错，先检查返回的是配置内容还是错误页面。

STEP 02

选择模式与出口

通常从规则模式开始，在主要代理组中选择一个可用节点。桌面端先开启系统代理；移动端按系统提示允许建立 VPN。暂时不要同时开启多套代理程序，也不要在尚未确认基础连接时修改 DNS、端口和路由等多个设置。

STEP 03

访问目标并检查连接

打开需要验证的应用，在连接列表中找到相应域名或进程，核对规则命中和实际出口。仅看到开关开启不能说明请求已进入内核。若应用没有产生记录，先查代理入口；若有记录但失败，再查解析结果、节点连接与目标服务。

查看完整教程 →

订阅更新失败保留现有配置，检查地址、内容格式与更新日志。 Clash UWP 回环桌面应用正常而 UWP 应用失败时，检查回环访问限制。 代理是否生效用应用请求、连接列表与规则出口交叉验证。
04 / OPEN SOURCE CONTEXT

Clash 生态与 mihomo 内核客户端界面之外的项目关系

这里的 Clash 指一组共享配置理念的客户端与内核生态，不是所有应用都由同一个团队开发。界面相似，不代表协议支持与配置行为完全一致。

从原版配置模型到 mihomo

Clash 以 YAML 描述代理、代理组和规则，图形客户端在这套模型上提供导入、切换与系统集成。原版项目停止维护后，生态中的不同项目继续演进。Clash Meta 这一名称与后续的 mihomo 存在项目沿革关系，阅读旧教程时会同时遇到这些称呼。判断一项功能是否可用，应查看当前运行内核，而不是只凭应用名称中有没有 Meta。

开源范围与许可证需要分开看

mihomo 内核采用 GPL-3.0 许可证，源代码、议题与提交记录可以在项目仓库查阅。图形客户端、系统服务组件与配置工具可能有各自的仓库和许可证，不能把内核许可直接套到全部软件上。需要修改、分发或集成代码时，应阅读具体项目的许可文件与依赖声明；仅需日常连接的用户，可以先从下载页了解维护状态与系统要求。

配置兼容不等于逐项完全相同

旧配置中的基础规则和部分代理字段可能继续适用，但新协议、新规则类型与高级 DNS 字段需要相应内核支持。把配置复制到另一款客户端前，先看它是接收完整 YAML，还是只接收节点订阅；再确认客户端是否会自动合并默认设置。遇到解析错误，按日志指出的字段逐项处理，不建议为了让文件被接受而批量删除不认识的配置。

客户端、内核与订阅分别更新

更新客户端主要改变界面、平台集成和打包组件；更新内核影响协议实现与规则解析；更新订阅改变远程提供的节点或配置。这三种操作解决的问题不同。更新前保留可恢复的配置，更新后检查活动配置、监听端口与系统代理状态。正在使用的连接若出现变化，先对照更新范围，再决定是回退设置还是调整配置。

05 / TECHNICAL NOTES

Clash 配置与排查文章按现象定位到具体设置

快速上手解决首次连接，技术参考解释协议与内核，专题文章补充单一问题的验证过程。记录现象后，选择对应层级的说明阅读。

查看全部文章 →