Clash发布站 · mihomo 内核客户端与中文文档

Clash 客户端下载与配置教程

从平台选型到规则分流,用真实配置与日志说明 mihomo 内核的使用方法。

开源生态 订阅管理 中文配置说明
GPL-3.0 开源 mihomo 内核 Windows / macOS / Linux / Android / iOS
配置/config.yaml
规则模式
系统代理 TUN 模式
规则从上到下匹配 · 界面示意
  1. 1DOMAIN-SUFFIX,github.com,Proxy
  2. 2DOMAIN-KEYWORD,google,Proxy
  3. 3DOMAIN-SUFFIX,example.com,Proxy
  4. 4IP-CIDR,127.0.0.0/8,DIRECT
  5. 5GEOIP,CN,DIRECT
  6. 6MATCH,Proxy
日志静态日志示例
  • [TCP] 127.0.0.1 --> api.github.com:443 match DomainSuffix(github.com) using Proxy
  • [TCP] 127.0.0.1 --> www.example.com:443 match DomainSuffix(example.com) using Proxy
  • [TCP] 127.0.0.1 --> 127.0.0.1:8080 match IPCIDR(127.0.0.0/8) using DIRECT

开源代码 / 配置语法 / 可追溯的连接日志

Clash 生态与内核关系

mihomoGPL-3.0YAML 配置规则分流

客户端界面与代理内核

Clash 是一个代理工具生态的常用名称,不代表所有客户端都由同一团队开发。图形客户端负责展示代理组、导入订阅、管理系统代理与保存设置;代理内核负责解析配置、匹配规则和建立连接。选择软件时,应同时确认客户端是否仍在维护,以及它实际使用的内核。本站整理下载入口与中文说明,并非这些客户端的官方开发者。

从 Clash Meta 到 mihomo

mihomo 延续了 Clash Meta 项目的技术路线。旧教程中的 Clash Meta 名称,常与当前 mihomo 文档指向相近的配置体系,但不同阶段支持的字段可能有差异。遇到未知配置项、启动失败或协议不受支持时,先核对当前客户端的内核信息,再查阅对应文档,不宜仅根据文件名判断兼容性。

开源许可与项目边界

mihomo 的代码仓库公开提供源码、发布说明与问题讨论,采用 GPL-3.0 许可。开源许可说明代码的使用与分发条件,不等于客户端提供网络服务,也不代表任意订阅内容可信。客户端、内核与订阅提供方是不同环节:安装工具后,仍需要合法取得的配置或自行管理的服务器信息,才能建立相应连接。

更新前保留可回退配置

客户端更新、内核更新与订阅更新应分别理解。客户端更新可能改变菜单与权限处理,内核更新可能改变协议和配置支持,订阅更新则可能替换代理条目及规则。调整前导出当前配置,阅读发布说明,并在更新后观察启动日志和规则命中结果。一次只改一类设置,更容易判断变化来自哪个环节。

mihomo 源码仓库

查看源码与发布记录;克隆源码需要本地安装 Git,不是日常使用客户端的必需步骤。

查看开源项目 ↗
git clone https://github.com/MetaCubeX/mihomo.git

客户端下载 / 按操作系统选择

Clash 全平台入口

先确定设备系统,再选择对应客户端。桌面与移动端的权限、网络接管方式及后台运行机制不同,同一份订阅也可能需要分别设置。

下载页按平台列出 Clash Plus、Clash Verge Rev、FlClash 等客户端,并区分仍在维护的项目与归档软件。首次使用优先查看各平台首推项;已有配置时,先核对协议、规则和覆写功能是否兼容,再决定迁移。

图形客户端适合日常管理。服务器和路由器用户可查阅内核区,自行准备配置文件与运行环境。内核文件本身不包含桌面设置界面,也不会自动替代系统里的网络设置。

查看全部客户端 → 客户端横向评测 →
配置工作区 / 四个核心环节

规则、策略与网络接管

下面展示配置结构与设置项示意,不代表某个客户端的完整界面。不同客户端的菜单名称可能略有差异,操作时以当前界面为准。

按顺序判断规则命中

规则模式不是按应用名称猜测去向,而是让内核从上到下检查连接是否满足条件。域名后缀、关键词与 IP 范围适合表达不同需求;一旦命中,连接就交给指定策略,后续规则通常不再参与判断。更具体的例外应放在通用规则之前,兜底的 MATCH 放在末尾。修改后先在日志里寻找目标域名,核对命中的规则类型与策略名称,再判断是否需要调整顺序,避免把连接问题误当成代理组问题。

查看 Clash 自定义规则 →
规则语法

DOMAIN-SUFFIX、GEOIP 与 MATCH 分工不同。

日志定位

同时查看目标地址、命中规则和最终策略。

配置 / config.yaml
rules:
  - DOMAIN-SUFFIX,github.com,Proxy
  - DOMAIN-KEYWORD,google,Proxy
  - IP-CIDR,127.0.0.0/8,DIRECT
  - GEOIP,CN,DIRECT
  - MATCH,Proxy

Proxy 必须是配置中已定义的代理或代理组。

代理组与策略选择

