开源项目mihomo 生态

Clash 开源客户端下载

按系统选择客户端,参考 mihomo 配置示例导入订阅、设置规则分流,再按需调整 DNS 与网络接管方式。

  • 安装包选择
  • YAML 示例
  • 中文文档
config.yaml 配置摘录
mixed-port: 7890mode: ruledns:  enable: true  enhanced-mode: fake-iprules:  - GEOIP,CN,DIRECT  - MATCH,Proxy
内核 mihomo
浏览开源仓库与发布记录

MIHOMO / CONFIG SCENES

从配置片段定位手册章节

查看进阶配置手册

CONFIG REFERENCE

mihomo 配置
与运行行为

策略组决定出口,规则决定哪些连接使用这个出口。先从这两层检查分流,再看 DNS 是否返回了预期结果,以及流量是否进入内核。

config.yaml

策略组名称与出口选择

把规则指向策略组,可以更换出口而不用重写域名列表。select 由用户选定成员;url-test 按探测结果选取成员;fallback 则优先使用列表中靠前的可用成员。例子只用内置策略来说明引用关系。接入订阅后,先核对组名和成员名,再从连接记录确认规则命中的组与最终出口。客户端的界面可能隐藏部分字段,排查时以生效配置为准。

proxy-groups:
  - name: Proxy
    type: select
    proxies: [DIRECT, REJECT]
rules:
  - MATCH,Proxy
查阅策略组类型与实战

PLATFORM PACKAGES

按平台选择 Clash 客户端

先看操作系统与处理器架构,再比较客户端。图形客户端适合在界面中管理配置;单独运行 mihomo 则需要自行处理配置目录、进程管理和系统网络设置。如果是替换已有客户端,先保存本地覆写和策略组选择,再退出旧客户端。遇到端口占用时,先确认旧进程是否退出,不要直接修改订阅里的端口来绕过问题。

Windows

适合优先使用图形界面、按应用排查代理行为的桌面环境。在系统的“关于”页面确认处理器架构,再对照下载页的包类型。初次连接可先打开系统代理验证浏览器;只有目标应用不读取系统代理时,再考虑 TUN。升级前退出旧客户端,并确认后台服务也已停止。若客户端退出后浏览器仍无法联网,先检查系统代理是否保留了指向本地端口的设置。单位设备上的管理员授权和防火墙设置应遵守设备管理要求。

前往下载

macOS

在“关于本机”查看芯片信息,区分 Apple Silicon 与 Intel。以下载页实际列出的架构为准,不用根据系统界面或设备年份猜测。使用菜单栏切换代理时,可到系统网络设置复核代理状态。若一启动就退出,先检查安装包架构和系统要求;如果只是个别应用不能联网,先排除应用自己的代理设置。迁移旧配置时,分别确认订阅地址、本地文件和策略选择,不要假定新客户端会读取另一个客户端的工作目录。

前往下载

Android

根据设备架构选择 APK;下载页提供通用包时,可用它减少选错架构的概率。首次连接通常需要确认系统 VPN 请求。若设备上已有其他 VPN,先检查系统当前允许哪个应用建立连接。保持默认的电池策略做一次前台和锁屏测试,再决定是否需要调整后台权限。锁屏后掉线与切换无线网络后掉线可能是两类问题:前者先看进程是否被暂停,后者先确认系统 VPN 是否已在新网络上重新连接。

前往下载

iOS

通过下载页进入客户端的 App Store 详情,先核对系统要求。安装后按应用提示添加 VPN 配置,再导入已有订阅。若订阅在桌面端可用、在移动端却无法导入,应先检查客户端支持的配置格式与字段,而不是直接修改服务端地址。测试时可分别使用无线网络和蜂窝网络,确认问题是否只出现在某种接入方式。如果设备受单位或学校管理,VPN 配置项可能由管理策略限制,应先确认允许的使用范围。

前往下载

Linux

桌面系统优先按发行版的包管理方式和处理器架构选择安装包。桌面代理设置不一定会同步到终端,命令行工具应单独确认是否读取相应的代理环境变量。服务器或路由器通常更适合单独运行内核,并显式指定配置目录、工作用户与日志位置。启动失败时先区分包不兼容、缺少依赖和服务权限不足;连接失败时再看监听地址和路由。两类问题的排查入口不同,不必为了测试而同时修改防火墙与系统路由。

前往下载

查看全部客户端 →

FIRST CONNECTION

Clash 首次连接:导入、接管、验证

