客户端教程
Mihomo(Clash Meta)内核入门:下载、配置文件与运行方法
Mihomo(原 Clash Meta)是多数 Clash 系图形客户端的底层内核。本文介绍它与图形客户端的关系、官方下载、配置文件结构、命令行运行与 TUN 设置,适合进阶用户和服务器、路由器部署。
简短回答
Mihomo 是 Clash Meta 更名后的开源代理内核,本身没有图形界面。普通用户通过 Clash Verge Rev 等客户端间接使用即可;需要在服务器、路由器或无界面环境运行时,再直接部署内核。
| 支持平台 | Windows / macOS / Linux / Android |
|---|---|
| 价格 | 免费 |
| 开源 | 是 |
| 内核 | Mihomo |
| 支持协议 | Shadowsocks、VMess、VLESS、Trojan、Hysteria2、TUIC、WireGuard |
| 上手难度 | 进阶 |
| 适合 | 进阶用户、路由器与服务器部署 |
| 官方下载 | github.com |
只从官方渠道下载,第三方打包版本可能被篡改。信息核对:2026-10-01
快速步骤 · 5 步
- 01从官方仓库下载
在 MetaCubeX/mihomo 的 Releases 页面按系统和架构下载对应文件并解压。
- 02准备配置目录
新建配置目录,把机场的 Clash 配置保存为 config.yaml,或自行编写并用 proxy-providers 引用订阅。
- 03测试配置
用 -t 参数检查配置文件语法,确认无误。
- 04启动内核
用 -d 参数指定配置目录启动,按需配置为系统服务开机运行。
- 05让程序走代理
将浏览器或终端代理指向配置中的 mixed-port,或在配置中启用 TUN。
Mihomo 是什么,你是否需要直接使用它
Mihomo 是 Clash Meta 更名后的开源代理内核,也是目前 Clash 生态维护最活跃的分支。它只负责“按规则把流量转发到节点”,没有图形界面。Windows、macOS 上的 Clash Verge Rev 等客户端都以它为底层。所以:日常在电脑上用 Claude、ChatGPT,装图形客户端就够了;只有想在 Linux 服务器、软路由、NAS 上运行代理,或者希望完全用配置文件管理时,才需要直接部署 Mihomo。
下载与安装
官方发布地址是 MetaCubeX/mihomo 的 Releases 页面。文件名中包含系统和架构,例如 linux-amd64、linux-arm64、darwin-arm64、windows-amd64,按设备选择即可。Linux 上解压后赋予执行权限:
gunzip mihomo-linux-amd64-*.gz
chmod +x mihomo-linux-amd64-*
sudo mv mihomo-linux-amd64-* /usr/local/bin/mihomo
注意
只使用官方仓库发布的文件。第三方打包的“一键脚本”可能修改了内核或附带其他程序,部署到服务器前务必确认来源。
配置文件的基本结构
Mihomo 使用 YAML 格式配置,兼容 Clash 配置。一个最小可用的结构如下(节点信息由订阅提供):
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
proxy-providers:
airport:
type: http
url: "你的订阅链接"
path: ./providers/airport.yaml
interval: 86400
proxy-groups:
- name: 节点选择
type: select
use:
- airport
rules:
- GEOIP,CN,DIRECT
- MATCH,节点选择
mixed-port:同时提供 HTTP 和 SOCKS5 的本地端口,7890 是常见写法,可自行修改;proxy-providers:引用订阅链接,按interval秒自动更新;proxy-groups与rules:决定哪些流量走哪个节点,详细写法见 分流规则入门。
运行与测试
mihomo -d ~/.config/mihomo -t # 测试配置是否有效
mihomo -d ~/.config/mihomo # 以该目录为配置目录启动
长期运行建议配置为系统服务(如 systemd),并开启 external-controller 搭配网页面板查看连接与切换节点。面板只监听本机或内网地址,并设置 secret,不要直接暴露到公网。
TUN 与终端工具
在服务器上,Claude Code、Codex CLI 等工具不会自动走代理。可以在终端中设置环境变量,指向 mixed-port(方法见 终端代理设置);也可以在配置中启用 tun 段落,让内核接管系统流量。TUN 需要 root 权限,配置不当可能导致 SSH 断开,远程服务器上建议先用环境变量方式。
常见问题
| 现象 | 可能原因 | 处理方向 |
|---|---|---|
| 启动即退出 | 配置语法错误、端口被占用 | 先用 -t 测试,检查端口 |
| 节点列表为空 | 订阅下载失败或格式不兼容 | 检查订阅链接与服务器网络 |
| 开启 TUN 后断网 | 路由或 DNS 配置冲突 | 见 开启客户端后没有网络 |
常见问题
QMihomo 和 Clash Verge Rev 有什么关系?
Mihomo 是负责实际转发流量的内核,Clash Verge Rev 是在它之上的图形界面。在 Clash Verge Rev 中使用订阅,实际上就是由 Mihomo 内核在运行。
Q普通用户需要单独下载 Mihomo 吗?
不需要。桌面端直接安装 Clash Verge Rev 等图形客户端即可,内核已经内置。只有在服务器、路由器或想用命令行管理时才需要单独部署。
Q机场的 Clash 订阅能直接给 Mihomo 用吗?
多数情况下可以。Mihomo 兼容 Clash 配置格式,可以把订阅下载为配置文件,或在自己的配置里用 proxy-providers 引用订阅链接。
Q修改配置后怎么确认没有语法错误?
可以先用 -t 参数测试配置文件,确认通过后再正式启动,避免服务因配置错误无法运行。