开源内核 · 全平台客户端

Mihomo 内核 Clash 客户端 下载与配置教程

下载Clash 查看教程

从适合当前系统的客户端开始，依次完成订阅导入、规则分流与系统代理设置。页面同时说明 Mihomo 内核、图形客户端和配置文件之间的关系，便于按问题快速定位资料。

永久免费 代码开源 中文文档
CORE mihomo LICENSE GPL-3.0 PLATFORMS 5 CONFIG YAML

配置资料浏览器

先弄清配置，再打开系统代理

客户端界面负责操作，Mihomo 内核负责处理连接，配置文件负责告诉内核如何分流。下面四组资料对应日常使用中最常遇到的设置。

config.yaml

配置文件是内核的运行说明

mixed-port: 7890
mode: rule
log-level: info
allow-lan: false

Clash 客户端导入订阅后，通常会把远程内容保存为一个可切换的 Profile，并交给 Mihomo 内核加载。配置里包含端口、代理节点、策略组、规则和 DNS 等字段。日常使用不必从空文件开始编写，先导入服务提供方给出的订阅，再确认客户端显示“配置有效”。需要手动修改时，应先复制一份配置，避免更新订阅后覆盖本地改动。

与只提供固定开关的网络工具相比，YAML 配置可以明确表达每一层关系，也便于迁移和排错。若启动失败，先查看日志指出的字段与行号，再检查缩进、冒号后的空格及列表层级。配置加载成功只是第一步，后续还要选择策略组并打开系统代理。

了解订阅导入步骤 →

客户端下载

按操作系统选择 Clash 客户端

图形客户端适合日常桌面与移动设备。服务器、路由器和自动化环境再考虑直接使用 Mihomo 内核。

Windows

适合桌面常驻使用。下载前确认设备架构，安装后重点检查系统代理、混合端口和开机启动选项。若旧客户端仍在运行，应先退出，避免多个程序同时占用代理端口。

前往下载

macOS

根据 Intel 或 Apple Silicon 选择对应安装包。首次运行可能需要在系统设置中确认权限；开启代理后，也要留意其他网络工具、浏览器扩展和系统 VPN 是否同时改变连接路径。

前往下载

Android

移动端通常通过系统 VPN 接口接管流量。导入订阅并启动后，确认状态栏显示连接状态；后台省电限制可能结束客户端进程，长时间使用时可按系统设置允许其稳定运行。

前往下载

iOS

通过 App Store 获取支持 Mihomo 配置的客户端。首次添加网络配置时，系统会请求确认；导入后应先选择策略，再启动连接，并从客户端日志判断订阅更新或规则加载是否成功。

前往下载

Linux

桌面用户可选择带图形界面的客户端，服务器用户可直接运行 Mihomo 内核。部署前确认发行版、处理器架构、配置路径与服务权限，并为日志和配置更新保留明确目录。

前往下载

查看全部客户端 →

快速上手

导入、选择、验证三步完成基础连接

先沿主线完成一次可用连接，再处理规则、DNS 或局域网共享等进阶设置。一次改动一项，排查会更清楚。

  1. 01

    导入订阅配置

    打开客户端的配置或 Profile 页面，粘贴完整订阅地址并执行下载。导入后手动更新一次，确认配置名称、策略组和规则均已显示。若提示格式错误，先检查链接是否被截断，不要把网页地址当作订阅地址。

  2. 02

    选择策略与模式

    进入代理或策略组页面，选择一个可用策略。运行模式先使用“规则”，它会按配置区分直连和代理。测试期间不要同时修改 DNS、端口和规则，否则出现变化时难以判断是哪项设置产生作用。

  3. 03

    打开代理并验证

    桌面端开启系统代理，移动端启动系统 VPN 连接。随后访问一个外部站点，并在客户端连接记录中确认请求已出现、规则已命中、策略已选定。网页能打开但记录为空时，应优先检查系统代理是否真正指向客户端端口。

完整教程还包含配置更新、模式切换、出口验证和常见失败现象的处理顺序。

查看完整教程 →

开源生态

