Mihomo 内核是什么？与客户端区别、下载选择和基础配置
简答：Mihomo 是负责代理协议、DNS、规则分流、TUN 和控制接口的网络代理内核；图形客户端则负责界面、配置管理和系统开关。普通用户通常不必单独运行裸核，直接选择内置 Mihomo 的客户端；只有服务器、软路由、NAS 或需要命令行管理时，才下载官方二进制并准备配置文件。本文从概念、下载核验、最小配置到启动排错逐步说明。
定义：Mihomo 内核是一个可被图形客户端调用、也可以独立运行的网络代理核心，负责接收本地流量、选择代理出站、执行 DNS 与规则分流，并提供控制接口。
先看结论：Mihomo 内核、客户端和配置文件不是一回事
如果你只是想导入订阅、切换节点或开启系统代理，通常应先选择一个已经集成 Mihomo 的客户端，而不是直接下载裸核。客户端提供窗口、订阅管理、系统代理和日志界面；Mihomo 内核负责真正处理代理协议、DNS、规则和流量转发；YAML 配置文件则告诉内核端口、节点、策略组、规则和 DNS 应该怎样工作。
| 对象 | 主要职责 | 适合谁 |
|---|---|---|
| Mihomo 内核 | 处理代理连接、DNS、规则、TUN 和 API | 服务器、软路由、NAS、需要命令行管理的人 |
| 图形客户端 | 提供界面、订阅导入、系统代理和日志操作 | Windows、macOS、Android 等普通桌面或移动用户 |
| 配置文件 | 定义端口、代理节点、策略组、DNS 和规则 | 所有运行 Mihomo 的环境 |
Mihomo 文档将代理端口、TUN 和 listeners 都归为流量接入方式；其中顶层 mixed-port 可同时承载 HTTP 与 SOCKS 流量，顶层 tun 则用于接管系统流量。官方入站配置文档对这些入口的作用有明确说明。
本文为第三方使用指南，不代表任何品牌的官方页面。若某个客户端界面与本文不同，应以该客户端当前版本说明和日志为准。
下载 Mihomo 时，先核对系统、架构和编译标识
官方发布页中的文件名通常包含系统、CPU 架构、兼容性标签和版本号。不要只看文件名里是否有“amd64”就直接下载，还要确认操作系统和设备架构是否匹配。官方文档列出了 Windows、Linux、macOS、FreeBSD、Android 等系统以及 amd64、386、arm64、armv7 等架构选项；官方 FAQ 还解释了 compatible、默认 amd64 构建和 Go 版本标识的区别。官方启动与安装文档和官方 FAQ可用于逐项核对。
| 设备情况 | 优先核对 | 不要忽略 |
|---|---|---|
| 普通 Windows 或 Linux 64 位电脑 | 系统为 windows/linux，架构通常为 amd64 | 老旧或虚拟化 CPU 可能需要 compatible 构建 |
| Apple 芯片设备 | 系统为 darwin，架构通常为 arm64 | 不要误选 darwin-amd64 |
| ARM 设备、软路由或 NAS | 确认是 arm64、armv7 还是其他架构 | 以设备系统信息和发布页资产为准 |
| Android 设备 | 确认 arm64、armv7、amd64 或 386 | 裸核文件不等于完整移动端客户端 |
- 打开 Mihomo 官方 Releases，确认发布通道是稳定版还是测试版。
- 根据系统和 CPU 架构筛选资产，不要从不明镜像或改名下载页获取二进制。
- 下载后对照发布页提供的 SHA-256 值校验文件；校验值不一致时不要继续运行。
- 记录下载日期。版本、资产和测试通道会变化，本文截至 2026 年 11 月 6 日不固定承诺某个“最新版本号”。
最小配置怎么写：先让内核启动，再逐项增加功能
下面是用于理解结构的最小骨架，不包含真实节点，也不能直接连接外部服务。字段名称和可用值应以当前版本文档为准。实际使用时，至少需要有效的 proxies 或 proxy-providers，并让策略组引用它们。
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
proxies: []
proxy-groups:
- name: PROXY
type: select
proxies:
- DIRECT
rules:
- MATCH,PROXYmixed-port 是本地 HTTP/SOCKS 混合代理端口；allow-lan: false 可先限制为本机使用，避免在还没配置认证和防火墙前暴露给局域网；mode: rule 表示按规则匹配流量，官方全局配置文档同时列出了 rule、global 和 direct 三种模式。官方全局配置文档可核对这些字段。
如果配置来自远程订阅，不建议把订阅内容直接覆盖自己维护的主配置。更稳妥的思路是使用 proxy-providers 保存远程代理列表，再由 proxy-groups 引用提供者；这样调整本地端口、DNS、规则和策略组时，不必每次更新订阅都重写整份配置。具体的提供者字段、格式和覆盖规则应查看官方 proxy-providers 文档。
DNS、TUN 和复杂规则不要在第一次启动时全部打开。先使用本地混合端口验证内核能够启动，再逐项添加 DNS、规则集或 TUN；一次只改一个功能，出现问题时更容易定位。
按顺序完成校验、启动和本地连接测试
无论使用 Windows、macOS 还是 Linux，排错顺序都建议保持一致：先检查配置语法，再启动内核，再确认端口监听，最后测试代理请求。不要在配置解析失败时直接排查 DNS 或节点。
- 准备工作目录：将 Mihomo 可执行文件和配置文件放在同一目录，或使用命令中的
-d指定配置目录。 - 校验配置：在该目录执行配置测试命令。Windows 示例为
.\mihomo.exe -t -d .；macOS/Linux 示例为./mihomo -t -d .。如果提示 YAML 解析错误，优先检查缩进、冒号、引号和重复字段；不同版本的参数形式应以当前文档为准。 - 启动内核：Windows 可执行
.\mihomo.exe -d .；macOS/Linux 可执行./mihomo -d .。看到启动日志后，再继续下一步。 - 检查端口：确认
7890没有被其他程序占用。Windows 可使用netstat -ano | findstr :7890，macOS/Linux 可使用lsof -i :7890；若已有进程监听，关闭冲突程序或修改mixed-port，然后重新校验配置。 - 测试本地代理：使用支持代理参数的命令行工具访问一个你有权访问的测试地址，例如
curl -x http://127.0.0.1:7890 https://example.com -I。能返回 HTTP 响应头，说明本地代理端口至少已经接收请求；若连接被拒绝，回到进程和端口检查。
Linux 服务器若需要开机运行，可参考官方 systemd 示例，将二进制放入系统路径、把配置放入独立目录，再通过 systemctl status mihomo 和 journalctl -u mihomo 查看状态和日志。官方 systemd 服务文档提供了服务文件和管理命令，但权限、目录和 TUN 能力仍需按你的系统调整。
连接失败时，先分清配置、端口、DNS 还是 TUN
- 配置解析失败：先关闭客户端或停止裸核，检查 YAML 缩进和字段拼写；不要直接复制不同版本教程中的完整配置。
- 端口被占用：用系统命令找到占用进程，优先修改本地端口或退出冲突程序；不要一开始就重置系统网络。
- 代理端口能连但网页打不开：检查策略组是否有可用代理、规则最终是否落到正确策略，再观察日志中是否出现 DNS 解析失败或连接超时。
- DNS 异常：先暂时关闭自定义 DNS 和 Fake-IP，确认基础代理可用后再逐项恢复。官方 DNS 文档说明了 DNS 服务器、代理连接和 Fake-IP 等配置之间的关系。官方 DNS 配置文档
- TUN 无法启动：先关闭 TUN 开关，退出客户端，检查系统是否授予虚拟网卡或网络扩展权限；恢复时按“关闭 TUN→退出客户端→确认系统代理→重新启动”的顺序操作。TUN 相关字段和平台限制应以官方 TUN 文档为准。
- 控制面板打不开：确认
external-controller的监听地址和端口，并设置访问密钥。不要在不需要远程管理时绑定0.0.0.0；官方文档明确提醒外部控制接口需要自行做好安全保护。官方安全配置说明
如果你只是普通电脑用户，最省事的路径是：选择支持 Mihomo 的客户端→导入配置或订阅→确认本地代理端口→先测试单个应用→最后再启用 TUN。若你运行的是服务器、软路由或 NAS，再考虑 systemd、TUN、局域网访问和外部控制接口。
Mihomo 常用术语速查
| 英文术语 | 中文理解 | 使用提醒 |
|---|---|---|
| kernel | 内核 | 负责实际代理处理，不等于图形客户端 |
| binary | 可执行文件 | 必须匹配系统和 CPU 架构 |
| release asset | 发布附件 | 从官方发布页核对文件名和 SHA-256 |
| mixed-port | 混合代理端口 | 用于接收本地 HTTP/SOCKS 请求 |
| proxy-provider | 代理提供者 | 适合保存远程代理列表，减少覆盖主配置 |
| proxy-group | 策略组 | 决定节点选择、故障切换或规则出口 |
| external-controller | 控制接口 | 远程监听时必须考虑鉴权和防火墙 |
| TUN | 虚拟网卡接管 | 涉及系统权限、路由和 DNS，建议最后开启 |
如果你看到旧教程仍使用 Clash.Meta 这个名称，不要仅凭名称判断文件来源；应回到项目发布页、文档和文件校验值进行核对。版本动态变化时，以官方页面实际显示内容为准。
继续排查：从内核概念转到具体客户端问题
理解内核与客户端的分工后，下一步应只选择一个具体问题继续处理：如果连接成功但网页打不开，先看请求、DNS、规则和 TUN；如果规则组不生效，按配置层、策略组和规则匹配顺序排查；如果订阅导入失败，则先看状态码和解析日志。可继续阅读站内的 Mihomo 代理连接成功但打不开网页怎么办、Mihomo 规则组不生效怎么办、Mihomo 订阅配置导入失败怎么办 和 mihomo GitHub 仓库与下载文件核验指南。
了解边界云加速的线路方案，以官网说明为准。
常见问题
Mihomo 内核和客户端有什么区别？
Mihomo 内核负责实际的代理协议、DNS、规则和流量转发；客户端负责图形界面、订阅管理、系统代理和开关。普通用户通常使用集成 Mihomo 的客户端，不必单独运行裸核。
Mihomo 和 Clash.Meta 是同一个东西吗？
它们属于项目名称沿革和兼容语境中的相关称呼。下载时不要只凭旧名称判断来源，应以项目发布页、官方文档、文件名和 SHA-256 校验值为准。
普通用户需要单独下载 Mihomo 内核吗？
多数情况下不需要。若客户端已经内置并管理 Mihomo，直接在客户端中导入配置即可；服务器、软路由、NAS 或需要命令行运行时，才更常见地单独下载二进制。
下载哪个 Mihomo 文件最合适？
先确认操作系统和 CPU 架构，再比较默认构建与 compatible 构建。老旧或虚拟化 CPU 可能需要兼容版本；具体资产和版本通道以官方 Releases 页面当前显示为准。
配置文件校验失败怎么办？
先执行对应系统的配置测试命令，检查 YAML 缩进、冒号、引号、重复字段和字段是否受当前版本支持。确认测试通过后再启动，不要在语法错误状态下继续排查 DNS 或节点。
Mihomo 连接成功但网页打不开怎么办？
按本地代理端口、策略组、规则匹配、DNS 和 TUN 的顺序排查。先关闭 TUN 与自定义 DNS，确认基础代理请求能够返回响应，再一次恢复一个功能。