Mihomo 下载、安装与连接配置教程

Mihomo 是读取配置、匹配路由规则并通过所选上游连接发送请求的代理内核。既可以直接在命令行运行，也可以使用图形客户端管理内核。

选择内核或图形客户端

使用目标	建议起点
在桌面界面管理配置和连接	使用 Clash Verge Rev 等 Mihomo 客户端。
在终端或服务器运行配置	使用 Mihomo 内核程序。
理解请求发往何处	检查配置中的 proxies、proxy-groups 与 rules。

本文介绍命令行方式；需要图形界面时，请看 Clash Verge Rev 桌面配置教程。

请求路径：应用 → Mihomo 本地端口 → 匹配规则 → 策略组 → MIYAIP 端点。

下载适合系统的 Mihomo

打开 MetaCubeX Mihomo 官方发布页，按操作系统与处理器选择程序，解压到工作目录。

macOS 或 Linux 中的程序名使用 mihomo，Windows 中使用 mihomo.exe。在同一工作目录创建 miyaip-config 文件夹，用于保存下面的配置。

系统	下载前检查
Windows	系统类型：x64 或 ARM64。
macOS	处理器：Intel 或 Apple Silicon。
Linux	CPU 架构与发布版本的兼容要求。

macOS 或 Linux 中，先为解压后的程序添加执行权限，再检查版本：

chmod +x ./mihomo
./mihomo -v

Windows 中，在工作目录打开 PowerShell：

.\mihomo.exe -v

创建第一份 Mihomo 配置

将以下内容保存到 miyaip-config/config.yaml。把示例服务器、端口、账号和密码替换为 MIYAIP 账户提供的 SOCKS5 连接信息。

mixed-port: 7890
allow-lan: false
bind-address: 127.0.0.1
mode: rule
log-level: info

proxies:
  - name: MIYAIP-SOCKS5
    type: socks5
    server: proxy.example
    port: 1080
    username: "YOUR_USERNAME"
    password: "YOUR_PASSWORD"

proxy-groups:
  - name: MIYAIP
    type: select
    proxies:
      - MIYAIP-SOCKS5

rules:
  - MATCH,MIYAIP

设置	用途
mixed-port	供应用使用的本地 HTTP 与 SOCKS5 入口。
bind-address 与 allow-lan	将此示例的监听范围限制在当前电脑。
proxies	上游连接信息。
proxy-groups	策略可以选择的节点。
rules	请求匹配时采用的策略。

最终 MATCH 规则将所有进入本地监听端口的请求交给 MIYAIP 组；应用必须把流量发送到该端口，才会使用这份配置。监听和规则含义可参考 Mihomo 入站配置与路由规则。

应用经本地 mixed-port、MATCH 规则和 MIYAIP 组访问示例 SOCKS5 上游的路径

示例应用连接 127.0.0.1:7890，MATCH 再选择 MIYAIP 组及其中的 SOCKS5 节点。

改用 HTTP 端点

将 SOCKS5 节点替换为以下 HTTP 节点，并将策略组节点列表中的 MIYAIP-SOCKS5 改为 MIYAIP-HTTP。端口应使用 HTTP 连接信息实际提供的值。

  - name: MIYAIP-HTTP
    type: http
    server: proxy.example
    port: 3128
    username: "YOUR_USERNAME"
    password: "YOUR_PASSWORD"

也可以使用连接配置格式转换器生成完整配置：选择 Clash / Mihomo YAML，点击 Export file，按提示确认包含凭据后保存文件。

生成的文件包含节点、选择组和路由规则，可导出后在客户端使用。

校验配置并启动 Mihomo

校验配置

执行适合当前系统的命令；-t 参数检查配置后退出。

./mihomo -t -d ./miyaip-config -f ./miyaip-config/config.yaml

.\mihomo.exe -t -d .\miyaip-config -f .\miyaip-config\config.yaml

启动内核

用同一文件启动内核。测试期间保持进程运行，完成后按 Ctrl+C 停止。

./mihomo -d ./miyaip-config -f ./miyaip-config/config.yaml

.\mihomo.exe -d .\miyaip-config -f .\miyaip-config\config.yaml

通过本地代理发起请求

此示例的应用 HTTP 或 SOCKS5 代理地址为 127.0.0.1:7890。也可以在终端发起一次 HTTP 请求：

curl -I --proxy http://127.0.0.1:7890 https://example.com/

Windows PowerShell 中请使用 curl.exe。检查返回的响应头和 Mihomo 日志中的出站节点。浏览器测试需要先将浏览器指向本地代理，再打开 IP 查询工具检查出口。

报错或现象	检查内容	操作
配置校验失败	报告的行、字段与策略组名	修正后重新执行 -t 校验。
本地端口拒绝连接	进程与监听端口	启动内核，并让应用使用 mixed-port。
地址已被占用	其他本地代理进程	停止冲突进程，或更换本地端口。
上游认证失败	账号、密码、协议和端口	修正节点中的连接信息。
浏览器请求未出现在日志中	浏览器代理设置	指向本地监听端口，再发起新请求。

端点字段和 HTTP、HTTPS、SOCKS5 手动配置可参考静态端点教程。

常见问题

Mihomo 与 Clash Meta 是同一个内核吗？

Mihomo 是 MetaCubeX 代理内核目前使用的名称，该内核也常被称为 Clash Meta。选择程序和确认配置字段时，请使用项目文档与官方发布页。

Mihomo 与图形客户端有什么区别？

Mihomo 是内核；Clash Verge Rev 等图形客户端在内核之外提供配置和连接管理界面。需要应用界面时选择客户端，需要命令行配置时直接运行内核。官方客户端列表提供相关项目入口。

启动 Mihomo 会改变所有应用的路由吗？

本文示例仅开启本地监听端口。需要使用它的应用应设置对应地址和端口。全系统路由还需另行设置系统代理或 TUN。

可以同时配置多个 MIYAIP 端点吗？

可以。为每个端点设置唯一节点名，并在策略组中引用；路由规则可指向该组。组内选择可通过图形客户端或已配置的控制器管理。

使用静态住宅端点运行 Mihomo

获取 MIYAIP 连接信息，将端点加入配置，并从实际应用验证出站路径。

查看静态住宅套餐生成 Mihomo 配置

来源

Mihomo 项目与发布版本 — 查阅于 2026 年 10 月 19 日。
Mihomo 命令行参数（官方源码） — 查阅于 2026 年 10 月 19 日。
Mihomo 入站配置 — 查阅于 2026 年 10 月 19 日。
Mihomo 路由规则 — 查阅于 2026 年 10 月 19 日。
Mihomo HTTP 节点配置 — 查阅于 2026 年 10 月 19 日。
Mihomo SOCKS 节点配置 — 查阅于 2026 年 10 月 19 日。
Mihomo 客户端列表 — 查阅于 2026 年 10 月 19 日。