建议先保留一份可以正常启动的配置,再逐步更改分流规则和网络接管方式。每次只改变一个设置,测试同一个目标,确认变化来自哪个开关。

  1. 导入并启用配置

    安装后进入“配置”或“订阅”页面,选择从 URL 导入已有订阅,或者从文件导入本地 YAML。列表出现新条目后,手动选中它并确认已应用。能看到配置名称只表示条目已经保存,未必说明内核成功加载。若应用失败,先看报错指出的字段或行号,核对缩进、引用名称和客户端支持的字段。向他人求助时,提供相关字段与报错即可,不要把订阅地址或完整配置贴到公开讨论区。

  2. 选择规则模式和接管方式

    将运行模式设为“规则”,保留配置给出的分流逻辑。桌面端先用系统代理测试支持该设置的应用,移动端按系统提示建立 VPN 连接。如果目标程序没有进入连接列表,再考虑应用独立代理或 TUN。系统代理决定应用是否把请求交给客户端,运行模式决定内核接收请求后如何处理,两处设置不能互相替代。若设备已有其他网络接管工具,先停止旧工具测试,避免把路由冲突误判成订阅失效。

  3. 用连接记录验证命中结果

    选一个预期直连的目标和一个应走代理的目标,分别发起新请求。在连接记录里查看目标域名、命中规则和最终出口,不要只以页面能否打开来判断分流。如果有记录但出口不对,先检查规则顺序和策略组当前成员;如果没有记录,先确认应用的连接是否被接管。调整规则后要建立新连接再比较,应用复用已有连接时,观察到的结果可能仍来自修改前。

查看完整教程 →

SOURCE / RELEASES

mihomo 源码与发布记录

原版 Clash 与后续分支

原版 Clash 停止维护后,相关客户端与内核项目沿各自的代码仓库继续演进。mihomo 源于 Clash.Meta 分支,仍使用读者熟悉的规则、策略组和 YAML 配置结构,但也发展了自己的字段与行为。名称里带有 Clash,并不表示项目共享同一维护者或发布周期。阅读旧教程时,应先识别它讲的是原版内核、后续分支,还是某款图形客户端,尤其要留意安装入口、服务模式和 DNS 配置的差异。

迁移归档客户端的配置时,先导入一份副本,观察内核启动日志和客户端生成的实际配置。旧字段能被解析,并不代表旧有网络行为会被原样保留;系统权限、路由和 DNS 默认值也可能变化。

客户端与内核的分工

mihomo 负责解析运行配置、接收连接、执行规则并选择出口。Clash Verge Rev、FlClash 等图形客户端在此基础上提供配置管理、菜单开关与连接视图。托盘交互、订阅更新入口和覆写编辑器通常属于界面层;规则匹配失败和模块初始化报错则需查内核日志。两个界面都提供名为“系统代理”的开关,也可能用不同方式管理系统设置。排查时先确认问题归哪一层,不必为解决界面问题重写整份 YAML。

同一订阅在不同客户端上的表现有差异时,查看各自应用了哪些本地覆写、启用了哪些代理入口。若能导出生效配置,把相关字段放在一起比较,比对照整个设置页面更容易找出区别。

仓库、议题与问题归属

上游仓库用来查源码、改动和公开议题。遇到配置问题,可先用报错原文或字段名搜索;如果只是某个客户端的安装器无法启动,应从该客户端的发布记录和议题查起。准备反馈时,写明系统架构、接管方式、复现步骤和实际结果。用最小配置复现有助于判断是字段关系、网络环境还是界面设置,不需要附带完整的订阅内容。本站提供客户端入口与中文文档;对项目功能和维护状态的判断,以各项目的上游记录为准。

如果同一问题只在接入某个网络后出现,也应注明何时开始复现,以及切回原网络是否恢复。这样维护者能区分环境限制和稳定可复现的软件回归。

读完改动说明再更新

图形客户端的发布与 mihomo 内核的发布是两条线。界面更新未必伴随内核更新,单独替换内核也可能超出客户端的支持范围。安装前先区分稳定发布和预发布,核对包的系统与架构,再读有关 DNS、TUN、权限或配置迁移的改动说明。更新完成后,用现有配置验证启动、订阅加载、直连和代理出口。出现异常时,保留旧配置与更新前的正常操作记录,以便回退或逐项确认变化。

无需在更新客户端的同时更换规则集、重设上游 DNS 或启用新模式。如果把升级和配置修改分开做,即使出现网络问题,也能明确应先恢复哪一步。

获取 mihomo 源码

此命令用于阅读源码。安装现成客户端请使用下载页;编译内核请按仓库说明准备环境。

git clone https://github.com/MetaCubeX/mihomo.git
源码仓库 发布记录

TECHNICAL NOTES

最新配置与平台文章

查看全部文章 →

Clash下载