mihomo 内核 · 客户端与配置文档

Clash Meta下载与配置指南

下载Clash 查看教程

按系统选择客户端，完成订阅导入，设置规则分流，检查代理连接。

  • 开源内核
  • 多平台入口
  • 中文配置说明

平台与安装文件

Clash 客户端下载

先确认系统与处理器架构，再选图形客户端。安装包、系统要求与维护状态集中放在下载页，内核文件单独列出。

Windows

桌面使用可先看 Clash Plus，再按界面偏好比较 Clash Verge Rev、FlClash 与 Clash Nyanpasu。系统代理适合遵循系统设置的应用；需要接管更多连接时，再检查 TUN 所需权限与服务。安装前确认处理器架构，不把旧客户端的安装目录直接覆盖到新项目中。

前往下载

macOS

先区分 Apple Silicon 与 Intel，再选择对应安装文件。Clash Plus、Clash Verge Rev 和 FlClash 可作为界面选型起点。首次运行时按系统提示完成授权，切换客户端前先关闭原客户端的代理接管；配置是否兼容，应看实际使用的内核与配置字段，而不是只看应用名称。

前往下载

Android

按设备架构选择安装包，并在首次连接时确认 VPN 授权。Clash Plus、Clash Meta for Android 与 FlClash 的设置入口各有差异，先完成订阅导入，再检查应用分流和后台运行限制。Surfboard 的配置体系与 Clash YAML 不同，不能仅改文件后缀就直接通用。

前往下载

iOS

下载页提供 Clash Plus 的 App Store 入口及官网 clashplus.io。安装后先允许添加 VPN 配置，再导入客户端支持的链接或文件。桌面配置里的本地路径、脚本和特定系统参数不一定适用于手机；导入报错时，先确认配置格式和应用支持范围，再修改内容。

前往下载

Linux

有桌面环境时，可从 Clash Verge Rev 与 FlClash 开始，结合发行版选择软件包格式。服务器与路由器用户可查阅独立 mihomo 内核入口，但需要自行管理配置目录、进程与网络权限。桌面图形客户端和后台服务不要同时争用相同的监听端口与虚拟网卡。

前往下载

安装成功只说明程序能够运行，不代表订阅、节点或分流已经生效。首次使用建议只启动一个客户端，保留原配置副本，按“导入、选择、验证”的顺序完成检查。

查看全部客户端 →

配置能力浏览

mihomo 与规则分流

图形界面负责操作，内核负责连接与规则执行。按使用问题查看对应能力，先理解作用范围，再决定是否启用。

按目标匹配出站

规则分流用于把不同目标的连接交给不同出站策略，避免每次访问都手动切换模式。mihomo 按规则从上到下匹配，首个命中项决定后续路径；域名、地址段与规则集合都可以作为条件。策略组则负责组织可选出站，两者不是同一层概念。遇到某个应用走错路径时，先查看连接记录里的命中规则，再调整顺序，而不是直接把全部流量改成全局模式。

了解更多 ›

区分规则与策略组

导入配置后，先在代理页面选定策略组的出站项，再使用规则模式发起一次新连接。手动选择组会保留选择，自动测试组则按配置执行探测与切换。与原版 Clash 相比，mihomo 扩展了部分规则和策略能力，但具体可用字段仍需对照内核文档。自定义规则应放在确实需要优先匹配的位置，并使用客户端的覆写或合并机制，避免下次订阅更新时丢失修改。

了解更多 ›

首次运行流程

订阅导入与连接检查

保留一条可重复的检查路径：先让配置正常加载，再确定出站策略，最后观察实际连接。一次只改一类设置。

步骤 01 / 配置

导入并启用 Profile

打开客户端的配置页面，粘贴可信来源提供的订阅链接，或选择本地 YAML 文件。等待下载与解析完成，再明确选中这份配置。仅看到文件出现在列表里，还不能说明内核已经加载；应同时确认当前配置标记与错误提示。

导入报错时，先区分链接返回的是网页还是配置内容，再检查格式是否适配当前内核。订阅链接可能包含访问凭据，分享截图时遮住完整地址，不把链接粘贴到公开讨论区。先保留一份能够恢复的配置，再尝试覆写和合并。

步骤 02 / 出站

选择模式与策略组

初次连接可使用规则模式，在配置提供的策略组里选择出站项，再按系统要求开启系统代理或允许 VPN 连接。延迟测试只反映特定探测目标的连接情况，不能直接代表所有网站的访问速度，也不能替代一次完整请求。