代理组把规则中的策略名称与实际出口连接起来。select 适合手动选择,url-test 根据配置的探测条件选择可用出口,fallback 按既定顺序回退。组名可以自定义,但规则引用必须完全一致。规则模式下,修改一个未被规则引用的组,不会改变目标连接的路径;全局模式则通过全局策略处理连接,适合短时对照排查。选择完成后应重新建立测试连接,已有连接可能仍沿用原来的路径。

查看 Clash Verge Rev 教程 →
组名引用

规则中的策略名需要与代理组定义一致。

模式对照

短时切换用于定位问题,日常按需求恢复规则模式。

代理 / 策略组类型示意
Proxyselect
Autourl-test
Fallbackfallback
Mediaselect

这里只列组名与策略类型。具体出口来自用户导入的配置。

订阅更新与本地覆写

订阅链接用于取得配置,更新时可能重新写入代理列表、策略组和规则。直接编辑下载后的文件,改动可能在下次更新时消失。需要长期保留的规则,应优先通过客户端支持的覆写、扩展脚本或合并功能管理,并确认合并发生在更新后的配置上。更新失败时先检查链接是否有效、是否需要登录,以及当前网络能否访问订阅地址。向他人提供日志或截图前,应遮盖订阅链接中的访问凭据。

查看订阅导入与更新步骤 →
分开更新

订阅更新不等于升级客户端或内核。

保留改动

使用客户端支持的覆写机制维护本地规则。

配置 / 订阅设置示意
配置来源远程订阅
自动更新
更新间隔按订阅要求设置
本地覆写单独维护

具体更新入口与合并顺序取决于客户端。修改前先导出当前配置。

系统代理与TUN 模式

系统代理向遵循系统设置的应用提供本机代理地址,通常适合作为桌面端首次配置的起点。部分命令行工具、游戏和自带网络栈的应用不读取这项设置,不能仅凭开关已开启就判断全部连接已接管。TUN 通过虚拟网卡处理更广的连接范围,同时涉及路由、DNS 与系统权限。启用前先确认普通代理连接正常,再处理服务模式和权限;遇到冲突时,停用其他 VPN 或网络接管软件进行对照,避免同时改动多套路径。

查看 Clash 系统代理设置 →
按需接管

根据应用是否读取系统代理,选择对应方式。

分层排查

依次确认权限、连接日志、DNS 与路由。

设置 / 网络接管示意
系统代理
TUN 模式
运行权限开启前检查
DNS 设置与接管方式配套

开关仅为静态示意。移动端通常通过系统 VPN 权限建立接管。

快速上手 / 从导入到验证

首次配置的三个步骤

安装成功只代表客户端能够启动。先完成配置导入,再选择模式与接管方式,最后用新连接验证结果;这三个环节分别检查,定位问题会更直接。

  1. 导入可用配置

    打开「配置」页面,选择从链接导入或导入本地 YAML 文件,保存后将该配置设为当前配置。链接应来自可信来源,普通网页地址不能代替订阅地址。若导入后提示解析失败,先查看错误行与缩进,不要反复切换系统代理。已有其他客户端配置时,迁移前另存一份,避免覆盖原文件。

  2. 选择模式并接管连接

    在「代理」页面选择规则模式,检查规则使用的策略组并选择可用出口。桌面端可先开启系统代理;移动端按照系统提示允许 VPN 连接。只有在目标应用不读取系统代理,或确有更广接管需求时,再按教程配置 TUN。不要同时运行多个接管网络的客户端,以免代理地址和路由互相覆盖。

  3. 用日志验证连接路径

    新打开一个测试页面,在「日志」或「连接」页面寻找相应域名。先确认连接是否进入内核,再核对命中规则、策略组及出口。日志没有目标连接时,优先检查接管方式;有记录但连接失败时,再检查出口与 DNS。测试结束后恢复常用日志级别,分享排查信息时隐藏订阅凭据和个人网络信息。

查看完整教程 →

配置前需要准备什么?

客户端只提供连接管理能力,不会自动生成可用服务器。准备与所选客户端兼容的配置,确认设备日期、网络和剩余存储空间正常。若需要从旧客户端迁移,记录本机代理端口、覆写规则与 DNS 设置;订阅链接相同,也不代表这些本地选项会一起同步。

Android 设备还应检查后台运行与电池管理设置,避免熄屏后服务被系统停止。涉及应用分流时,先确认规则针对的是应用还是域名,再进行排除设置。具体操作可从Android 配置说明继续阅读。

常见问题精选

导入订阅后为什么仍无法访问?

导入只负责加载配置。还需激活配置、选择策略组,并开启适合设备的接管方式。先在日志中确认目标连接是否出现,再按故障排查流程 →逐项处理。

规则模式和全局模式如何选择?

规则模式按规则列表决定每条连接的去向;全局模式通过全局策略处理连接。全局模式可用于短时对照,但不能替代对规则顺序和组名的检查。参阅规则配置说明 →

开启 TUN 后还需要调整 DNS 吗?

TUN 与 DNS 处理相互关联,应按客户端提供的配套设置检查。出现解析异常时,保留原配置再逐项测试,不要同时替换全部 DNS 地址与路由选项。参阅网络故障排查 →

配置文章 / 按问题查阅

近期配置与排查文章

从界面入口、设备同步到 DNS 增强模式,按当前问题选择阅读顺序。修改网络设置前保留原配置,验证每一次改动的实际结果。

查看全部文章 →
Clash下载