mihomo 内核 · 全平台客户端上手教程

Clash 入门指南

先选客户端,再完成订阅导入、规则模式与系统代理设置。

  • 永久免费
  • 代码开源
  • 中文文档
01 / quickstart

第一次连接,先完成三步

把客户端、配置和流量入口分开确认,排查时就有顺序。

查看完整教程
01

导入订阅链接

打开客户端的配置或订阅页面,粘贴服务提供方给出的完整链接,保存后执行更新。订阅是获取节点与配置的地址,不是普通网页地址。看到配置名称后,还要将它设为当前使用的配置;仅保存链接并不等于已经启用。

先检查订阅是否有效,再处理客户端设置。链接可能含有账户凭据,分享截图时应遮住地址,也不要粘贴到不熟悉的在线转换页面。

配置 → 新建 → 导入 → 启用
02

选择规则模式

将运行模式设为规则,再到代理组中选择可用出口。代理组是配置中组织多个节点的集合;组名由订阅决定,不一定与教程截图相同。规则负责决定请求走代理还是直连,代理组负责决定使用哪个具体出口。

先沿用订阅自带的分流设置,连接成功后再修改。全局模式适合临时对照排查,不必为了第一次连接就重写整份规则。

mode: rule
03

开启代理并验证

在桌面客户端开启系统代理,然后用浏览器访问目标页面,查看连接记录是否出现对应域名。系统代理是系统提供给应用的代理地址设置,不是所有程序都会读取它;终端命令和部分游戏需要单独确认。

完成测试后记住关闭位置。退出客户端之前先关闭系统代理,避免程序停止监听后,应用仍向原来的本地端口发送请求。

应用 → 本地端口 → 规则 → 出口
02 / downloads

按设备选择 Clash 客户端

先确定操作系统与处理器架构,再到下载页选择安装包。

查看全部客户端

选择带图形界面的客户端,就能通过按钮导入配置、切换代理组和查看日志。mihomo 内核则是负责实际网络处理的程序,直接运行它需要自行准备配置文件。普通桌面与手机用户先从客户端开始,服务器和路由器用户再考虑下载页的内核入口。不同客户端的菜单位置可能不同,配置、模式、代理与日志这几类功能仍可作为寻找设置的线索。

Windows

适合日常桌面使用。先查看系统信息中的系统类型,再选择匹配架构的客户端。安装后先检查托盘中的运行状态;遇到端口占用时,确认是否同时启动了另一套代理程序。

前往下载

macOS

先在“关于本机”中确认 Apple Silicon 或 Intel,再选对应安装包。首次运行若需要系统授权,逐项阅读提示。切换网络后连接异常时,先检查当前网络服务的代理设置。

前往下载

Android

安装与设备架构匹配的应用,首次连接时确认系统的 VPN 授权。这里的 VPN 接口用于接管本机流量;如果另一个应用已占用该接口,先停止它,再启动当前客户端。

前往下载

iOS

从下载页进入 Clash Plus 的商店页面,安装后导入兼容配置,并按系统提示允许添加 VPN 配置。移动端以应用内的连接开关为准,具体功能与配置支持范围应查看客户端说明。

前往下载

Linux

桌面环境可先选 Clash Verge Rev 或 FlClash,再按发行版选择包格式。服务器用户可以直接运行 mihomo,但需要自行管理配置目录、进程权限与服务启动方式。

前往下载
03 / configuration

理解四类常用设置

先辨认每项设置负责哪一段,再决定是否修改。

查阅配置术语
mode

规则、全局与直连

先使用规则模式,让请求按配置中的条件选择出口。全局模式会将进入内核的流量交给全局代理组,适合临时判断是否为分流规则导致异常;直连模式则让进入内核的请求直接连接目标。三种模式改变的是内核处理方式,不代表所有应用流量都已进入客户端。切换后应重新发起请求并查看连接记录,已有连接可能继续沿用原出口。下面可切换说明,示意不会修改设备设置。

mode: rule

按规则自上而下匹配,命中后使用对应的策略或代理组。

proxy-providers

订阅导入与定时更新

先区分整份配置订阅与节点提供器:前者可能包含代理组、规则和 DNS 设置,后者通常只供应节点,并由主配置引用。客户端的订阅更新按钮与内核的节点提供器更新并不一定是同一操作。导入后检查更新时间、配置是否启用,以及代理组是否出现可选出口。自动更新间隔按实际需要设置;若要保留自定义规则,优先使用客户端支持的覆写功能,避免远程更新覆盖手工修改。

