Clash开源社区 mihomo

Clash 客户端下载与 配置指南

按系统选 Clash 客户端,查 mihomo 配置字段,用连接记录确认规则分流结果。

  • 内核代码开源
  • 中文文档

INSTALL / PLATFORM

Clash 平台下载

先确认操作系统和处理器,再挑客户端。同一项目可能分别提供不同架构的安装包,名称相近也不能混装。初次使用建议选图形客户端:导入配置、查看连接和切换策略都能在界面里完成。已经在路由器或服务器上管理网络服务,再考虑单独部署内核。

Windows

在「设置 → 系统 → 关于」查看系统类型。先对照下载页提供的架构,再选安装包。换客户端前先退出旧程序,确认托盘里的后台进程也已结束,避免两个实例都在尝试监听同一个端口。

macOS

在「关于本机」看芯片或处理器一栏,分别选 Apple 芯片或 Intel 安装包。客户端出现在菜单栏,通常只说明程序正在运行。导入配置后,还要确认当前配置已启用,并按需开启系统代理。

Android

选择与设备应用架构匹配的安装包,不能仅凭手机型号里写着「六十四位」就下结论。首次连接时留意系统 VPN 授权提示。如果设备原先启用了另一个本地 VPN,先确认是否需要断开它,再启动新客户端。

iOS

从下载页进入 Clash Plus 的 App Store 页面,查看应用详情中的系统要求。安装后先核对客户端支持的导入格式。建立连接时按系统提示添加 VPN 配置,之后回到客户端确认当前使用的是哪份配置。

Linux

先看发行版支持哪种包格式,再核对架构。桌面环境可考虑图形客户端;纯命令行环境则要自行安排配置目录、进程启动与日志保存。迁移到另一台机器时,记得核对规则集和本地文件引用,不只复制主配置。

旧教程里出现的同名按钮,在新客户端里可能被移到不同位置。尤其是从已停止维护的 Clash for Windows 迁移时,先保留自己添加的规则与覆写,在新客户端重新导入配置。不要直接搬整个旧工作目录:除了配置文件,目录里还可能有缓存和只对旧界面有效的设置。

查看全部客户端 → 对照客户端功能与选型

CONFIG / INSPECTION

mihomo 核心配置

排查时把三个问题分开:请求有没有进内核,进来后命中了什么规则,最后走了哪个出站。下面的片段分别说明一个字段,不是整份可直接替换的配置;需要查字段取值和依赖关系,可翻完整配置字段参考。

具体规则在前,兜底在后

规则模式按列表从上往下判断,命中后就不再检查后续条目。要让某个子域名走与主域不同的路线,先写精确域名,再写覆盖面更广的后缀规则,最后用兜底规则收口。与全局模式不同,规则模式可以在同一份配置里指定不同出站。修改后用连接记录核对实际命中项;如果规则指向自定义策略组,还要确认规则里的名称与组名完全一致。

config.yaml · rules
mode: rule
rules:
  - DOMAIN,blocked.example.com,REJECT
  - DOMAIN-SUFFIX,example.com,DIRECT
  - MATCH,DIRECT

SETUP / FIRST RUN

导入、接管与验证

首次测试用一个平时能访问的网站,先记下未开启代理时的表现。接下来一次只改一个设置;遇到问题,可以回到上一步,看故障在哪次改动后出现。

  1. 导入并启用一份配置

    进入客户端的「配置」或「订阅」,选择从文件导入,或输入来源可信的订阅地址。导入后选中该配置,查看规则和策略组是否加载。列表里已有一条记录,不等于内核正在用它。遇到解析错误,先记下提示指出的字段或行号;现有文件保留一份,再改副本里的缩进、列表层级或字段类型。

  2. 选择规则模式与一种接管方式

    用规则模式测试,再在相关策略组里选定一个出站。桌面端可先用系统代理测试会读取系统设置的应用;移动端按客户端提示建立系统 VPN。暂时不要同时换模式、节点和接管方式。如果只是想让一个终端工具通过代理连接,可以先按它自己的文档配置代理地址,不必立即改整机路由。

  3. 用连接记录确认是否命中

    打开测试页面,然后到客户端的连接列表找目标域名,核对规则与出站。如果连记录都没有,先检查应用有没有接入;如果有记录,但命中了兜底,回头看规则的顺序与域名写法;如果命中正确仍然超时,再查目标站点和所选出站的连通性。报错时记录时间、模式和错误信息,分享日志前删去订阅地址及鉴权信息。

查看完整教程 →

首次排查常见问题

节点延迟有读数,为什么网页还是打不开?

测速请求与网页请求可能走不同规则,目标地址也不同。先看网页请求是否进入连接列表,再核对实际出站。读数只能说明那一次探测的结果。相关名词见术语手册。

订阅更新失败,要删除旧配置吗?

先保留可用配置。查看更新报错是请求超时、授权失败,还是格式解析失败,再按具体原因处理;远端内容无法读取时,反复重装客户端通常不能解决。可先在术语手册区分订阅与本地配置。

浏览器能上网,终端为何不走同一路线?

命令行程序不一定读取系统代理。有的读取环境变量,有的需要单独设置;先查该工具的说明,再到客户端看有没有入站记录。网络接管方式可参照术语手册。

SOURCE / MAINTENANCE

mihomo 源码与维护边界

项目名、客户端名和订阅来源是三件事。查一个字段时,先看真正加载配置的是哪个内核;查安装、更新或界面问题时,再回到具体客户端的说明。

从 Clash 到 mihomo

Clash 生态长期使用 YAML 描述入站、出站和规则。mihomo 延续了原来称作 Clash.Meta 的内核项目。旧资料沿用早期命名很常见,遇到旧文档里的界面截图或参数时,先确认对应的是哪个项目。相似的名字只能作为检索线索,不能用来判断某个字段仍然可用,也不能据此认定两个安装包来自同一个维护方。

开源协议与项目分工

mihomo 源码仓库采用 GPL-3.0 开源协议,可在上游仓库查阅代码、变更记录和问题讨论。该协议对应的是内核项目,不能据此推定每个图形客户端都采用相同协议。提供 GUI 的项目各自维护交互、系统集成与发行包;订阅则由配置提供方维护,更新订阅不会替换客户端或给系统安装新内核。

图形界面与实际生效配置

内核负责处理入站、按规则选出站并执行连接。图形客户端除了展示这些信息,还可能合并订阅、覆写和全局设置,再把结果交给内核。遇到配置文件里写了规则、界面里却没生效的情况,先确认活动配置,接着查覆写的应用顺序,最后对照连接记录。只看编辑器里的原始文件,容易遗漏客户端后来加上的设置。

升级前看哪份变更说明

更换安装包先看客户端的发布说明;涉及规则语法、DNS 行为或虚拟网卡支持,再查所用内核的变更。更新前记录当前配置和接管方式,保存本地规则及覆写副本,更新后用同一个目标测试。若只是新增一条规则,单独保存和测试规则比同时更新程序、规则集和订阅更容易定位变化。

NOTES / LATEST

技术笔记

找不到连接记录,先看代理有没有接管请求;有记录但路线不对,再查模式。准备换客户端时,先核对必须保留的功能和配置迁移方式。

查看全部文章 →