先让基础代理路径工作，再决定是否需要 TUN。全局模式改变的是策略选择方式，不会自动让原本忽略系统代理的应用开始使用代理。切换模式后应新建连接观察结果；已经建立的长连接可能继续沿用原来的出站路径。

步骤 03 / 验证

核对连接与命中规则

访问一个明确的测试目标，查看客户端连接列表中的目标域名、匹配规则、策略组和最终出站。需要确认出口时，再配合可信的 IP 查询页面。页面能打开只能证明当前请求成功，仍应结合记录判断是否经过预期路径。

如果浏览器正常而某个应用失败，先检查该应用是否遵循系统代理，再考虑接管范围与 DNS。Windows 商店应用还可能涉及回环限制。记录发生问题的应用、目标和日志摘要，分别排查配置、代理路径与解析，避免同时更换多个参数后失去比较依据。

查看完整教程 → 首次连接检查清单 →

项目与维护依据

开源生态与内核关系

区分内核项目、图形客户端与订阅来源。代码、许可证和更新记录可以查阅，但客户端名称本身不能证明所有配置都兼容。

Clash、Meta 与 mihomo

Clash 是这类规则代理工具的重要起点，Clash Meta 在相关配置体系上扩展协议和网络能力，后续内核项目以 mihomo 名称继续发展。日常搜索中的“Clash Meta”仍可能指内核，也可能指采用该内核的图形客户端。识别具体项目时，需要同时看应用名称、内核说明和维护记录，不能把三个名称简单当成可以互换的安装包。

内核承担配置解析、规则匹配和连接处理；图形客户端通常提供订阅列表、托盘操作、系统代理开关与日志界面。相同内核可以搭配不同界面，不同界面也可能采用各自的配置预处理方式。迁移时先确认导出的内容是标准内核配置，还是仅供某个客户端使用的管理数据，再决定如何导入。

源码与许可证

mihomo 的源码和项目说明可在 MetaCubeX 的公开仓库查阅，内核采用 GPL-3.0 许可证。许可证说明代码的使用、修改和分发条件，并不表示每个图形客户端都采用相同许可证，也不代表订阅服务由内核项目提供。需要分发或二次开发时，应分别阅读所使用项目的许可文本和相关依赖说明。

查阅源码的价值在于核对实现与文档，而不是把星标数量当作连接质量承诺。本文不列动态热度数字；判断某项功能是否适用，应优先看公开文档、变更记录与当前客户端实际集成的内核。社区讨论适合查找已知问题，提交反馈前仍需去掉配置里的访问凭据与个人信息。

查看 mihomo 开源仓库 ↗

更新机制与兼容边界

客户端更新、内核更新、订阅更新和规则集合更新是四件不同的事。客户端更新可能改变界面与权限流程；内核更新可能调整协议或配置字段；订阅更新主要刷新远程配置内容；规则集合更新则改变某些规则引用的数据。排查变化时先识别是哪一层发生更新，才能找到对应记录，避免把所有问题都归因于订阅。

更新前保留配置副本和本地覆写内容，更新后先用原来的测试目标检查基础连接，再验证自定义规则。旧配置能够通过解析，不代表所有行为都与旧环境一致；反过来，新配置中的扩展字段也可能让旧内核无法加载。归档客户端适合查阅旧环境，日常选型应优先考虑仍有维护记录、系统支持明确的项目。

订阅来源与文档范围

本站整理客户端下载入口、操作流程和概念说明。订阅中提供哪些出站、服务端采用什么参数、远程地址是否可访问，由相应配置来源决定。客户端安装完成后仍需要有效配置；安装文件本身不是订阅服务。需要核对参数时，应向配置提供方确认协议类型、格式与使用要求，而不是从客户端名称推断连接信息。

不同客户端的按钮名称和设置位置可能变化，因此教程以“导入配置、选择出站、接管流量、验证连接”这条主线组织。遇到界面差异，先寻找对应功能，不必照搬所有开关。需要理解策略组、规则集合或 DNS 增强模式时，可先查概念速查；需要比较协议与内核能力时，再阅读协议手册。

概念速查 › 协议手册 › 常见问题 ›

获取 mihomo 源码

已安装 Git 的环境可复制以下命令。克隆操作只下载代码仓库，不会自动安装图形客户端，也不会启用系统代理。编译与运行要求以仓库文档为准。

git clone https://github.com/MetaCubeX/mihomo.git

可复制到本地终端；执行前确认命令内容。

配置与问题记录

近期技术文章

围绕配置管理、DNS 行为与应用兼容性展开说明。先确认问题所在层，再按文章步骤逐项验证。

查看全部文章 →