订阅链接 · 示例地址https://example.com/subscription
从剪贴板导入
自动更新间隔 · 秒interval: 3600
rules

按条件选择流量出口

先查看连接实际命中的规则,再调整规则顺序。域名后缀规则按域名匹配,GeoIP 规则根据目标 IP 的地区数据判断,MATCH 则用于接住前面没有匹配的请求。内核通常采用从上到下、首次命中即结束的方式,因此更具体的条件应放在宽泛条件前面。示意中的 PROXY 必须对应配置中实际存在的代理组;复制规则前先核对组名,地区判断所用的数据文件也需要保持可用。

DOMAIN-SUFFIX,google.com,PROXYGEOIP,CN,DIRECTMATCH,PROXY
PROXYDIRECT
tun

区分系统代理与 TUN

先开启系统代理验证浏览器,再考虑 TUN。系统代理只是向应用提供代理地址,应用可以不采用;TUN 是虚拟网卡,可结合路由设置接管更多流量,但需要相应权限,也会影响 DNS 与网络路径。二者不应被当成重复的连接开关。首次设置时一次只改一项,确认连接记录后再继续。遇到企业网络、其他 VPN 或虚拟机网卡,应先检查路由冲突,而不是同时开启所有接管选项。

TUN 模式
系统代理
混合端口 mixed-port: 7890同时接收 HTTP 与 SOCKS 代理连接;请以当前配置为准。

把本地监听端口与控制接口分开理解。混合端口接收应用的代理请求,控制接口用于读取运行状态和管理配置,两者不能互换。首页终端中的片段只用于辨认字段,不是一份包含节点、代理组和规则的完整联网配置。初次使用时应先导入有效配置,再对照客户端显示的实际端口进行设置。

04 / source & maintenance

开源内核、客户端与维护边界

从项目源码与发布说明核对信息,不用下载次数代替判断。

查看 mihomo 源码

先区分 Clash 生态中的项目

把内核和界面分成两层,就能理解为什么不同客户端有相似设置。Clash 生态围绕配置解析、规则分流与代理转发展开;原版 Clash 与后续衍生项目不是同一个持续更新的软件包。Clash Meta 后来更名为 mihomo,现有教程和配置中仍可能看到旧名称。遇到旧文章时,先确认它讨论的内核与客户端,再判断操作是否适用。

再确认客户端实际使用的内核

查看客户端的关于页面、内核设置与发布说明。图形客户端负责配置管理、托盘开关、系统代理等交互,内核负责处理连接;相似的界面名称不意味着功能完全相同。协议支持、配置字段和更新方式可能随项目变化,尤其不能把某个桌面客户端的菜单路径直接套到所有移动端。站点提供入门整理与下载入口,不代表所有上游项目的官方发布渠道。

把三类更新分别检查

分别检查客户端、内核和订阅数据。更新客户端可能修复界面或系统集成问题,更新内核可能改变协议与配置支持,更新订阅则刷新服务提供方给出的节点和规则。GeoIP、GeoSite 等地区与域名分类数据库又有独立的更新机制。遇到异常时先记录改动发生在哪一层,避免一次更新所有项目后难以确认原因。

改配置前保留可回退的副本

保存当前能工作的配置、覆写内容与关键设置,再进行调整。直接运行 mihomo 的用户可以先执行配置测试,通过后再启动服务;使用图形客户端时,应优先使用其内置的配置检查与日志页面。公开问题报告只保留必要的错误信息,隐藏订阅地址、节点认证字段和账户内容,便于在不暴露私人配置的前提下描述故障。

连接异常时,先确定请求停在哪一段

先确认客户端是否正在运行、当前配置是否启用,再查看应用请求是否出现在连接记录中。完全没有记录时,优先检查系统代理、应用自身设置或 TUN 接管;有记录但连接失败时,再检查命中的规则、代理组选择与节点可用性。浏览器正常而终端失败,往往需要单独检查命令行工具的代理配置,不能仅凭浏览器结果判断所有应用。

保留完整错误文字,并记下问题出现前的改动,比反复重装更容易缩小范围。若关闭客户端后仍不能联网,先恢复系统代理设置;若只有特定域名失败,再检查 DNS 解析和规则。基础名词可查术语表,常见操作可查FAQ,需要连续排查时再进入问题诊断页。

05 / reading notes

配置与排查使用心得

完成第一次连接后,再按实际遇到的问题深入阅读。

查看全部文章