Mihomo 内核、客户端与配置资料的关系

判断一个 Clash 客户端是否适合自己，不能只看界面。还要分清内核来源、配置兼容性、更新路径和问题边界。

项目演进与内核定位

Mihomo 是 Clash Meta 项目延续使用的内核名称，负责监听本地端口、解析配置、建立代理连接、执行规则匹配并处理 DNS。用户平时看到的窗口、托盘菜单、订阅管理和系统代理按钮，多数由上层图形客户端提供。内核与客户端并不是同一个软件包，因此两个客户端即使都使用 Mihomo，安装方式、设置入口和系统集成也可能不同。

开源生态中的职责分工

内核维护者关注协议实现、配置字段、网络行为和运行稳定性；客户端维护者负责把这些能力整理成适合桌面或移动系统的界面。订阅服务提供方则负责生成节点、策略组与规则。出现问题时先判断所属层级：界面打不开属于客户端层，配置解析失败通常与 YAML 或字段兼容有关，节点超时属于连接层，网站走错策略则应查看规则命中。

配置兼容与迁移方式

Mihomo 支持较完整的 Clash 配置结构，但不同客户端可能会在原始配置外保存自己的界面设置。例如开机启动、窗口行为和系统代理开关通常不会写进订阅文件。迁移客户端时，应分别备份订阅地址、本地覆写规则和客户端偏好，不要只复制一个配置文件就假定全部设置都会跟随。重新导入后，逐项核对策略组、DNS 与系统代理状态更稳妥。

更新机制与问题复现

客户端更新、内核更新和订阅更新是三条不同路径。客户端升级主要改变界面与系统集成；内核升级可能加入配置字段或修复网络行为；订阅更新则会替换节点、规则和策略组。排查时记录使用的平台、客户端名称、配置来源、运行模式和关键日志，能够减少无效尝试。若更新后出现异常，先确认变化发生在哪一层，再决定回看配置还是客户端设置。

常见问题精选

先按现象确定排查方向

导入订阅后为什么没有可选策略？

先手动更新当前 Profile，确认订阅地址返回的是 Clash YAML 配置，而不是登录页面或普通网页。若配置能够加载但策略为空，再查看客户端日志中的解析提示，并到使用教程核对导入步骤。

开启客户端后为什么网页仍然直连？

桌面端需要同时确认内核正在运行和系统代理已经开启。若浏览器使用独立代理扩展，也要检查它是否覆盖系统设置。打开客户端连接记录并刷新网页；记录为空通常说明流量尚未进入客户端。

规则模式与全局模式应该选哪个？

日常使用优先选择规则模式，让不同连接按配置分流。全局模式适合临时验证节点是否可用，不建议把它当作所有问题的固定解决办法。测试完成后切回规则模式，再查看具体规则命中。

配置更新后为什么修改内容消失了？

订阅更新通常会重新写入远程配置，本地直接编辑的内容可能被替换。需要长期保留的调整应使用客户端提供的覆写功能，或维护独立配置副本。操作前先记录原值，方便出现问题时恢复。

技术笔记

配置管理与故障定位记录

文章围绕一个具体问题展开，给出可以复现的检查步骤。先看现象对应的主题，再按顺序执行。

入门指南

Clash 配置文件 Profile 是什么：多配置切换与管理方法

说明 Profile、订阅链接与 config.yaml 的关系，并整理多个配置的命名、切换、更新和清理方法，减少改错配置或覆盖本地内容的情况。

阅读全文 →
故障排查

Clash 端口被占用怎么办：定位 7890 冲突进程并修改混合端口

分别使用 Windows、macOS 与 Linux 常见命令定位占用进程，并说明修改 mixed-port 后如何同步检查系统代理，避免端口改了但流量入口仍指向旧值。

阅读全文 →
格式与选型

Clash 订阅格式一览：YAML、Base64 分享链接与 sing-box JSON 如何互转

比较常见订阅格式的结构与识别方式，说明转换前需要保留的字段，以及转换完成后应复核的策略组、规则、DNS 和协议参数。

阅读全文 →

查看全部文章 →