mihomo 中文指南
clashv · 最后核实：2026-10-29
mihomo 是一个基于规则的代理内核，原名 Clash Meta，由 MetaCubeX 维护。它负责真正的代理、DNS 和分流，本身没有图形界面。Clash Verge Rev、FlClash、Clash Meta for Android、OpenClash 等客户端都内置了它，所以大多数人不需要单独下载 mihomo。
本站是非官方的 Clash 中文指南，与 MetaCubeX 无关。下载链接全部指向官方发布页。
- 类型
- 命令行内核
- 平台
- Windows · macOS · Linux · FreeBSD · Android
- 价格
- 免费
- 开源协议
- GPL-3.0
- 官方地址
- 发布页 ↗（在新窗口打开） · 文档 ↗（在新窗口打开）
我需要单独下载 mihomo 吗？
大多数人不需要。下表中的客户端都已内置 mihomo，装好客户端就能用。
| 你的情况 | 用什么 |
|---|---|
| Windows / macOS / Linux 电脑 | Clash Verge Rev 或 FlClash |
| 安卓手机 | Clash Meta for Android 或 FlClash |
| OpenWrt 路由器 | OpenClash |
| 服务器、NAS、Docker、不想用图形界面 | 直接用 mihomo（继续往下读） |
下载哪个文件
发布页每个版本有上百个文件，文件名格式是：
mihomo-系统-架构[-编译标签]-版本号.扩展名
- 选系统：windows、darwin（macOS）、linux、freebsd、android。
- 选架构：普通电脑选 amd64；Apple 芯片的 Mac、树莓派等 ARM 设备选 arm64；路由器常见的还有 armv7、mips 等。
- 看编译标签：amd64 电脑不确定 CPU 新旧时选带 v1 的；其他架构选不带额外标签的即可。
| 标签 | 含义 | 什么时候选 |
|---|---|---|
| 无标签 | 用最新 Go 版本编译。注意：amd64 的无标签版本等同于 v3 | 非 amd64 设备；确定 CPU 较新的 amd64 电脑 |
| v1 / v2 / v3 | 仅用于 amd64，对应 x86-64 指令集等级，数字越大要求 CPU 越新 | 不确定时选 v1，所有 64 位 x86 CPU 都能运行 |
| go120 / go123 等 | 用旧版 Go 编译，兼容更老的系统 | Linux 内核低于 3.2 时选 go123 |
| compatible | 旧文件名，内容与 v1 相同，官方构建脚本注明将移除 | 不必选，改选 v1 |
| abi1 / abi2 | 龙芯（loong64）的 ABI 版本 | 龙芯设备 |
扩展名：Windows 是 .zip；Linux 有 .gz、.deb、.rpm、.pkg.tar.zst；macOS 和 FreeBSD 是 .gz。官方构建支持 Windows 7+、macOS 10.13+。
发布页里的 toolchain.tar.gz、vendor.tar.gz、version.txt 用于从源码构建，普通用户不用下载。正式版不附校验值文件，请认准官方发布页地址。
基本用法
| 参数 | 作用 |
|---|---|
| -d <目录> | 指定配置目录 |
| -f <文件> | 指定配置文件 |
| -t | 检查配置文件是否正确，然后退出 |
| -v | 显示版本号 |
不加参数时，默认配置目录是 ~/.config/mihomo（Windows 为 %USERPROFILE%\.config\mihomo）。常见的启动方式：
$ mihomo -d /etc/mihomo每个参数也可以用环境变量设置，例如 CLASH_HOME_DIR 对应 -d。开机自启见官方文档的服务页面（在新窗口打开）（含 systemd 配置示例）。
网页控制面板
官方面板 metacubexd（在新窗口打开） 可以在浏览器里切换节点、查看连接和日志。需要在配置里设置 external-controller（官方示例 127.0.0.1:9090），并建议用 secret 设访问密码；面板文件可放在 external-ui 指定的目录。
用 Docker 运行
官方镜像 docker.io/metacubex/mihomo，配置目录挂载到 /root/.config/mihomo/。
docker run -d --name mihomo \ -v /path/to/config:/root/.config/mihomo \ docker.io/metacubex/mihomo
端口映射、TUN 模式等进阶设置，本站实测后另写教程。第三方打包的镜像不是官方发布的。
配置
配置文件是 YAML 格式，由基础设置、节点、代理组和分流规则四部分组成。逐项讲解见 Clash 配置文件详解；改完可以用 mihomo -t 或配置文件检查器先检查一遍。
常见问题
mihomo 和原版 Clash 有什么区别？
原版 Clash 内核已不再维护。mihomo 在它的基础上继续开发，官方文档称其支持原版的全部特性，并增加了更多协议和功能。本站推荐的客户端都使用 mihomo。
旧的 Clash 配置文件能直接用吗？
一般可以。从 v1.17.0 之前的版本升级时，注意默认配置目录已改为 ~/.config/mihomo。个别字段在后续版本中废弃或改名，可以先用 mihomo -t 检查。
mihomo 有图形界面吗？
没有。想要图形界面，可以用内置 mihomo 的客户端；在服务器上运行时，可以配合官方网页面板 metacubexd。
发布页里那么多文件，我该下哪个？
按"系统 → 架构 → 编译标签"的顺序选，amd64 电脑不确定时选带 v1 的，其他架构选不带额外标签的。
怎么更新 mihomo？
用客户端的人，更新客户端即可。直接用内核的人，从发布页下载新版替换原来的程序文件；用 Docker 的人，拉取新镜像后重建容器。
仓库首页为什么是一个 Python 项目？
mihomo 仓库的默认分支 main 目前放的是一个与代理无关的 Python 项目，内核源码在 Meta 和 Alpha 分支。下载时直接进发布页即可，不影响使用。
Meta 和 Alpha 分支有什么区别？
按官方 FAQ：Alpha 是最新提交的分支，Meta 分支每隔一段时间合并 Alpha 的代码，但 Meta 不一定比 Alpha 更稳定。普通用户下载发布页里标为 Latest 的正式版即可。
相关问题排查
全部问题排查 →用 mihomo 时遇到这些情况，可以按对应的排查页一步步处理。
相关文章
博客全部文章 →博客里和 mihomo 有关的版本更新和专题文章，新文章在前。
版本动态
- mihomo v1.19.33 发布：更新内容与各平台安装包内核新版本发布。使用图形客户端的人一般等客户端更新即可，直接运行内核的人可从官方发布页下载。
专题文章
- 打开 mihomo 的 GitHub 仓库，为什么看到的是另一个项目？mihomo 仓库的默认分支放的是一个无关的 Python 项目，内核代码和发布版在别处。这篇说明怎么认准真正的发布页。